com.unboundid.ldap.protocol
Class IntermediateResponseProtocolOp

java.lang.Object
  extended by com.unboundid.ldap.protocol.IntermediateResponseProtocolOp
All Implemented Interfaces:
ProtocolOp, java.io.Serializable

@InternalUseOnly
@NotMutable
@ThreadSafety(level=COMPLETELY_THREADSAFE)
public final class IntermediateResponseProtocolOp
extends java.lang.Object
implements ProtocolOp

This class provides an implementation of an LDAP intermediate response protocol op.

See Also:
Serialized Form

Field Summary
static byte TYPE_OID
          The BER type for the OID element.
static byte TYPE_VALUE
          The BER type for the value element.
 
Constructor Summary
IntermediateResponseProtocolOp(IntermediateResponse response)
          Creates a new intermediate response protocol op from the provided intermediate response object.
IntermediateResponseProtocolOp(java.lang.String oid, ASN1OctetString value)
          Creates a new intermediate response protocol op with the provided information.
 
Method Summary
static IntermediateResponseProtocolOp decodeProtocolOp(ASN1Element element)
          Decodes the provided ASN.1 element as a intermediate response protocol op.
 ASN1Element encodeProtocolOp()
          Encodes this protocol op to an ASN.1 element suitable for inclusion in an encoded LDAP message.
 java.lang.String getOID()
          Retrieves the OID for this intermediate response, if any.
 byte getProtocolOpType()
          Retrieves the BER type for this protocol op.
 ASN1OctetString getValue()
          Retrieves the value for this intermediate response, if any.
 IntermediateResponse toIntermediateResponse(Control... controls)
          Creates a intermediate response from this protocol op.
 java.lang.String toString()
          Retrieves a string representation of this protocol op.
 void toString(java.lang.StringBuilder buffer)
          Appends a string representation of this LDAP protocol op to the provided buffer.
 void writeTo(ASN1Buffer buffer)
          Writes an ASN.1-encoded representation of this LDAP protocol op to the provided ASN.1 buffer.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Field Detail

TYPE_OID

public static final byte TYPE_OID
The BER type for the OID element.

See Also:
Constant Field Values

TYPE_VALUE

public static final byte TYPE_VALUE
The BER type for the value element.

See Also:
Constant Field Values
Constructor Detail

IntermediateResponseProtocolOp

public IntermediateResponseProtocolOp(java.lang.String oid,
                                      ASN1OctetString value)
Creates a new intermediate response protocol op with the provided information.

Parameters:
oid - The OID for this intermediate response, or null if there should not be an OID.
value - The value for this intermediate response, or null if there should not be a value.

IntermediateResponseProtocolOp

public IntermediateResponseProtocolOp(IntermediateResponse response)
Creates a new intermediate response protocol op from the provided intermediate response object.

Parameters:
response - The intermediate response object to use to create this protocol op.
Method Detail

getOID

public java.lang.String getOID()
Retrieves the OID for this intermediate response, if any.

Returns:
The OID for this intermediate response, or null if there is no response OID.

getValue

public ASN1OctetString getValue()
Retrieves the value for this intermediate response, if any.

Returns:
The value for this intermediate response, or null if there is no response value.

getProtocolOpType

public byte getProtocolOpType()
Retrieves the BER type for this protocol op.

Specified by:
getProtocolOpType in interface ProtocolOp
Returns:
The BER type for this protocol op.

encodeProtocolOp

public ASN1Element encodeProtocolOp()
Encodes this protocol op to an ASN.1 element suitable for inclusion in an encoded LDAP message.

Specified by:
encodeProtocolOp in interface ProtocolOp
Returns:
The ASN.1 element containing the encoded protocol op.

decodeProtocolOp

public static IntermediateResponseProtocolOp decodeProtocolOp(ASN1Element element)
                                                       throws LDAPException
Decodes the provided ASN.1 element as a intermediate response protocol op.

Parameters:
element - The ASN.1 element to be decoded.
Returns:
The decoded intermediate response protocol op.
Throws:
LDAPException - If the provided ASN.1 element cannot be decoded as a intermediate response protocol op.

writeTo

public void writeTo(ASN1Buffer buffer)
Writes an ASN.1-encoded representation of this LDAP protocol op to the provided ASN.1 buffer. This method is intended for internal use only and should not be used by third-party code.

Specified by:
writeTo in interface ProtocolOp
Parameters:
buffer - The ASN.1 buffer to which the encoded representation should be written.

toIntermediateResponse

public IntermediateResponse toIntermediateResponse(Control... controls)
Creates a intermediate response from this protocol op.

Parameters:
controls - The set of controls to include in the intermediate response. It may be empty or null if no controls should be included.
Returns:
The intermediate response that was created.

toString

public java.lang.String toString()
Retrieves a string representation of this protocol op.

Overrides:
toString in class java.lang.Object
Returns:
A string representation of this protocol op.

toString

public void toString(java.lang.StringBuilder buffer)
Appends a string representation of this LDAP protocol op to the provided buffer.

Specified by:
toString in interface ProtocolOp
Parameters:
buffer - The buffer to which the string representation should be appended.