org.apache.directory.api.ldap.codec.api

Class ExtendedRequestDecorator<Q extends ExtendedRequest>

java.lang.Object

org.apache.directory.api.ldap.codec.api.MessageDecorator<M>

org.apache.directory.api.ldap.codec.decorators.RequestDecorator<M>

org.apache.directory.api.ldap.codec.decorators.ResultResponseRequestDecorator<M>

org.apache.directory.api.ldap.codec.decorators.SingleReplyRequestDecorator<Q>

org.apache.directory.api.ldap.codec.api.ExtendedRequestDecorator<Q>

All Implemented Interfaces:

Asn1Object, Decorator<Q>, AbandonableRequest, ExtendedRequest, Message, Request, ResultResponseRequest, SingleReplyRequest

Direct Known Subclasses:

CancelRequestDecorator, CertGenerationRequestDecorator, GracefulShutdownRequestDecorator, PasswordModifyRequestDecorator, StartTlsRequestDecorator, StoredProcedureRequestDecorator, WhoAmIRequestDecorator

public class ExtendedRequestDecorator<Q extends ExtendedRequest>
extends SingleReplyRequestDecorator<Q>
implements ExtendedRequest

A decorator for the ExtendedRequest message

Field Summary

Fields

Modifier and Type	Field and Description
private int	extendedRequestLength The extended request length
private byte[]	requestNameBytes The OID bytes
protected byte[]	requestValue The ExtendedRequest value

Fields inherited from class org.apache.directory.api.ldap.codec.api.MessageDecorator

messageLength

Constructor Summary

Constructors

Constructor and Description
ExtendedRequestDecorator(LdapApiService codec, Q decoratedMessage) Makes a ExtendedRequest a MessageDecorator.

Method Summary

Modifier and Type	Method and Description
ExtendedRequest	addAllControls(Control[] controls) Adds an array of controls to this Message.
ExtendedRequest	addControl(Control control) Adds a control to this Message.
int	computeLength() Compute the ExtendedRequest length ExtendedRequest : 0x77 L1 | +--> 0x80 L2 name [+--> 0x81 L3 value] L1 = Length(0x80) + Length(L2) + L2 [+ Length(0x81) + Length(L3) + L3] Length(ExtendedRequest) = Length(0x77) + Length(L1) + L1
java.nio.ByteBuffer	encode(java.nio.ByteBuffer buffer) Encode the ExtendedRequest message to a PDU.
java.lang.String	getRequestName() Gets the Object Identifier corresponding to the extended request type.
byte[]	getRequestValue()
ExtendedRequest	removeControl(Control control) Deletes a control removing it from this Message.
ExtendedRequest	setMessageId(int messageId) Sets the Message ID for this request
ExtendedRequest	setRequestName(java.lang.String oid) Sets the Object Identifier corresponding to the extended request type.
void	setRequestValue(byte[] requestValue)

Methods inherited from class org.apache.directory.api.ldap.codec.decorators.SingleReplyRequestDecorator

abandon, addAbandonListener, getResponseType, isAbandoned

Methods inherited from class org.apache.directory.api.ldap.codec.decorators.ResultResponseRequestDecorator

getResultResponse, hasResponse

Methods inherited from class org.apache.directory.api.ldap.codec.api.MessageDecorator

get, getCodecService, getControl, getControls, getControlsLength, getCurrentControl, getDecorated, getDecorator, getMessageId, getMessageLength, getType, hasControl, put, setControlsLength, setMessageLength, toString

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.apache.directory.api.ldap.model.message.SingleReplyRequest

getResponseType

Methods inherited from interface org.apache.directory.api.ldap.model.message.ResultResponseRequest

getResultResponse

Methods inherited from interface org.apache.directory.api.ldap.model.message.Request

hasResponse

Methods inherited from interface org.apache.directory.api.ldap.model.message.Message

get, getControl, getControls, getMessageId, getType, hasControl, put

Field Detail

extendedRequestLength

private int extendedRequestLength

The extended request length

requestNameBytes

private byte[] requestNameBytes

The OID bytes

requestValue

protected byte[] requestValue

The ExtendedRequest value

Constructor Detail

ExtendedRequestDecorator

public ExtendedRequestDecorator(LdapApiService codec,
                                Q decoratedMessage)

Makes a ExtendedRequest a MessageDecorator.

Parameters:

decoratedMessage - the decorated ExtendedRequest

Method Detail

getRequestName

public java.lang.String getRequestName()

Gets the Object Identifier corresponding to the extended request type. This is the requestName portion of the ExtendedRequst PDU.

Specified by:

getRequestName in interface ExtendedRequest

Returns:

the dotted-decimal representation as a String of the OID

setRequestName

public ExtendedRequest setRequestName(java.lang.String oid)

Sets the Object Identifier corresponding to the extended request type.

Specified by:

setRequestName in interface ExtendedRequest

Parameters:

oid - the dotted-decimal representation as a String of the OID

Returns:

The ExtendedRequest instance

getRequestValue

public byte[] getRequestValue()

setRequestValue

public void setRequestValue(byte[] requestValue)

setMessageId

public ExtendedRequest setMessageId(int messageId)

Sets the Message ID for this request

Specified by:

setMessageId in interface ExtendedRequest

Specified by:

setMessageId in interface Message

Overrides:

setMessageId in class MessageDecorator<Q extends ExtendedRequest>

Parameters:

messageId - The message Id

Returns:

A Message reference

addControl

public ExtendedRequest addControl(Control control)

Adds a control to this Message.

Specified by:

addControl in interface ExtendedRequest

Specified by:

addControl in interface Message

Overrides:

addControl in class MessageDecorator<Q extends ExtendedRequest>

Parameters:

control - the control to add.

Returns:

A Message reference

addAllControls

public ExtendedRequest addAllControls(Control[] controls)

Adds an array of controls to this Message.

Specified by:

addAllControls in interface ExtendedRequest

Specified by:

addAllControls in interface Message

Overrides:

addAllControls in class MessageDecorator<Q extends ExtendedRequest>

Parameters:

controls - the controls to add.

Returns:

A Message reference

removeControl

public ExtendedRequest removeControl(Control control)

Deletes a control removing it from this Message.

Specified by:

removeControl in interface ExtendedRequest

Specified by:

removeControl in interface Message

Overrides:

removeControl in class MessageDecorator<Q extends ExtendedRequest>

Parameters:

control - the control to remove.

Returns:

A Message reference

computeLength

public int computeLength()

Compute the ExtendedRequest length ExtendedRequest : 0x77 L1 | +--> 0x80 L2 name [+--> 0x81 L3 value] L1 = Length(0x80) + Length(L2) + L2 [+ Length(0x81) + Length(L3) + L3] Length(ExtendedRequest) = Length(0x77) + Length(L1) + L1

Specified by:

computeLength in interface Asn1Object

Specified by:

computeLength in interface Decorator<Q extends ExtendedRequest>

Returns:

The object's computed length

encode

public java.nio.ByteBuffer encode(java.nio.ByteBuffer buffer)
                           throws EncoderException

Encode the ExtendedRequest message to a PDU. ExtendedRequest : 0x80 LL resquest name [0x81 LL request value]

Specified by:

encode in interface Asn1Object

Specified by:

encode in interface Decorator<Q extends ExtendedRequest>

Parameters:

buffer - The buffer where to put the PDU

Returns:

The PDU.

Throws:

EncoderException - if the buffer can't be encoded