Oracle® C++ Call Interface Programmer's Guide, 11g Release 2 (11.2) Part Number E10764-01 |
|
|
View PDF |
The Producer
enqueues Message
s into a queue and defines the enqueue options.
Table 13-32 Enumerated Values Used by Producer Class
Attribute | Options |
---|---|
EnqueueSequence |
|
Visibility |
|
Table 13-33 Summary of Producer Methods
Method | Summary |
---|---|
|
|
Retrieves the name of a queue on which the |
|
Retrieves the |
|
Retrieves information regarding whether the |
|
Retrieves the transformation applied before a |
|
Retrieves the transactional behavior of the enqueue request. |
|
Tests whether the |
|
Enqueues and sends a |
|
Assignment operator for |
|
Frees memory if the scope of the |
|
Specifies the name of a queue on which the |
|
Specifies the |
|
Specifies whether |
|
Specifies transformation applied before enqueuing a |
|
Specifies transaction behavior of the enqueue request. |
Producer
object constructor.
Syntax | Description |
---|---|
Producer( const Connection *conn); |
Creates a Producer object with the specified Connection . |
Producer( const Connection *conn, const string& queue); |
Creates a Producer object with the specified Connection and queue name. |
Parameter | Description |
---|---|
conn |
The connection of the new Producer object. |
queue |
The queue that is used by the new Producer object. |
Retrieves the name of a queue on which the Message
s are enqueued.
Syntax
string getQueueName() cosnt;
Retrieves the Message
id that is referenced in a sequence deviation operation. Used only if a sequence deviation is specified; ignored otherwise.
Syntax
Bytes getRelativeMessageId() const;
Retrieves information regarding whether the Message
should be dequeued ahead of other Message
s in the queue. Valid return values are ENQ_BEFORE
and ENQ_TOP
, as defined in Table 13-32.
Syntax
EnqueueSequence getSequenceDeviation() const;
Retrieves the transformation applied before a Message
is enqueued.
Syntax
string getTransformation() const;
Retrieves the transactional behavior of the enqueue request. Visibility
is defined in Table 13-32.
Syntax
Visibility getVisibility() const;
Tests whether the Producer
is NULL
. If the Producer
is NULL
, then TRUE
is returned; otherwise, FALSE
is returned.
Syntax
bool isNull() const;
The assignment operator for Producer
.
Syntax
void operator=( const Producer& prod);
Parameter | Description |
---|---|
prod |
The original Producer |
Enqueues and sends a Message
.
Syntax | Description |
---|---|
Bytes send( Message& msg); |
Used when queueName has been previously set by the setQueueName() method. |
Bytes send( Message& msg, string& queue); |
Enqueue the Message to the specified queueName . |
Parameter | Description |
---|---|
msg |
The Message that is enqueued. |
queue |
The name of a valid queue in the database. |
Frees memory associated with the Producer
. Unless working in inner scope, this call should be made before terminating the Connection
.
Syntax
void setNull();
Specifies the name of a queue on which the Message
s are enqueued. Typically used when enqueuing multiple messages to the same queue.
Syntax
void setQueueName( const string& queue);
Parameter | Description |
---|---|
queue |
The name of a valid queue in the database, to which the Message s are enqueued. |
Specifies the Message
id to be referenced in the sequence deviation operation. If the sequence deviation is not specified, this parameter is ignored. Can be set for each enqueuing of a Message
.
Syntax
void setRelativeMessageId( const Bytes& msgid);
Parameter | Description |
---|---|
msgid |
The id of the relative Message . |
Specifies whether Message
being enqueued should be dequeued before other Message
(s) in the queue. Can be set for each enqueuing of a Message
.
Syntax
void setSequenceDeviation( EnqueueSequence option);
Parameter | Description |
---|---|
option |
The enqueue sequence being set, defined in Table 13-32. |
Specifies transformation function applied before enqueuing the Message
.
Syntax
void setTransformation( string &fName);
Parameter | Description |
---|---|
fName |
SQL transformation function. |
Specifies transaction behavior of the enqueue request. Can be set for each enqueuing of a Message
.
Syntax
void setVisibility( Visibility option);
Parameter | Description |
---|---|
option |
Visibility option being set, defined in Table 13-32. |