org.apache.directory.shared.ldap.message.internal
Class InternalAbstractMessage

java.lang.Object
  org.apache.directory.shared.ldap.message.internal.InternalAbstractMessage

All Implemented Interfaces:

InternalMessage

Direct Known Subclasses:

InternalAbstractRequest, InternalAbstractResponse

public abstract class InternalAbstractMessage
extends Object
implements InternalMessage

Abstract message base class.

Version:

$Rev: 910150 $

Author:

Apache Directory Project

Constructor Summary

protected

InternalAbstractMessage(int id, MessageTypeEnum type) Completes the instantiation of a Message.

Method Summary

void	add(Control control) Adds a control to this Message.
void	addAll(Control[] controls) Adds an array of controls to this Message.
boolean	equals(Object obj) Checks to see if two messages are equivalent.
Object	get(Object key) Gets a message scope parameter.
Map<String,Control>	getControls() Gets the controls associated with this message mapped by OID.
int	getMessageId() Gets the session unique message sequence id for this message.
MessageTypeEnum	getType() Gets the LDAP message type code associated with this Message.
boolean	hasControl(String oid) Checks whether or not this message has the specified control.
int	hashCode()
Object	put(Object key, Object value) Sets a message scope parameter.
void	remove(Control control) Deletes a control removing it from this Message.

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

InternalAbstractMessage

protected InternalAbstractMessage(int id,
                                  MessageTypeEnum type)

Completes the instantiation of a Message.

Parameters:

id - the seq id of the message

type - the type of the message

Method Detail

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 InternalMessage

Returns:

the session unique message id.

getControls

public Map<String,Control> getControls()

Gets the controls associated with this message mapped by OID.

Specified by:

getControls in interface InternalMessage

Returns:

Map of OID strings to Control object instances.

See Also:

CodecControl

hasControl

public boolean hasControl(String oid)

Description copied from interface: InternalMessage

Checks whether or not this message has the specified control.

Specified by:

hasControl in interface InternalMessage

Parameters:

oid - the OID of the control

Returns:

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

See Also:

InternalMessage.hasControl(java.lang.String)

add

public void add(Control control)
         throws MessageException

Adds a control to this Message.

Specified by:

add in interface InternalMessage

Parameters:

control - the control to add.

Throws:

MessageException - if controls cannot be added to this Message or the control is not known etc.

remove

public void remove(Control control)
            throws MessageException

Deletes a control removing it from this Message.

Specified by:

remove in interface InternalMessage

Parameters:

control - the control to remove.

Throws:

MessageException - if controls cannot be added to this Message or the control is not known etc.

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 InternalMessage

Returns:

the message type code.

get

public Object get(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 InternalMessage

Parameters:

key - the key used to access a message parameter.

Returns:

the transient message parameter value.

put

public Object put(Object key,
                  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 InternalMessage

Parameters:

key - the parameter key

value - the parameter value

Returns:

the old value or null

equals

public boolean equals(Object obj)

Checks to see if two messages are equivalent. Messages equivalence does not factor in parameters accessible through the get() and put() operations, nor do they factor in the Lockable properties of the Message. Only the type, controls, and the messageId are evaluated for equality.

Overrides:

equals in class Object

Parameters:

obj - the object to compare this Message to for equality

hashCode

public int hashCode()

Overrides:

hashCode in class Object

Returns:

the instance's hash code

See Also:

Object.hashCode()

addAll

public void addAll(Control[] controls)
            throws MessageException

Description copied from interface: InternalMessage

Adds an array of controls to this Message.

Specified by:

addAll in interface InternalMessage

Parameters:

controls - the controls to add.

Throws:

MessageException - if controls cannot be added to this Message or they are not known etc.