A persistence session must be opened (by calling
PersistenceManager.openSession PersistenceManager.openSession before
performing any other persistence operation. It can be considered analagous to
a transaction in a database environment.
author: Colin MacLeod author: colin.macleod@ivata.com since: ivata masks 0.3 (2004-03-27) version: $Revision: 1.5 $ See Also:PersistenceManager
Commit any changes made in this transaction to the data store. You must
call this method after performing persistence methods - use it within a
finally block as shown in the example code.
TODO: link to demo code reference here.
throws: PersistenceException - if the session cannot be closed/committed for any reason.
Access the data connection wrapped by this persistence session. You
should think twice before using this method - not all implementations of
a persistence layer may use a database, and therefore this may not always
be appropriate.
valid database connection for the underlying data store. throws: PersistenceException - if the database connection cannot be retrieved for any reason(including lack of support by the underlying persistencelayer).
Return a system-specific (i.e. ivata masks knows nothing
about it's specific implementation) session object - this is stored when
PersistenceManager.openSession is called with an object
parameter.
system-specific session object, or null if none wasset.