org.apache.directory.server.core.api.changelog

Interface ChangeLogStore

All Known Subinterfaces:

SearchableChangeLogStore, TaggableChangeLogStore, TaggableSearchableChangeLogStore

All Known Implementing Classes:

MemoryChangeLogStore

public interface ChangeLogStore

A store for change events on the directory which exposes methods for managing, querying and in general performing legal operations on the log.

Author:

Apache Directory Project

Method Summary

Modifier and Type	Method and Description
void	destroy() Destroy the logs.
org.apache.directory.api.ldap.model.cursor.Cursor<ChangeLogEvent>	find() Gets a Cursor over all the ChangeLogEvents within the system since revision 0.
org.apache.directory.api.ldap.model.cursor.Cursor<ChangeLogEvent>	find(long startRevision, long endRevision) Finds the ChangeLogEvents that occurred between a revision range inclusive.
org.apache.directory.api.ldap.model.cursor.Cursor<ChangeLogEvent>	findAfter(long revision) Finds the ChangeLogEvents that occurred after a revision exclusive.
org.apache.directory.api.ldap.model.cursor.Cursor<ChangeLogEvent>	findBefore(long revision) Gets a Cursor over the ChangeLogEvents that occurred before a revision exclusive.
long	getCurrentRevision() Gets the current revision of the server (a.k.a. the HEAD revision).
void	init(DirectoryService service) Initialize the store.
ChangeLogEvent	log(LdapPrincipal principal, org.apache.directory.api.ldap.model.ldif.LdifEntry forward, org.apache.directory.api.ldap.model.ldif.LdifEntry reverse) Records a change as a forward LDIF, a reverse change to revert the change and the authorized principal triggering the revertable change event.
ChangeLogEvent	log(LdapPrincipal principal, org.apache.directory.api.ldap.model.ldif.LdifEntry forward, List<org.apache.directory.api.ldap.model.ldif.LdifEntry> reverses) Records a change as a forward LDIF, some reverse changes to revert the change and the authorized principal triggering the revertable change event.
ChangeLogEvent	lookup(long revision) Looks up the ChangeLogEvent for a revision.
void	sync() Write the changes on disk

Method Detail

init

void init(DirectoryService service)
   throws org.apache.directory.api.ldap.model.exception.LdapException

Initialize the store.

Parameters:

service - The associated DirectoryService

Throws:

org.apache.directory.api.ldap.model.exception.LdapException - If the initialization failed

sync

void sync()
   throws org.apache.directory.api.ldap.model.exception.LdapException

Write the changes on disk

Throws:

org.apache.directory.api.ldap.model.exception.LdapException - If the write failed

destroy

void destroy()
      throws org.apache.directory.api.ldap.model.exception.LdapException

Destroy the logs.

Throws:

org.apache.directory.api.ldap.model.exception.LdapException - If we can't destroy the logs

getCurrentRevision

long getCurrentRevision()

Gets the current revision of the server (a.k.a. the HEAD revision).

Returns:

the current revision of the server

log

ChangeLogEvent log(LdapPrincipal principal,
                   org.apache.directory.api.ldap.model.ldif.LdifEntry forward,
                   org.apache.directory.api.ldap.model.ldif.LdifEntry reverse)

Records a change as a forward LDIF, a reverse change to revert the change and the authorized principal triggering the revertable change event.

Parameters:

principal - the authorized LDAP principal triggering the change

forward - LDIF of the change going to the next state

reverse - LDIF (anti-operation): the change required to revert this change

Returns:

the new revision reached after having applied the forward LDIF

log

ChangeLogEvent log(LdapPrincipal principal,
                   org.apache.directory.api.ldap.model.ldif.LdifEntry forward,
                   List<org.apache.directory.api.ldap.model.ldif.LdifEntry> reverses)

Records a change as a forward LDIF, some reverse changes to revert the change and the authorized principal triggering the revertable change event.

Parameters:

principal - the authorized LDAP principal triggering the change

forward - LDIF of the change going to the next state

reverses - LDIF (anti-operation): the changes required to revert this change

Returns:

the new revision reached after having applied the forward LDIF

lookup

ChangeLogEvent lookup(long revision)

Looks up the ChangeLogEvent for a revision.

Parameters:

revision - to get a ChangeLogEvent for

Returns:

the ChangeLogEvent associated with the revision

Throws:

IllegalArgumentException - if the revision is out of range (less than 0 and greater than the current revision)

find

org.apache.directory.api.ldap.model.cursor.Cursor<ChangeLogEvent> find()

Gets a Cursor over all the ChangeLogEvents within the system since revision 0. This method should exhibit isolation characteristics: meaning if the request is initiated at revision 100, then any subsequent log entries increasing the revision should not be seen.

Returns:

a Cursor over all the ChangeLogEvents

findBefore

org.apache.directory.api.ldap.model.cursor.Cursor<ChangeLogEvent> findBefore(long revision)

Gets a Cursor over the ChangeLogEvents that occurred before a revision exclusive.

Parameters:

revision - the revision number to get the ChangeLogEvents before

Returns:

a Cursor over the ChangeLogEvents before a revision

Throws:

IllegalArgumentException - if the revision is out of range (less than 0 and greater than the current revision)

findAfter

org.apache.directory.api.ldap.model.cursor.Cursor<ChangeLogEvent> findAfter(long revision)

Finds the ChangeLogEvents that occurred after a revision exclusive. This method should exhibit isolation characteristics: meaning if the request is initiated at revision 100 then any subsequent log entries increasing the revision should not be seen.

Parameters:

revision - the revision number to get the ChangeLogEvents after

Returns:

a Cursor of all the ChangeLogEvents after and including the revision

Throws:

IllegalArgumentException - if the revision is out of range (less than 0 and greater than the current revision)

find

org.apache.directory.api.ldap.model.cursor.Cursor<ChangeLogEvent> find(long startRevision,
                                                                       long endRevision)

Finds the ChangeLogEvents that occurred between a revision range inclusive.

Parameters:

startRevision - the revision number to start getting the ChangeLogEvents above

endRevision - the revision number to start getting the ChangeLogEvents below

Returns:

an enumeration of all the ChangeLogEvents within some revision range inclusive

Throws:

IllegalArgumentException - if the start and end revisions are out of range (less than 0 and greater than the current revision), or if startRevision > endRevision