Package org.apache.directory.api.ldap.extras.controls.ad

Interface AdDirSyncResponse

All Superinterfaces:

Control

All Known Implementing Classes:

AdDirSyncResponseImpl

public interface AdDirSyncResponse
extends Control

The DirSync response control, as described in http://tools.ietf.org/html/draft-armijo-ldap-dirsync-00. Here is the ASN/1 description of the SearchRequest control :

 Repl    Control ::= SEQUENCE {
     controlType             1.2.840.113556.1.4.841
     controlValue            replControlValue
     criticality             TRUE
 }
 

the control value is :

 realReplControlValue ::= SEQUENCE {
     flag                  integer
     maxReturnLength       integer
     cookie                OCTET STRING
 }
 

Author:

Apache Directory Project

Field Summary

Fields

Modifier and Type	Field	Description
static String	OID	This control OID

Method Summary

Modifier and Type	Method	Description
void	addFlag(AdDirSyncResponseFlag flag)
byte[]	getCookie()
Set<AdDirSyncResponseFlag>	getFlags()
int	getMaxReturnLength()
void	removeFlag(AdDirSyncResponseFlag flag)
void	setCookie(byte[] cookie)
void	setFlags(Set<AdDirSyncResponseFlag> flags)
void	setMaxReturnLength(int maxReturnLength)

Methods inherited from interface org.apache.directory.api.ldap.model.message.Control

getOid, isCritical, setCritical

Field Detail

OID

static final String OID

This control OID

See Also:

Constant Field Values

Method Detail

getMaxReturnLength

int getMaxReturnLength()

Returns:

The maximum length of attributes to be returned

setMaxReturnLength

void setMaxReturnLength(int maxReturnLength)

Parameters:

maxReturnLength - The maximum length of attributes to be returned

getCookie

byte[] getCookie()

Returns:

The cookie used while processing the successive DirSync operations

setCookie

void setCookie(byte[] cookie)

Parameters:

cookie - The cookie to send to the server. It's the value found in the response control. Should be null for the first control.

getFlags

Set<AdDirSyncResponseFlag> getFlags()

Returns:

The flags returned by the server. Zero or more of :

• LDAP_DIRSYNC_OBJECT_SECURITY (0x0001)
• LDAP_DIRSYNC_ANCESTORS_FIRST_ORDER (0x0800)
• LDAP_DIRSYNC_PUBLIC_DATA_ONLY (0x2000)(
• LDAP_DIRSYNC_INCREMENTAL_VALUES (0x7FFFFFFF)

setFlags

void setFlags(Set<AdDirSyncResponseFlag> flags)

Parameters:

flags - The flags to be set. See EnumSet for how to generate EnumSets.

addFlag

void addFlag(AdDirSyncResponseFlag flag)

Parameters:

flag - The flag to be added to the current collection of flags.

removeFlag

void removeFlag(AdDirSyncResponseFlag flag)

Parameters:

flag - The flag to be removed from the current collection of flags.