org.apache.directory.server.xdbm

Interface Store

All Known Implementing Classes:

AbstractBTreePartition, AbstractLdifPartition, AvlPartition, JdbmPartition, LdifPartition, MavibotPartition, ReadOnlyConfigurationPartition, SingleFileLdifPartition

public interface Store

Represents an entry store based on the Table, Index, and MasterTable database structure.

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String[]	SYS_INDEX_OID_ARRAY
static java.util.Set<java.lang.String>	SYS_INDEX_OIDS

Method Summary

Modifier and Type	Method and Description
void	addIndex(Index<?,java.lang.String> index) Adds a (system or user) index to the list of index for this store.
long	count() Gets the total count of entries within this store.
org.apache.directory.api.ldap.model.entry.Entry	delete(java.lang.String id) Delete an entry from the store
org.apache.directory.api.ldap.model.entry.Entry	fetch(java.lang.String id) Get back an entry knowing its UUID
org.apache.directory.api.ldap.model.entry.Entry	fetch(java.lang.String id, org.apache.directory.api.ldap.model.name.Dn dn) Get back an entry knowing its UUID
net.sf.ehcache.Cache	getAliasCache()
Index<org.apache.directory.api.ldap.model.name.Dn,java.lang.String>	getAliasIndex()
int	getCacheSize() Gets the cache size for this store.
long	getChildCount(java.lang.String id) Gets the count of immediate children of the given entry UUID.
Index<java.lang.String,java.lang.String>	getEntryCsnIndex()
org.apache.directory.api.ldap.model.name.Dn	getEntryDn(java.lang.String id) Gets the Entry's Dn identified by the given id.
java.lang.String	getEntryId(org.apache.directory.api.ldap.model.name.Dn dn) Gets the entry's id.
Index<?,java.lang.String>	getIndex(org.apache.directory.api.ldap.model.schema.AttributeType attributeType) Get the user or system index associated with the given attributeType
MasterTable	getMasterTable() Expose the Master table
Index<java.lang.String,java.lang.String>	getObjectClassIndex()
Index<java.lang.String,java.lang.String>	getOneAliasIndex()
java.lang.String	getParentId(java.lang.String childId) Gets the UUID of an entry's parent using the child entry's UUID.
java.net.URI	getPartitionPath() Gets the partition path (working directory) for the store.
Index<java.lang.String,java.lang.String>	getPresenceIndex()
Index<ParentIdAndRdn,java.lang.String>	getRdnIndex()
java.util.concurrent.locks.ReadWriteLock	getReadWriteLock()
Index<java.lang.String,java.lang.String>	getSubAliasIndex()
Index<?,java.lang.String>	getSystemIndex(org.apache.directory.api.ldap.model.schema.AttributeType attributeType) Get the system index associated with the given name
java.util.Iterator<java.lang.String>	getSystemIndices() An iterator build on top of the System's index
Index<?,java.lang.String>	getUserIndex(org.apache.directory.api.ldap.model.schema.AttributeType attributeType) Get the user index associated with the given name
java.util.Iterator<java.lang.String>	getUserIndices() An iterator build on top of the User's index
boolean	hasIndexOn(org.apache.directory.api.ldap.model.schema.AttributeType attributeType) Tells if an index is already present in the User's or System's index list
boolean	hasSystemIndexOn(org.apache.directory.api.ldap.model.schema.AttributeType attributeType) Tells if an index is already present in the System's index list
boolean	hasUserIndexOn(org.apache.directory.api.ldap.model.schema.AttributeType attributeType) Tells if an index is already present in the User's index list
boolean	isSyncOnWrite()
org.apache.directory.api.ldap.model.entry.Entry	modify(org.apache.directory.api.ldap.model.name.Dn dn, org.apache.directory.api.ldap.model.entry.Modification... mods) Modify an entry applying the given list of modifications.
void	move(org.apache.directory.api.ldap.model.name.Dn oldDn, org.apache.directory.api.ldap.model.name.Dn newSuperior, org.apache.directory.api.ldap.model.name.Dn newDn, org.apache.directory.api.ldap.model.entry.Entry entry) Move an entry from one place to the other.
void	moveAndRename(org.apache.directory.api.ldap.model.name.Dn oldChildDn, org.apache.directory.api.ldap.model.name.Dn newParentDn, org.apache.directory.api.ldap.model.name.Rdn newRdn, org.apache.directory.api.ldap.model.entry.Entry entry, boolean deleteOldRdn)
void	rename(org.apache.directory.api.ldap.model.name.Dn dn, org.apache.directory.api.ldap.model.name.Rdn newRdn, boolean deleteOldRdn, org.apache.directory.api.ldap.model.entry.Entry entry) Changes the relative distinguished name of an entry specified by a distinguished name with the optional removal of the old Rdn attribute value from the entry.
void	setCacheSize(int cacheSize) Sets the cache size for this store.
void	setPartitionPath(java.net.URI partitionPath) Sets the partition path (working directory) for the store.
void	setSyncOnWrite(boolean isSyncOnWrite) Sets the flag telling the server to flush on disk when some modification has been done.

Field Detail

SYS_INDEX_OID_ARRAY

static final java.lang.String[] SYS_INDEX_OID_ARRAY

SYS_INDEX_OIDS

static final java.util.Set<java.lang.String> SYS_INDEX_OIDS

Method Detail

setPartitionPath

void setPartitionPath(java.net.URI partitionPath)

Sets the partition path (working directory) for the store.

Parameters:

partitionDir - the new partition path

getPartitionPath

java.net.URI getPartitionPath()

Gets the partition path (working directory) for the store.

Returns:

The current partition path (working directory) for the store

setSyncOnWrite

void setSyncOnWrite(boolean isSyncOnWrite)

Sets the flag telling the server to flush on disk when some modification has been done.

Parameters:

isSyncOnWrite - A boolean set to true if we have to flush on disk when a modification occurs

isSyncOnWrite

boolean isSyncOnWrite()

Returns:

true if we write to disk for every modification

setCacheSize

void setCacheSize(int cacheSize)

Sets the cache size for this store.

Parameters:

cacheSize - The cache size

getCacheSize

int getCacheSize()

Gets the cache size for this store.

Returns:

The cache size

addIndex

void addIndex(Index<?,java.lang.String> index)
       throws java.lang.Exception

Adds a (system or user) index to the list of index for this store. Note that the attribute id returned by Index.getAttributeId() must be the numeric OID.

Parameters:

index - The index to add

Throws:

java.lang.Exception - If the addition failed

getPresenceIndex

Index<java.lang.String,java.lang.String> getPresenceIndex()

Returns:

The Presence system index

getAliasIndex

Index<org.apache.directory.api.ldap.model.name.Dn,java.lang.String> getAliasIndex()

Returns:

The Alias system index

getOneAliasIndex

Index<java.lang.String,java.lang.String> getOneAliasIndex()

Returns:

The OneAlias system index

getSubAliasIndex

Index<java.lang.String,java.lang.String> getSubAliasIndex()

Returns:

The SubAlias system index

getRdnIndex

Index<ParentIdAndRdn,java.lang.String> getRdnIndex()

Returns:

The Rdn system index

getObjectClassIndex

Index<java.lang.String,java.lang.String> getObjectClassIndex()

Returns:

The ObjectClass system index

getEntryCsnIndex

Index<java.lang.String,java.lang.String> getEntryCsnIndex()

Returns:

The EntryCSN system index

getUserIndices

java.util.Iterator<java.lang.String> getUserIndices()

An iterator build on top of the User's index

getSystemIndices

java.util.Iterator<java.lang.String> getSystemIndices()

An iterator build on top of the System's index

hasIndexOn

boolean hasIndexOn(org.apache.directory.api.ldap.model.schema.AttributeType attributeType)
            throws java.lang.Exception

Tells if an index is already present in the User's or System's index list

Parameters:

id - The index we are looking for

Returns:

true if the index is already present in the User's or System's index list

Throws:

java.lang.Exception - If something went wrong

hasUserIndexOn

boolean hasUserIndexOn(org.apache.directory.api.ldap.model.schema.AttributeType attributeType)
                throws java.lang.Exception

Tells if an index is already present in the User's index list

Parameters:

attributeType - The attributeType index we are looking for

Returns:

true if the index is already present in the User's index list

Throws:

java.lang.Exception - If something went wrong

hasSystemIndexOn

boolean hasSystemIndexOn(org.apache.directory.api.ldap.model.schema.AttributeType attributeType)
                  throws org.apache.directory.api.ldap.model.exception.LdapException

Tells if an index is already present in the System's index list

Parameters:

attributeType - The index we are looking for

Returns:

true if the index is already present in the System's index list

Throws:

java.lang.Exception - If something went wrong

org.apache.directory.api.ldap.model.exception.LdapException

getIndex

Index<?,java.lang.String> getIndex(org.apache.directory.api.ldap.model.schema.AttributeType attributeType)
                            throws IndexNotFoundException

Get the user or system index associated with the given attributeType

Parameters:

attributeType - The index attributeType we are looking for

Returns:

The associated user or system index

Throws:

IndexNotFoundException - If the index does not exist

getUserIndex

Index<?,java.lang.String> getUserIndex(org.apache.directory.api.ldap.model.schema.AttributeType attributeType)
                                throws IndexNotFoundException

Get the user index associated with the given name

Parameters:

attributeType - The index name we are looking for

Returns:

The associated user index

Throws:

IndexNotFoundException - If the index does not exist

getSystemIndex

Index<?,java.lang.String> getSystemIndex(org.apache.directory.api.ldap.model.schema.AttributeType attributeType)
                                  throws IndexNotFoundException

Get the system index associated with the given name

Parameters:

attributeType - The index name we are looking for

Returns:

The associated system index

Throws:

IndexNotFoundException - If the index does not exist

getEntryId

java.lang.String getEntryId(org.apache.directory.api.ldap.model.name.Dn dn)
                     throws java.lang.Exception

Gets the entry's id. Returns null if the Dn doesn't exist in this store. Note that the Dn must be normalized!

Parameters:

dn - the normalized entry Dn

Returns:

the entry's id, or null if the Dn doesn't exists

Throws:

java.lang.Exception

getEntryDn

org.apache.directory.api.ldap.model.name.Dn getEntryDn(java.lang.String id)
                                                throws java.lang.Exception

Gets the Entry's Dn identified by the given id.

Parameters:

id - the entry's id

Returns:

the entry's Dn

Throws:

java.lang.Exception

getParentId

java.lang.String getParentId(java.lang.String childId)
                      throws java.lang.Exception

Gets the UUID of an entry's parent using the child entry's UUID. Note that the suffix entry returns 0, which does not map to any entry.

Parameters:

childId - the UUID of the entry

Returns:

the id of the parent entry or zero if the suffix entry UUID is used

Throws:

java.lang.Exception - on failures to access the underlying store

count

long count()
    throws java.lang.Exception

Gets the total count of entries within this store.

Returns:

the total count of entries within this store

Throws:

java.lang.Exception - on failures to access the underlying store

delete

org.apache.directory.api.ldap.model.entry.Entry delete(java.lang.String id)
                                                throws org.apache.directory.api.ldap.model.exception.LdapException

Delete an entry from the store

Parameters:

id - The Entry UUID we want to delete

Returns:

the deleted entry if found

Throws:

java.lang.Exception - If the deletion failed for any reason

org.apache.directory.api.ldap.model.exception.LdapException

fetch

org.apache.directory.api.ldap.model.entry.Entry fetch(java.lang.String id)
                                               throws org.apache.directory.api.ldap.model.exception.LdapException

Get back an entry knowing its UUID

Parameters:

id - The Entry UUID we want to get back

Returns:

The found Entry, or null if not found

Throws:

java.lang.Exception - If the lookup failed for any reason (except a not found entry)

org.apache.directory.api.ldap.model.exception.LdapException

fetch

org.apache.directory.api.ldap.model.entry.Entry fetch(java.lang.String id,
                                                      org.apache.directory.api.ldap.model.name.Dn dn)
                                               throws org.apache.directory.api.ldap.model.exception.LdapException

Get back an entry knowing its UUID

Parameters:

id - The Entry UUID we want to get back

dn - The entry DN when we have it

Returns:

The found Entry, or null if not found

Throws:

java.lang.Exception - If the lookup failed for any reason (except a not found entry)

org.apache.directory.api.ldap.model.exception.LdapException

getChildCount

long getChildCount(java.lang.String id)
            throws java.lang.Exception

Gets the count of immediate children of the given entry UUID.

Parameters:

id - the entry UUID

Returns:

the child count

Throws:

java.lang.Exception - on failures to access the underlying store

modify

org.apache.directory.api.ldap.model.entry.Entry modify(org.apache.directory.api.ldap.model.name.Dn dn,
                                                       org.apache.directory.api.ldap.model.entry.Modification... mods)
                                                throws java.lang.Exception

Modify an entry applying the given list of modifications.

Parameters:

dn - The Entry's Dn

mods - The list of modifications

Returns:

The modified entry

Throws:

java.lang.Exception - If the modification failed

rename

void rename(org.apache.directory.api.ldap.model.name.Dn dn,
            org.apache.directory.api.ldap.model.name.Rdn newRdn,
            boolean deleteOldRdn,
            org.apache.directory.api.ldap.model.entry.Entry entry)
     throws java.lang.Exception

Changes the relative distinguished name of an entry specified by a distinguished name with the optional removal of the old Rdn attribute value from the entry. Name changes propagate down as dn changes to the descendants of the entry where the Rdn changed. An Rdn change operation does not change parent child relationships. It merely propagates a name change at a point in the DIT where the Rdn is changed. The change propagates down the subtree rooted at the distinguished name specified.

Parameters:

dn - the normalized distinguished name of the entry to alter

newRdn - the new Rdn to set

deleteOldRdn - whether or not to remove the old Rdn attr/val

entry - the modified entry

Throws:

java.lang.Exception - if there are any errors propagating the name changes

moveAndRename

void moveAndRename(org.apache.directory.api.ldap.model.name.Dn oldChildDn,
                   org.apache.directory.api.ldap.model.name.Dn newParentDn,
                   org.apache.directory.api.ldap.model.name.Rdn newRdn,
                   org.apache.directory.api.ldap.model.entry.Entry entry,
                   boolean deleteOldRdn)
            throws java.lang.Exception

Throws:

java.lang.Exception

move

void move(org.apache.directory.api.ldap.model.name.Dn oldDn,
          org.apache.directory.api.ldap.model.name.Dn newSuperior,
          org.apache.directory.api.ldap.model.name.Dn newDn,
          org.apache.directory.api.ldap.model.entry.Entry entry)
   throws java.lang.Exception

Move an entry from one place to the other. The Rdn remains unchanged, the parent Dn changes

We have to update some of the index when moving an entry. Assuming that the target destination does not exist, the following index must be updated :

• oneLevel index
• subLevel index

If the moved entry is an alias, then we also have to update the following index :

• oneAlias index
• subAlias index

The Alias index is not updated, as the entry UUID won't change.

We have a few check we must do before moving the entry :

• The destination must not exist
• The moved entry must exist (this has already been checked)
• The moved entry must not inherit from a referral (already checked)

Parameters:

oldDn - The previous entry Dn

newSuperior - The new superior Dn

newDn - The new Dn

entry - The entry to move

Throws:

java.lang.Exception - If the move failed

getMasterTable

MasterTable getMasterTable()

Expose the Master table

Returns:

The masterTable instance

getReadWriteLock

java.util.concurrent.locks.ReadWriteLock getReadWriteLock()

Returns:

The ReadWrite lock used to protect the server against concurrent read and writes

getAliasCache

net.sf.ehcache.Cache getAliasCache()

Returns:

the Alias cache