com.novell.nds.dirxml.ldap
Class GetDriverGCVRequest

java.lang.Object
  com.novell.ldap.LDAPExtendedOperation
      com.novell.nds.dirxml.ldap.GetDriverGCVRequest

All Implemented Interfaces:

Externalizable, Serializable, Cloneable, ExtendedRequest

public class GetDriverGCVRequest
extends LDAPExtendedOperation
implements ExtendedRequest

Get effective GCV's given a set of gcv names for a DirXML driver 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.

If the corresponding response class has been registered then the return from LDAPConnection.extendedOperation will be an instance of the response class.

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

The return from LdapContext.extendedOperation will be an instance of the response class.

Rights needed:

Read rights to the DirXML-ConfigValues attribute on the target DirXML-Driver object.

OID:

2.16.840.1.113719.1.14.100.89

Request data:

 ASN1OctetString     UTF-encoded DN of DirXML-Driver object
 ASN1SequenceOf
       ASN1OctetString  gcvName
       ...........
 

Notes:

Returns GCV data in the form of an XML document for each valid requested gcv name.

See Also:

GetDriverGCVResponse, LDAPConnection.extendedOperation(com.novell.ldap.LDAPExtendedOperation), Serialized Form

Constructor Summary

GetDriverGCVRequest(String driverDN, String gcvName)
Construct an LDAP extended operation to get the effective gcv definition for a DirXML driver on a server.

GetDriverGCVRequest(String driverDN, String[] gcvNameArray)
Construct an LDAP extended operation to get the effective gcv's for a DirXML driver on a server.

Method Summary

ExtendedResponse	createExtendedResponse(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

GetDriverGCVRequest

public GetDriverGCVRequest(String driverDN,
                           String[] gcvNameArray)
                    throws LDAPException

Construct an LDAP extended operation to get the effective gcv's for a DirXML driver on a server.

Parameters:

driverDN - DN of a DirXML-Driver object

gcvNameArray - Array of a gcv name

Throws:

LDAPException

GetDriverGCVRequest

public GetDriverGCVRequest(String driverDN,
                           String gcvName)
                    throws LDAPException

Construct an LDAP extended operation to get the effective gcv definition for a DirXML driver on a server.

Parameters:

driverDN - DN of a DirXML-Driver object

gcvName - Name of a gcv

Throws:

LDAPException

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 ExtendedRequest

Returns:

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

createExtendedResponse

public ExtendedResponse createExtendedResponse(String id,
                                               byte[] berValue,
                                               int offset,
                                               int length)
                                        throws 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 ExtendedRequest

Parameters:

id - (ignored)

berValue - contains LBER-encoded response data

offset - offset into berValue

length - length (in bytes) of reponse data

Throws:

NamingException