| org.objectweb.speedo.pm.api.POManagerItf
All known Subclasses: org.objectweb.speedo.pm.lib.AbstractPOManager,
| POManagerItf | | public interface POManagerItf extends Synchronization(Code) | | defines a manager of persistent instance.
A POManagerItf is a javax.transaction.Synchronization for the JTA
integration. This permits to support the container transaction demarcation.
On the beforeCompletion method the perseus transaction is prepared.
A po manager used a TransactionalPersistenceManager for managing the
concurrency, the loading and the caching aspects.
See Also: org.objectweb.speedo.pm.api.POManagerFactoryItf
See Also: org.objectweb.speedo.pm.api.POManagerSwitchItf
See Also: org.objectweb.perseus.persistence.api.TransactionalPersistenceManager
author:
S.Chassande-Barrioz |
| Method Summary | |
| void | addUse()
Signal to the persistence maneger that it is used. | | void | closePOManager()
| | PName | decodeIdentifier(Class aClass, Object s)
| | Object | getConnectionSpec()
| | Object | getEncodedPName(PersistentObjectItf po)
Encodes a PName into a serializable representation which could be decoded
later. | | POManagerFactoryItf | getPOManagerFactory()
| | Semaphore | getSemaphore()
Retrieves the semaphore object permiting the multithreading mode. | | TransactionItf | getSpeedoTransaction()
| | TransactionalPersistenceManager | getTransactionalPersistenceManager()
Retrieves the TransactionalPersistenceManager used by this POManagerItf. | | boolean | isPOMClosed()
| | void | open(Object connectionSpec)
Opens the persistent manager. | | Object | speedoAttachCopy(Object detached, Map map)
| | void | speedoDeletePersistent(Object o)
Delete persistent a PersistentObjectItf. | | void | speedoDeletePersistent(Object oid, Class pc)
| | void | speedoDeletePersistentAll(Object[] o)
| | Object | speedoDetachCopy(PersistentObjectItf sp, Map map, Collection fgHints)
| | FetchPlanItf | speedoGetFetchPlan()
| | Object | speedoGetObject(PName pn, boolean validate)
| | Object | speedoMakePersistent(PersistentObjectItf sp, Map map)
Make persistent a PersistentObjectItf. | | void | speedoRefresh(PersistentObjectItf sp, Map map, Collection fgHints)
| | void | speedoRetrieve(PersistentObjectItf sp, Map map, Collection fgHints)
|
| addUse | | void addUse()(Code) | | Signal to the persistence maneger that it is used. A persistence managed
can be used by several thread. In this case each thread have done a
PersistenceManagerFactory.getPersistentceManager() to obtain a po
manager instance. The threads will do a close() operation, but only the
last has to be taken in account. This method permits to knwon how many
users uses the current pomanager.
|
| closePOManager | | void closePOManager()(Code) | | Close the POM
|
| getConnectionSpec | | Object getConnectionSpec()(Code) | | the connection information to access the data store |
| getEncodedPName | | Object getEncodedPName(PersistentObjectItf po)(Code) | | Encodes a PName into a serializable representation which could be decoded
later. The representation depends on the PName structure.
Parameters:
po - is a persistent object |
| getSemaphore | | Semaphore getSemaphore()(Code) | | Retrieves the semaphore object permiting the multithreading mode.
|
| getSpeedoTransaction | | TransactionItf getSpeedoTransaction()(Code) | | the unique transaction associate to the POM. |
| getTransactionalPersistenceManager | | TransactionalPersistenceManager getTransactionalPersistenceManager()(Code) | | Retrieves the TransactionalPersistenceManager used by this POManagerItf.
|
| isPOMClosed | | boolean isPOMClosed()(Code) | | true if the POM is closed, otherwise false. |
| open | | void open(Object connectionSpec)(Code) | | Opens the persistent manager. This operation is the opposite of the
javax.jdo.PersistenceManager.close() method. It prepares a POManagerItf
to be used. During the preparation, the optimistic and multithread modes
are initialized.
Parameters:
connectionSpec - is the information to access to the data store(user, password, ...) |
| speedoDeletePersistent | | void speedoDeletePersistent(Object o)(Code) | | Delete persistent a PersistentObjectItf. This method does the same thing than the
PersistenceManager.deletePersistent(Object) method except the call to the
bind to the POManagerItf to the current thread.
Parameters:
o - is the instance to make persistent. |
| speedoDeletePersistentAll | | void speedoDeletePersistentAll(Object[] o)(Code) | | |
| speedoGetObject | | Object speedoGetObject(PName pn, boolean validate)(Code) | | |
| speedoMakePersistent | | Object speedoMakePersistent(PersistentObjectItf sp, Map map)(Code) | | Make persistent a PersistentObjectItf. This method does the same thing than the
PersistenceManager.makePersistent(Object) method except the call to the
bind to the POManagerItf to the current thread.
Parameters:
sp - is the instance to make persistent.
Parameters:
map - is the context of the attachment process if any. If no attachment, it is null. TODO |
|
|