org.datanucleus.store.ldap

Class LDAPPersistenceHandler

java.lang.Object

org.datanucleus.store.AbstractPersistenceHandler

org.datanucleus.store.ldap.LDAPPersistenceHandler

All Implemented Interfaces:

org.datanucleus.store.StorePersistenceHandler

public class LDAPPersistenceHandler
extends org.datanucleus.store.AbstractPersistenceHandler

Persistence handler for persisting to LDAP datastores. Doesn't support optimistic version checking. Doesn't support datastore identity.

Nested Class Summary

Nested classes/interfaces inherited from interface org.datanucleus.store.StorePersistenceHandler

org.datanucleus.store.StorePersistenceHandler.PersistenceBatchType

Field Summary

Fields inherited from class org.datanucleus.store.AbstractPersistenceHandler

storeMgr

Constructor Summary

Constructors

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

Method Summary

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 LDAP 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 LDAP datastore.
void	locateObject(org.datanucleus.state.ObjectProvider op) Locates the object managed by the passed ObjectProvider into the LDAP datastore.
void	updateObject(org.datanucleus.state.ObjectProvider op, int[] fieldNumbers) Updates the specified fields of the object managed by the passed ObjectProvider in the LDAP datastore.

Methods inherited from class org.datanucleus.store.AbstractPersistenceHandler

assertReadOnlyForUpdateOfObject, findObjectForUnique

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.datanucleus.store.StorePersistenceHandler

batchEnd, batchStart, deleteObjects, fetchObjects, findObjects, insertObjects, locateObjects

Constructor Detail

LDAPPersistenceHandler

public LDAPPersistenceHandler(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 LDAP 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 LDAP 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 LDAP 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 - ExecutionContext in use

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 LDAP datastore.

Parameters:

op - ObjectProvider

Throws:

org.datanucleus.exceptions.NucleusObjectNotFoundException - if the object cannot be located