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

Class MessageDecorator<E extends Message>

java.lang.Object

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

All Implemented Interfaces:

Asn1Object, Decorator<E>, Message

Direct Known Subclasses:

IntermediateResponseDecorator, RequestDecorator, ResponseDecorator, SearchRequestDecorator, SearchResultEntryDecorator, SearchResultReferenceDecorator

public abstract class MessageDecorator<E extends Message>
extends java.lang.Object
implements Message, Decorator<E>, Asn1Object

A decorator for the generic LDAP Message

Field Summary

Fields

Modifier and Type	Field and Description
private LdapApiService	codec The LdapCodecService
private java.util.Map<java.lang.String,Control>	controls Map of message controls using OID Strings for keys and Control values
private int	controlsLength The length of the controls
private CodecControl<? extends Control>	currentControl The current control
private E	decoratedMessage The decorated Control
protected int	messageLength The encoded Message length

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	MessageDecorator(LdapApiService codec, E decoratedMessage) Makes a Message an Decorator object.

Method Summary

Modifier and Type	Method and Description
Message	addAllControls(Control[] controls) Adds an array of controls to this Message.
Message	addControl(Control control) Adds a control to this Message.
java.lang.Object	get(java.lang.Object key) Gets a message scope parameter.
LdapApiService	getCodecService() Gets the codec service responsible for managing the encoding and decoding of the decorated objects.
Control	getControl(java.lang.String oid) Gets the control associated with the given OID.
java.util.Map<java.lang.String,Control>	getControls() Gets the controls associated with this message mapped by OID.
int	getControlsLength()
CodecControl<? extends Control>	getCurrentControl() Get the current Control Object
E	getDecorated() Gets the object being decorated by this IDecorator.
static MessageDecorator<? extends Message>	getDecorator(LdapApiService codec, Message decoratedMessage)
int	getMessageId() Gets the session unique message sequence id for this message.
int	getMessageLength()
MessageTypeEnum	getType() Gets the LDAP message type code associated with this Message.
boolean	hasControl(java.lang.String oid) Checks whether or not this message has the specified control.
java.lang.Object	put(java.lang.Object key, java.lang.Object value) Sets a message scope parameter.
Message	removeControl(Control control) Deletes a control removing it from this Message.
void	setControlsLength(int controlsLength)
Message	setMessageId(int messageId) Sets the Message ID for this request
void	setMessageLength(int messageLength)
java.lang.String	toString() Delegates to the toString() method of the decorated Message.

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.codec.api.Decorator

computeLength, encode

Methods inherited from interface org.apache.directory.api.asn1.Asn1Object

computeLength, encode

Field Detail

decoratedMessage

private final E extends Message decoratedMessage

The decorated Control

controls

private final java.util.Map<java.lang.String,Control> controls

Map of message controls using OID Strings for keys and Control values

currentControl

private CodecControl<? extends Control> currentControl

The current control

messageLength

protected int messageLength

The encoded Message length

controlsLength

private int controlsLength

The length of the controls

codec

private final LdapApiService codec

The LdapCodecService

Constructor Detail

MessageDecorator

protected MessageDecorator(LdapApiService codec,
                           E decoratedMessage)

Makes a Message an Decorator object.

Method Detail

getDecorator

public static MessageDecorator<? extends Message> getDecorator(LdapApiService codec,
                                                               Message decoratedMessage)

setControlsLength

public void setControlsLength(int controlsLength)

Parameters:

controlsLength - the encoded controls length

getControlsLength

public int getControlsLength()

Returns:

the encoded controls length

setMessageLength

public void setMessageLength(int messageLength)

Parameters:

messageLength - The encoded message length

getMessageLength

public int getMessageLength()

Returns:

The encoded message length

getCurrentControl

public CodecControl<? extends Control> getCurrentControl()

Get the current Control Object

Returns:

The current Control Object

getType

public MessageTypeEnum getType()

Gets the LDAP message type code associated with this Message. Each request and response type has a unique message type code defined by the protocol in RFC 2251.

Specified by:

getType in interface Message

Returns:

the message type code.

getControls

public java.util.Map<java.lang.String,Control> getControls()

Gets the controls associated with this message mapped by OID.

Specified by:

getControls in interface Message

Returns:

Map of OID strings to Control object instances.

getControl

public Control getControl(java.lang.String oid)

Gets the control associated with the given OID.

Specified by:

getControl in interface Message

Parameters:

oid - The Cntrol's OID we are looking for

Returns:

The Control object instance with the OID.

hasControl

public boolean hasControl(java.lang.String oid)

Checks whether or not this message has the specified control.

Specified by:

hasControl in interface Message

Parameters:

oid - the OID of the control

Returns:

true if this message has the control, false if it does not

addControl

public Message addControl(Control control)

Adds a control to this Message.

Specified by:

addControl in interface Message

Parameters:

control - the control to add.

Returns:

A Message reference

addAllControls

public Message addAllControls(Control[] controls)

Adds an array of controls to this Message.

Specified by:

addAllControls in interface Message

Parameters:

controls - the controls to add.

Returns:

A Message reference

removeControl

public Message removeControl(Control control)

Deletes a control removing it from this Message.

Specified by:

removeControl in interface Message

Parameters:

control - the control to remove.

Returns:

A Message reference

getMessageId

public int getMessageId()

Gets the session unique message sequence id for this message. Requests and their responses if any have the same message id. Clients at the initialization of a session start with the first message's id set to 1 and increment it with each transaction.

Specified by:

getMessageId in interface Message

Returns:

the session unique message id.

get

public java.lang.Object get(java.lang.Object key)

Gets a message scope parameter. Message scope parameters are temporary variables associated with a message and are set locally to be used to associate housekeeping information with a request or its processing. These parameters are never transmitted nor recieved, think of them as transient data associated with the message or its processing. These transient parameters are not locked down so modifications can occur without firing LockExceptions even when this Lockable is in the locked state.

Specified by:

get in interface Message

Parameters:

key - the key used to access a message parameter.

Returns:

the transient message parameter value.

put

public java.lang.Object put(java.lang.Object key,
                            java.lang.Object value)

Sets a message scope parameter. These transient parameters are not locked down so modifications can occur without firing LockExceptions even when this Lockable is in the locked state.

Specified by:

put in interface Message

Parameters:

key - the parameter key

value - the parameter value

Returns:

the old value or null

setMessageId

public Message setMessageId(int messageId)

Sets the Message ID for this request

Specified by:

setMessageId in interface Message

Parameters:

messageId - The message Id

Returns:

A Message reference

toString

public java.lang.String toString()

Delegates to the toString() method of the decorated Message.

Overrides:

toString in class java.lang.Object

getDecorated

public E getDecorated()

Gets the object being decorated by this IDecorator.

Specified by:

getDecorated in interface Decorator<E extends Message>

Returns:

The decorated object

getCodecService

public LdapApiService getCodecService()

Gets the codec service responsible for managing the encoding and decoding of the decorated objects.

Specified by:

getCodecService in interface Decorator<E extends Message>

Returns:

the codec service