org.datanucleus.store.xml

Class XMLPersistenceHandler

java.lang.Object

org.datanucleus.store.AbstractPersistenceHandler

org.datanucleus.store.xml.XMLPersistenceHandler

All Implemented Interfaces:

org.datanucleus.store.StorePersistenceHandler

public class XMLPersistenceHandler
extends org.datanucleus.store.AbstractPersistenceHandler

Persistence handler for persisting to XML datastores.

Field Summary

Fields inherited from class org.datanucleus.store.AbstractPersistenceHandler

storeMgr

Constructor Summary

Constructors

Constructor and Description
XMLPersistenceHandler(org.datanucleus.store.StoreManager storeMgr) Constructor.

Method Summary

Methods

Modifier and Type	Method and Description
void	close() Method to close the handler and release any resources.
void	deleteObject(org.datanucleus.state.ObjectProvider op) Deletes the object managed by the passed ObjectProvider from the XML datastore.
void	fetchObject(org.datanucleus.state.ObjectProvider op, int[] fieldNumbers) Method to retrieve the specified fields of the object managed by the ObjectProvider.
Object	findObject(org.datanucleus.ExecutionContext ec, Object id) Accessor for the object with the specified identity (if present).
void	insertObject(org.datanucleus.state.ObjectProvider op) Insert the object managed by the passed ObjectProvider into the XML datastore.
void	locateObject(org.datanucleus.state.ObjectProvider op) Locates the object managed by the passed ObjectProvider into the XML datastore.
void	updateObject(org.datanucleus.state.ObjectProvider op, int[] fieldNumbers) Updates the specified fields of the object managed by the passed ObjectProvider in the XML datastore.

Methods inherited from class org.datanucleus.store.AbstractPersistenceHandler

assertReadOnlyForUpdateOfObject, batchEnd, batchStart, deleteObjects, findObjects, insertObjects, locateObjects

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

XMLPersistenceHandler

public XMLPersistenceHandler(org.datanucleus.store.StoreManager storeMgr)

Constructor.

Parameters:

storeMgr - Manager for the datastore

Method Detail

close

public void close()

Method to close the handler and release any resources.

insertObject

public void insertObject(org.datanucleus.state.ObjectProvider op)

Insert the object managed by the passed ObjectProvider into the XML datastore.

Parameters:

op - ObjectProvider

Throws:

org.datanucleus.exceptions.NucleusDataStoreException - when an error occurs in the datastore communication

updateObject

public void updateObject(org.datanucleus.state.ObjectProvider op,
                int[] fieldNumbers)

Updates the specified fields of the object managed by the passed ObjectProvider in the XML datastore.

Parameters:

op - ObjectProvider

Throws:

org.datanucleus.exceptions.NucleusDataStoreException - when an error occurs in the datastore communication

org.datanucleus.exceptions.NucleusOptimisticException - thrown if version checking fails

deleteObject

public void deleteObject(org.datanucleus.state.ObjectProvider op)

Deletes the object managed by the passed ObjectProvider from the XML datastore.

Parameters:

op - ObjectProvider

Throws:

org.datanucleus.exceptions.NucleusDataStoreException - when an error occurs in the datastore communication

org.datanucleus.exceptions.NucleusOptimisticException - thrown if version checking fails on an optimistic transaction for this object

fetchObject

public void fetchObject(org.datanucleus.state.ObjectProvider op,
               int[] fieldNumbers)

Method to retrieve the specified fields of the object managed by the ObjectProvider.

Parameters:

op - ObjectProvider

fieldNumbers - Absolute field numbers to retrieve

Throws:

org.datanucleus.exceptions.NucleusDataStoreException - when an error occurs in the datastore communication

findObject

public Object findObject(org.datanucleus.ExecutionContext ec,
                Object id)

Accessor for the object with the specified identity (if present). Since we don't manage the memory instantiation of objects this just returns null.

Parameters:

ec - execution context

id - Identity of the object

Returns:

The object

locateObject

public void locateObject(org.datanucleus.state.ObjectProvider op)

Locates the object managed by the passed ObjectProvider into the XML datastore.

Parameters:

op - ObjectProvider

Throws:

org.datanucleus.exceptions.NucleusDataStoreException - if an error occurs in locating the object