org.ldaptive.ad.handler

Class RangeEntryHandler

java.lang.Object

org.ldaptive.handler.AbstractSearchEntryHandler

org.ldaptive.ad.handler.RangeEntryHandler

All Implemented Interfaces:

Handler<SearchRequest,SearchEntry>, SearchEntryHandler

public class RangeEntryHandler
extends AbstractSearchEntryHandler

Rewrites attributes returned from Active Directory to include all values by performing additional searches. This behavior is based on the expired RFC "Incremental Retrieval of Multi-valued Properties" http://www.ietf.org/proceedings/53/I-D/draft-kashi-incremental-00.txt.

For example, when the membership of a group exceeds 1500, requests for the member attribute will likely return an attribute with name "member;Range=0-1499" and 1500 values. For a group with just over 3000 members, subsequent searches will request "member;Range=1500-2999" and then "member;Range=3000-4499". When the returned attribute is of the form "member;Range=3000-*", all values have been retrieved.

Field Summary

Fields

Modifier and Type	Field and Description
private static java.lang.String	END_OF_RANGE The character indicating that the end of the range has been reached.
private static int	HASH_CODE_SEED hash code seed.
private static java.lang.String	RANGE_FORMAT The format used to calculate attribute IDs for subsequent searches.
private static java.util.regex.Pattern	RANGE_PATTERN The pattern matching the range attribute ID.
private static java.lang.String	RANGE_PATTERN_STRING The expression matching the range attribute ID ";range=-".

Fields inherited from class org.ldaptive.handler.AbstractSearchEntryHandler

logger

Constructor Summary

Constructors

Constructor and Description
RangeEntryHandler()

Method Summary

Modifier and Type	Method and Description
protected void	handleAttributes(Connection conn, SearchRequest request, SearchEntry entry) Handle the attributes of a search entry.
int	hashCode()

Methods inherited from class org.ldaptive.handler.AbstractSearchEntryHandler

equals, handle, handleAttribute, handleAttributeName, handleAttributeValue, handleAttributeValue, handleDn, initializeRequest

Methods inherited from class java.lang.Object

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

Field Detail

HASH_CODE_SEED

private static final int HASH_CODE_SEED

hash code seed.

See Also:

Constant Field Values

END_OF_RANGE

private static final java.lang.String END_OF_RANGE

The character indicating that the end of the range has been reached.

See Also:

Constant Field Values

RANGE_FORMAT

private static final java.lang.String RANGE_FORMAT

The format used to calculate attribute IDs for subsequent searches.

See Also:

Constant Field Values

RANGE_PATTERN_STRING

private static final java.lang.String RANGE_PATTERN_STRING

The expression matching the range attribute ID ";range=-".

See Also:

Constant Field Values

RANGE_PATTERN

private static final java.util.regex.Pattern RANGE_PATTERN

The pattern matching the range attribute ID.

Constructor Detail

RangeEntryHandler

public RangeEntryHandler()

Method Detail

handleAttributes

protected void handleAttributes(Connection conn,
                                SearchRequest request,
                                SearchEntry entry)
                         throws LdapException

Description copied from class: AbstractSearchEntryHandler

Handle the attributes of a search entry.

Overrides:

handleAttributes in class AbstractSearchEntryHandler

Parameters:

conn - the search was performed on

request - used to find the search entry

entry - search entry to extract the attributes from

Throws:

LdapException - if the LDAP returns an error

hashCode

public int hashCode()

Specified by:

hashCode in class AbstractSearchEntryHandler