org.apache.qpid.jms.provider.amqp.message

Class AmqpMessageIdHelper

java.lang.Object

org.apache.qpid.jms.provider.amqp.message.AmqpMessageIdHelper

public class AmqpMessageIdHelper
extends Object

Helper class for identifying and converting message-id and correlation-id values between the AMQP types and the Strings values used by JMS.

AMQP messages allow for 4 types of message-id/correlation-id: message-id-string, message-id-binary, message-id-uuid, or message-id-ulong. In order to accept or return a string representation of these for interoperability with other AMQP clients, the following encoding can be used after removing or before adding the "ID:" prefix used for a JMSMessageID value:
"AMQP_BINARY:<hex representation of binary content>"
"AMQP_UUID:<string representation of uuid>"
"AMQP_ULONG:<string representation of ulong>"
"AMQP_STRING:<string>"

The AMQP_STRING encoding exists only for escaping message-id-string values that happen to begin with one of the encoding prefixes (including AMQP_STRING itself). It MUST NOT be used otherwise.

When provided a string for conversion which attempts to identify itself as an encoded binary, uuid, or ulong but can't be converted into the indicated format, an exception will be thrown.

Field Summary

Fields

Modifier and Type	Field and Description
static String	AMQP_BINARY_PREFIX
static String	AMQP_NO_PREFIX
static String	AMQP_STRING_PREFIX
static String	AMQP_ULONG_PREFIX
static String	AMQP_UUID_PREFIX
static String	JMS_ID_PREFIX

Constructor Summary

Constructors

Constructor and Description
AmqpMessageIdHelper()

Method Summary

Modifier and Type	Method and Description
static String	convertBinaryToHexString(byte[] bytes) Convert the provided binary into a hex-string representation where each character represents 4 bits of the provided binary, i.e each byte requires two characters.
static byte[]	convertHexStringToBinary(String hexString) Convert the provided hex-string into a binary representation where each byte represents two characters of the hex string.
static boolean	hasMessageIdPrefix(String string) Checks whether the given string begins with "ID:" prefix used to denote a JMSMessageID
static String	toCorrelationIdString(Object idObject)
static Object	toIdObject(String origId) Takes the provided id string and return the appropriate amqp messageId style object.
static String	toMessageIdString(Object idObject)

Methods inherited from class java.lang.Object

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

Field Detail

AMQP_STRING_PREFIX

public static final String AMQP_STRING_PREFIX

See Also:

Constant Field Values

AMQP_UUID_PREFIX

public static final String AMQP_UUID_PREFIX

See Also:

Constant Field Values

AMQP_ULONG_PREFIX

public static final String AMQP_ULONG_PREFIX

See Also:

Constant Field Values

AMQP_BINARY_PREFIX

public static final String AMQP_BINARY_PREFIX

See Also:

Constant Field Values

AMQP_NO_PREFIX

public static final String AMQP_NO_PREFIX

See Also:

Constant Field Values

JMS_ID_PREFIX

public static final String JMS_ID_PREFIX

See Also:

Constant Field Values

Constructor Detail

AmqpMessageIdHelper

public AmqpMessageIdHelper()

Method Detail

hasMessageIdPrefix

public static boolean hasMessageIdPrefix(String string)

Checks whether the given string begins with "ID:" prefix used to denote a JMSMessageID

Parameters:

string - the string to check

Returns:

true if and only id the string begins with "ID:"

toMessageIdString

public static String toMessageIdString(Object idObject)

toCorrelationIdString

public static String toCorrelationIdString(Object idObject)

toIdObject

public static Object toIdObject(String origId)
                         throws IdConversionException

Takes the provided id string and return the appropriate amqp messageId style object. Converts the type based on any relevant encoding information found as a prefix.

Parameters:

origId - the object to be converted

Returns:

the amqp messageId style object

Throws:

IdConversionException - if the provided baseId String indicates an encoded type but can't be converted to that type.

convertHexStringToBinary

public static byte[] convertHexStringToBinary(String hexString)
                                       throws IllegalArgumentException

Convert the provided hex-string into a binary representation where each byte represents two characters of the hex string. The hex characters may be upper or lower case.

Parameters:

hexString - string to convert

Returns:

a byte array containing the binary representation

Throws:

IllegalArgumentException - if the provided String is a non-even length or contains non-hex characters

convertBinaryToHexString

public static String convertBinaryToHexString(byte[] bytes)

Convert the provided binary into a hex-string representation where each character represents 4 bits of the provided binary, i.e each byte requires two characters. The returned hex characters are upper-case.

Parameters:

bytes - binary to convert

Returns:

a String containing a hex representation of the bytes