com.novell.nds.dirxml.ldap

Class MigrateAppRequest

java.lang.Object

com.novell.ldap.LDAPExtendedOperation

com.novell.nds.dirxml.ldap.MigrateAppRequest

All Implemented Interfaces:

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

public class MigrateAppRequest
extends com.novell.ldap.LDAPExtendedOperation

Start a migrate from application 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.

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-AccessMigrate attribute on the target DirXML-Driver object.

OID:

2.16.840.1.113719.1.14.100.25

Request data:

 ASN1OctetString     UTF-8 encoded DN of DirXML-Driver object
 ASN1OctetString     serialized XML document containing one or more query commands
 

Notes:

The query document data must be a well-formed, serialized XML document.

There is no specific response data or response class.

See Also:

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

Constructor Summary

Constructors

Constructor and Description
MigrateAppRequest(java.lang.String driverDN, byte[] docBytes) Construct an LDAP extended operation to start a "migrate from application" for a DirXML driver on a server.

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

MigrateAppRequest

public MigrateAppRequest(java.lang.String driverDN,
                         byte[] docBytes)
                  throws com.novell.ldap.LDAPException

Construct an LDAP extended operation to start a "migrate from application" for a DirXML driver on a server.

Parameters:

driverDN - the DN of the DirXML-Driver object

docBytes - a serialized XML document

Throws:

com.novell.ldap.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 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