oracle.jdbc.aq
Interface AQMessage

public interface AQMessage

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

See Also:

AQFactory.createAQMessage

Method Summary

ANYDATA	getANYDATAPayload() Retrieves the payload as an ANYDATA.
byte[]	getMessageId() Gets the id (16 bytes) of this message.
AQMessageProperties	getMessageProperties() Gets the AQMessageProperties that goes with this AQMessage.
byte[]	getPayload() Retrieves the payload in its linearized form.
byte[]	getPayloadTOID() Retrieves the TOID of the payload.
RAW	getRAWPayload() Retrieves the payload as a RAW.
STRUCT	getSTRUCTPayload() Retrieves the payload as an ADT.
XMLType	getXMLTypePayload() Retrieves the payload as an XMLType.
boolean	isANYDATAPayload() Returns true if the payload type is ANYDATA and false otherwise.
boolean	isRAWPayload() Returns trus if the payload type is RAW and false otherwise.
boolean	isSTRUCTPayload() Returns true if the payload is a STRUCT (in other words if the payload is an object) and false otherwise.
boolean	isXMLTypePayload() Returns trus if the payload type is XMLType and false otherwise.
void	setPayload(ANYDATA payload) Sets an ANYDATA payload.
void	setPayload(byte[] payload) Sets a RAW payload.
void	setPayload(byte[] payload, byte[] tdo) Sets the payload in its linearized form.
void	setPayload(RAW payload) Sets a RAW payload.
void	setPayload(STRUCT payload) Sets an ADT payload.
java.lang.String	toString() Returns the String description of this message.

Method Detail

getMessageId

byte[] getMessageId()
                    throws java.sql.SQLException

Gets the id (16 bytes) of this message.

There are enqueue and dequeue options to retrieve the id of a message after enqueue or dequeue.

Throws:

java.sql.SQLException

getMessageProperties

AQMessageProperties getMessageProperties()
                                         throws java.sql.SQLException

Gets the AQMessageProperties that goes with this AQMessage.

Throws:

java.sql.SQLException

setPayload

void setPayload(byte[] payload)
                throws java.sql.SQLException

Sets a RAW payload.

Sets the payload payload type to "RAW" and stores the given payload but doesn't make a copy.

Calling this method is the equivalent of:

      // payloadInBytes being the byte[] array
      RAW rawPayload = new RAW(payloadInBytes);
      message.setPayload(rawPayload);
    

Throws:

java.sql.SQLException

setPayload

void setPayload(byte[] payload,
                byte[] tdo)
                throws java.sql.SQLException

Sets the payload in its linearized form.

This method lets you set the payload in its linearized form. You need to provide the correpondant OID of the Type Descriptor Object. This is useful in the case where you have your own pickler.

For example, given that the linearized form of a RAW instance is the bytes themselves, the following code:

  message.setPayload(payloadInBytes);

is the same as

  message.setPayload(payloadInBytes,TypeDescriptor.RAWTOID);

Throws:

java.sql.SQLException

setPayload

void setPayload(STRUCT payload)
                throws java.sql.SQLException

Sets an ADT payload.

Throws:

java.sql.SQLException

setPayload

void setPayload(ANYDATA payload)
                throws java.sql.SQLException

Sets an ANYDATA payload.

Throws:

java.sql.SQLException

setPayload

void setPayload(RAW payload)
                throws java.sql.SQLException

Sets a RAW payload.

Throws:

java.sql.SQLException

getPayload

byte[] getPayload()
                  throws java.sql.SQLException

Retrieves the payload in its linearized form.

Throws:

java.sql.SQLException

getPayloadTOID

byte[] getPayloadTOID()

Retrieves the TOID of the payload.

getSTRUCTPayload

STRUCT getSTRUCTPayload()
                        throws java.sql.SQLException

Retrieves the payload as an ADT.

Throws:

java.sql.SQLException

isSTRUCTPayload

boolean isSTRUCTPayload()
                        throws java.sql.SQLException

Returns true if the payload is a STRUCT (in other words if the payload is an object) and false otherwise.

If the payload is q STRUCT, you should use getSTRUCTPayload() to get its value.

Throws:

java.sql.SQLException

getANYDATAPayload

ANYDATA getANYDATAPayload()
                          throws java.sql.SQLException

Retrieves the payload as an ANYDATA.

Throws:

java.sql.SQLException

isANYDATAPayload

boolean isANYDATAPayload()
                         throws java.sql.SQLException

Returns true if the payload type is ANYDATA and false otherwise.

If the payload type is ANYDATA, you should use getANYDATAPayload() to get its content.

Throws:

java.sql.SQLException

getRAWPayload

RAW getRAWPayload()
                  throws java.sql.SQLException

Retrieves the payload as a RAW.

Throws:

java.sql.SQLException

isRAWPayload

boolean isRAWPayload()
                     throws java.sql.SQLException

Returns trus if the payload type is RAW and false otherwise.

If the payload type is RAW, you should use getRAWPayload() to get its content.

Throws:

java.sql.SQLException

getXMLTypePayload

XMLType getXMLTypePayload()
                          throws java.sql.SQLException

Retrieves the payload as an XMLType.

Throws:

java.sql.SQLException

isXMLTypePayload

boolean isXMLTypePayload()
                         throws java.sql.SQLException

Returns trus if the payload type is XMLType and false otherwise.

If the payload type is XMLType, you should use getXMLTypePayload() to get its content.

Throws:

java.sql.SQLException

toString

java.lang.String toString()

Returns the String description of this message.

Overrides:

toString in class java.lang.Object