|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
public interface PM
The persistence manager
(or PM
for short) is responsible for reading objects from the
database or storing them into the database.
Method Summary | |
---|---|
java.lang.Object |
create()
Creates a new, empty element. |
void |
delete(Element element)
Deletes the given document from the database. |
JMManager |
getManager()
Returns the manager being queried for configuration details. |
void |
init(JMManager pManager)
Initializes the PM. |
void |
insert(Element element)
Inserts the given document into the database. |
void |
select(Observer pObserver,
java.lang.String pQuery)
Reads documents matching the given query. |
void |
select(Observer pObserver,
java.lang.String pQuery,
PMParams pPlaceHolderArgs)
Reads documents matching the given query. |
java.util.Iterator |
select(java.lang.String pQuery)
Returns an iterator to all documents matching the given query. |
java.util.Iterator |
select(java.lang.String pQuery,
PMParams pPlaceHolderArgs)
Returns an iterator to all documents matching the given query. |
void |
update(Element element)
Updates the given document in the database. |
Method Detail |
---|
void init(JMManager pManager) throws JAXBException
Initializes the PM. Called from the
JAXBContextImpl
upon initialization.
pManager
- The manager being queried for configuration details.
JAXBException
JMManager getManager()
Returns the manager being queried for configuration details.
void select(Observer pObserver, java.lang.String pQuery) throws JAXBException
Reads documents matching the given query. For any document matching, the Observer's notify method is executed with the matching document as an argument.
pObserver
- This Observer is notified for any matching document.
The document is added as an argument.pQuery
- The query to perform.
JAXBException
void select(Observer pObserver, java.lang.String pQuery, PMParams pPlaceHolderArgs) throws JAXBException
Reads documents matching the given query. For any document matching, the Observer's notify method is executed with the matching document as an argument.
The query may contain placeholders. If it does, you have
to supply an instance of PMParams
with the placeholder
values. Example:
manager.select("Name = ? and Id = ?", new PMParams().addString("Someone").addInt(4));
pObserver
- This Observer is notified for any matching document.
The document is added as an argument.pQuery
- The query to perform. May contain placeholders.pPlaceHolderArgs
- An array of objects or null, if the
query doesn't contain any placeholders.
JAXBException
java.util.Iterator select(java.lang.String pQuery) throws JAXBException
Returns an iterator to all documents matching the given query.
pQuery
- The query to perform.
JAXBException
java.util.Iterator select(java.lang.String pQuery, PMParams pPlaceHolderArgs) throws JAXBException
Returns an iterator to all documents matching the given query.
The query may contain placeholders. If it does, you have
to supply an instance of PMParams
with the placeholder
values. Example:
manager.select("Name = ? and Id = ?", new PMParams().addString("Someone").addInt(4));
pQuery
- The query to perform. May contain placeholders.pPlaceHolderArgs
- An array of objects or null, if the
query doesn't contain any placeholders.
JAXBException
void insert(Element element) throws JAXBException
Inserts the given document into the database.
JAXBException
void update(Element element) throws JAXBException
Updates the given document in the database.
JAXBException
void delete(Element element) throws JAXBException
Deletes the given document from the database.
JAXBException
java.lang.Object create() throws JAXBException
Creates a new, empty element.
JAXBException
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |