Qpid Broker-J supports message conversion from one protocol into another. For example, when message is published with AMQP 0-9-1 and consumed using AMQP 1.0, the Broker takes care about converting the message from AMQP 0-9-1 format into AMQP 1.0. This page provides summary of how conversion from one protocol into another works.

Type conversion matrices

Various types can be used to set values of message properties and values in Map, List messages. The matrices below show how the types are converted. The red colour is used to highlight the types where conversion is unsupported yet. The orange/yellow colours are used to highlight the types for which conversion is implemented but the target type does not correspond to the original one even when protocol supports such type. The green colour is used to highlight the types where conversion is implemented into correct corresponding type on another protocol.

AMQP 0-8/0-9.x types conversion into AMQP 1.0 and AMQP 0-10

0-9.1 types \ 1-0 types	null	boolean	byte	short	int	long	float	double	char	binary	string	list	map
bit
short-string											X
long-string											X
timestamp						?
field-array												X
field-table													X
float							X
double								X
decimal (decimal-value)
void	X
boolean		X
byte (short-short-int)			X
unsigned byte (short-short-uint)			?
short (short-int)				X
unsigned short (short-uint)				?
integer (long-int)					X
unsigned integer (long-uint)					?
long (long-long-int)						X
unsigned long (long-long-unit)						?
binary *										X
ascii string *											X
wide string *											X
ascii character *									X

* types are not defined in 0-9.1/0-9/0-8 specifications

0-9.1/0-10	void	boolean	char	int8	int16	int32	int64	float	double	map	list	str16	vbin32
bit
short-string												X
long-string												X
timestamp							?
field-array											X
field-table										X
float								X
double									X
decimal (decimal-value)
void	X
boolean		X
byte (short-short-int)				X
unsigned byte(short-short-uint)				?
short (short-int)					X
unsigned short (short-uint)					?
integer (long-int)						X
unsigned integer (long-uint)						?
long (long-long-int)							X
unsigned long (long-long-unit)							?
binary *													X
ascii string *												X
wide string *												X
ascii character			X

* types are not defined in 0-9.1/0-9/0-8 specifications

AMQP 0-10 types conversion into AMQP 1.0 and AMQP 0-8/0-9.x

0-10 defines the following mandatory types: uint8, uint16, uint32, sequence-no, uint64, datetime, uuid, vbin8, str8, vbin16, str16, byte-ranges, sequence-set, vbin32,map, array, struct32, bit.

0-10 types \ 0-9-1 types	long-string	field-array	field-table	float	double	void	boolean	byte	short	int	long	binary	ascii char
bin8									?
int8								X
uint8									?
char													X
boolean							X
bin16										?
int16									X
uint16										?
bin32											?
int32										X
uint32											?
float				X
char-utf32										?
sequence-no
bin64											?
int64											X
uint64											?
double					X
datetime											?
bin128												X
uuid **
bin256												X
bin512												X
bin1024												X
bin40												X
dec32												?
bin72												X
dec64												?
void						X
bit												?
vbin8												X
str8-latin	?
str8	X
str8-utf16	X
vbin16												X
str16-latin	X
str16	X
str16-utf16	X
byte-ranges												?
sequence-se												?
vbin32												X
map			X*
list		X
array		X
struct32

X* - failure when conversion key with length > 255

** - UUID type is unsupported by AMQP 0-8/0-9.x. An exception is thrown on attempt to convert. Should it be converted into short string?

0-10 types \ 1-0 types	null	boolean	byte	short	int	long	float	double	char	uuid	binary	string	map	array
bin8				?
int8			X
uint8				?
char									X
boolean		X
bin16					?
int16				X
uint16					?
bin32						?
int32					X
uint32						?
float							X
char-utf32					?
sequence-no											?
bin64						?
int64						X
uint64						?
double								X
datetime						?
bin128											X
uuid										X
bin256											X
bin512											X
bin1024											X
bin40											X
dec32											?
bin72											X
dec64											?
void	X
bit											?
vbin8											X
str8-latin												X
str8												X
str8-utf16												X
vbin16											X
str16-latin												X
str16												X
str16-utf16												X
byte-ranges											?
sequence-se											?
vbin32												X
map													X
list														X
array														X
struct32

AMQP 1-0 types conversion into AMQP 0-10 and AMQP 0-8/0-9.x

1-0/0-9.1	long-string	field-array	field-table	float	double	void	boolean	byte	short	int	long	binary	ascii char
null						X
boolean							X
ubyte									?
ushort										?
uint											?
ulong											?
byte								X
short									X
int										X
long											X
float				X
double					X
decimal32
decimal64
decimal128
char													? ***
timestamp											?
uuid **
binary												X
string	X
symbol	X
list		X
map			X*
array		X

X* - exception on key length > 255

** - UUID type is unsupported by AMQP 0-8/0-9.x. An exception is thrown on attempt to convert. Should it be converted into short string?

? *** - char in 1-0 is a UTF-32BE encoded unicode character but char in 0-10 is an octet. Should it be converted into string?

1-0/0-10	void	boolean	char	int8	int16	int32	int64	float	double	map	list	uuid	str16	vbin32
null	X
boolean		X
ubyte				?
ushort					?
uint						?
ulong							?
byte				X
short					X
int						X
long							X
float								X
double									X
decimal32
decimal64
decimal128
char			?*
timestamp
uuid												X
binary														X
string													X
symbol													X
list											X
map										X
array											X

?* - char in 1-0 is a UTF-32BE encoded unicode character but char in 0-10 is an octet. It should be converted into char-utf32

Message properties conversion matrices

TODO

Message types conversion matrices