消息中间件之ActiveMQ初步认识及第一个程序（二）

1 ActiveMQ 简介

      ActiveMQ是Apache出品，最流行的，能力强劲的开源消息总线。

      ActiveMQ是一个完全支持JMS1.1和J2EE 1．4规范的JMS Provider现，尽管JMS规范出台己经是很久的事情了，但是JMS在当今的J2EE应用中间仍然扮演着特殊的地位，可以说ActiveMQ在业界应用最广泛，当然如果想要有更强大的性能和海量数据处理能力，ActiveMQ还需要不断的升级版本，80%以上的业务我们使用ActiveMQ以及足够满足需求，当然后续如天猫、淘宝网这种大型的电商网站，尤其是双11这种特殊时间，ActiveMQ需要进行很复杂的优化源码以及架构设计才能完成，后面我还会介绍更强大的分布式消息中间件，RocketMQ，可以说ActiveMQ是核心，是基础，所以我们必须要掌握好。

1 ActiveMQ Windows 安装说明

由于这个是windows的安装这里我不做太多说明。

下载链接（目前是最新版）：http://activemq.apache.org/activemq-5152-release.html

安装完后的目录：

      这时我们启动ActiveMQ,进入bin目录一个32位的一个64位的，我的机子是64位的，打开64位的文件夹找的activemq.bat双击启动。

      默认的范围问路径是：http://localhost:8161 注意这里端口是8161这个可以自己改，这时你在浏览器访问时，会弹出一个登陆的界面，默认用户名密码都是admin。

登陆进去如图：

1.1 如何修改端口？

打开conf目录找到jetty.xml文件，打开文件，大概在110行左右。

<bean id="jettyPort" class="org.apache.activemq.web.WebConsolePort" init-method="start">
         
    <property name="host" value="0.0.0.0"/>
    
    <property name="port" value="8161"/>
bean>

1.2 如何修改用户名跟密码？

      打开conf目录找到jetty-realm.properties文件，打开文件，看到底部，改成自己用户名密码即可（其实改不改都无所谓，自己知道有这回事就好）。

记得如果你改了，一定要重新启动 ！！！

2 ActiveMQ Hello World

      我们首先写一个简单的HelloWorld示例，让大家感受下ActiveMQ ,我们的要实现接受者和发送者两部分代码的编写。

步骤如下(这个步骤都是固定的)：Sendert/Receivert

第一步：建立ConnectionFactory工厂对象，需要填入用户名、密码、以及要连接的地址，均使用默认即可，默认端囗为“tcp://localhost:61616”

第二步，通过ConnectionFactory工厂对象我们创建一个Connection连接，并且调用Connection的start方法开启连接，Connection默认是关闭的。

第三步，过Connection对象创建Session会话（上下文环境对象），用于接收消息，参数配置1为是否启用是事务，参数配置2为签收模式，一般我们设置自动签收。

第四步：通过Session创建Destination对象,指的是一个客户端用来指定生产消息目标和消费消息来源的对象，在PTP模式中，Destination被称作Queue即队列：在Pub/Sub模式，Destination被称作Topic及主题。在程序中可以使用多个Queue和Topic。

第五步：我们需要通过Session对象创建消息的发送和接收对象（生产者和消费者） MessageProducer/MessageConsumer。

第六步：我们可以使用MessageProducer的setDeIiveryMode方法为其设置持久化特性和非持久化特性（DeliveryMode），消费端这部分不用写，我们稍后详细介绍。

第七步：最后我们使用JMS范的TextMessage形式创建数据（通过Session对象），并用MessageProducer的send方法发送数据同理客户端使用receive方法进行接收数据。最后不要忘记关闭Connection连接

生产端：

public class Sender {
    public static void main(String[] args) throws JMSException {

        //1 建立ConnectionFactory工厂对象，需要填入用户名、密码、以及要连接的地址，均使用默认即可，默认端囗为“tcp://localhost:61616”
        // 由于这里我们还没有设置 用户名 密码 这里使用默认，在下一节我会介绍这个用户名密码如何设置
        ActiveMQConnectionFactory activeMQConnectionFactory = new ActiveMQConnectionFactory(
                ActiveMQConnectionFactory.DEFAULT_USER,
                ActiveMQConnectionFactory.DEFAULT_PASSWORD,
                "tcp://localhost:61616"
        );

        //2通过ConnectionFactory工厂对象我们创建一个Connection连接，并且调用Connection的start方法开启连接，Connection默认是关闭的。
        Connection connection = activeMQConnectionFactory.createConnection();
        connection.start();

        //3 过Connection对象创建Session会话（上下文环境对象），用于接收消息，参数配置1为是否启用是事务，参数配置2为签收模式，一般我们设置自动签收。
        Session session = connection.createSession(Boolean.FALSE , Session.AUTO_ACKNOWLEDGE);

        //4通过Session创建Destination对象,指的是一个客户端用来指定生产消息目标和消费消息来源的对象，在PTP模式中，Destination被称作Queue即队列：在Pub/Sub模式，Destination被称作Topic及主题。在程序中可以使用多个Queue和Topic。
        Destination destination = (Destination) session.createQueue("queue");

        //5我们需要通过Session对象创建消息的发送和接收对象（生产者和消费者） MessageProducer/MessageConsumer。
        MessageProducer producer = session.createProducer(destination);

        //6我们可以使用MessageProducer的setDeIiveryMode方法为其设置持久化特性和非持久化特性（DeliveryMode），消费端这部分不用写，我们稍后详细介绍。
        producer.setDeliveryMode(DeliveryMode.NON_PERSISTENT);

        //7最后我们使用JMS范的TextMessage形式创建数据（通过Session对象），并用MessageProducer的send方法发送数据同理客户端使用receive方法进行接收数据。
        for (int i = 0; i < 10; i++) {
            TextMessage textMessage = session.createTextMessage();
            textMessage.setText("I Tell You >>> "+i);
            producer.send(textMessage);
        }
        //最后不要忘记关闭Connection连接
        if (connection!=null){
            connection.close();
        }

    }
}

消费端：

public class Receiver {

    public static void main(String[] args) throws  Exception{

        //1
        ActiveMQConnectionFactory activeMQConnectionFactory = new ActiveMQConnectionFactory(
                ActiveMQConnectionFactory.DEFAULT_USER,
                ActiveMQConnectionFactory.DEFAULT_PASSWORD,
                "tcp://localhost:61616"
        );

        //2
        Connection connection = activeMQConnectionFactory.createConnection();
        connection.start();

        //3
        Session session = connection.createSession(Boolean.FALSE , Session.AUTO_ACKNOWLEDGE);

        //4
        Destination destination = (Destination) session.createQueue("queue");

        //5
        MessageConsumer producer = session.createConsumer(destination);

        //7
        while(true){

            TextMessage receive = (TextMessage) producer.receive();
            if (receive==null) break;
            System.out.println("收到的内容 >>>  " +receive.getText());
        }


        if (connection!=null){
            connection.close();
        }
    }
}

启动生产端，在浏览器访问：http://localhost:8161/admin/queues.jsp 查看我们的数据,如图：

好我们启动消费端，控制台打印如下：

再次访问http://localhost:8161/admin/queues.jsp，如图（注意参数的变化）：

3 ActiveMQ 安全机制

      在安装时候我已经教大家如何修改那个ActiveMQ的Web管理界面的密码了，在这不说了。

      在这主要说的是ActiveMQ应该设置有安全机制，只有符合验证的用户才能进行发送和获取消息。其实刚刚在Hello Wolrd 第一步中我就给大家提示过用户名跟密码使用的是默认的，现在我教大家如何改成自己的。

      在conf目录下找到acivemq.xml,打开文件，在大概126行中加入(在broker结束标签上)：

<plugins>
    <simpleAuthenticationPlugin>
        <users>
            <authenticationUser username="hfbin" password="hfbin" groups="users,admins"/>
        users>
    simpleAuthenticationPlugin>
plugins>

      这个时候你改了这里，那个生产/消费端中第一步就不能使用默认用户名和密码了，更改如下：

ActiveMQConnectionFactory activeMQConnectionFactory = new ActiveMQConnectionFactory(
        "hfbin",
        "hfbin",
        "tcp://localhost:61616"
);

4 方法使用

4.1 Conection方法使用

      在成功创建正确的ConectionFactory后，下一步将是创建一个连接，它是JMS定义的一个接囗。ConectionFactory负责返回可以与底层消息传递系统进行通信的 Connectionn实现。通常客户端只使用单一连接。根据JMS文档，Connection的目的是“利用JMS提供者封装开放的连接”，以及表示“客户端与提供者服务例程之间的开放TCP/IP套接字”。该文档还指出Connection应该是进行客户端身份验证的地方等等。

      当一一个Connection被创建时，它的传输默认是关闭的，必须使用start方法开启。一个Connection可以建立一个或多个的Session。

      当一个程序执行完成后，必须关闭之前创建Connection，否则ActiveMQ不能释放资源，关闭一个Connection同样也关闭了Session，MessageProducer和 MessageConsumer。

Connection createConnection();

Connection createConnection(String userName，String password);

4.2 Session方法使用

      一旦从ConectionFactory中获得一个Connection，必须从Connection中创建一个或者多个Session。Session是一个发送或接收消息线程，可以使用Session创建 MessageProducer, MessageConsumer和Message。

      Session可以被事务化，也可以不被事务化，通常， 可以通过向Connection上的适当创建方法传递一个布尔参数对此进行设置。

Session createsession(boolean transacted ， int acknowledgeMode); 

其中transacted为使用事务标识，acknowledgeMode为签收模式。

      结束事务有两种方法：提交或者回滚。当一个事务提交，消息被处理。如果事务中有个步骤操作失败，事务就回滚，这个事务中已执行的动作将被撤销。在发送消息最后也必要使用session.commit()方法表示提交事务。如果你设置为false则不同提交事务，如果是true则使用session.commit()方法提交事务。

最后必须要使用签收模式有三种形式：

      Session.AUTO_ACKNOWLEDGE 当客户端从receive或onMessage成功返回时。Session自动签收客户端的这条消息的收条。（建议使用自动签收模式）

      Session.CLIENT_ACKNOWLEDGE客户端通过调用消息（Message）的ackonwledge方法签收消息。在这种情况下，签收发生在Session层面：签收一个已消费的消息会自动的签收这个Session所有已消费消息的收条。

      Session.DUPS_OK_ACKNOWLEDGE此选项指示Session不必确保对传送消息的签收。它可能引起消息的重复，但降低了Session的开销，所以只有客户端能容忍重复的消息，才能使用。

4.3 MessageProducer方法使用

      MessageProducer：MessageProducer是一个由Session创建的对象，用来向Destination发送消息。

void send(Message message);

void send(Message message, int deliveryMode, int priority, long timeToLive);

void send(Destination destination, Message message);

void send(Destination destination, Message message, int deliveryMode, int priority, long timeToLive);

      其中deliveryMode为传输模式，priority为消息优先级，timeToLive为消息过期时间。ActiverMQ支持两种消息传送模式：PERSISTENT和PERSISTENT两种。如果不指定传输模式，那么默认的是持久性消息。如果容忍消息丢失，那么使用非持久性消息可以改善性能和减少存储的开销。

      消息优先级从0-9是个级别，0-4是普通消息，5-9是加急消息。如果不指定优先级，默认为4。需要注意的是，JMS并不一定保证按照优先级的顺序提交消息，建议使用事务，这样的准确性更高，我已经测试过，基本上按照优先级消费。
      使用优先级必须要在activemq.xml文件中添加如下配置（大概在44行，在policyEntries标签内加入）：这里queue要跟程序中session.createQueue("queue1")里面参数一致。

      默认情况下，消息永远不会过期，如果消息在指定周期内，则失去意义，那么可以设置过期时间，时间单位为毫秒。

4.4 MessageComsumer方法使用

      MessageConsumer是由一个Session创建的对象，用来从Destination接收消息。

MessageProducer createProducer(Destination destination);

MessageConsumer createConsumer(Destination destination);

MessageConsumer createConsumer(Destination destination, String messageSelector);

MessageConsumer createConsumer(Destination destination, String name, boolean noLocal);

TopicSubscriber createDurableSubscriber(Topic topic, String name);

TopicSubscriber createDurableSubscriber(Topic topic, String name, String messageSelector, boolean noLocal);

      其中messageSelector为消息选择器，noLocal标志默认为false，当设置为true时限制消费者只能接收和自己相同的连接（Connection）所发布的消息，此标志只适用于主题，不适用于队列；name标识订阅主题所对应的订阅名称，持久订阅时需要设置此参数。

      Public final String SELECTOR = “name = ‘hfbin’”;该选择器检查了传入消息Name属性，并确定了这个属性的值是否等于hfbin，如果等于，则消息被消费，否者该消息会被忽略。

消息的同步和异步接收：

      消息的同步接收是指客户端主动去接收消息，客户端可以采用MessageConsumer的 receive方法去接收下一个消息。

Message receive()

Message receive(long timeout)

Message receiveNoWait()

      消息的异步接收是指当消息到达时，ActiveMQ主动通知客户端，可以通过注册一个实现MessageListener接囗的的对象到MessageConsumer。MessageListener只有一个必须实现的方法一一onMessage，它只接收一个参数，即Message。在为每个发送Destination的消息实现onMessage时，将调用该方法。

4.5 Message方法使用

      JMS程序的最终目的是生产和消费的消息能被其他程序使用，JMS的Message是一个即简单又不灵活性的基本格式，允许创建不同平台上的符合非JMS程序格式的消息，Message由以下几部分组成：消息头，属性和消息体。

BlobMessage createBlobMessage(File file)

Blobtaessage createBIobMessage(InputStream in)

BlobMessage createBIobMessage(URL url)

BlobMessage createBIobMessage(URL url, boolean deletedByBroker)

BytesMessage createBytesMessage()

MapMessage createMapMessage()

Message createMessage()

ObjectMessage createObjectMessage()

ObjectMessage createObjectMessage(SeriaIizabIe object)

TextMessage createTextMessage()

TextMessage createTextaessage(String text)

      我们一般会在接收端通过instanceof方法去区别数据类型。

这里我就不一一举例说明上面的这些方法使用了，想试的自己动手，根据我的Hello World那个程序改就好了。