第 12 章互操作性

本章讨论如何与其他 AMQ 组件结合使用 AMQ JavaScript。有关 AMQ 组件兼容性的概述，请参阅产品简介。

12.1. 与其他 AMQP 客户端互操作

AMQP 消息通过 AMQP 类型系统来构成。这种常见格式是不同语言的 AMQP 客户端能够相互互操作的原因之一。

发送消息时，AMQ JavaScript 会自动将语言原生类型转换为 AMQP 编码的数据。接收消息时，会进行反向转换。

注意

有关 AMQP 类型的更多信息，请参阅 Apache Qpid 项目维护的交互式类型参考。

表 12.1. AMQP 类型
AMQP 类型	描述
`null`	一个空值
`boolean`	true 或 false 值
`char`	单个 Unicode 字符
`string`	Unicode 字符序列
`binary`	字节序列
`byte`	签名的 8 位整数
`short`	签名的 16 位整数
`int`	签名的 32 位整数
`long`	签名的 64 位整数
`ubyte`	未签名的 8 位整数
`ushort`	未签名的 16 位整数
`uint`	未签名 32 位整数
`ulong`	未签名 64 位整数
`float`	32 位浮动点数
`double`	64 位浮动点数
`array`	单个类型值序列
`list`	变量类型的一系列值
`map`	从不同键到值的映射
`uuid`	通用唯一标识符
`symbol`	来自受限域的 7 位 ASCII 字符串
`timestamp`	绝对时间点

JavaScript 具有比 AMQP 可以编码的原生类型更少。要发送包含特定 AMQP 类型的消息，请使用 rhea/types.js 模块中的 wrap_ 功能。

表 12.2. 编码之前和解码之后的 AMQ JavaScript 类型
AMQP 类型	编码前 AMQ JavaScript 类型	解码后 AMQ JavaScript 类型
`null`	`null`	`null`
`boolean`	`boolean`	`boolean`
`char`	`wrap_char(number)`	`number`
`string`	`string`	`string`
`binary`	`wrap_binary(string)`	`string`
`byte`	`wrap_byte(number)`	`number`
`short`	`wrap_short(number)`	`number`
`int`	`wrap_int(number)`	`number`
`long`	`wrap_long(number)`	`number`
`ubyte`	`wrap_ubyte(number)`	`number`
`ushort`	`wrap_ushort(number)`	`number`
`uint`	`wrap_uint(number)`	`number`
`ulong`	`wrap_ulong(number)`	`number`
`float`	`wrap_float(number)`	`number`
`double`	`wrap_double(number)`	`number`
`array`	`wrap_array(Array, code)`	`Array`
`list`	`wrap_list(Array)`	`Array`
`map`	`wrap_map(object)`	`object`
`uuid`	`wrap_uuid(number)`	`number`
`symbol`	`wrap_symbol(string)`	`string`
`timestamp`	`wrap_timestamp(number)`	`number`

表 12.3. AMQ JavaScript 和其他 AMQ 客户端类型（2 中的 1 个）
编码前 AMQ JavaScript 类型	AMQ C++ 类型	AMQ .NET 类型
`null`	`nullptr`	`null`
`boolean`	`bool`	`System.Boolean`
`wrap_char(number)`	`wchar_t`	`System.Char`
`string`	`std::string`	`System.String`
`wrap_binary(string)`	`proton::binary`	`System.Byte[]`
`wrap_byte(number)`	`int8_t`	`System.SByte`
`wrap_short(number)`	`int16_t`	`System.Int16`
`wrap_int(number)`	`int32_t`	`System.Int32`
`wrap_long(number)`	`int64_t`	`System.Int64`
`wrap_ubyte(number)`	`uint8_t`	`System.Byte`
`wrap_ushort(number)`	`uint16_t`	`System.UInt16`
`wrap_uint(number)`	`uint32_t`	`System.UInt32`
`wrap_ulong(number)`	`uint64_t`	`System.UInt64`
`wrap_float(number)`	`float`	`System.Single`
`wrap_double(number)`	`double`	`System.Double`
`wrap_array(Array, code)`	-	-
`wrap_list(Array)`	`std::vector`	`Amqp.List`
`wrap_map(object)`	`std::map`	`Amqp.Map`
`wrap_uuid(number)`	`proton::uuid`	`System.Guid`
`wrap_symbol(string)`	`proton::symbol`	`Amqp.Symbol`
`wrap_timestamp(number)`	`proton::timestamp`	`System.DateTime`

表 12.4. AMQ JavaScript 和其他 AMQ 客户端类型（共 2 个）
编码前 AMQ JavaScript 类型	AMQ Python 类型	AMQ Ruby 类型
`null`	`None`	`nil`
`boolean`	`bool`	`true, false`
`wrap_char(number)`	`unicode`	`String`
`string`	`unicode`	`String`
`wrap_binary(string)`	`bytes`	`String`
`wrap_byte(number)`	`int`	`Integer`
`wrap_short(number)`	`int`	`Integer`
`wrap_int(number)`	`long`	`Integer`
`wrap_long(number)`	`long`	`Integer`
`wrap_ubyte(number)`	`long`	`Integer`
`wrap_ushort(number)`	`long`	`Integer`
`wrap_uint(number)`	`long`	`Integer`
`wrap_ulong(number)`	`long`	`Integer`
`wrap_float(number)`	`float`	`Float`
`wrap_double(number)`	`float`	`Float`
`wrap_array(Array, code)`	`proton.Array`	`Array`
`wrap_list(Array)`	`list`	`Array`
`wrap_map(object)`	`dict`	`Hash`
`wrap_uuid(number)`	-	-
`wrap_symbol(string)`	`str`	`Symbol`
`wrap_timestamp(number)`	`long`	`Time`

学习

尝试、购买和销售

社区

关于红帽文档

通过我们的产品和服务，以及可以信赖的内容，帮助红帽用户创新并实现他们的目标。

让开源更具包容性

红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。欲了解更多详情，请参阅红帽博客.

關於紅帽

我们提供强化的解决方案，使企业能够更轻松地跨平台和环境（从核心数据中心到网络边缘）工作。

© 2024 Red Hat, Inc.