org.jboss.mx.persistence
Interface AttributePersistenceManager

All Known Implementing Classes:

NullAttributePersistenceManager (src) , XMLAttributePersistenceManager (src)

public interface AttributePersistenceManager

AttributePersistenceManager interface. Implementations of this interface are created by an MBean service that acts as factory and a manager for the active AttributePersistenceManager implementation The DelegatingPersistenceManager will contact the MBean to get an AttributePersistenceManager implementation. In this way, the Persistence Manager can be controlled externally as an MBean.

create

public void create(java.lang.String version,
                   org.w3c.dom.Element config)
            throws java.lang.Exception

Initializes the AttributePersistenceManager using the supplied configuration element CONFIG_ELEMENT whose content will be probably different for each particular implementation. The version string is a tag that must be used by the AttributePersistenceManager implementation to make sure that data saved/loaded under different version tags are partitioned. It can be null or empty to indicate that no particular version tag is required. Once created, the configuration of the implementation object cannot change. Calling any other method before create() is executed will result in a IllegalStateException Finally, the implementation should be prepared to receive multiple concurrent calls.

Parameters:

version - a tag to identify the version

config - XML Element to load arbitrary config

Throws:

java.lang.Exception - when any error occurs during create

getState

public boolean getState()

Returns true if the AttributePersistenceManager is "in-service" state, i.e. after create() and before destroy() has been called, false otherwise.

Returns:

true if in operational state

destroy

public void destroy()

Releases resources and destroys the AttributePersistenceManager. The object is unusable after destroy() has been called. Any call to any method will result to an IllegalStateException.

exists

public boolean exists(java.lang.String id)
               throws java.lang.Exception

Checks if a persistened AttributeList for this particular id exists

Parameters:

id - the key of the image

Returns:

true if an image exists; false otherwise

Throws:

java.lang.Exception - on any error

load

public AttributeList (src)  load(java.lang.String id)
                   throws java.lang.Exception

Uses the specified id to retrieve a previously persisted AttributeList. If no data can be found under the specified id, a null will be returned.

Parameters:

id - the key for retrieving the data

Returns:

the data, or null

Throws:

java.lang.Exception - when an error occurs

store

public void store(java.lang.String id,
                  AttributeList (src)  attrs)
           throws java.lang.Exception

Persists an AttributeList (name/value pair list), under a specified id. The id can be used to retrieve the AttributeList later on. The actual mechanism will differ among implementations.

Parameters:

id - the key for retrieving the data later on, not null

attrs - the data to be persisted, not null

Throws:

java.lang.Exception - when data cannot be persisted

remove

public void remove(java.lang.String id)
            throws java.lang.Exception

Removes the persisted AttributeList, if exists

Parameters:

id - the key of the image

Throws:

java.lang.Exception - when any error occurs

removeAll

public void removeAll()
               throws java.lang.Exception

Removes all the persisted data stored under the configured version tag.

Throws:

java.lang.Exception - when any error occurs

listAll

public java.lang.String[] listAll()
                           throws java.lang.Exception

Returns a String array with all the saved ids under the configured version tag.

Returns:

array with all persisted ids

Throws:

java.lang.Exception - when any error occurs