com.novell.nds.dirxml.ldap
Class SetNamedPasswordRequest

java.lang.Object
  extended by com.novell.ldap.LDAPExtendedOperation
      extended by com.novell.nds.dirxml.ldap.SetNamedPasswordRequest
All Implemented Interfaces:
Externalizable, Serializable, Cloneable, ExtendedRequest

public class SetNamedPasswordRequest
extends LDAPExtendedOperation

Set a named password for an eDirectory object associated with 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-AccessConfigure attribute on the target object.

OID:
2.16.840.1.113719.1.14.100.75

Request data:
 ASN1OctetString     UTF-8 encoded DN of object
 ASN1OctetString     UTF-8 encoded password name
 ASN1OctetString     UTF-8 encoded password description
 ASN1OctetString     UTF-8 encoded password value
 

Notes:
There is no specific response data or response class.

See Also:
LDAPConnection.extendedOperation(com.novell.ldap.LDAPExtendedOperation), Serialized Form

Constructor Summary
SetNamedPasswordRequest(String dn, String key, String desc, char[] password)
          Construct an LDAP extended operation to set a named password on an object.
 
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.
 void zero()
          Zero-fill any password data in memory.
 
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

SetNamedPasswordRequest

public SetNamedPasswordRequest(String dn,
                               String key,
                               String desc,
                               char[] password)
                        throws LDAPException
Construct an LDAP extended operation to set a named password on an object.

Parameters:
dn - the DN of the object
key - the name of the password
desc - the description of the password
password - password characters
Throws:
LDAPException
Method Detail

zero

public void zero()
Zero-fill any password data in memory. After calling this method the instance is no longer usable.


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