blackboard.persist.user
Interface UserXmlPersister

All Superinterfaces:

Persister

public interface UserXmlPersister

extends Persister

UserXmlPersister

Since:

Bb 6.0

Version:

$Revision: 6 $ $Date: 4/18/03 11:27a $

Field Summary

static java.lang.String

TYPE Type used to obtain an instance of the class configured to provide the implementation for this interface.

Method Summary

org.w3c.dom.Element	persist(User obj, org.w3c.dom.Document doc) Generates an Element tree whose values and structure matches the contents of the provided User object.
org.w3c.dom.Element	persistList(BbList list, org.w3c.dom.Document doc) Generates an Element whose children are the provided User objects persisted to XML.

Methods inherited from interface blackboard.persist.Persister

getAppVersion, init

Field Detail

TYPE

public static final java.lang.String TYPE

Type used to obtain an instance of the class configured to provide the implementation for this interface. Used when making a call to BbPersistenceManager.getPersister(String)

See Also:

Constant Field Values

Method Detail

persist

public org.w3c.dom.Element persist(User obj,
                                   org.w3c.dom.Document doc)
                            throws ValidationException,
                                   PersistenceException

Generates an Element tree whose values and structure matches the contents of the provided User object.

Parameters:

obj - the User we should generate the XML tree for.

doc - the Document we should use to create the Element with. No assumptions should be made concerning the state of this Document -- it should only be used for Element creation.

Returns:

an Element that matches the contents of this User object

Throws:

ValidationException - thrown if the provided User is not in a proper condition for persisting.

PersistenceException - thrown if an error occurs in the element writing process.

persistList

public org.w3c.dom.Element persistList(BbList list,
                                       org.w3c.dom.Document doc)
                                throws ValidationException,
                                       PersistenceException

Generates an Element whose children are the provided User objects persisted to XML.

Parameters:

list - the BbList of User objects we should persist.

doc - the Document we should use to create the Element with. No assumptions should be made concerning the state of this Document -- it should only be used for Element creation.

Returns:

an Element that is the root of a list of User object XML

Throws:

ValidationException - thrown if one of the provided User objects is not in a proper condition for persisting.

PersistenceException - thrown if an error occurs in the element writing process.