RocketMQ入门（生产者）_2

从 RocketMQ环境搭建_1 我们已经建立了MQ的Server，接下来就是简单的生产和消费的过程。

1. rocketMQ的源码中有个示例代码example  ，我们从Apache官网中可以下载源码source找到example，进行学习。

下载地址：http://rocketmq.apache.org/docs/quick-start/

建立简单的工程，mvn最主要依赖client

<dependency>
    <groupId>org.apache.rocketmq</groupId>
    <artifactId>rocketmq-client</artifactId>
    <version>4.3.1</version>
</dependency>

 在做transactionProducer时，发现无法消费，问题是需要依赖parent，因此借鉴demo中的mvn依赖：

    <parent>
        <groupId>org.apache.rocketmq</groupId>
        <artifactId>rocketmq-all</artifactId>
        <version>4.3.0</version>
    </parent>

    <modelVersion>4.0.0</modelVersion>
    <packaging>jar</packaging>
    <artifactId>rocketmq-example</artifactId>
    <name>rocketmq-example ${project.version}</name>

    <dependencies>
        <dependency>
            <groupId>${project.groupId}</groupId>
            <artifactId>rocketmq-client</artifactId>
        </dependency>
        <dependency>
            <groupId>${project.groupId}</groupId>
            <artifactId>rocketmq-srvutil</artifactId>
        </dependency>
        <dependency>
            <groupId>ch.qos.logback</groupId>
            <artifactId>logback-classic</artifactId>
        </dependency>
         <dependency>
            <groupId>org.javassist</groupId>
            <artifactId>javassist</artifactId>
        </dependency>
        <dependency>
            <groupId>io.openmessaging</groupId>
            <artifactId>openmessaging-api</artifactId>
        </dependency>
        <dependency>
            <groupId>org.apache.rocketmq</groupId>
            <artifactId>rocketmq-openmessaging</artifactId>
            <version>4.3.0</version> 
        </dependency>
    </dependencies>

创建Producer类：

/**
 * 简单生产者
 * 
 * @author DennyZhao
 * @since 2018/10/29
 * @version 1.0
 */
public class Producer {

    /**
     * main方法
     * 
     * @param args
     * @throws InterruptedException
     * @throws MQBrokerException
     * @throws RemotingException
     * @throws MQClientException
     * @throws UnsupportedEncodingException
     */
    public static void main(String[] args) throws MQClientException, RemotingException, MQBrokerException,
            InterruptedException, UnsupportedEncodingException {
        //创建生产者实例，并确定生产组
        DefaultMQProducer producer = new DefaultMQProducer("fruitProducerGroup");
        // 指定服务NameServer服务
        producer.setNamesrvAddr("192.168.68.137:9876;192.168.68.138:9876;");
        // 生产者启动
        producer.start();
        String[] fruitArray = { "apple", "strawbarry", "pear", "banana", "orange" };
        for (String fruit : fruitArray) {
            // 创建消息
            Message message = new Message("fruit", "common", fruit.getBytes(RemotingHelper.DEFAULT_CHARSET));
            // 发送消息
            SendResult result = producer.send(message);
            SendStatus sendStatus = result.getSendStatus();
            // 获取回执
            System.out.println(result);
            if (sendStatus == SendStatus.SEND_OK) {
                System.out.println("信息发送成功！");
            } else {
                System.out.println("信息发送失败！");
            }
        }
        // 关闭生产者
        producer.shutdown();
    }
}

 创建Consumer类：

/**
 * 消費者群體
 * @author DennyZhao
 * @since 2018/10/29
 * @version 1.0
 */
public class Consumer {

    public static void main(String[] args) throws MQClientException {
        //创建消费者实例和组
        DefaultMQPushConsumer consumer = new DefaultMQPushConsumer("fruitConsumerGroup");
        // 指定nameServer服务地址
        consumer.setNamesrvAddr("192.168.68.137:9876;192.168.68.138:9876;");
        // 订阅消费Topic
        consumer.subscribe("fruit", "*");
        // 订阅从何地方开始读（先进先出，还是先进后出）
        consumer.setConsumeFromWhere(ConsumeFromWhere.CONSUME_FROM_LAST_OFFSET);
        // 添加监听
        consumer.registerMessageListener(new MessageListenerConcurrently() {

            
            public ConsumeConcurrentlyStatus consumeMessage(List<MessageExt> msgList, ConsumeConcurrentlyContext arg1) {
                if(msgList != null && msgList.size() > 0) {
                    MessageExt msg = msgList.get(0);
                    System.out.println(msg);
                    try {
                        System.out.println(new String(msg.getBody(), RemotingHelper.DEFAULT_CHARSET));
                    } catch (UnsupportedEncodingException e) {
                        // TODO Auto-generated catch block
                        e.printStackTrace();
                    }
                }
                return ConsumeConcurrentlyStatus.CONSUME_SUCCESS;
            }
            
        });
        // 启动消费者
        consumer.start();
    }
}

※注意：启动最好先启动消费者然后再启动服务者。

从RocketMQ-console中可以看到创建的消费者群和生产者群。至此，简单的生产消费就算大功告成。

配置说明：

1.producer-生产者类型

• 1. NormalProducer         （普通生产者）
• 2. OrderProducer           （严格顺序生产者，例如：订单创建，付款，发货等）
• 3. TransactionProducer  （事务生产者）

msgId和msgKey非常关键：msgId是mq自动生成的，可在控制台message中查找数据。

                                            msgKey大多是业务主键key，用于跟踪数据，比如订单号等。

msg中有个很重要的属性：在producer端放置：msg.putUserProperty([key],  [value]);  //是个map,可放内容，在consumer端获取

主要可选参数：

        // 设置超过多大进行compress压缩
        producer.setCompressMsgBodyOverHowmuch(1024 * 10);
        // 设置发送失败的尝试次数。
        producer.setRetryTimesWhenSendFailed(3);
        // 设置如果返回值不是send_ok，是否要重新发送
        producer.setRetryAnotherBrokerWhenNotStoreOK(false);
        // 设置限制最大的文件大小
        producer.setMaxMessageSize(1024*50);
        // 设置默认主题对应的队列数
        producer.setDefaultTopicQueueNums(4);
        //创建新的topic
        producer.createTopic("1121", "vegetables", 4);
        // 设置发送超时时间 ms
        producer.setSendMsgTimeout(1000);

OrderProducer 采用将有序内容放在单个queue，保证消费的顺序进行。可参见示例中的order代码。

         Producer类不同点展示，发送消息：

            // 发送消息
            SendResult result = producer.send(message, new MessageQueueSelector() {
                public MessageQueue select(List<MessageQueue> msgList, Message message, Object queueId) {
                    return msgList.get(Integer.valueOf(queueId.toString()));
                }}, 0); //这个0表示将这些msg放入到队列0中

         Consumer类不同点展示，接受消息：

// 添加监听
        consumer.registerMessageListener(new MessageListenerOrderly() {

            //获取数据，防止一次获取太多无法消化，可一次取单个条数。
            public ConsumeOrderlyStatus consumeMessage(List<MessageExt> msgList, ConsumeOrderlyContext arg1) {
                if(msgList != null && msgList.size() > 0) {
                    MessageExt msg = msgList.get(0);
                    System.out.println(msg);
                        System.out.println(msg.getBody());
                }
                return ConsumeOrderlyStatus.SUCCESS;
            }
            
        });

 TransactionProducer ：

       用于解决事务同步，尤其是金融方面，在单体应用中我们可以通过数据库事务来控制，但大的电商系统表和表可能分属于不同的数据库，数据库事务则失效。

       比如微信转银行操作：我们从银行扣款100元到微信，如果微信增加100元，而此时出现问题，银行扣款没有成功这样理论上是要回滚微信的增加100元。

       一般分布式采用2pc（2 phase commit）模式（两阶段提交协议：预留和确认），安全性高，但是因为长连接导致长时间等待。

      而RocketMQ采用两阶段补偿型，TCC（Try-Confirm-Cancel）的简称。

     应用场景：买2张票(春运回家，从天津->上海->武汉），先买预留，然后在规定时间内付款则commit，否则过期后rollback.（无论哪个）

    异常回溯：在3.2.6+版本的非商业版已经取消，

需要手动回查参见别人的文章RocketMQ事务消息回查设计方案

 常对应参数：

/**
 * 做数据反查轮询用 UN KNOW，时会用到反查目前已经 deprecated
 */
producer.setCheckThreadPoolMaxSize(5);
producer.setCheckThreadPoolMinSize(2);
producer.setCheckRequestHoldMax(200);//回查最大数

 生产者修改：添加

sendMessage变化：TransactionSendResult 
producer变化：   TransactionMQProducer
添加监听：        TransactionListener 
因非商业3.2.6取消回查：因此 producer.setExecutorService(executorService);没有作用，本来是用于开启多线程进行回查用

/**
 * 事务生产者
 * 
 * @author DennyZhao
 * @since 2018/10/31
 * @version 1.0
 */
public class Producer {

    /**
     * main方法
     * 
     * @param args
     * @throws InterruptedException
     * @throws MQBrokerException
     * @throws RemotingException
     * @throws MQClientException
     * @throws UnsupportedEncodingException
     */
    public static void main(String[] args) throws MQClientException, RemotingException, MQBrokerException,
            InterruptedException, UnsupportedEncodingException {
        //创建生产者实例，并确定生产组
        TransactionMQProducer producer = new TransactionMQProducer("transProducerGroup");
        TransactionListener transListener = new FruitTransactionListener();
        // 指定服务NameServer服务
        producer.setNamesrvAddr("192.168.68.137:9876;192.168.68.138:9876;");
//        // 设置超过多大进行compress压缩
//        producer.setCompressMsgBodyOverHowmuch(1024 * 10);
//        // 设置发送失败的尝试次数。
//        producer.setRetryTimesWhenSendFailed(3);
//        // 设置如果返回值不是send_ok，是否要重新发送
//        producer.setRetryAnotherBrokerWhenNotStoreOK(true);
//        // 设置限制最大的文件大小
//        producer.setMaxMessageSize(1024*50);
//        // 设置默认主题对应的队列数
//        producer.setDefaultTopicQueueNums(4);
//        // 设置发送超时时间 ms
//        producer.setSendMsgTimeout(1000);
        /**
         * 做数据反查轮询用
         */
//        producer.setCheckThreadPoolMaxSize(5);
//        producer.setCheckThreadPoolMinSize(2);
//        producer.setCheckRequestHoldMax(200);//回查最大数
        
        
        
        ExecutorService executorService = new ThreadPoolExecutor(2, 5, 100, TimeUnit.SECONDS, new ArrayBlockingQueue<Runnable>(2000), new ThreadFactory() {

            public Thread newThread(Runnable r) {
                Thread th = new Thread(r);
                th.setName("client-transaction-msg-check-thread");
                System.out.println("id:" + th.getId());
                System.out.println("name:" + th.getName());
                return th;
            }
       });
        producer.setExecutorService(executorService);
        /**
         * 添加监听
         */
        producer.setTransactionListener(transListener);
        
        // 生产者启动
        producer.start();
        String[] fruitArray = { "apple-苹果", "strawbarry-草莓", "pear-梨子", "banana-香蕉", "orange-橘子"};
        for (String fruit : fruitArray) {
            // 创建消息
            Message message = new Message("transactionFruit", "common", "key"+fruit, fruit.getBytes(RemotingHelper.DEFAULT_CHARSET));
            // 发送消息
            TransactionSendResult result = producer.sendMessageInTransaction(message, "abcd");
             Thread.sleep(10);
            SendStatus sendStatus = result.getSendStatus();
            // 获取回执
            System.out.println(result);
            if (sendStatus == SendStatus.SEND_OK) {
                System.out.println("信息发送成功！");
            } else {
                System.out.println("信息发送失败！");
            }
        }
        int j = 0;
        while(j <500) {
            Thread.sleep(1000);
            j++;
        }
        // 关闭生产者
        producer.shutdown();
    }

 监听：

因回查被取消因此：checkLocalTransaction(MessageExt msg)没有作用了，所以如果

LocalTransactionState.UNKNOW 将无法处理，会使得topic一直处于不显示状态。

/**
 * 事务执行监听
 * @author DennyZhao
 *
 */
public class FruitTransactionListener implements TransactionListener {

    /**
     * 执行事务，事务成功commit，不成功rollback，未知unknown
     * msg Message
     * arg 附加参数，用于处理传递内容加以判断，使用
     * 
     */
    public LocalTransactionState executeLocalTransaction(Message msg, Object arg) {
        System.out.println((String) arg);
        // 执行事务处
        // 假设以水果入库为例：苹果，香蕉 commit，梨子 rollback， 橘子和草莓不知道怎么处理
        System.out.println(msg + "---executeLocal");
        System.out.println(msg.getTransactionId());
        String fruit = "";
        try {
            fruit = new String(msg.getBody(), RemotingHelper.DEFAULT_CHARSET);
        } catch (UnsupportedEncodingException e) {
            e.printStackTrace();
            return LocalTransactionState.ROLLBACK_MESSAGE;
        }
        
        if(StringUtils.contains(fruit, "苹果")
                || StringUtils.contains(fruit, "香蕉")) {//提交
            return LocalTransactionState.COMMIT_MESSAGE;
        }else if(StringUtils.contains(fruit, "梨")) {//回滚
            return LocalTransactionState.ROLLBACK_MESSAGE;
        }else { //通过轮询去处理
            return LocalTransactionState.UNKNOW;
        }
    }

    /**
     * 轮询反查，对于unknow的内容，进行反查获取结果
     */
    public LocalTransactionState checkLocalTransaction(MessageExt msg) {
        System.out.println(msg + "---checkAgain");
        String fruit = "";
        try {
            fruit = new String(msg.getBody(), RemotingHelper.DEFAULT_CHARSET);
        } catch (UnsupportedEncodingException e) {
            e.printStackTrace();
            return LocalTransactionState.ROLLBACK_MESSAGE;
        }
        //从库中反查知道库中 存在葡萄，不存在橘子 
        if(StringUtils.contains(fruit, "葡萄")) {//提交
            return LocalTransactionState.COMMIT_MESSAGE;
        }else if(StringUtils.contains(fruit, "橘子")) {//回滚
            return LocalTransactionState.ROLLBACK_MESSAGE;
        }
        return LocalTransactionState.UNKNOW;
    }

错误说明：

1. No route info of this topic

因在启动broker时，参数中未设置可自动创建topic，因此生产者创建topic被认为不合法，需要在console中先创建topic，或者服务端先创建topic。

2. transactionProducer 生产后无法消费

mvn依赖中缺少 <parent>rocketmq-all</parent>导致。

3. 事务回查无效

 版本 3.2.6 后rocketmq取消了事务回查机制，如果丢失需要自己手动通过key值回查.