com.novell.nds.dirxml.ldap

Class DeleteCacheEntriesRequest

java.lang.Object

com.novell.ldap.LDAPExtendedOperation

com.novell.nds.dirxml.ldap.DeleteCacheEntriesRequest

All Implemented Interfaces:

java.io.Externalizable, java.io.Serializable, java.lang.Cloneable, javax.naming.ldap.ExtendedRequest

public class DeleteCacheEntriesRequest
extends com.novell.ldap.LDAPExtendedOperation
implements javax.naming.ldap.ExtendedRequest

Delete event records from the cache of a DirXML-Driver object on a server.

To use this class with the Novell Java LDAP SDK create an instance and call LDAPConnection.extendedOperation with the instance as the LDAPExtendedOperation parameter.

To use this class with Java LDAP JNDI create an instance and call LdapContext.extendedOperation with the instance as the ExtendedRequest parameter.

Rights needed:

Write access to the DirXML-AccessManage attribute on the target DirXML-Driver object.

OID:

2.16.840.1.113719.1.14.100.41

Request data:

 ASN1OctetString     UTF-encoded DN of DirXML-Driver object
 ASN1Integer         starting position token (0, or value from a previous ViewCacheEntriesRequest operation)
 ASN1Integer         count of records to delete (1 to 0xffffffff)
 ASN1OctetString     optional event ID of starting record
 ASN1Integer         (Optional)Type of Cache(DxConst.TYPE_NORMAL_CACHE or DxConst.TYPE_PRIORITY_CACHE)
 

Notes:

The position token must be either zero, or a value returned from a ViewCacheEntriesRequest operation. The position token represents the starting position in the cache of the first event to delete.

The driver must not be disabled, and driver must not be running.

Cache type is an optional parameter for normal cache. To delete the entries from priority cache it should be set to DxConst.TYPE_PRIORITY_CACHE.

See Also:

ViewCacheEntriesRequest, ViewCacheEntriesResponse, LDAPConnection.extendedOperation(com.novell.ldap.LDAPExtendedOperation), DxConst.TYPE_NORMAL_CACHE, DxConst.TYPE_PRIORITY_CACHE, Serialized Form

Constructor Summary

Constructors

Constructor and Description
DeleteCacheEntriesRequest(java.lang.String driverDN, int position, int count, java.lang.String eventID) Construct an LDAP extended operation to delete entries from a DirXML driver's cache.
DeleteCacheEntriesRequest(java.lang.String driverDN, int position, int count, java.lang.String eventID, int cacheType) Construct an LDAP extended operation to delete entries from a DirXML driver's cache based on the cache type.

Method Summary

Modifier and Type	Method and Description
javax.naming.ldap.ExtendedResponse	createExtendedResponse(java.lang.String id, byte[] berValue, int offset, int length) Create the ExtendedResponse-implementing object that corresponds to this request.
byte[]	getEncodedValue() Return the LBER-encoded data for this request.

Methods inherited from class com.novell.ldap.LDAPExtendedOperation

clone, getID, getValue, readDSML, readExternal, setID, setValue, toString, writeDSML, writeExternal

Methods inherited from class java.lang.Object

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

Methods inherited from interface javax.naming.ldap.ExtendedRequest

createExtendedResponse, getEncodedValue, getID

Constructor Detail

DeleteCacheEntriesRequest

public DeleteCacheEntriesRequest(java.lang.String driverDN,
                                 int position,
                                 int count,
                                 java.lang.String eventID)
                          throws com.novell.ldap.LDAPException

Construct an LDAP extended operation to delete entries from a DirXML driver's cache.

Parameters:

driverDN - the DN of the DirXML-Driver object

position - starting position token (0, or result from a previous request)

count - maximum count of events to delete (1 to 0xffffffff, not range checked)

eventID - event ID of starting record (may be null or empty)

Throws:

com.novell.ldap.LDAPException

DeleteCacheEntriesRequest

public DeleteCacheEntriesRequest(java.lang.String driverDN,
                                 int position,
                                 int count,
                                 java.lang.String eventID,
                                 int cacheType)
                          throws com.novell.ldap.LDAPException

Construct an LDAP extended operation to delete entries from a DirXML driver's cache based on the cache type.

Parameters:

driverDN - the DN of the DirXML-Driver object

position - starting position token (0, or result from a previous request)

count - maximum count of events to delete (1 to 0xffffffff, not range checked)

eventID - event ID of starting record (may be null or empty)

cacheType - Cache type value (DxConst.TYPE_NORMAL_CACHE, DxConst.TYPE_PRIORITY_CACHE)

Throws:

com.novell.ldap.LDAPException

See Also:

DxConst.TYPE_NORMAL_CACHE, DxConst.TYPE_PRIORITY_CACHE

Method Detail

getEncodedValue

public byte[] getEncodedValue()

Return the LBER-encoded data for this request. This is an implementation method for the JNDI ExtendedRequest interface.

Specified by:

getEncodedValue in interface javax.naming.ldap.ExtendedRequest

Returns:

LBER-encoded data or null, if there is no request data.

createExtendedResponse

public javax.naming.ldap.ExtendedResponse createExtendedResponse(java.lang.String id,
                                                                 byte[] berValue,
                                                                 int offset,
                                                                 int length)
                                                          throws javax.naming.NamingException

Create the ExtendedResponse-implementing object that corresponds to this request. This is an implementation method for the JNDI ExtendedRequest interface.

Specified by:

createExtendedResponse in interface javax.naming.ldap.ExtendedRequest

Parameters:

id - (ignored)

berValue - contains LBER-encoded response data

offset - offset into berValue

length - length (in bytes) of reponse data

Throws:

javax.naming.NamingException