5.1. 管理连接工厂

5.1.1. 在配置文件中配置

在 APUSIC_MQ_HOME/config/jms.xml 文件中,每一个连接工厂配置信息对应一个connection-factory标记申明的xml元素,每个connection-factory元素可包含使用以下三种标记所申明的子元素:

description,可选标记,对此连接工厂的描述;

display-name,必须申明的标记,用于区别于其它连接工厂;

jndi-name,可选标记,通过JNDI,用于客户在服务器命名空间中查找此连接工厂;

实际应用中,当管理员为连接工厂分配JNDI名之后,消息客户即可使用JNDI在服务器的命名空间中对连接工厂进行查找并获得引用,之后通过连接工厂取得与 AMQ 的连接。

连接工厂的配置属性如下表:

属性描述值类型缺省值
pooled指定此连接工厂是否对其管理的连接使用连接池。“True”或“False”“False”
secure指定连接工厂所提供的连接是否使用安全的通讯方式。“True”或“False”“False”
anonymous是否授权匿名用户访问此连接工厂。“True”或“False”“True”
client-id由于标识连接客户状态的标识符,通常被用于Pub/Sub模型中的持久订阅(Durable subscription)。字符串,此属性是可选的
default-delivery-mode使用由此连接工厂生成的连接发送消息时,缺省的发送方式。“persistent”或“non-persistent”“non-persistent”
default-priority使用由此连接工厂生成的连接发送消息时,缺省的优先级。数字(0~9)“4”
default-time-to-live使用由此连接工厂生成的连接发送消息时,对于已发送的消息,消息系统保留此消息的缺省时间长度,单位为毫秒。整型0
min-pool-size此连接工厂对应的连接池中,所保持的最少连接数。整型5
max-pool-size此连接工厂对应的连接池中,所保持的最大连接数。整型30
idle-timeout连接等待超时时间。当连接池中的某个连接等待被使用的实际时间超过此属性数值时,连接池自动关闭此连接。整型,单位是秒300

5.1.2. 使用 AMQ 管理工具进行配置

通过管理工具可以对网络上任意的 AMQ 服务器的连接工厂进行管理和监控。进行配置时,配置完成之后,需要提交更新并重启该连接工厂才能使配置生效。

AMQ 管理工具

图 5.1.  AMQ 管理工具