Message Class

A message is the unit that is enqueued dequeued. A Message object holds both its content, or payload, and its properties. This class provides methods to get and set message properties.

MessageState

PayloadType

Message()

Message class constructor.

Message(
    const Environment *env);

Message(
   const Message& mes);

env

mes

getAnyData()

Retrieves the AnyData payload of the Message.

LNCPP21131Syntax

AnyData getAnyData() const;

getAttemptsToDequeue()

Retrieves the number of attempts made to dequeue the message. This property cannot be retrieved while enqueuing.

LNCPP21133Syntax

int getAttemptsToDequeue() const;

getBytes()

Retrieves Bytes payload of the Message.

LNCPP21135Syntax

Bytes getBytes() const;

getCorrelationId()

Retrieves the identification string.

LNCPP21137Syntax

string getCorrelationId() const;

getDelay()

Retrieves the delay (in seconds) with which the Message was enqueued.

LNCPP21139Syntax

int getDelay() const;

getExceptionQueueName()

Retrieves the name of the queue to which the Message is moved, in cases when the Message cannot be processed successfully.

LNCPP21141Syntax

string getExceptionQueueName() const;

getExpiration()

Retrieves the expiration time of the Message (in seconds). This is the duration for which the message is available for dequeuing.

LNCPP21143Syntax

int getExpiration() const;

getMessageEnqueuedTime()

Retrieves the time at which the message was enqueued, in Date format. This value is determined by the system, and cannot be set by the user.

LNCPP21145Syntax

Date getMessageEnqueuedTime() const;

getMessageState()

Retrieves the state of the message at the time of enqueuing. This parameter cannot be set an enqueuing time. MessageState is defined in Table 13-25.

LNCPP21147Syntax

MessageState getMessageState() const;

getObject()

Retrieves object payload of the Message.

LNCPP21149Syntax

PObject* getObject();

getOriginalMessageId()

Retrieves the original message Id. When a message is propagated from one queue to another, gets the ID to the last queue that generated this message.

LNCPP21151Syntax

Bytes getOriginalMessageId() const;

getPayloadType()

Retrieves the type of the payload, as defined for PayloadType in Table 13-25.

LNCPP21153Syntax

PayloadType getPayloadType( ) const;

getPriority()

Retrieves the priority of the Message.

LNCPP21155Syntax

int getPriority() const;

getSenderId()

Retrieves the agent who send the Message.

LNCPP21157Syntax

Agent getSenderId() const;

isNull()

Tests whether the Message object is NULL. If the Message object is NULL, then TRUE is returned; otherwise, FALSE is returned.

LNCPP21159Syntax

bool isNull() const;

operator=()

Assignment operator for Message.

void operator=(
   const Message& mes);

mes

setAnyData()

Specifies AnyData payload of the Message.

LNCPP21162Syntax

void setAnyData(
   const AnyData& anydata);

anydata

setBytes()

Specifies Bytes payload of the Message.

LNCPP21164Syntax

void setBytes(
   const Bytes& bytes);

bytes

setCorrelationId()

Specifies the identification string. This parameter is set at enqueuing time by the Producer. Messages can be dequeued with this id. The id can contain wildcard characters.

LNCPP21166Syntax

void setCorrelationId(
   const string& id);

id

setDelay()

Specifies the time (in seconds) to delay the enqueued Message. After the delay ends, the Message is available for dequeuing.

Note that dequeuing by msgid overrides the delay specification. A Message enqueued with delay is in the WAITING state. Delay is set by the producer of the Message.

LNCPP21168Syntax

void setDelay(
   int delay);

delay

setExceptionQueueName()

Specifies the name of the queue to which the Message object is moved if it cannot be processed successfully. The queue name must be valid.

Note that if the exception queue does not exist at the time of the move, the Message is moved to the default exception queue associated with the queue table; a warning is logged in the alert log.

Also note that if the default exception queue is used, the parameter returns a NULL value at enqueuing time; the attribute must refer to a valid queue name.

LNCPP21170Syntax

void setExceptionQueueName(
   const string& queue);

queue

setExpiration()

Specifies the duration time (in seconds) that the Message object is available for dequeuing. A Message expires after this time.

LNCPP21172Syntax

void setExpiration(
   int exp);

exp

setNull()

Sets the Message object to NULL. Before the Connection is destroyed by the terminateConnection() call of the Environment Class, all Message objects must be set to NULL.

LNCPP21174Syntax

void setNull();

setObject()

Specifies object payload of the Message.

LNCPP21176Syntax

void setObject(
   PObject& pobj);

pobj

setOriginalMessageId()

Sets the Id of the last queue that generated the message, when a message is propagated from one queue to another.

LNCPP21178Syntax

void setOriginalMessageId(
   const Bytes& queue);

queue

setPriority()

Specifies the priority of the Message object. This property is set during enqueuing time, and can be negative. Default is 0.

LNCPP21180Syntax

void setPriority(
   int priority);

priority

setRecipientList()

Specifies the list of Agents for whom the Message is intended. These recipients are not identical to subscribers of the queue. The property is set during enqueuing. All Agents in the list must be valid. The recipient list overrides the default subscriber list.

LNCPP21182Syntax

void setRecipientList(
   vector<Agent>& agentList);

agentList

setSenderId()

Specifies the sender of the Message.

LNCPP21184Syntax

void setSenderId(
   const Agent& sender);

sender