第 3 章 在网络连接中配置消息传递协议

在使用前，您必须将协议与网络连接关联。（请参阅 第 2 章 在网络连接中配置接受器和连接器 来了解如何创建和配置网络连接。）位于文件 < broker_instance_dir>/etc/broker.xml 的默认配置包括已定义的多个连接。为方便起见，AMQ Broker 包括每个支持的协议的接受者，以及支持所有协议的默认接受者。

默认接受器概述

以下是 broker.xml 配置文件默认包括的 acceptors。

<configuration>
  <core>
    ...
    <acceptors>

      <!-- All-protocols acceptor -->
      <acceptor name="artemis">tcp://0.0.0.0:61616?tcpSendBufferSize=1048576;tcpReceiveBufferSize=1048576;protocols=CORE,AMQP,STOMP,HORNETQ,MQTT,OPENWIRE;useEpoll=true;amqpCredits=1000;amqpLowCredits=300</acceptor>

      <!-- AMQP Acceptor. Listens on default AMQP port for AMQP traffic -->
      <acceptor name="amqp">tcp://0.0.0.0:5672?tcpSendBufferSize=1048576;tcpReceiveBufferSize=1048576;protocols=AMQP;useEpoll=true;amqpCredits=1000;amqpLowCredits=300</acceptor>

      <!-- STOMP Acceptor -->
      <acceptor name="stomp">tcp://0.0.0.0:61613?tcpSendBufferSize=1048576;tcpReceiveBufferSize=1048576;protocols=STOMP;useEpoll=true</acceptor>

      <!-- HornetQ Compatibility Acceptor. Enables HornetQ Core and STOMP for legacy HornetQ clients. -->
      <acceptor name="hornetq">tcp://0.0.0.0:5445?anycastPrefix=jms.queue.;multicastPrefix=jms.topic.;protocols=HORNETQ,STOMP;useEpoll=true</acceptor>

      <!-- MQTT Acceptor -->
      <acceptor name="mqtt">tcp://0.0.0.0:1883?tcpSendBufferSize=1048576;tcpReceiveBufferSize=1048576;protocols=MQTT;useEpoll=true</acceptor>

    </acceptors>
    ...
  </core>
</configuration>

在给定网络连接器中启用协议的唯一要求是，将 protocol 参数添加到接受者的 URI 中。参数的值必须是用逗号分开的协议名称列表。如果 URI 中省略了 protocol 参数，则会启用所有协议。

例如，要创建一个使用 AMQP 协议在端口 3232 上接收消息的接受者，请按照以下步骤操作：

<acceptor name="ampq">tcp://0.0.0.0:3232?protocols=AMQP</acceptor>

默认接受器中的其他参数

在最小的 acceptor 配置中，您可以将协议指定为连接 URI 的一部分。但是，broker.xml 配置文件中的默认 acceptors 配置了一些额外的参数。下表详细介绍了为默认 acceptors 配置的额外参数。