org.apache.directory.server.core.subtree
Class SubentryInterceptor

java.lang.Object
  org.apache.directory.server.core.interceptor.BaseInterceptor
      org.apache.directory.server.core.subtree.SubentryInterceptor

All Implemented Interfaces:

Interceptor

public class SubentryInterceptor
extends BaseInterceptor

The Subentry interceptor service which is responsible for filtering out subentries on search operations and injecting operational attributes

Version:

$Rev: 928945 $

Author:

Apache Directory Project

XBean

Nested Class Summary

class	SubentryInterceptor.HideEntriesFilter SearchResultFilter used to filter out normal entries but shows subentries based on objectClass values.
class	SubentryInterceptor.HideSubentriesFilter SearchResultFilter used to filter out subentries based on objectClass values.

Field Summary

static java.lang.String	AC_AREA
static java.lang.String	AC_INNERAREA
static java.lang.String	COLLECTIVE_AREA
static java.lang.String	COLLECTIVE_INNERAREA
static java.lang.String	SCHEMA_AREA
static java.lang.String[]	SUBENTRY_OPATTRS
static java.lang.String	TRIGGER_AREA
static java.lang.String	TRIGGER_INNERAREA

Constructor Summary

SubentryInterceptor()

Method Summary

void	add(NextInterceptor next, AddOperationContext addContext)
void	delete(NextInterceptor next, DeleteOperationContext opContext)
java.util.List<org.apache.directory.shared.ldap.entry.Modification>	getOperationalModsForAdd(org.apache.directory.shared.ldap.entry.ServerEntry entry, org.apache.directory.shared.ldap.entry.ServerEntry operational) Calculates the subentry operational attributes to add or replace from a candidate entry selected by a subtree specification.
org.apache.directory.shared.ldap.entry.ServerEntry	getSubentryAttributes(org.apache.directory.shared.ldap.name.DN dn, org.apache.directory.shared.ldap.entry.ServerEntry entryAttrs) Evaluates the set of subentry subtrees upon an entry and returns the operational subentry attributes that will be added to the entry if added at the dn specified.
void	init(DirectoryService directoryService)
EntryFilteringCursor	list(NextInterceptor nextInterceptor, ListOperationContext opContext)
void	modify(NextInterceptor next, ModifyOperationContext opContext)
void	move(NextInterceptor next, MoveOperationContext opContext)
void	moveAndRename(NextInterceptor next, MoveAndRenameOperationContext opContext)
void	rename(NextInterceptor next, RenameOperationContext opContext)
EntryFilteringCursor	search(NextInterceptor nextInterceptor, SearchOperationContext opContext)

Methods inherited from class org.apache.directory.server.core.interceptor.BaseInterceptor

addContextPartition, bind, compare, destroy, getContext, getMatchedName, getName, getPrincipal, getRootDSE, getSuffix, hasEntry, listSuffixes, lookup, removeContextPartition, unbind

Methods inherited from class java.lang.Object

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

Field Detail

AC_AREA

public static final java.lang.String AC_AREA

See Also:

Constant Field Values

AC_INNERAREA

public static final java.lang.String AC_INNERAREA

See Also:

Constant Field Values

SCHEMA_AREA

public static final java.lang.String SCHEMA_AREA

See Also:

Constant Field Values

COLLECTIVE_AREA

public static final java.lang.String COLLECTIVE_AREA

See Also:

Constant Field Values

COLLECTIVE_INNERAREA

public static final java.lang.String COLLECTIVE_INNERAREA

See Also:

Constant Field Values

TRIGGER_AREA

public static final java.lang.String TRIGGER_AREA

See Also:

Constant Field Values

TRIGGER_INNERAREA

public static final java.lang.String TRIGGER_INNERAREA

See Also:

Constant Field Values

SUBENTRY_OPATTRS

public static final java.lang.String[] SUBENTRY_OPATTRS

Constructor Detail

SubentryInterceptor

public SubentryInterceptor()

Method Detail

init

public void init(DirectoryService directoryService)
          throws java.lang.Exception

Specified by:

init in interface Interceptor

Overrides:

init in class BaseInterceptor

Throws:

java.lang.Exception

list

public EntryFilteringCursor list(NextInterceptor nextInterceptor,
                                 ListOperationContext opContext)
                          throws java.lang.Exception

Specified by:

list in interface Interceptor

Overrides:

list in class BaseInterceptor

Throws:

java.lang.Exception

search

public EntryFilteringCursor search(NextInterceptor nextInterceptor,
                                   SearchOperationContext opContext)
                            throws java.lang.Exception

Specified by:

search in interface Interceptor

Overrides:

search in class BaseInterceptor

Throws:

java.lang.Exception

getSubentryAttributes

public org.apache.directory.shared.ldap.entry.ServerEntry getSubentryAttributes(org.apache.directory.shared.ldap.name.DN dn,
                                                                                org.apache.directory.shared.ldap.entry.ServerEntry entryAttrs)
                                                                         throws java.lang.Exception

Evaluates the set of subentry subtrees upon an entry and returns the operational subentry attributes that will be added to the entry if added at the dn specified.

Parameters:

dn - the normalized distinguished name of the entry

entryAttrs - the entry attributes are generated for

Returns:

the set of subentry op attrs for an entry

Throws:

java.lang.Exception - if there are problems accessing entry information

add

public void add(NextInterceptor next,
                AddOperationContext addContext)
         throws java.lang.Exception

Specified by:

add in interface Interceptor

Overrides:

add in class BaseInterceptor

Throws:

java.lang.Exception

delete

public void delete(NextInterceptor next,
                   DeleteOperationContext opContext)
            throws java.lang.Exception

Specified by:

delete in interface Interceptor

Overrides:

delete in class BaseInterceptor

Throws:

java.lang.Exception

rename

public void rename(NextInterceptor next,
                   RenameOperationContext opContext)
            throws java.lang.Exception

Specified by:

rename in interface Interceptor

Overrides:

rename in class BaseInterceptor

Throws:

java.lang.Exception

moveAndRename

public void moveAndRename(NextInterceptor next,
                          MoveAndRenameOperationContext opContext)
                   throws java.lang.Exception

Specified by:

moveAndRename in interface Interceptor

Overrides:

moveAndRename in class BaseInterceptor

Throws:

java.lang.Exception

move

public void move(NextInterceptor next,
                 MoveOperationContext opContext)
          throws java.lang.Exception

Specified by:

move in interface Interceptor

Overrides:

move in class BaseInterceptor

Throws:

java.lang.Exception

modify

public void modify(NextInterceptor next,
                   ModifyOperationContext opContext)
            throws java.lang.Exception

Specified by:

modify in interface Interceptor

Overrides:

modify in class BaseInterceptor

Throws:

java.lang.Exception

getOperationalModsForAdd

public java.util.List<org.apache.directory.shared.ldap.entry.Modification> getOperationalModsForAdd(org.apache.directory.shared.ldap.entry.ServerEntry entry,
                                                                                                    org.apache.directory.shared.ldap.entry.ServerEntry operational)
                                                                                             throws java.lang.Exception

Calculates the subentry operational attributes to add or replace from a candidate entry selected by a subtree specification. When a subentry is added or it's specification is modified some entries must have new operational attributes added to it to point back to the associated subentry. To do so a modify operation must be performed on entries selected by the subtree specification. This method calculates the modify operation to be performed on the entry.

Parameters:

entry - the entry being modified

operational - the set of operational attributes supported by the AP of the subentry

Returns:

the set of modifications needed to update the entry

Throws:

java.lang.Exception - if there are probelms accessing modification items