Oracle® C++ Call Interface Programmer's Guide 10g Release 2 (10.2) Part Number B14294-02 |
|
|
View PDF |
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.
Table 12-24 Enumerated Values Used by Message Class
Attribute | Options |
---|---|
MessageState |
|
PayloadType |
|
Table 12-25 Summary of Message Methods
Method | Summary |
---|---|
|
|
|
Retrieves |
|
Retrieves the number of attempts made to dequeue the message. |
|
Retrieves |
|
Retrieves the identification string. |
|
Retrieves delay with which message was enqueued. |
|
Retrieves name of queue to which |
|
Retrieves the expiration of the message. |
|
Retrieves time at which message was enqueued. |
|
Retrieves state of the message at time of enqueuing. |
|
Retrieves object payload of the message. |
|
Retrieves the Id of the message that generated this message on the last queue. |
|
Retrieves the type of the payload.. |
|
Retrieves the priority of the message. |
|
Retrieves the agent who send the |
|
|
|
Assignment operator for |
|
Specifies |
|
Specifies |
|
Specifies the identification string. |
|
Specifies the number of seconds to delay the enqueued |
|
Specifies the name of the queue to which the |
|
Specifies the duration of time that |
|
Sets the |
|
Specifies object payload of the message. |
|
Specifies id of last queue that generated the |
|
Specifies priority of the |
|
Specifies the list of agents for whom the message is intended. |
|
Specifies the sender of the |
Message
class constructor.
Syntax | Description |
---|---|
Message( const Environment *env); |
Creates a Message object within the specified Environment . |
Message( const Message& mes); |
Copy constructor. |
Parameter | Description |
---|---|
env |
The environment of the Message . |
mes |
The original Message .. |
Retrieves the AnyData
payload of the Message
.
Syntax
AnyData getAnyData() const;
Retrieves the number of attempts made to dequeue the message. This property cannot be retrieved while enqueuing.
Syntax
int getAttemptsToDequeue() const;
Retrieves Bytes
payload of the Message
.
Syntax
Bytes getBytes() const;
Retrieves the identification string.
Syntax
string getCorrelationId() const;
Retrieves the delay (in seconds) with which the Message
was enqueued.
Syntax
int getDelay() const;
Retrieves the name of the queue to which the Message
is moved, in cases when the Message
cannot be processed successfully.
Syntax
string getExceptionQueueName() const;
Retrieves the expiration time of the Message
(in seconds). This is the duration for which the message is available for dequeuing.
Syntax
int getExpiration() const;
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.
Syntax
Date getMessageEnqueuedTime() const;
Retrieves the state of the message at the time of enqueuing. This parameter cannot be set an enqueuing time. MessageState is defined in Table 12-24.
Syntax
MessageState getMessageState() const;
Retrieves object payload of the Message
.
Syntax
PObject* getObject();
Retrieves the original message Id. When a message is propogated from one queue to another, gets the ID to the last queue that generated this message.
Syntax
Bytes getOriginalMessageId() const;
Retrieves the type of the payload, as defined for PayloadType in Table 12-24.
Syntax
PayloadType getPayloadType( ) const;
Retrieves the priority of the Message
.
Syntax
int getPriority() const;
Retrieves the agent who send the Message
.
Syntax
Agent getSenderId() const;
Tests whether the Message
object is NULL
. If the Message
object is NULL
, then TRUE
is returned; otherwise, FALSE
is returned.
Syntax
bool isNull() const;
Assignment operator for Message
.
void operator=( const Message& mes);
Parameter | Description |
---|---|
mes |
Original message.. |
Specifies AnyData
payload of the Message
.
Syntax
void setAnyData( const AnyData& anydata);
Parameter | Description |
---|---|
anydata |
Data content of the Message . |
Specifies Bytes
payload of the Message
.
Syntax
void setBytes( const Bytes& bytes);
Parameter | Description |
---|---|
bytes |
Data content of the Message . |
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.
Syntax
void setCorrelationId( const string& id);
Parameter | Description |
---|---|
id |
The id; upper limit of 128 bytes. |
Specifies the time (in seconds) to delay the enqueued Message
. After the delay ends, the Message
is available for dequeuing.
Note:
Dequeuing bymsgid
overrides the delay specification. A Message
enqueued with delay will be in the WAITING
state. Delay is set by the producer of the Message
.Syntax
void setDelay( int delay);
Parameter | Description |
---|---|
delay |
The delay. |
Specifies the name of the queue to which the Message
object will be moved if it cannot be processed successfully. The queue name must be valid.
Note:
If the exception queue does not exist at the time of the move, the Message
will be moved to the default exception queue associated with the queue table; a warning will be logged in the alert file.
If the default exception queue is used, the parameter will return a NULL
value at enqueuing time; the attribute must refer to a valid queue name.
Syntax
void setExceptionQueueName( const string& queue);
Parameter | Description |
---|---|
queue |
The name of the exception queue. |
Specifies the duration time (in seconds) that the Message
object is available for dequeuing. A Message
expires after this time.
Syntax
void setExpiration( int exp);
Parameter | Description |
---|---|
exp |
The duration of expiration. |
Sets the Message
object to NULL
. Before the Connection
is destroyed by the terminateConnection() call of the Environment Class, all Message
objects need to be set to NULL
.
Syntax
void setNull();
Specifies object payload of the Message
.
Syntax
void setObject( PObject& pobj);
Parameter | Description |
---|---|
pobj |
Content of the data |
Sets the Id of the last queue that generated the message, when a message is propogated from one queue to another.
Syntax
void setOriginalMessageId( const Bytes& queue);
Parameter | Description |
---|---|
queue |
The last queue. |
Specifies the priority of the Message
object. This property is set during enqueuing time, and can be negative. Default is 0
.
Syntax
void setPriority( int priority);
Parameter | Description |
---|---|
priority |
The priority of the Message . |
Specifies the list of Agent
s for whom the Message
is intended. These recipients are not identical to subscribers of the queue. The property is set during enqueuing. All Agent
s in the list must be valid. The recipient list will override the default subscriber list.
Syntax
void setRecipientList( vector<Agent>& agentList);
Parameter | Description |
---|---|
agentList |
The list of Agent s. |
Specifies the sender of the Message
.
Syntax
void setSenderId( const Agent& sender);
Parameter | Description |
---|---|
sender |
Sender id. |