亚洲AV成人精品一区二区三区,亚洲狠狠成人综合网,国产精品亚洲一区二区在线观看

ActiveMQ in Action(7)

�C�物 — Wed, 01 Sep 2010 14:29:00 GMT

2�Q?�Q? Wildcards
Wildcards用来支持联合的名字分层体�p�（federated name hierarchies�Q�。它不是JMS规范的一部分�Q�而是ActiveMQ的扩展。ActiveMQ支持以下三种wildcards�Q?/p>

"." 用于作�ؓ路径上名字间的分隔符�?/li>
"*" 用于匚w��路径上的��M��名字�?/li>
">" 用于递归地匹配�Q何以�q�个名字开始的destination�?/li>

作�ؓ一�U�组�l�事件和订阅感兴��那部分信息的一�U�方法，�q�个概念在金融市场领域已�l�流行了一�D�|��间了。设想你有以下两个destination�Q?/p>

PRICE.STOCK.NASDAQ.IBM �Q�IBM在NASDAQ的股��P��
PRICE.STOCK.NYSE.SUNW �Q�SUN在纽�U�证�怺�易所的股��P��

订阅者可以明��地指定destination的名字来订阅消息�Q�或者它也可以��用wildcards来定义一个分层的模式来匹配它希望订阅的destination。例如：

Subscription	Meaning
PRICE.>	Any price for any product on any exchange
PRICE.STOCK.>	Any price for a stock on any exchange
PRICE.STOCK.NASDAQ.*	Any stock price on NASDAQ
PRICE.STOCK.*.IBM	Any IBM stock price on any exchange

2�Q?�Q? Async Sends
ActiveMQ支持以同步（sync�Q�方式或者异步（async�Q�方式向broker发送消息�?使用何种方式对send�Ҏ��的�g�q�有巨大的媄响。对于生产者来��_��既然延迟是决定吞吐量的重要因素，那么使用异步发送方式会极大地提高系�l�的性能�?br /> ActiveMQ�~�省使用异步传输方式。但是按照JMS规范�Q�当在事务外发送持久化消息的时候，ActiveMQ会强制��用同步发送方式。在�q�种情况下，每一�ơ发送都是同步的�Q�而且��d��到收到broker的应�{�。这个应�{�保证了broker已经成功地将消息持久化，而且不会丢失。但是这样作也严重地影响�? 性能�?br /> 如果你的�pȝ��可以容忍��量的消息丢失，那么可以在事务外发送持久消息的时候，选择使用异步方式。以下是几种不同的配�|�方式：

Java代码

cf = new ActiveMQConnectionFactory( "tcp://locahost:61616?jms.useAsyncSend=true" );
((ActiveMQConnectionFactory)connectionFactory).setUseAsyncSend(true);
((ActiveMQConnection)connection).setUseAsyncSend(true);

2�Q?�Q? Dispatch Policies
2�Q?�Q?�Q? Round Robin Dispatch Policy
�?�Q?�Q?��节介绍�q�ActiveMQ的prefetch机制�Q�ActiveMQ的缺省参数是针对处理大量消息时的高性能和高吞吐量而设�|�的。所以缺�? 的prefetch参数比较大，而且�~�省的dispatch policies会尝试尽可能快的填满prefetch�~�冲。然而在有些情况下，例如只有��量的消息而且单个消息的处理时间比较长�Q�那么在�~�省�? prefetch和dispatch policies下，�q�些��量的消息��L��們֐�于被分发��C��别的consumer上。这样就会因��载的不均衡分配而导致处理时间的增加�?br /> Round robin dispatch policy会尝试��^均分发消息，以下是ActiveMQ配置文�g的一个例子：

Xml代码

< destinationPolicy >
<policyMap>
<policyEntries>
<policyEntry topic="FOO.>">
<dispatchPolicy>
<roundRobinDispatchPolicy />
dispatchPolicy>
policyEntry>
policyEntries>
policyMap>
destinationPolicy >

2�Q?�Q?�Q? Strict Order Dispatch Policy
有时候需要保证不同的topic consumer以相同的��序接收消息。通常ActiveMQ会保证topic consumer以相同的��序接收来自同一个producer的消息。然而，�׃��多线�E�和异步处理�Q�不同的topic consumer可能会以不同的顺序接收来自不同producer的消息。例如有两个producer�Q�分别是P和Q。差不多是同一旉��内，P发送了 P1、P2和P3三个消息�Q�Q发送了Q1和Q2两个消息。两个不同的consumer可能会以以下��序接收到消息：

   consumer1: P1 P2 Q1 P3 Q2
    consumer2: P1 Q1 Q2 P2 P3
    Strict order dispatch policy 会保证每个topic consumer会以相同的顺序接收消息，代�h是性能上的损失。以下是采用了strict order dispatch policy后，两个不同的consumer可能以以下的��序接收消息�Q?br />    consumer1: P1 P2 Q1 P3 Q2
    consumer2: P1 P2 Q1 P3 Q2

以下是ActiveMQ配置文�g的一个例子：

Xml代码

< destinationPolicy >
<policyMap>
<policyEntries>
<policyEntry topic=""FOO.>">
<dispatchPolicy>
<strictOrderDispatchPolicy />
dispatchPolicy>
policyEntry>
policyEntries>
policyMap>
destinationPolicy >

2�Q?�Q?0 Message Cursors
当producer发送的持久化消息到达broker之后�Q�broker首先会把它保存在持久存储中。接下来�Q�如果发现当前有�z�跃的consumer�Q��? 且这个consumer消费消息的速度能跟上producer生��消息的速度�Q�那么ActiveMQ会直接把消息传递给broker内部跟这�? consumer兌��的dispatch queue�Q�如果当前没有活跃的consumer或者consumer消费消息的速度跟不上producer生��消息的速度�Q�那么ActiveMQ会��? Pending Message Cursors保存�Ҏ��息的引用。在需要的时候，Pending Message Cursors把消息引用传递给broker内部跟这个consumer兌��的dispatch queue。以下是两种Pending Message Cursors�Q?/p>

VM Cursor。在内存中保存消息的引用�?/li>
File Cursor。首先在内存中保存消息的引用�Q�如果内存��用量辑ֈ�上限�Q�那么会把消息引用保存到临时文�g中�?/li>

在缺省情况下�Q�ActiveMQ 5.0�Ҏ��使用的Message Store来决定��用何�U�类型的Message Cursors�Q�但是你可以�Ҏ��destination来配�|�Message Cursors�?/p> 对于topic�Q�可以��用的pendingSubscriberPolicy 有vmCursor和fileCursor。可以��用的PendingDurableSubscriberMessageStoragePolicy�? vmDurableCursor �?fileDurableSubscriberCursor。以下是ActiveMQ配置文�g的一个例子：

Xml代码

<destinationPolicy>
<policyMap>
<policyEntries>
<policyEntry topic="org.apache.>">
<pendingSubscriberPolicy>
<vmCursor />
pendingSubscriberPolicy>
<PendingDurableSubscriberMessageStoragePolicy>
<vmDurableCursor/>
PendingDurableSubscriberMessageStoragePolicy>
policyEntry>
policyEntries>
policyMap>
destinationPolicy>

对于queue�Q�可以��用的pendingQueuePolicy有vmQueueCursor �?fileQueueCursor。以下是ActiveMQ配置文�g的一个例子：

Xml代码

<destinationPolicy>
<policyMap>
<policyEntries>
<policyEntry queue="org.apache.>">
<pendingQueuePolicy>
<vmQueueCursor />
pendingQueuePolicy>
policyEntry>
policyEntries>
policyMap>
destinationPolicy>

2�Q?�Q?1 Optimized Acknowledgement
ActiveMQ�~�省支持扚w��认消息。由于批量确认会提高性能�Q�因此这是缺省的��认方式。如果希望在应用�E�序中禁止经�q�优化的��认方式�Q�那么可以采用如下方法：

Java代码

cf = new ActiveMQConnectionFactory ("tcp://locahost:61616?jms.optimizeAcknowledge=false");
((ActiveMQConnectionFactory)connectionFactory).setOptimizeAcknowledge(false);
((ActiveMQConnection)connection).setOptimizeAcknowledge(false);

2�Q?�Q?2 Producer Flow Control
同步发送消息的producer会自动��用producer flow control �Q�对于异步发送消息的producer�Q�要使用producer flow control�Q�你先要为connection配置一个ProducerWindowSize参数�Q�如下：

Java代码

((ActiveMQConnectionFactory)cf).setProducerWindowSize(1024000);

ProducerWindowSize是producer在发送消息的�q�程中，收到broker对于之前发送消息的��认之前�Q?能够发送消息的最大字节数。你也可以禁用producer flow control�Q�以下是ActiveMQ配置文�g的一个例子：

Java代码

"FOO.>" producerFlowControl="false">

2�Q?�Q?3 Message Transformation
有时候需要在JMS provider内部�q�行message的�{换。从4.2版本��P��ActiveMQ 提供了一个MessageTransformer 接口用于�q�行消息转换�Q�如下：

Java代码

public interface MessageTransformer {
Message producerTransform(Session session, MessageProducer producer, Message message) throws JMSException;
Message consumerTransform(Session session, MessageConsumer consumer, Message message)throws JMSException;
}

通过在以下对象上通过调用setTransformer�Ҏ��来设�|�MessageTransformer�Q?ul>

ActiveMQConnectionFactory

ActiveMQConnection

ActiveMQSession

ActiveMQMessageConsumer

ActiveMQMessageProducer

MessageTransformer接口支持�Q?

在消息被发送到JMS provider的消息�ȝ��前进行�{换。通过producerTransform�Ҏ��?/li>
在消息到达消息�ȝ��后，但是在consumer接收到消息前�q�行转换。通过consumerTransform�Ҏ��?/li>

以下是个��单的例子�Q� �?

Java代码

public class SimpleMessage implements Serializable {
//
private static final long serialVersionUID = 2251041841871975105L;
//
private String id;
private String text;
public String getId() {
return id;
}
public void setId(String id) {
this.id = id;
}
public String getText() {
return text;
}
public void setText(String text) {
this.text = text;
}
}

在producer内发送ObjectMessage�Q�如下：

Java代码

SimpleMessage sm = new SimpleMessage();
sm.setId("1");
sm.setText("this is a sample message");
ObjectMessage message = session.createObjectMessage();
message.setObject(sm);
producer.send(message);

在consumer的session上设�|�一个MessageTransformer用于��ObjectMessage转换成TextMessage�Q�如下：

Java代码

((ActiveMQSession)session).setTransformer(new MessageTransformer() {
public Message consumerTransform(Session session, MessageConsumer consumer, Message message) throws JMSException {
ObjectMessage om = (ObjectMessage)message;
XStream xstream = new XStream();
xstream.alias("simple message", SimpleMessage.class);
String xml = xstream.toXML(om.getObject());
return session.createTextMessage(xml);
}
public Message producerTransform(Session session, MessageProducer consumer, Message message) throws JMSException {
return null;
}
});

�C�物 2010-09-01 22:29 发表评论

ActiveMQ in Action(6)

�C�物 — Wed, 01 Sep 2010 14:28:00 GMT

2�Q? Features
ActiveMQ包含了很多功能强大的�Ҏ��，下面��要介�l�其中的几个�?br />2�Q?�Q? Exclusive Consumer
Queue中的消息是按照顺序被分发到consumers的。然而，当你有多个consumers同时从相同的queue中提取消息时�Q�你��失去这个保证。因��些消息是被多个线�E��ƈ发的处理。有的时候，保证消息按照��序处理是很重要的。例如，你可能不希望在插入订单操作结束之前执行更新这个订单的�? 作�?br /> ActiveMQ�?.x版本起开始支持Exclusive Consumer �Q�或者说Exclusive Queues�Q��? Broker会从多个consumers中挑选一个consumer来处理queue中所有的消息�Q�从而保证了消息的有序处理。如果这个consumer 失效�Q�那么broker会自动切换到其它的consumer�?br /> 可以通过Destination Options 来创��Z��个Exclusive Consumer�Q�如下：

Java代码

queue = new ActiveMQQueue( "TEST.QUEUE?consumer.exclusive=true" );
consumer = session.createConsumer(queue);

��Z��说一下，可以�l�consumer讄��优先�U�，以便针对�|�络情况�Q�如network hops�Q�进行优化，如下�Q?div class="dp-highlighter">

Java代码

queue = new ActiveMQQueue("TEST.QUEUE?consumer.exclusive=true &consumer.priority=10");

2�Q?�Q? Message Groups
用Apache官方文档的话��_��Message Groups rock�Q�它是Exclusive Consumer功能的增强。逻辑上，Message Groups 可以看成是一�U��ƈ发的Exclusive Consumer。跟所有的消息都由唯一的consumer处理不同�Q�JMS 消息属性JMSXGroupID 被用来区分message group。Message Groups�Ҏ��保证所有具有相同JMSXGroupID 的消息会被分发到相同的consumer�Q�只要这个consumer保持active�Q�。另外一斚w��Q�Message Groups�Ҏ��也是一�U�负载均衡的机制�?br /> 在一个消息被分发到consumer之前�Q�broker首先��查消息JMSXGroupID属性。如果存在，那么broker 会检查是否有某个consumer拥有�q�个message group。如果没有，那么broker会选择一个consumer�Q��ƈ��它兌��到这个message group。此后，�q�个consumer会接收这个message group的所有消息，直到�Q?/p>

Consumer被关闭�?/li>
Message group被关闭。通过发送一个消息，�q�设�|�这个消息的JMSXGroupSeq�?�?/li>

�?.1版本开始，ActiveMQ支持一个布��字�D�JMSXGroupFirstForConsumer 。当某个message group的第一个消息被发送到consumer的时候，�q�个字段被设�|�。如果客户��用failover transport�q�接到broker。在�׃��|�络问题�{�造成客户重新�q�接到broker的时候，相同message group的消息可能会被分发到不同与之前的consumer�Q�因此JMSXGroupFirstForConsumer字段也会被重新设�|�。�?

以下是��用message groups的例子：

Java代码

Mesasge message = session.createTextMessage("hey");
message.setStringProperty("JMSXGroupID", "IBM_NASDAQ_20/4/05");
...
producer.send(message);

2�Q?�Q? JMS Selectors
JMS Selectors用于在订阅中�Q�基于消息属性对�q�行消息的过滤。JMS Selectors由SQL92语法定义。以下是个Selectors的例子：

Java代码

consumer = session.createConsumer(destination, "JMSType = 'car' AND weight > 2500");

在JMS Selectors表达式中�Q�可以��用IN、NOT IN、LIKE�{�，例如�Q?br /> LIKE '12%3' �Q?123' true�Q?12993' true�Q?1234' false�Q?br /> LIKE 'l_se' �Q?lose' true�Q?loose' false�Q?br /> LIKE '\_%' ESCAPE '\' �Q?_foo' true�Q?foo' false�Q?br /> 需要注意的是，JMS Selectors表达式中的日期和旉��需要��用标准的long型毫�U�倹{��另外表辑ּ�中的属性不会自动进行类型�{换，例如�Q?br />

Java代码

myMessage.setStringProperty("NumberOfOrders", "2");

"NumberOfOrders > 1" 求值结果是false。关于JMS Selectors的详�l�文档请参考javax.jms.Message的javadoc�?br /> 上一��节介绍的Message Groups虽然可以保证��h��相同message group的消息被唯一的consumer��序处理�Q�但是却不能��定被哪个consumer处理。在某些情况下，Message Groups可以和JMS Selector一起工作，例如�Q?br /> 设想有三个consumers分别是A、B和C。你可以在producer中�ؓ消息讄��三个message groups分别�?A"�?B"�?C"。然后��oconsumer A使用"JMXGroupID = 'A'"作�ؓselector。B和C也同理。这样就可以保证message group A的消息只被consumer A处理。需要注意的是，�q�种做法有以下缺点：

producer必须知道当前正在�q�行的consumers�Q�也��是说producer和consumer被耦合��C��赗��?/li>
如果某个consumer失效�Q�那么应该被�q�个consumer消费的消息将会一直被�U�压在broker上�?/li>

2�Q?�Q? Pending Message Limit Strategy
    首先��要介�l�一下prefetch机制。ActiveMQ通过prefetch机制来提高性能�Q�这意味�q�客��L��的内存里可能会缓存一定数量的消息。缓存消息的数量由prefetch limit来控制。当某个consumer的prefetch buffer已经辑ֈ�上限�Q�那么broker不会再向consumer分发消息�Q�直到consumer向broker发送消息的��认。可以通过�? ActiveMQConnectionFactory或者ActiveMQConnection上设�|�ActiveMQPrefetchPolicy对象来配�|�prefetch policy。也可以通过connection options或者destination options来配�|�。例如：
    tcp://localhost:61616?jms.prefetchPolicy.all=50
    tcp://localhost:61616?jms.prefetchPolicy.queuePrefetch=1
    queue = new ActiveMQQueue("TEST.QUEUE?consumer.prefetchSize=10");
    prefetch size的缺省值如下：

persistent queues (default value: 1000)
non-persistent queues (default value: 1000)
persistent topics (default value: 100)
non-persistent topics (default value: Short.MAX_VALUE -1)

慢消费者会在非持久的topics上导致问题：一旦消息积压�v来，会导致broker把大量消息保存在内存中，broker也会因此而变慢。未�? ActiveMQ可能会实现磁盘缓存，但是�q�也�q�是会存在性能问题。目前ActiveMQ使用Pending Message Limit Strategy来解册��个问题。除了prefetch buffer之外�Q�你�q�要配置�~�存消息的上限，��过�q�个上限后，新消息到来时会丢弃旧消息。通过在配�|�文件的destination map中配�|�PendingMessageLimitStrategy�Q�可以�ؓ不用的topic namespace配置不同的策略。目前有以下两种�Q?/p>

ConstantPendingMessageLimitStrategy。这个策略��用常量限制�?br />例如�Q?lt;constantPendingMessageLimitStrategy limit="50"/>
PrefetchRatePendingMessageLimitStrategy。这个策略��用prefetch size的倍数限制�?br />例如�Q?lt;prefetchRatePendingMessageLimitStrategy multiplier="2.5"/>

在以上两�U�方式中�Q�如果设�|?意味着除了prefetch之外不再�~�存消息�Q�如果设�|?1意味着��止丢弃消息。�?
此外�Q�你�q�可以配�|�消息的丢弃�{�略�Q�目前有以下两种�Q?/p>

oldestMessageEvictionStrategy。这个策略丢弃最旧的消息�?/li>
oldestMessageWithLowestPriorityEvictionStrategy。这个策略丢弃最旧的�Q�而且��h��最低优先��的消息�?/li>

以下是个ActiveMQ配置文�g的例子：

Xml代码

<broker persistent="false" brokerName="${brokername}" xmlns="http://activemq.org/config/1.0">
<destinationPolicy>
<policyMap>
<policyEntries>
<policyEntry topic="PRICES.>">
<subscriptionRecoveryPolicy>
<timedSubscriptionRecoveryPolicy recoverDuration="10000" />
subscriptionRecoveryPolicy>
<pendingMessageLimitStrategy>
<constantPendingMessageLimitStrategy limit="10"/>
pendingMessageLimitStrategy>
policyEntry>
policyEntries>
policyMap>
destinationPolicy>
...
broker>

2�Q?�Q? Composite Destinations
�?.1版本�? ActiveMQ支持composite destinations。它允许用一个虚拟的destination 代表多个destinations。例如你可以通过composite destinations在一个操作中同时�?2个queue发送消息。在composite destinations中，多个destination之间采用","分割。例如：

Java代码

Queue queue = new ActiveMQQueue("FOO.A,FOO.B,FOO.C");

如果你希望��用不同类型的destination�Q�那么需要加上前�~�如queue:// 或topic://�Q�例如：

Java代码

Queue queue = new ActiveMQQueue("FOO.A,topic://NOTIFY.FOO.A");

以下是ActiveMQ配置文�g�q�行配置的一个例子：

Xml代码

<destinationInterceptors>
<virtualDestinationInterceptor>
<virtualDestinations>
<compositeQueue name="MY.QUEUE">
<forwardTo>
<queue physicalName="FOO" />
<topic physicalName="BAR" />
forwardTo>
compositeQueue>
virtualDestinations>
virtualDestinationInterceptor>
destinationInterceptors>

可以在�{发前�Q�先通过JMS Selector判断一个消息是否需要�{发，例如�Q?/p>

Xml代码

<destinationInterceptors>
<virtualDestinationInterceptor>
<virtualDestinations>
<compositeQueue name="MY.QUEUE">
<forwardTo>
<filteredDestination selector="odd = 'yes'" queue="FOO"/>
<filteredDestination selector="i = 5" topic="BAR"/>
forwardTo>
compositeQueue>
virtualDestinations>
virtualDestinationInterceptor>
destinationInterceptors>

2�Q?�Q? Mirrored Queues
每个queue中的消息只能被一个consumer消费。然而，有时候你可能希望能够监视生��者和消费者之间的消息��。你可以通过使用Virtual Destinations 来徏立一个virtual queue 来把消息转发到多个queues中。但�? 为系�l�中每个queue都进行如此的配置可能会很�ȝ��?
ActiveMQ支持Mirrored Queues。Broker会把发送到某个queue的所有消息�{发到一个名�U�类似的topic�Q�因此监控程序可以订阅这个mirrored queue topic。�ؓ了启用Mirrored Queues�Q�首先要��BrokerService的useMirroredQueues属性设�|�成true�Q�然后可以通过 destinationInterceptors讄��其它属性，如mirror topic的前�~��Q�缺省是"VirtualTopic.Mirror."。以下是ActiveMQ配置文�g的一个例子：

Xml代码

<broker xmlns="http://activemq.org/config/1.0" brokerName="MirroredQueuesBroker1" useMirroredQueues="true">
<transportConnectors>
<transportConnector uri="tcp://localhost:61616"/>
transportConnectors>
<destinationInterceptors>
<mirroredQueue copyMessage = "true" prefix="Mirror.Topic"/>
destinationInterceptors>
...
broker>

假如某个producer向名为Foo.Bar的queue中发送消息，那么你可以通过订阅名�ؓMirror.Topic.Foo.Bar的topic来获得发送到Foo.Bar中的所有消息�?img src ="http://m.tkk7.com/libin2722/aggbug/330629.html" width = "1" height = "1" />

�C�物 2010-09-01 22:28 发表评论

ActiveMQ in Action(4)

�C�物 — Wed, 01 Sep 2010 14:27:00 GMT

2�Q? Security
ActiveMQ支持可插拔的安全机制�Q�用以在不同的provider之间切换�?br />2�Q?�Q? Simple Authentication Plugin
Simple Authentication Plugin适用于简单的认证需求，或者用于徏立测试环境。它允许在XML配置文�g中指定用戗��用��L��和密码等信息。以下是ActiveMQ配置的一个例子：

Xml代码

< plugins >
...
<simpleAuthenticationPlugin>
<users>
<authenticationUser username="system" password="manager" groups="users,admins"/>
<authenticationUser username="user" password="password" groups="users"/>
<authenticationUser username="guest" password="password" groups="guests"/>
users>
simpleAuthenticationPlugin>
plugins >

2�Q?�Q? JAAS Authentication Plugin
JAAS Authentication Plugin依赖标准的JAAS机制来实现认证。通常情况下，你需要通过讄��java.security.auth.login.config�pȝ��属性来配置login modules的配�|�文件。如果没有指定这个系�l�属性，那么JAAS Authentication Plugin会缺省��用login.config作�ؓ文�g名。以下是一个login.config文�g的例子：

activemq-domain {
org.apache.activemq.jaas.PropertiesLoginModule required debug=true org.apache.activemq.jaas.properties.user="users.properties" org.apache.activemq.jaas.properties.group="groups.properties";
};
�q�个login.config文�g中设�|�了两个属性：org.apache.activemq.jaas.properties.user�? org.apache.activemq.jaas.properties.group分别用来指向user.properties�? group.properties文�g。需要注意的是，PropertiesLoginModule使用本地文�g的查找方式，而且查找旉��用的base directory是login.config文�g所在的目录。因此这个login.config说明user.properties�? group.properties文�g存放在跟login.config文�g相同的目录里�?br /> 以下是ActiveMQ配置的一个例子：

Xml代码

< plugins >
...
<jaasAuthenticationPlugin configuration="activemq-domain" />
plugins >

��Z��以上的配�|�，在JAAS的LoginContext中会使用activemq-domain中配�|�的PropertiesLoginModule来进行登陆�?br /> ActiveMQ JAAS�q�支持LDAPLoginModule、CertificateLoginModule、TextFileCertificateLoginModule�{�login module�?/p>

2�Q?�Q? Custom Authentication Implementation
可以通过�~�码的方式�ؓActiveMQ增加认证功能。例如编写一个类�l�承自XBeanBrokerService�?

Java代码

package com.yourpackage;
import java.net.URI;
import java.util.HashMap;
import java.util.Map;
import org.apache.activemq.broker.Broker;
import org.apache.activemq.broker.BrokerFactory;
import org.apache.activemq.broker.BrokerService;
import org.apache.activemq.security.SimpleAuthenticationBroker;
import org.apache.activemq.xbean.XBeanBrokerService;
public class SimpleAuthBroker extends XBeanBrokerService {
//
private String user;
private String password;
@SuppressWarnings("unchecked")
protected Broker addInterceptors(Broker broker) throws Exception {
broker = super.addInterceptors(broker);
Map passwords = new HashMap();
passwords.put(getUser(), getPassword());
broker = new SimpleAuthenticationBroker(broker, passwords, new HashMap());
return broker;
}
public String getUser() {
return user;
}
public void setUser(String user) {
this.user = user;
}
public String getPassword() {
return password;
}
public void setPassword(String password) {
this.password = password;
}
}

以下是ActiveMQ配置文�g的一个例子：

Xml代码

<beans>
… �?/span>
<auth:SimpleAuthBroker
xmlns:auth="java://com.yourpackage"
xmlns="http://activemq.org/config/1.0" brokerName="SimpleAuthBroker1" user="user" password="password" useJmx="true">
<transportConnectors>
<transportConnector uri="tcp://localhost:61616"/>
transportConnectors>
auth:SimpleAuthBroker>
… �?/span>
beans>

在这个配�|�文件中增加了一个namespace auth�Q�用于指向之前编写的哪个�c�R��同时�ؓSimpleAuthBroker注入了两个属性值user和password�Q�因此在�? SimpleAuthBroker改写的addInterceptors�Ҏ��里，可以使用�q�两个属性进行认证了。ActiveMQ提供�? SimpleAuthenticationBroker�cȝ��承自BrokerFilter�Q�可以简单的看成是Broker的Adaptor�Q�，它的构造函 ��C��的两个Map分别是userPasswords和userGroups�?SimpleAuthenticationBroker�? addConnection�Ҏ��中��用userPasswords�q�行认证�Q�同时会把userGroups的信息保存到 ConnectionContext�?�?/p>

2�Q?�Q? Authorization Plugin
可以通过Authorization Plugin��证后的用��h��权，以下ActiveMQ配置文�g的一个例子：

Xml代码

<plugins>
<jaasAuthenticationPlugin configuration="activemq-domain"/>
<authorizationPlugin>
<map>
<authorizationMap>
<authorizationEntries>
<authorizationEntry queue=">" read="admins" write="admins" admin="admins" />
<authorizationEntry queue="USERS.>" read="users" write="users" admin="users" />
<authorizationEntry queue="GUEST.>" read="guests" write="guests,users" admin="guests,users" />
<authorizationEntry topic=">" read="admins" write="admins" admin="admins" />
<authorizationEntry topic="USERS.>" read="users" write="users" admin="users" />
<authorizationEntry topic="GUEST.>" read="guests" write="guests,users" admin="guests,users" />
<authorizationEntry topic="ActiveMQ.Advisory.>" read="guests,users" write="guests,users" admin="guests,users"/>
authorizationEntries>
authorizationMap>
map>
authorizationPlugin>
plugins>

�C�物 2010-09-01 22:27 发表评论

ActiveMQ in Action(5)

�C�物 — Wed, 01 Sep 2010 14:27:00 GMT

2�Q? Clustering
ActiveMQ从多�U�不同的斚w��提供了集��的支持�?br />2�Q?�Q? Queue consumer clusters
ActiveMQ支持订阅同一个queue的consumers上的集群。如果一个consumer失效�Q�那么所有未被确�? �Q�unacknowledged�Q�的消息都会被发送到�q�个queue上其它的consumers。如果某个consumer的处理速度比其�? consumers更快�Q�那么这个consumer��׃��消费更多的消息�?br /> 需要注意的是，�W�者发现AcitveMQ5.0版本的Queue consumer clusters存在一个bug�Q�采用AMQ Message Store�Q�运行一个producer�Q�两个consumer�Q��ƈ采用如下的配�|�文�Ӟ��

Xml代码

< beans >
<broker xmlns="http://activemq.org/config/1.0" brokerName="BugBroker1" useJmx="true">
<transportConnectors>
<transportConnector uri="tcp://localhost:61616"/>
transportConnectors>
<persistenceAdapter>
<amqPersistenceAdapter directory="activemq-data/BugBroker1" maxFileLength="32mb"/>
persistenceAdapter>
broker>
beans >

那么�l�过一�D�|��间后可能会报出如下错误：
ERROR [ActiveMQ Transport: tcp:///127.0.0.1:1843 - RecoveryListenerAdapter.java:58 - RecoveryListenerAdapter] Message id ID:versus-1837-1203915536609-0:2:1:1:419 could not be recovered from the data store!
Apache官方文档��_��此bug已经被修正，预定�?.1.0版本上体现�?/p>

2�Q?�Q? Broker clusters
一个常见的场景是有多个JMS broker�Q�有一个客戯��接到其中一个broker。如果这个broker失效�Q�那么客户会自动重新�q�接到其它的broker。在ActiveMQ中�� 用failover:// 协议来实现这个功能。ActiveMQ3.x版本的reliable://协议已经变更为failover://�?br /> 如果某个�|�络上有多个brokers而且客户使用静态发玎ͼ�使用Static Transport或Failover Transport�Q�或动态发玎ͼ�使用Discovery Transport�Q�，那么客户可以�Ҏ��地在某个broker失效的情况下切换到其它的brokers。然而，stand alone brokers�q�不了解其它brokers上的consumers�Q�也��是说如果某个broker上没有consumers�Q�那么这个broker上的�? 息可能会因得不到处理而积压�v来。目前的解决�Ҏ��是��用Network of brokers�Q�以便在broker之间存储转发消息。ActiveMQ在未来会有更好的�Ҏ��，用来在客��L��处理�q�个问题�?br /> 从ActiveMQ1.1版本��P��ActiveMQ支持networks of brokers。它支持分布式的queues和topics。一个broker会相同对待所有的订阅�Q�subscription�Q�：不管他们是来自本地的客户�q�接�Q�还是来自远�E�broker�Q�它都会递送有关的消息拯��到每个订阅。远�E�broker得到�q�个消息拯��后，会依�ơ把它递送到其内部的本地�q�接上�? 有两�U�方式配�|�Network of brokers�Q�一�U�是使用static transport�Q�如下：

Xml代码

< broker brokerName = "receiver" persistent = "false" useJmx = "false" >
<transportConnectors>
<transportConnector uri="tcp://localhost:62002"/>
transportConnectors>
<networkConnectors>
<networkConnector uri="static:( tcp://localhost:61616,tcp://remotehost:61616)"/>
networkConnectors>
… �?/span>
broker >

另外一�U�是使用multicast discovery�Q�如下：

Xml代码

<broker name="sender" persistent="false" useJmx="false">
<transportConnectors>
<transportConnector uri="tcp://localhost:0" discoveryUri="multicast://default"/>
transportConnectors>
<networkConnectors>
<networkConnector uri="multicast://default"/>
networkConnectors>
...
broker>

Network Connector有以下属性：

Property	Default Value	Description
name	bridge	name of the network - for more than one network connector between the same two brokers - use different names
dynamicOnly	false	if true, only forward messages if a consumer is active on the connected broker
decreaseNetworkConsumerPriority	false	decrease the priority for dispatching to a Queue consumer the further away it is (in network hops) from the producer
networkTTL	1	the number of brokers in the network that messages and subscriptions can pass through
conduitSubscriptions	true	multiple consumers subscribing to the same destination are treated as one consumer by the network
excludedDestinations	empty	destinations matching this list won't be forwarded across the network
dynamicallyIncludedDestinations	empty	destinations that match this list will be forwarded across the network n.b. an empty list means all destinations not in the excluded list will be forwarded
staticallyIncludedDestinations	empty	destinations that match will always be passed across the network - even if no consumers have ever registered an interest
duplex	false	if true, a network connection will be used to both produce AND Consume messages. This is useful for hub and spoke scenarios when the hub is behind a firewall etc.

关于conduitSubscriptions属性，�q�里�E�稍说明一下。设��x��两个brokers�Q�分别是brokerA和brokerB�Q�它们之间用 forwarding bridge�q�接。有一个consumer�q�接到brokerA�q�订阅queue�Q�Q.TEST。有两个consumers�q�接到brokerB�Q�也是订阅queue�Q�Q.TEST。这三个consumers有相同的优先�U�。然后启动一个producer�Q�它发送了30条消息到brokerA。如�? conduitSubscriptions=true�Q�那么brokerA上的consumer会得�?5条消息，另外15条消息会发送给brokerB。此时负载�ƈ不均衡，因�ؓ此时brokerA��brokerB上的两个consumers视�ؓ一个；如果 conduitSubscriptions=false�Q�那么每个consumer上都会收�?0条消息。以下是关于NetworkConnector�? 性的一个例子：

Xml代码

<networkConnectors>
<networkConnector uri="static://(tcp://localhost:61617)"
name="bridge" dynamicOnly="false" conduitSubscriptions="true"
decreaseNetworkConsumerPriority="false">
<excludedDestinations>
<queue physicalName="exclude.test.foo"/>
<topic physicalName="exclude.test.bar"/>
excludedDestinations>
<dynamicallyIncludedDestinations>
<queue physicalName="include.test.foo"/>
<topic physicalName="include.test.bar"/>
dynamicallyIncludedDestinations>
<staticallyIncludedDestinations>
<queue physicalName="always.include.queue"/>
<topic physicalName="always.include.topic"/>
staticallyIncludedDestinations>
networkConnector>
networkConnectors>

2�Q?�Q? Master Slave
在一个网�l�内�q�行多个brokers或者stand alone brokers时存在一个问题，�q�就是消息在物理上只被一个broker持有�Q�因此当某个broker失效�Q�那么你只能�{�待直到它重启后�Q�这�? broker上的消息才能够被�l�箋发送（如果没有讄��持久化，那么在这�U�情况下�Q�消息将会丢失）。Master Slave 背后的想法是�Q�消息被复制到slave broker�Q�因此即使master broker遇到了像��g故障之类的错误，你也可以立即切换到slave broker而不丢失��M��消息�?br /> Master Slave是目前ActiveMQ推荐的高可靠性和定w��的解��x��案。以下是几种不同的类型：

Master Slave Type	Requirements	Pros	Cons
Pure Master Slave	None	No central point of failure	Requires manual restart to bring back a failed master and can only support 1 slave
Shared File System Master Slave	A Shared File system such as a SAN	Run as many slaves as required. Automatic recovery of old masters	Requires shared file system
JDBC Master Slave	A Shared database	Run as many slaves as required. Automatic recovery of old masters	Requires a shared database. Also relatively slow as it cannot use the high performance journal

2�Q?�Q?�Q? Pure Master Slave
Pure Master Slave的工作方式如下：

Slave broker消费master broker上所有的消息状态，例如消息、确认和事务状态等。只要slave broker�q�接��C��master broker�Q�它不会�Q�也不被允许�Q�启动�Q何network connectors或者transport connectors�Q�所以唯一的目的就是复制master broker的状态�?/li>
Master broker只有在消息成功被复制到slave broker之后才会响应客户。例如，客户的commit��h��只有在master broker和slave broker都处理完毕commit��h��之后才会�l�束�?/li>
当master broker失效的时候，slave broker有两�U�选择�Q�一�U�是slave broker启动所有的network connectors和transport connectors�Q�这允许客户端切换到slave broker�Q�另外一�U�是slave broker停止。这�U�情况下�Q�slave broker只是复制了master broker的状态�?/li>
客户应该使用failover transport�q�且应该首先��试�q�接master broker。例如：
failover://(tcp://masterhost:61616,tcp://slavehost:61616)?randomize=false
讄��randomize为false��可以让客户��L��首先��试�q�接master broker�Q�slave broker�q�不会接受�Q何连接，直到它成��Z��master broker�Q��?/li>

Pure Master Slave��h��以下限制�Q?/p>

只能有一个slave broker�q�接到master broker�?/li>
在因master broker失效而导致slave broker成�ؓmaster之后�Q�之前的master broker只有在当前的master broker�Q�原slave broker�Q�停止后才能重新生效�?/li>
Master broker失效后而切换到slave broker后，最安全的恢复master broker的方式是人工处理。首先要停止slave broker�Q�这意味着所有的客户也要停止�Q�。然后把slave broker的数据目录中所有的数据拯��到master broker的数据目录中。然后重启master broker和slave broker�?/li>

Master broker不需要特�D�的配置。Slave broker需要进行以下配�|?/p>

Xml代码

<broker masterConnectorURI="tcp://masterhost:62001" shutdownOnMasterFailure="false">
...
<transportConnectors>
<transportConnector uri="tcp://slavehost:61616"/>
transportConnectors>
broker>

其中的masterConnectorURI用于指向master broker�Q�shutdownOnMasterFailure用于指定slave broker在master broker失效的时候是否需要停止。此外，也可以��用如下配�|�：

Xml代码

<broker brokerName="slave" useJmx="false" deleteAllMessagesOnStartup="true" xmlns="http://activemq.org/config/1.0">
...
<services>
<masterConnector remoteURI= "tcp://localhost:62001" userName="user" password="password"/>
services>
broker>

需要注意的是，�W�者认为ActiveMQ5.0版本的Pure Master Slave仍然不够�E�_��?

2�Q?�Q?�Q? Shared File System Master Slave
如果你��用SAN或者共享文件系�l�，那么你可以��用Shared File System Master Slave。基本上�Q�你可以�q�行多个broker�Q�这些broker�׃�n数据目录。当�W�一个broker得到文�g上的排他锁之后，其它的broker便会在��@环中�{�待获得�q�把锁。客��L��使用failover transport来连接到可用的broker。当master broker失效的时候会释放�q�把锁，�q�时候其中一个slave broker会得到这把锁从而成为master broker。以下是ActiveMQ配置的一个例子：

Xml代码

<broker useJmx="false" xmlns="http://activemq.org/config/1.0">
<persistenceAdapter>
<journaledJDBC dataDirectory="/sharedFileSystem/broker"/>
persistenceAdapter>
… �?/span>
broker>

2�Q?�Q?�Q? JDBC Master Slave
JDBC Master Slave的工作原理跟Shared File System Master Slave�c�M��Q�只是采用了数据库作为持久化存储。以下是ActiveMQ配置的一个例子：

Xml代码

<beans>
<broker xmlns="http://activemq.org/config/1.0" brokerName="JdbcMasterBroker">
...
<persistenceAdapter>
<jdbcPersistenceAdapter dataSource="#mysql-ds"/>
persistenceAdapter>
broker>
<bean id="mysql-ds" class="org.apache.commons.dbcp.BasicDataSource" destroy-method="close">
<property name="driverClassName" value="com.mysql.jdbc.Driver"/>
<property name="url" value="jdbc:mysql://localhost:3306/test?relaxAutoCommit=true"/>
<property name="username" value="username"/>
<property name="password" value="passward"/>
<property name="poolPreparedStatements" value="true"/>
bean>
beans>

需要注意的是，如果你��用MySQL数据库，需要首先执行以下三条语句：�Q�Apache官方文档��_��此bug已经被修正，预定�?.1.0版本上体玎ͼ�

Sql代码

ALTER TABLE activemq_acks ENGINE = InnoDB;
ALTER TABLE activemq_lock ENGINE = InnoDB;
ALTER TABLE activemq_msgs ENGINE = InnoDB;

�C�物 2010-09-01 22:27 发表评论

ActiveMQ in Action(3)

�C�物 — Wed, 01 Sep 2010 14:26:00 GMT

2�Q? Persistence
2�Q?�Q? AMQ Message Store
AMQ Message Store是ActiveMQ5.0�~? 省的持久化存储。Message commands被保存到transactional journal�Q�由rolling data logs�l�成�Q�。Messages被保存到data logs中，同时被reference store�q�行索引以提高存取速度。Date logs�׃��些单独的data log文�g�l�成�Q�缺省的文�g大小�?2M�Q�如果某个消息的大小��过了data log文�g的大��，那么可以修改配置以增加data log文�g的大��。如果某个data log文�g中所有的消息都被成功消费了，那么�q�个data log文�g��会被标讎ͼ�以便在下一轮的清理中被删除或者归档。以下是光��|�的一个例子：

Xml代码

< broker brokerName = "broker" persistent = "true" useShutdownHook = "false" >
<persistenceAdapter>
<amqPersistenceAdapter directory="${activemq.base}/data" maxFileLength="32mb"/>
persistenceAdapter>
broker >

Property name	Default value	Comments
directory	activemq-data	the path to the directory to use to store the message store data and log files
useNIO	true	use NIO to write messages to the data logs
syncOnWrite	false	sync every write to disk
maxFileLength	32mb	a hint to set the maximum size of the message data logs
persistentIndex	true	use a persistent index for the message logs. If this is false, an in-memory structure is maintained
maxCheckpointMessageAddSize	4kb	the maximum number of messages to keep in a transaction before automatically committing
cleanupInterval	30000	time (ms) before checking for a discarding/moving message data logs that are no longer used
indexBinSize	1024	default number of bins used by the index. The bigger the bin size - the better the relative performance of the index
indexKeySize	96	the size of the index key - the key is the message id
indexPageSize	16kb	the size of the index page - the bigger the page - the better the write performance of the index
directoryArchive	archive	the path to the directory to use to store discarded data logs
archiveDataLogs	false	if true data logs are moved to the archive directory instead of being deleted

2�Q?�Q? Kaha Persistence
Kaha Persistence 是一个专门针�Ҏ��息持久化的解��x��案。它对典型的消息使用模式�q�行了优化。在Kaha中，数据被追加到data logs中。当不再需要log文�g中的数据的时候，log文�g会被丢弃。以下是光��|�的一个例子：

Xml代码

< broker brokerName = "broker" persistent = "true" useShutdownHook = "false" >
<persistenceAdapter>
<kahaPersistenceAdapter directory="activemq-data" maxDataFileLength="33554432"/>
persistenceAdapter>
broker >

2�Q?�Q? JDBC Persistence
目前支持的数据库有Apache Derby, Axion, DB2, HSQL, Informix, MaxDB, MySQL, Oracle, Postgresql, SQLServer, Sybase�?br /> 如果你��用的数据库不被支持，那么可以调整StatementProvider 来保证��用正��的SQL方言�Q�flavour of SQL�Q�。通常�l�大多数数据库支持以下adaptor�Q?

org.activemq.store.jdbc.adapter.BlobJDBCAdapter
org.activemq.store.jdbc.adapter.BytesJDBCAdapter
org.activemq.store.jdbc.adapter.DefaultJDBCAdapter
org.activemq.store.jdbc.adapter.ImageJDBCAdapter

也可以在配置文�g中直接指定JDBC adaptor�Q�例如：

Xml代码

< jdbcPersistenceAdapter adapterClass = "org.apache.activemq.store.jdbc.adapter.ImageBasedJDBCAdaptor" />

以下是其配置的一个例子：

Xml代码

<persistence>
<jdbcPersistence dataSourceRef=" mysql-ds"/>
persistence>
<bean id="mysql-ds" class="org.apache.commons.dbcp.BasicDataSource" destroy-method="close">
<property name="driverClassName" value="com.mysql.jdbc.Driver"/>
<property name="url" value="jdbc:mysql://localhost/activemq?relaxAutoCommit=true"/>
<property name="username" value="activemq"/>
<property name="password" value="activemq"/>
<property name="poolPreparedStatements" value="true"/>
bean>

需要注意的是，如果使用MySQL�Q�那么需要设�|�relaxAutoCommit 标志为true�?/p>

2�Q?�Q? Disable Persistence
以下是其配置的一个例子：

Xml代码

<broker persistent="false">
broker>

�C�物 2010-09-01 22:26 发表评论

ActiveMQ in Action(2)

�C�物 — Wed, 01 Sep 2010 14:26:00 GMT

2�Q? Transport
ActiveMQ目前支持的transport有：VM Transport、TCP Transport、SSL Transport、Peer Transport、UDP Transport、Multicast Transport、HTTP and HTTPS Transport、Failover Transport、Fanout Transport、Discovery Transport、ZeroConf Transport�{�。以下简单介�l�其中的几种�Q�更多请参考Apache官方文档�?/p>

2�Q?�Q? VM Transport
VM transport允许在VM内部通信�Q�从而避免了�|�络传输的开销。这时候采用的�q�接不是socket�q�接�Q�而是直接地方法调用�? �W�一个创建VM �q�接的客户会启动一个embed VM broker�Q�接下来所有��用相同的broker name的VM�q�接都会使用�q�个broker。当�q�个broker上所有的�q�接都关闭的时候，�q�个broker也会自动关闭�?br /> 以下是配�|�语法：

vm://brokerName?transportOptions

例如�Q�vm://broker1?marshal=false&broker.persistent=false

Transport Options的可选值如下：

Option Name	Default Value	Description
Marshal	false	If true, forces each command sent over the transport to be marshlled and unmarshlled using a WireFormat
wireFormat	default	The name of the WireFormat to use
wireFormat.*		All the properties with this prefix are used to configure the wireFormat
create	true	If the broker should be created on demand if it does not allready exist. Only supported in ActiveMQ 4.1
broker.*		All the properties with this prefix are used to configure the broker. See Configuring Wire Formats for more information

以下是高�U�配�|�语法：

vm:(broker:(tcp://localhost)?brokerOptions)?transportOptions

vm:broker:(tcp://localhost)?brokerOptions

例如�Q�vm:(broker:(tcp://localhost:6000)?persistent=false)?marshal=false

Transport Options的可选值如下：

Option Name	Default Value	Description
marshal	false	If true, forces each command sent over the transport to be marshlled and unmarshlled using a WireFormat
wireFormat	default	The name of the WireFormat to use
wireFormat.*		All the properties with this prefix are used to configure the wireFormat

   使用配置文�g的配�|�语法：
    vm://localhost?brokerConfig=xbean:activemq.xml
    例如�Q�vm:// localhost?brokerConfig=xbean:com/test/activemq.xml

使用Spring的配�|�：

Xml代码

< bean id = "broker" class = "org.apache.activemq.xbean.BrokerFactoryBean" >
<property name="config" value="classpath:org/apache/activemq/xbean/activemq.xml" />
<property name="start" value="true" />
bean >
< bean id = "connectionFactory" class = "org.apache.activemq.ActiveMQConnectionFactory" depends-on = "broker" >
<property name="brokerURL" value="vm://localhost"/>
bean >

如果persistent是true�Q�那么ActiveMQ会在当前目录下创��Z��个缺省值是activemq-data的目录用于持久化保存数据。需要注意的是，如果�E�序中启动了多个不同名字的VM broker�Q�那么可能会有如下警告：Failed to start jmx connector: Cannot bind to URL [rmi://localhost:1099/jmxrmi]: javax.naming.NameAlreadyBoundException…可以通过在transportOptions中追�? broker.useJmx=false来禁用JMX来避免这个警告�?/p>

2�Q?�Q? TCP Transport
TCP transport 允许客户端通过TCP socket�q�接到远�E�的broker。以下是配置语法�Q?br /> tcp://hostname:port?transportOptions
Transport Options的可选值如下：

Option Name	Default Value	Description
minmumWireFormatVersion	0	The minimum version wireformat that is allowed
trace	false	Causes all commands that are sent over the transport to be logged
useLocalHost	true	When true, it causes the local machines name to resolve to "localhost".
socketBufferSize	64 * 1024	Sets the socket buffer size in bytes
soTimeout	0	sets the socket timeout in milliseconds
connectionTimeout	30000	A non-zero value specifies the connection timeout in milliseconds. A zero value means wait forever for the connection to be established. Negative values are ignored.
wireFormat	default	The name of the WireFormat to use
wireFormat.*		All the properties with this prefix are used to configure the wireFormat. See Configuring Wire Formats for more information

例如�Q�tcp://localhost:61616?trace=false

2�Q?�Q? Failover Transport
    Failover Transport是一�U�重新连接的机制�Q�它工作于其它transport的上层，用于建立可靠的传输。它的配�|�语法允许制定�Q意多个复合的URI�? Failover transport会自动选择其中的一个URI来尝试徏立连接。如果没有成功，那么会选择一个其它的URI来徏立一个新的连接。以下是配置语法�Q?br />    failover:(uri1,...,uriN)?transportOptions
    failover:uri1,...,uriN
    Transport Options的可选值如下：

Option Name	D efault Value	Description
initialReconnectDelay	10	How long to wait before the first reconnect attempt (in ms)
maxReconnectDelay	30000	The maximum amount of time we ever wait between reconnect attempts (in ms)
useExponentialBackOff	true	Should an exponential backoff be used between reconnect attempts
backOffMultiplier	2	The exponent used in the exponential backoff attempts
maxReconnectAttempts	0	If not 0, then this is the maximum number of reconnect attempts before an error is sent back to the client
randomize	true	use a random algorithm to choose the URI to use for reconnect from the list provided
backup	false	initialize and hold a second transport connection - to enable fast failover

例如�Q�failover:(tcp://localhost:61616,tcp://remotehost:61616)?initialReconnectDelay=100

2�Q?�Q? Discovery transport
    Discovery transport是可靠的tranport。它使用Discovery transport来定位用来连接的URI列表。以下是配置语法�Q?br />    discovery:(discoveryAgentURI)?transportOptions
    discovery:discoveryAgentURI
    Transport Options的可选值如下：

Option Name	Default Value	Description
initialReconnectDelay	10	How long to wait before the first reconnect attempt
maxReconnectDelay	30000	The maximum amount of time we ever wait between reconnect attempts
useExponentialBackOff	true	Should an exponential backoff be used btween reconnect attempts
backOffMultiplier	2	The exponent used in the exponential backoff attempts
maxReconnectAttempts	0	If not 0, then this is the maximum number of reconnect attempts before an error is sent back to the client

例如�Q�discovery:(multicast://default)?initialReconnectDelay=100
��Z��使用Discovery来发现broker�Q�需要�ؓbroker启用discovery agent�?以下是XML配置文�g中的一个例子：

Xml代码

< broker name = "foo" >
<transportConnectors>
<transportConnector uri="tcp://localhost:0" discoveryUri="multicast://default"/>
transportConnectors>
...
broker >

在��用Failover Transport或Discovery transport�{�能够自动重�q�的transport的时候，需要注意的是：设想有两个broker�Q�它们都启用AMQ Message Store作�ؓ持久化存储，有一个producer和一个consumer�q�接到某个queue。当因其中一个broker失效时而切换到另一�? broker的时候，如果失效的broker的queue中还有未被consumer消费的消息，那么�q�个queue里的消息仍然滞留在失效broker 的中�Q�直到失效的broker被修复�ƈ重新切换回这个被修复的broker后，之前被保留的消息才会被consumer消费掉。如果被处理的消息有时序�? �Ӟ��那么应用�E�序��需要处理这个问题。另外也可以通过ActiveMQ集群来解册��个问题�?/p>

在transport重连的时候，可以在connection上注册TransportListener来获得回调，例如�Q?/p>

Java代码

(ActiveMQConnection)connection).addTransportListener( new TransportListener() {
public void onCommand(Object cmd) {
}
public void onException(IOException exp) {
}
public void transportInterupted() {
// The transport has suffered an interruption from which it hopes to recover.
}
public void transportResumed() {
// The transport has resumed after an interruption.
}
});

�C�物 2010-09-01 22:26 发表评论

ActiveMQ in Action(1)

�C�物 — Wed, 01 Sep 2010 14:25:00 GMT

1 JMS
在介�l�ActiveMQ之前�Q�首先简要介�l�一下JMS规范�?br />1�Q? JMS的基本构�?br />1�Q?�Q? �q�接工厂
�q�接工厂是客��L��来创��接的对象�Q�例如ActiveMQ提供的ActiveMQConnectionFactory�?/p>

1�Q?�Q? �q�接
JMS Connection��装了客户与JMS提供者之间的一个虚拟的�q�接�?/p>

1�Q?�Q? 会话
JMS Session是生产和消费消息的一个单�U�程上下文。会话用于创建消息生产者（producer�Q�、消息消费者（consumer�Q�和消息�Q�message�Q�等。会话提供了一个事务性的上下文，在这个上下文中，一�l�发送和接收被组合到了一个原子操作中�?/p>

1�Q?�Q? 目的�?br /> 目的地是客户用来指定它生产的消息的目标和它消费的消息的来源的对象。JMS1.0.2规范中定义了两种消息传递域�Q�点对点�Q�PTP�Q�消息传递域和发�?订阅消息传递域�?br />点对�Ҏ��息传递域的特点如下：

每个消息只能有一个消费者�?/li>
消息的生产者和消费者之间没有时间上的相��x��。无论消费者在生��者发送消息的时候是否处于运行状态，它都可以提取消息�?/li>

发布/订阅消息传递域的特点如下：

每个消息可以有多个消费者�?/li>
生��者和消费者之间有旉��上的相关性。订阅一个主题的消费者只能消费自它订阅之后发布的消息。JMS规范允许客户创徏持久订阅�Q�这在一定程度上放松了时间上的相��x��要求。持久订阅允许消费者消费它在未处于�Ȁ�zȝ��态时发送的消息�?/li>

在点对点消息传递域中，目的地被成�ؓ队列�Q�queue�Q�；在发�?订阅消息传递域中，目的地被成�ؓ主题�Q�topic�Q��?/p>

1�Q?�Q? 消息生��?br /> 消息生��者是�׃��话创建的一个对象，用于把消息发送到一个目的地�?/p>

1�Q?�Q? 消息消费�?br /> 消息消费者是�׃��话创建的一个对象，它用于接收发送到目的地的消息。消息的消费可以采用以下两种�Ҏ��之一�Q?/p>

同步消费。通过调用消费者的receive�Ҏ��从目的地中显式提取消息。receive�Ҏ��可以一直阻塞到消息到达�?/li>
异步消费。客户可以�ؓ消费者注册一个消息监听器�Q�以定义在消息到达时所采取的动作�?/li>

1�Q?�Q? 消息
JMS消息�׃��下三部分�l�成�Q?/p>

消息头。每个消息头字段都有相应的getter和setter�Ҏ��?/li>
消息属性。如果需要除消息头字�D�以外的��|��那么可以使用消息属性�?/li>
消息体。JMS定义的消息类型有TextMessage、MapMessage、BytesMessage、StreamMessage和ObjectMessage�?/li>

1�Q? JMS的可靠性机�?br />1�Q?�Q? ��认
JMS消息只有在被��认之后�Q�才认�ؓ已经被成功地消费了。消息的成功消费通常包含三个阶段�Q�客��h��收消息、客户处理消息和消息被确认�?br /> 在事务性会话中�Q�当一个事务被提交的时候，��认自动发生。在非事务性会话中�Q�消息何时被��认取决于创��Z��话时的应�{�模式（acknowledgement mode�Q�。该参数有以下三个可选��|��

Session.AUTO_ACKNOWLEDGE。当客户成功的从receive�Ҏ��q�回的时候，或者从MessageListener.onMessage�Ҏ��成功�q�回的时候，会话自动��认客户收到的消息�?/li>
Session.CLIENT_ACKNOWLEDGE�? 客户通过消息的acknowledge�Ҏ��认消息。需要注意的是，在这�U�模式中�Q�确认是在会话层上进行：��认一个被消费的消息将自动��认所有已被会话消费的消息。例如，如果一个消息消费者消费了10个消息，然后��认�W?个消息，那么所�?0个消息都被确认�?/li>
Session.DUPS_ACKNOWLEDGE�? 该选择只是会话�q�钝�W�确认消息的提交。如果JMS provider��p�|�Q�那么可能会��D��一些重复的消息。如果是重复的消息，那么JMS provider必须把消息头的JMSRedelivered字段讄��为true�?/li>

1�Q?�Q? 持久�?br /> JMS 支持以下两种消息提交模式�Q?/p>

PERSISTENT。指�C�JMS provider持久保存消息�Q�以保证消息不会因�ؓJMS provider的失败而丢失�?/li>
NON_PERSISTENT。不要求JMS provider持久保存消息�?/li>

1�Q?�Q? 优先�U?br /> 可以使用消息优先�U�来指示JMS provider首先提交紧急的消息。优先��?0个��别，�?�Q�最低）�?�Q�最高）。如果不指定优先�U�，默认�U�别�?。需要注意的是，JMS provider�q�不一定保证按照优先��的顺序提交消息�?/p>

1�Q?�Q? 消息�q�期
可以讄��消息在一定时间后�q�期�Q�默认是�怸��q�期�?/p>

1�Q?�Q? 临时目的�?br /> 可以通过会话上的createTemporaryQueue�Ҏ��和createTemporaryTopic�Ҏ��来创��Z��时目的地。它们的存在旉��只限于创建它们的�q�接所保持的时间。只有创��临时目的地的�q�接上的消息消费者才能够从��时目的地中提取消息�?/p>

1�Q?�Q? 持久订阅
首先消息生��者必��M��用PERSISTENT提交消息。客户可以通过会话上的createDurableSubscriber�Ҏ��来创��Z��个持久订阅，该方法的�W�一个参数必��L��一个topic。第二个参数是订阅的名称�?br /> JMS provider会存储发布到持久订阅对应的topic上的消息。如果最初创建持久订阅的客户或者�Q何其它客户��用相同的�q�接工厂和连接的客户ID、相�? 的主题和相同的订阅名再次调用会话上的createDurableSubscriber�Ҏ��Q�那么该持久订阅��׃��被激�z�R��JMS provider会象客户发送客户处于非�Ȁ�zȝ��态时所发布的消息�?br /> 持久订阅在某个时��d��能有一个激�zȝ��订阅者。持久订阅在创徏之后会一直保留，直到应用�E�序调用会话上的unsubscribe�Ҏ��?/p>

1�Q?�Q? 本地事务
在一个JMS客户端，可以使用本地事务来组合消息的发送和接收。JMS Session接口提供了commit和rollback�Ҏ��。事务提交意味着生��的所有消息被发送，消费的所有消息被��认�Q�事务回滚意味着生��的所有消息被销毁，消费的所有消息被恢复�q��新提交，除非它们已经�q�期�?br /> 事务性的会话��L��牉|��C��务处理中�Q�commit或rollback�Ҏ��一旦被调用�Q�一个事务就�l�束了，而另一个事务被开始。关闭事务性会话将回滚其中的事务�?br />需要注意的是，如果使用��h��/回复机制�Q�即发送一个消息，同时希望在同一个事务中�{�待接收该消息的回复�Q�那么程序将被挂��P��因�ؓ知道事务提交�Q�发送操作才会真正执行�?br /> 需要注意的�q�有一个，消息的生产和消费不能包含在同一个事务中�?/p>

1�Q? JMS 规范的变�q?br /> JMS的最新版本的�?.1。它和同1.0.2版本之间最大的差别是，JMS1.1通过�l�一的消息传递域��化了消息传递。这不仅��化了JMS API�Q�也有利于开发�h员灵�z�选择消息传递域�Q�同时也有助于程序的重用和维护�?br />以下是不同消息传递域的相应接口：

JMS 公共	点对点域	发布/订阅�?/strong>
ConnectionFactory	QueueConnectionFactory	TopicConnectionFactory
Connection	QueueConnection	TopicConnection
Destination	Queue	Topic
Session	QueueSession	TopicSession
MessageProducer	QueueSender	TopicPublisher
MessageConsumer	QueueReceiver	TopicSubscriber

2 ActiveMQ
2�Q? Broker
2�Q?�Q? Running Broker
ActiveMQ5.0 的二�q�制发布包中bin目录中包含一个名为activemq的脚本，直接�q�行�q�个脚本��可以启动一个broker�?br /> 此外也可以通过Broker Configuration URI或Broker XBean URI对broker�q�行配置�Q�以下是一些命令行参数的例子：

Example	Description
activemq	Runs a broker using the default 'xbean:activemq.xml' as the broker configuration file.
activemq xbean:myconfig.xml	Runs a broker using the file myconfig.xml as the broker configuration file that is located in the classpath.
activemq xbean:file:./conf/broker1.xml	Runs a broker using the file broker1.xml as the broker configuration file that is located in the relative file path ./conf/broker1.xml
activemq xbean:file:C:/ActiveMQ/conf/broker2.xml	Runs a broker using the file broker2.xml as the broker configuration file that is located in the absolute file path C:/ActiveMQ/conf/broker2.xml
activemq broker:(tcp://localhost:61616, tcp://localhost:5000)?useJmx=true	Runs a broker with two transport connectors and JMX enabled.
activemq broker:(tcp://localhost:61616, network:tcp://localhost:5000)?persistent=false	Runs a broker with 1 transport connector and 1 network connector with persistence disabled.

2�Q?�Q? Embedded Broker
可以通过在应用程序中以编码的方式启动broker�Q�例如：

Java代码

BrokerService broker = new BrokerService();
broker.addConnector("tcp://localhost:61616");
broker.start();

如果需要启动多个broker�Q�那么需要�ؓbroker讄��一个名字。例如：

Java代码

BrokerService broker = new BrokerService();
broker.setName("fred");
broker.addConnector("tcp://localhost:61616");
broker.start();

如果希望在同一个JVM内访问这个broker�Q�那么可以��用VM Transport�Q�URI是：vm://brokerName。关于更多的broker属性，可以参考Apache的官�Ҏ��档�?br /> 此外�Q�也可以通过BrokerFactory来创建broker�Q�例如：

Java代码

BrokerService broker = BrokerFactory.createBroker(new URI(someURI));

someURI的可选值如下：

URI scheme	Example	Description
xbean:	xbean:activemq.xml	Searches the classpath for an XML document with the given URI (activemq.xml in this case) which will then be used as the Xml Configuration
file:	file:foo/bar/activemq.xml	Loads the given file (in this example foo/bar/activemq.xml) as the Xml Configuration
broker:	broker:tcp://localhost:61616	Uses the Broker Configuration URI to configure the broker

当��用XBean的配�|�方式的时候，需要指定一个xml配置文�g�Q�例如：

Java代码

BrokerService broker = BrokerFactory.createBroker(new URI("xbean:com/test/activemq.xml"));

使用Spring的配�|�方式如下：

Xml代码

<bean id="broker" class="org.apache.activemq.xbean.BrokerFactoryBean">
<property name="config" value="classpath:org/apache/activemq/xbean/activemq.xml" />
<property name="start" value="true" />
bean>

2�Q?�Q? Monitoring Broker
2�Q?�Q?�Q? JMX
在��用JMX监控broker之前�Q�首先要启用broker的JMX监控功能�Q�例如在配置文�g中设�|�useJmx="true"�Q�如下：

Xml代码

<broker useJmx="true" brokerName="broker1>
<managementContext>
<managementContext createConnector="true"/>
managementContext>
...
broker>

接下来运行JDK自带的jconsole。在�q�行了jconsole后，它会弹出对话框来选择需要连接到的agent。如果是在启动broker的主��Z�� q�行jconsole�Q�那么ActiveMQ broker会出现在jconsole的Local 标签中。如果要�q�接到远�E�的broker�Q�那么可以在Advanced标签中指定JMX URL�Q�以下是一个连接到本机的JMX URL�Q?br /> service:jmx:rmi:///jndi/rmi://localhost:1099/jmxrmi

在jconsole的MBeans标签中，可以查看详细信息�Q�也可以执行相应的operation。需要注意的是，在jconsole�q�接到broker 的时候，�q�不需要输入用户名和密码，如果�q�存在潜在的安全问题�Q�那么就需要�ؓJMX Connector配置密码保护�Q�需要��?.5以上版本的JDK�Q�。 �?

首先要禁止ActiveMQ创徏自己的connector�Q�例如：

Xml代码

<broker xmlns="http://activemq.org/config/1.0" brokerName="localhost"useJmx="true">
<managementContext>
<managementContext createConnector="false"/>
managementContext>
broker>

然后在ActiveMQ的conf目录下创��Z��个访问控制文件和密码文�g�Q�如下：
conf/jmx.access�Q?br /># The "monitorRole" role has readonly access.
# The "controlRole" role has readwrite access.
monitorRole readonly
controlRole readwrite

conf/jmx.password�Q?br /># The "monitorRole" role has password "abc123".
# The "controlRole" role has password "abcd1234".
monitorRole abc123
controlRole abcd1234

然后修改ActiveMQ的bin目录下activemq的启动脚本，查找包含"SUNJMX="的一行如下：

REM set SUNJMX=-Dcom.sun.management.jmxremote.port=1616 -Dcom.sun.management.jmxremote.authenticate=false -Dcom.sun.management.jmxremote.ssl=false
把它替换�?br />set SUNJMX=-Dcom.sun.management.jmxremote.port=1616 -Dcom.sun.management.jmxremote.authenticate=true -Dcom.sun.management.jmxremote.ssl=false -Dcom.sun.management.jmxremote.password.file=%ACTIVEMQ_BASE%/conf/jmx.password -Dcom.sun.management.jmxremote.access.file=%ACTIVEMQ_BASE%/conf/jmx.access
最后重启ActiveMQ和jconsole�Q�这时候需要强制login。如果在启动activemq的过�E�中出现以下错误�Q�那么需要�ؓ�q�个文�g增加讉K�� 控制。Windows�q�_��上的具体解决�Ҏ��请参考如下网址�Q�http://java.sun.com/j2se/1.5.0/docs/guide /management/security-windows.html
Error: Password file read access must be restricted: D:\apache-activemq-5.0.0\bin\../conf/jmx.password

2�Q?�Q?�Q? Web Console
Web Console被集成到了ActiveMQ的二�q�制发布包中�Q�因此缺省访问http://localhost:8161/admin卛_��讉K��Web Console�?br /> 在配�|�文件中�Q�可以通过修改nioConnector的port属性来修改Web console的缺省端口：

Xml代码

<jetty xmlns="http://mortbay.com/schemas/jetty/1.0">
<connectors>
<nioConnector port="8161" />
connectors>
...
jetty>

��Z��安全性或者可靠性的考虑�Q�Web Console 可以被部�|�到不同于ActiveMQ的进�E�中。例如把activemq-web-console.war部��v��C��个单独的web容器�? �Q�Tomcat�Q�Jetty�{�）。在ActiveMQ5.0的二�q�制发布包中不包含activemq-web-console.war�Q�因此需要下�? ActiveMQ的源码，然后�q�入�?{activemq.base}/src/activemq-web-console目录中执行mvn instanll。如果一切正常，那么�~�省会在${activemq.base}/src/activemq-web-console/target目录中生成activemq-web-console-5.0.0.war。然后将activemq-web-console-5.0.0.war拯��? Tomcat的webapps目录中，�q��命名成activemq-web-console.war�?/p>

需要注意的是，要将activemq-all-5.0.0.jar拯��到WEB-INF\lib目录中（可能�q�需要拷贝jms.jar�Q�。还要�ؓTomcat讄��以下五个�pȝ��属性（修改catalina.bat文�g�Q�：

set JAVA_OPTS=%JAVA_OPTS% -Dwebconsole.type="properties"
set JAVA_OPTS=%JAVA_OPTS% -Dwebconsole.jms.url="tcp://localhost:61616"
set JAVA_OPTS=%JAVA_OPTS% -Dwebconsole.jmx.url="service:jmx:rmi:///jndi/rmi://localhost:1099/jmxrmi"
set JAVA_OPTS=%JAVA_OPTS% -Dwebconsole.jmx.role=""
set JAVA_OPTS=%JAVA_OPTS% -Dwebconsole.jmx.password=""

如果JMX没有配置密码保护�Q�那么webconsole.jmx.role和webconsole.jmx.password讄��?"卛_��。如�? broker被配�|�成了Master/Slave模式�Q�那么可以配�|�成使用failover transport�Q�例如：

-Dwebconsole.jms.url=failover:(tcp://serverA:61616,tcp://serverB:61616)

��Z��说一下，�׃��webconsole.type 属性是properties�Q�因此实际上起作用的Web Console的配�|�文件是WEB-INF/ webconsole-properties.xml。最后启动被监控的ActiveMQ�Q�访问http://localhost:8080 /activemq-web-console/�Q�查看显�C�是否正常�?

2�Q?�Q?�Q? Advisory Message
ActiveMQ 支持Advisory Messages�Q�它允许你通过标准的JMS 消息来监控系�l�。目前的Advisory Messages支持�Q?

consumers, producers and connections starting and stopping
temporary destinations being created and destroyed
messages expiring on topics and queues
brokers sending messages to destinations with no consumers.
connections starting and stopping

Advisory Messages可以被想象成某种的管理通道�Q�通过它你可以得到关于JMS provider、producers、consumers和destinations的信息。Advisory topics都��用ActiveMQ.Advisory.�q�个前缀�Q�以下是目前支持的topics�Q?

Client based advisories

Advisory Topics	Description
ActiveMQ.Advisory.Connection	Connection start & stop messages
ActiveMQ.Advisory.Producer.Queue	Producer start & stop messages on a Queue
ActiveMQ.Advisory.Producer.Topic	Producer start & stop messages on a Topic
ActiveMQ.Advisory.Consumer.Queue	Consumer start & stop messages on a Queue
ActiveMQ.Advisory.Consumer.Topic	Consumer start & stop messages on a Topic

在消费者启�?/span>/停止�?/span>Advisory Messages的消息头中有�?/span>consumerCount属性，他用来指明目�?/span>desination上活跃的consumer的数量�?/span>

Destination and Message based advisories

Advisory Topics	Description
ActiveMQ.Advisory.Queue	Queue create & destroy
ActiveMQ.Advisory.Topic	Topic create & destroy
ActiveMQ.Advisory.TempQueue	Temporary Queue create & destroy
ActiveMQ.Advisory.TempTopic	Temporary Topic create & destroy
ActiveMQ.Advisory.Expired.Queue	Expired messages on a Queue
ActiveMQ.Advisory.Expired.Topic	Expired messages on a Topic
ActiveMQ.Advisory.NoConsumer.Queue	No consumer is available to process messages being sent on a Queue
ActiveMQ.Advisory.NoConsumer.Topic	No consumer is available to process messages being sent on a Topic

以上的这些destnations都可以用来作为前�~��Q�在其后面追加其它的重要信息�Q�例如topic、queue、clientID�? producderID和consumerID�{�。这令你可以利用Wildcards �?Selectors 来过滤Advisory Messages�Q�关于Wildcard和Selector会在�E�后介绍�Q��?/p>

例如�Q�如果你希望订阅FOO.BAR�q�个queue上Consumer的start/stop的消息，那么可以订阅 ActiveMQ.Advisory.Consumer.Queue.FOO.BAR�Q�如果希望订阅所有queue上的start/stop消息�Q�那么可以订阅ActiveMQ.Advisory.Consumer.Queue.>�Q�如果希望订阅所有queue或者topic上的 start/stop消息�Q�那么可以订阅ActiveMQ.Advisory.Consumer. >�?/p>

org.apache.activemq.advisory.AdvisorySupport�c�M��有如下的helper methods�Q�用来在�E�序中得到advisory destination objects�?/p>

Java代码

AdvisorySupport.getConsumerAdvisoryTopic()
AdvisorySupport.getProducerAdvisoryTopic()
AdvisorySupport.getDestinationAdvisoryTopic()
AdvisorySupport.getExpiredTopicMessageAdvisoryTopic()
AdvisorySupport.getExpiredQueueMessageAdvisoryTopic()
AdvisorySupport.getNoTopicConsumersAdvisoryTopic()
AdvisorySupport.getNoQueueConsumersAdvisoryTopic()

以下是段使用Advisory Messages的程序代码：

Java代码

Destination advisoryDestination = AdvisorySupport.getProducerAdvisoryTopic(destination)
MessageConsumer consumer = session.createConsumer(advisoryDestination);
consumer.setMessageListener(this);
...
public void onMessage(Message msg){
if (msg instanceof ActiveMQMessage){
try {
ActiveMQMessage aMsg = (ActiveMQMessage)msg;
ProducerInfo prod = (ProducerInfo) aMsg.getDataStructure();
} catch (JMSException e) {
log.error("Failed to process message: " + msg);
}
}
}

2�Q?�Q?�Q? Command Agent
在介�l�Command Agent前首先简要介�l�一下XMPP(Jabber)协议�Q�XMPP是一�U�基于XML的即旉��信协议�Q�它由Jabber软�g基金会开发。在配置文�g中通过增加transportConnector来支持XMPP协议�Q?

Xml代码

<broker xmlns="http://activemq.org/config/1.0">
<transportConnectors>
...
<transportConnector name="xmpp" uri="xmpp://localhost:61222"/>
transportConnectors>
broker>

ActiveMQ提供了ActiveMQ messages和XMPP之间的双向桥接：

如果客户加入了一个聊天室�Q�那么这个聊天室的名字会被映��到一个JMS topic�?/li>
��试在聊天室内发送消息会��D��一个JMS消息被发送到�q�个topic�?/li>
呆在一个聊天室中意味着�q�将保持一个对相应JMS topic的订阅。因此发送到�q�个topic的JMS消息也会被发送到聊天室�?/li>

推荐XMPP客户端Spark(http://www.igniterealtime.org/)�?

�?.2版本��P��ActiveMQ支持Command Agent。在配置文�g中，通过讄��commandAgent来启用Command Agent�Q?/p>

Xml代码

<beans>
<broker useJmx="true" xmlns="http://activemq.org/config/1.0">
...
broker>
<commandAgent xmlns="http://activemq.org/config/1.0"/>
beans>

启用了Command Agent的broker上会有一个来自Command Agent的连接，它同时订阅topic�Q? ActiveMQ.Agent。在你启动XMPP客户端，加入到ActiveMQ.Agent聊天室后�Q�就可以同broker�q�行交谈了。通过在XMPP 客户端中键入help�Q�可以得到帮助信息�?br /> 需要注意的是，ActiveMQ5.0版本有个��bug�Q�如果broker没有采用�~�省的用户名和密码，那么Command Agent便无法正常启动。Apache官方文档��_��此bug已经被修正，预定�?.2.0版本上体现。修�Ҏ��式如下：

Xml代码

<commandAgent xmlns="http://activemq.org/config/1.0" brokerUser="user" brokerPassword="passward"/>

2�Q?�Q?�Q? Visualization plugin
ActiveMQ支持以broker插�g的�Ş式生成DOT文�g(可以用agrviewer来查�?�Q�以图表的方式描�q�connections、sessions、producers、consumers、destinations�{�信息。配�|�方式如下：

Xml代码

<broker xmlns="http://activemq.org/config/1.0" brokerName="localhost" useJmx="true">
...
<plugins>
<connectionDotFilePlugin file="connection.dot"/>
<destinationDotFilePlugin file="destination.dot"/>
plugins>
broker>

需要注意的是，�W�者认为ActiveMQ5.0版本的Visualization Plugin��不�E�_��Q�存在诸多问题。例如：如果使用connectionDotFilePlugin�Q�那么brokerName必须�? localhost�Q�如果��用destinationDotFilePlugin可能会导致ArrayStoreException�?

�C�物 2010-09-01 22:25 发表评论