深入Pulsar Consumer的使用方式&源码分析

骑猪看日落 2022-09-09 02:22 19阅读 0赞

# 1、使用前准备 #

引入依赖：

<dependency>
        <groupId>org.apache.pulsar</groupId>
        <artifactId>pulsar-client</artifactId>
        <version>2.6.1</version>
    </dependency>

# 2、PulsarClient #

在尝试使用Producer和Consumer前，我们先讲一下Pulsar客户端，因为不管是Producer还是Consumer，都是依靠PulsarClient来创建的：

/** * Pulsar工具类 * @author winfun **/
    public class PulsarUtils { 
    
        /** * 根据serviceUrl创建PulsarClient * @param serviceUrl 服务地址 * @return 客户端 * @throws PulsarClientException 异常 */
        public static PulsarClient createPulsarClient(String serviceUrl) throws PulsarClientException { 
            return PulsarClient.builder()
                    .serviceUrl(serviceUrl)
                    .build();
        }
    }

我们这里简单使用，只借用ServiceUrl创建客户端，其实还有很多比较重要的参数，下面稍微列举一下：

*  ioThreads：Set the number of threads to be used for handling connections to brokers *(default: 1 thread)*
 *  listenerThreads：Set the number of threads to be used for message listeners *(default: 1 thread)*. 一条线程默认只为一个消费者服务
 *  enableTcpNoDelay：No-delay features make sure packets are sent out on the network as soon as possible
 *  …

# 3、Producer #

Producer这里我们也先简单使用，只负责往指定Topic发送消息，其他功能不用，例如异步发送、延时发送等

/** * 初次使用Pulsar生产者，无任何封装 * @author winfun **/
    public class FirstProducerDemo { 
    
        public static void main(String[] args) throws PulsarClientException { 
            PulsarClient client = PulsarClient.builder()
                    .serviceUrl("pulsar://127.0.0.1:6650")
                    .build();
    
            ProducerBuilder<String> productBuilder = client.newProducer(Schema.STRING).topic("winfun/study/test-topic")
                    .blockIfQueueFull(Boolean.TRUE).batchingMaxMessages(100).enableBatching(Boolean.TRUE).sendTimeout(3, TimeUnit.SECONDS);
    
            Producer<String> producer = productBuilder.create();
            for (int i = 0; i < 100; i++) { 
                producer.send("hello"+i);;
            }
            producer.close();
        }
    }

# 4、Consumer #

下面我们将比较详细地介绍消费者的使用方式，因为这里能拓展的东西稍微多一点，下面开始使用旅程。

## 4.1 第一次使用： ##

我们利用PulsarClient创建Consumer；接着在死循环中利用Consumer\#receive方法接收消息然后进行消费。

/** * 初次使用Pulsar消费者，无任何封装 * @author winfun **/
    @Slf4j
    public class FirstConsumerDemo { 
    
        public static void main(String[] args) throws PulsarClientException { 
            PulsarClient client = PulsarClient.builder()
                    .serviceUrl("pulsar://127.0.0.1:6650")
                    .build();
    
            /** * The subscribe method will auto subscribe the consumer to the specified topic and subscription. * One way to make the consumer listen on the topic is to set up a while loop. * In this example loop, the consumer listens for messages, prints the contents of any received message, and then acknowledges that the message has been processed. * If the processing logic fails, you can use negative acknowledgement to redeliver the message later. */
            Consumer<String> consumer = client.newConsumer(Schema.STRING)
                    .topic("winfun/study/test-topic")
                    .subscriptionName("my-subscription")
                    .ackTimeout(10, TimeUnit.SECONDS)
                    .subscriptionType(SubscriptionType.Exclusive)
                    .subscribe();
            // 死循环接收
            while (true){ 
                Message<String> message = consumer.receive();
                String msgContent = message.getValue();
                log.info("接收到消息: {}",msgContent);
                consumer.acknowledge(message);
            }
        }
    }

## 4.2 第二次使用： ##

上面我们可以看到，我们是利用死循环来保证及时消费，但是这样会导致主线程；所以下面我们可以使用Pulsar提供的MessageListener，即监听器，当消息来了，会回调监听器指定的方法，从而避免阻塞主线程。

/** * 使用MessageListener，避免死循环代码&阻塞主线程 * @author winfun **/
    @Slf4j
    public class SecondConsumerDemo { 
    
        public static void main(String[] args) throws PulsarClientException { 
            PulsarClient client = PulsarUtils.createPulsarClient("pulsar://127.0.0.1:6650");
            /** * If you don't want to block your main thread and rather listen constantly for new messages, consider using a MessageListener. * */
            Consumer<String> consumer = client.newConsumer(Schema.STRING)
                    .topic("winfun/study/test-topic")
                    .subscriptionName("my-subscription")
                    .ackTimeout(10, TimeUnit.SECONDS)
                    .subscriptionType(SubscriptionType.Exclusive)
                    .messageListener((MessageListener<String>) (consumer1, msg) -> { 
    
                        /** * 当接收到一个新的消息，就会回调 MessageListener的receive方法。 * 消息将会保证按顺序投放到单个消费者的同一个线程，因此可以保证顺序消费 * 除非应用程序或broker崩溃，否则只会为每条消息调用此方法一次 * 应用程序负责调用消费者的确认方法来确认消息已经被消费 * 应用程序负责处理消费消息时可能出现的异常 */
                        log.info("接收到消息:{}",msg.getValue());
                        try { 
                            consumer1.acknowledge(msg);
                        } catch (PulsarClientException e) { 
                            e.printStackTrace();
                        }
                    }).subscribe();
        }
    }

## 4.3 第三次使用： ##

上面利用监听器来解决死循环代码和阻塞主线程问题；但是我们可以发现，每次消费都是单线程，当一个消息消费完才能进行下一个消息的消费，这样会导致消费效率非常的低；

如果如果追求高吞吐量，不在乎消息消费的顺序性，那么我们可以接入线程池；一有消息来就丢进线程池中，这样不但可以支持异步消费，还能保证消费的效率非常的高。

/** * MessageListener 内使用线程池进行异步消费 * @author winfun **/
    @Slf4j
    public class ThirdConsumerDemo { 
    
        public static void main(String[] args) throws PulsarClientException { 
    
            Executor executor = new ThreadPoolExecutor(
                    10,
                    10,
                    10,
                    TimeUnit.SECONDS,
                    new ArrayBlockingQueue<>(100)
            );
            PulsarClient client = PulsarUtils.createPulsarClient("pulsar://127.0.0.1:6650");
            /** * If you don't want to block your main thread and rather listen constantly for new messages, consider using a MessageListener. * */
            Consumer<String> consumer = client.newConsumer(Schema.STRING)
                    .topic("winfun/study/test-topic")
                    .subscriptionName("my-subscription")
                    .ackTimeout(10, TimeUnit.SECONDS)
                    .subscriptionType(SubscriptionType.Exclusive)
                    .messageListener((MessageListener<String>) (consumer1, msg) -> { 
                        /** * MessageListener还是保证了接收的顺序性 * 但是利用线程池进行异步消费后不能保证消费顺序性 */
                        executor.execute(() -> handleMsg(consumer1, msg));
                    }).subscribe();
        }
    
        /** * 线程池异步处理 * @param consumer 消费者 * @param msg 消息 */
        public static void handleMsg(Consumer consumer, Message msg){ 
    
            ThreadUtil.sleep(RandomUtil.randomInt(3),TimeUnit.SECONDS);
            log.info("接收到消息:{}",msg.getValue());
            try { 
                consumer.acknowledge(msg);
            } catch (PulsarClientException e) { 
                e.printStackTrace();
            }
        }
    }

## 4.4 第四次使用： ##

我们可以发现，在上面的三个例子中，如果在调用Consumer\#acknowledge方法前，因为代码问题导致抛异常了，我们是没有做处理的，那么会导致消费者会一直重试没有被确认的消息。

那么我们此时需要接入Pulsar提供的死信队列：当Consumer消费消息时抛异常，并达到一定的重试次数，则将消息丢入死信队列；但需要注意的是，单独使用死信队列，Consumer的订阅类型需要是 Shared/Key\_Shared；否则不会生效。

/** * 超过最大重试次数，进入死信队列 * @author: winfun **/
    @Slf4j
    public class FourthConsumerDemo { 
    
        public static void main(String[] args) throws PulsarClientException { 
            /** * 如果指定了死信队列策略，但是没指定死信队列 * 死信队列：String.format("%s-%s-DLQ", topic, this.subscription) * 这里的this.subscription为上面指定的 subscriptionName。 * * 一般在生产环境，会将pulsar的自动创建topic功能给关闭掉，所以上线前，记得先提工单创建指定的死信队列。 * * 重点信息： * 如果是单单使用死信队列，subscriptionType为 Shared/Key_Shared，否则死信队列不生效。 */
            PulsarClient client = PulsarUtils.createPulsarClient("pulsar://127.0.0.1:6650");
            Consumer<String> consumer = client.newConsumer(Schema.STRING)
                    .topic("winfun/study/test-topic")
                    .subscriptionName("my-subscription")
                    .receiverQueueSize(100)
                    .ackTimeout(1, TimeUnit.SECONDS)
                    .subscriptionType(SubscriptionType.Key_Shared)
                    .negativeAckRedeliveryDelay(1,TimeUnit.SECONDS)
                    .deadLetterPolicy(DeadLetterPolicy.builder()
                            //可以指定最大重试次数，最大重试三次后，进入到死信队列
                            .maxRedeliverCount(3)
                            //可以指定死信队列
                            .deadLetterTopic("winfun/study/test-topic-dlq3")
                            .build())
                    .messageListener((MessageListener<String>) (consumer1, msg) -> { 
                        log.info("接收到队列「{}」消息:{}",msg.getTopicName(),msg.getValue());
    
                        if (msg.getValue().equals("hello3")) { 
                            throw new RuntimeException("hello3消息消费失败！");
                        }else { 
                            try { 
                                consumer1.acknowledge(msg);
                            } catch (PulsarClientException e) { 
                                e.printStackTrace();
                            }
                        }
                    }).subscribe();
        }
    }

## 4.5 第五次使用： ##

死信队列一般是不做消费的，我们会关注死信队列的情况，从而作出下一步的动作。  
而且，一般做消息重试，我们不希望在原Topic中做重试，这样会影响原有消息的消费进度。

那么我们可以同时使用重试队列和死信队列。  
当代码抛出异常时，我们可以捕获住，然后调用Consumer\#reconsumeLater方法，将消息丢入重试队列；当消息重试指定次数后还无法正常完成消费，即会将消息丢入死信队列。

/** * 重试队列 * @author winfun **/
    @Slf4j
    public class FifthConsumerDemo { 
    
        public static void main(String[] args) throws PulsarClientException { 
            PulsarClient client = PulsarUtils.createPulsarClient("pulsar://127.0.0.1:6650");
            /** * 注意点： * 1、使用死信策略，但是没有指定重试topic和死信topic名称 * 死信队列：String.format("%s-%s-DLQ", topic, this.subscription) * 重试队列：String.format("%s-%s-RETRY", topic, this.subscription) * 这里的this.subscription为上面指定的 subscriptionName。 * * 2、是否限制订阅类型 * 同时开启重试队列和死信队列，不限制subscriptionType只能为Shared/Key_Shared； * 如果只是单独使用死信队列，需要限制subscriptionType为Shared * * 3、重试原理 * 如果使用重试队列，需要保证 enableRetry 是开启的，否则调用 reconsumeLater 方法时会抛异常：org.apache.pulsar.client.api.PulsarClientException: reconsumeLater method not support! * 如果配置了重试队列，consumer会同时监听原topic和重试topic，consumer的实现类对应是：MultiTopicsConsumerImpl * 如果消费消息时调用了 reconsumeLater 方法，会将此消息丢进重试topic * 如果在重试topic重试maxRedeliverCount次后都无法正确ack消息，即将消息丢到死信队列。 * 死信队列需要另起Consumer进行监听消费。 * * 4、直接抛异常 * 如果我们不是业务层面上调用 reconsumeLater 方法来进行重试，而是代码层面抛异常了，如果subscriptionType不为Shared/Key_Shared，消息无法进入重试队列和死信队列，是当前消费者无限在原topic进行消费。 * 而如果如果subscriptionType为Shared/Key_Shared，则消息进行maxRedeliverCount次消费后，会直接进入到死信队列，此时不会用到重试队列。 * 因此，重试队列是仅仅针对 reconsumeLater 方法的，而不针对异常的重试。 */
            Consumer<String> consumer = client.newConsumer(Schema.STRING)
                    .topic("winfun/study/test-retry-topic")
                    .subscriptionName("my-subscription")
                    .receiverQueueSize(100)
                    .ackTimeout(1, TimeUnit.SECONDS)
                    .subscriptionType(SubscriptionType.Exclusive)
                    .negativeAckRedeliveryDelay(1,TimeUnit.SECONDS)
                    .enableRetry(true)
                    .deadLetterPolicy(DeadLetterPolicy.builder()
                                              //可以指定最大重试次数，最大重试三次后，进入到死信队列
                                              .maxRedeliverCount(3)
                                              .retryLetterTopic("winfun/study/test-retry-topic-retry")
                                              //可以指定死信队列
                                              .deadLetterTopic("winfun/study/test-retry-topic-dlq")
                                              .build())
                    .messageListener((MessageListener<String>) (consumer1, msg) -> { 
                        log.info("接收到队列「{}」消息:{}",msg.getTopicName(),msg.getValue());
    
                        if (msg.getValue().equals("hello3")) { 
                            try { 
                                consumer1.reconsumeLater(msg,1,TimeUnit.SECONDS);
                            } catch (PulsarClientException e) { 
                                e.printStackTrace();
                            }
                            //throw new RuntimeException("hello3消息消费失败！");
                        }else { 
                            try { 
                                consumer1.acknowledge(msg);
                            } catch (PulsarClientException e) { 
                                e.printStackTrace();
                            }
                        }
                    }).subscribe();
        }
    }

### 重试机制源码分析 ###

关于重试机制，其实是比较有意思的，下面我们会简单分析一下源码。

1.  判断是否开启重试机制，如果没有开启重试机制，则直接抛异常

public void reconsumeLater(Message<?> message, long delayTime, TimeUnit unit) throws PulsarClientException { 
        // 如果没开启重试机制，直接抛异常
        if (!this.conf.isRetryEnable()) { 
            throw new PulsarClientException("reconsumeLater method not support!");
        } else { 
            try { 
                // 当然了，reconsumeLaterAsync里面也会判断是否开启重试机制
                this.reconsumeLaterAsync(message, delayTime, unit).get();
            } catch (Exception var7) { 
                Throwable t = var7.getCause();
                if (t instanceof PulsarClientException) { 
                    throw (PulsarClientException)t;
                } else { 
                    throw new PulsarClientException(t);
                }
            }
        }
    }

> 还有我们可以发现，pulsar很多方法是支持同步和异步的，而同步就是直接调用异步方法，再后调用get()方法进行同步阻塞等待即可。

1.  调用 reconsumeLaterAsunc 方法，接着调用 get() 进行同步阻塞等待结果

public CompletableFuture<Void> reconsumeLaterAsync(Message<?> message, long delayTime, TimeUnit unit) { 
        if (!this.conf.isRetryEnable()) { 
            return FutureUtil.failedFuture(new PulsarClientException("reconsumeLater method not support!"));
        } else { 
            try { 
                return this.doReconsumeLater(message, AckType.Individual, Collections.emptyMap(), delayTime, unit);
            } catch (NullPointerException var6) { 
                return FutureUtil.failedFuture(new InvalidMessageException(var6.getMessage()));
            }
        }
    }

1.  调用 doReconsumeLater 方法

我们知道，在 Pulsar 的 Consumer 中，可以支持多 Topic 监听，而如果我们加入了重试机制，默认是同个 Consumer 同时监听原队列和重试队列，所以 Consumer 接口的实现此时为 MultiTopicsConsumerImpl，而不是 ComsumerImpl。  
那我们看看 MultiConsumerImpl 的 doReconsumeLater 是如何进行重新消费的：

*  首先判断客户端是否为准备状态
 *  接着判断 AckType 是累计的还是单独的，如果是累计的话，subscriptionType 一定要是 exclusive
 *  不管是累计还是单独的，最后都是调用 ConsumerImpl 的 doReconsumerLater 方法

protected CompletableFuture<Void> doReconsumeLater(Message<?> message, AckType ackType, Map<String, Long> properties, long delayTime, TimeUnit unit) { 
        MessageId messageId = message.getMessageId();
        if (messageId instanceof TopicMessageIdImpl) { 
            messageId = ((TopicMessageIdImpl)messageId).getInnerMessageId();
        }
    
        Preconditions.checkArgument(messageId instanceof MessageIdImpl);
        if (this.getState() != State.Ready && this.getState() != State.Connecting) { 
            this.stats.incrementNumAcksFailed();
            PulsarClientException exception = new PulsarClientException("Consumer not ready. State: " + this.getState());
            if (AckType.Individual.equals(ackType)) { 
                this.onAcknowledge(messageId, exception);
            } else if (AckType.Cumulative.equals(ackType)) { 
                this.onAcknowledgeCumulative(messageId, exception);
            }
    
            return FutureUtil.failedFuture(exception);
        } else { 
            if (delayTime < 0L) { 
                delayTime = 0L;
            }
            // 如果 retryLetterProducer 为null，则尝试创建
            if (this.retryLetterProducer == null) { 
                try { 
                    this.createProducerLock.writeLock().lock();
                    if (this.retryLetterProducer == null) { 
                        this.retryLetterProducer = this.client.newProducer(this.schema).topic(this.deadLetterPolicy.getRetryLetterTopic()).enableBatching(false).blockIfQueueFull(false).create();
                    }
                } catch (Exception var28) { 
                    log.error("Create retry letter producer exception with topic: {}", this.deadLetterPolicy.getRetryLetterTopic(), var28);
                } finally { 
                    this.createProducerLock.writeLock().unlock();
                }
            }
            // 如果 retryLetterProcuder 不为空，则尝试将消息丢进重试队列中
            if (this.retryLetterProducer != null) { 
                try { 
                    MessageImpl<T> retryMessage = null;
                    String originMessageIdStr = null;
                    String originTopicNameStr = null;
                    if (message instanceof TopicMessageImpl) { 
                        retryMessage = (MessageImpl)((TopicMessageImpl)message).getMessage();
                        originMessageIdStr = ((TopicMessageIdImpl)message.getMessageId()).getInnerMessageId().toString();
                        originTopicNameStr = ((TopicMessageIdImpl)message.getMessageId()).getTopicName();
                    } else if (message instanceof MessageImpl) { 
                        retryMessage = (MessageImpl)message;
                        originMessageIdStr = ((MessageImpl)message).getMessageId().toString();
                        originTopicNameStr = ((MessageImpl)message).getTopicName();
                    }
    
                    SortedMap<String, String> propertiesMap = new TreeMap();
                    int reconsumetimes = 1;
                    if (message.getProperties() != null) { 
                        propertiesMap.putAll(message.getProperties());
                    }
    
                    // 如果包含 RECONSUMETIMES，则最递增
                    if (propertiesMap.containsKey("RECONSUMETIMES")) { 
                        reconsumetimes = Integer.valueOf((String)propertiesMap.get("RECONSUMETIMES"));
                        ++reconsumetimes;
                    // 否则先加入「原始队列」和「原始messageId」信息
                    } else { 
                        propertiesMap.put("REAL_TOPIC", originTopicNameStr);
                        propertiesMap.put("ORIGIN_MESSAGE_IDY_TIME", originMessageIdStr);
                    }
                    // 加入重试次数信息
                    propertiesMap.put("RECONSUMETIMES", String.valueOf(reconsumetimes));
                    // 加入延时时间信息
                    propertiesMap.put("DELAY_TIME", String.valueOf(unit.toMillis(delayTime)));
                    TypedMessageBuilder typedMessageBuilderNew;
                    // 判断是否超过最大重试次数，如果还未超过，则重新投放到重试队列
                    if (reconsumetimes <= this.deadLetterPolicy.getMaxRedeliverCount()) { 
                        typedMessageBuilderNew = this.retryLetterProducer.newMessage().value(retryMessage.getValue()).properties(propertiesMap);
                        if (delayTime > 0L) { 
                            typedMessageBuilderNew.deliverAfter(delayTime, unit);
                        }
    
                        if (message.hasKey()) { 
                            typedMessageBuilderNew.key(message.getKey());
                        }
                        // 发送延时消息
                        typedMessageBuilderNew.send();
                        // 确认当前消息
                        return this.doAcknowledge(messageId, ackType, properties, (TransactionImpl)null);
                    }
                    // 先忽略
                    this.processPossibleToDLQ((MessageIdImpl)messageId);
                    // 判断 deadLetterProducer 是否为null，如果为null，尝试创建
                    if (this.deadLetterProducer == null) { 
                        try { 
                            if (this.deadLetterProducer == null) { 
                                this.createProducerLock.writeLock().lock();
                                this.deadLetterProducer = this.client.newProducer(this.schema).topic(this.deadLetterPolicy.getDeadLetterTopic()).blockIfQueueFull(false).create();
                            }
                        } catch (Exception var25) { 
                            log.error("Create dead letter producer exception with topic: {}", this.deadLetterPolicy.getDeadLetterTopic(), var25);
                        } finally { 
                            this.createProducerLock.writeLock().unlock();
                        }
                    }
                    // 如果 deadLetterProducer 不为null
                    if (this.deadLetterProducer != null) { 
                        // 加入「原始队列」信息
                        propertiesMap.put("REAL_TOPIC", originTopicNameStr);
                        // 加入「原始MessageId」信息
                        propertiesMap.put("ORIGIN_MESSAGE_IDY_TIME", originMessageIdStr);
                        typedMessageBuilderNew = this.deadLetterProducer.newMessage().value(retryMessage.getValue()).properties(propertiesMap);
                        // 将消息内容发往死信队列中
                        typedMessageBuilderNew.send();
                        // 确认当前消息
                        return this.doAcknowledge(messageId, ackType, properties, (TransactionImpl)null);
                    }
                } catch (Exception var27) { 
                    log.error("Send to retry letter topic exception with topic: {}, messageId: {}", new Object[]{ this.deadLetterProducer.getTopic(), messageId, var27});
                    Set<MessageId> messageIds = new HashSet();
                    messageIds.add(messageId);
                    this.unAckedMessageTracker.remove(messageId);
                    this.redeliverUnacknowledgedMessages(messageIds);
                }
            }
    
            return CompletableFuture.completedFuture((Object)null);
        }
    }

分析了一波，我们可以看到和上面代码的注释描述的基本一致。

## 4.6 第六次使用 ##

上面我们提到，当Consumer指定了重试队列，Consumer会同时监听原Topic和重试Topic，那么如果我们想多个Consumer消费重试Topic时，需要将Consumer的订阅类型指定为 Shared/Key\_Shared，让重试队列支持多Consumer监听消费，提升重试队列的消费效率。

/** * 重试队列-Shared * @author winfun **/
    @Slf4j
    public class SixthConsumerDemo { 
    
        public static void main(String[] args) throws PulsarClientException { 
            PulsarClient client = PulsarUtils.createPulsarClient("pulsar://127.0.0.1:6650");
            /** * 因为如果指定了重试策略，Consumer会同时监听「原队列」和「重试队列」 * 即如果我们想「重试队列」可以让多个 Consumer 监听，从而提高消费能力，那么 Consumer 需指定为 Shared 模式。 */
            Consumer<String> consumer = client.newConsumer(Schema.STRING)
                    .topic("winfun/study/test-retry-topic")
                    .subscriptionName("my-subscription")
                    .receiverQueueSize(100)
                    .ackTimeout(1, TimeUnit.SECONDS)
                    .subscriptionType(SubscriptionType.Shared)
                    .negativeAckRedeliveryDelay(1,TimeUnit.SECONDS)
                    .enableRetry(true)
                    .deadLetterPolicy(DeadLetterPolicy.builder()
                                              //可以指定最大重试次数，最大重试三次后，进入到死信队列
                                              .maxRedeliverCount(3)
                                              .retryLetterTopic("winfun/study/test-retry-topic-retry")
                                              //可以指定死信队列
                                              .deadLetterTopic("winfun/study/test-retry-topic-dlq")
                                              .build())
                    .messageListener((MessageListener<String>) (consumer1, msg) -> { 
                        log.info("接收到队列「{}」消息:{}",msg.getTopicName(),msg.getValue());
    
                        if (msg.getValue().contains("1") || msg.getValue().contains("2") || msg.getValue().contains("3")) { 
                            try { 
                                consumer1.reconsumeLater(msg,1,TimeUnit.SECONDS);
                            } catch (PulsarClientException e) { 
                                e.printStackTrace();
                            }
                            //throw new RuntimeException("hello3消息消费失败！");
                        }else { 
                            try { 
                                consumer1.acknowledge(msg);
                            } catch (PulsarClientException e) { 
                                e.printStackTrace();
                            }
                        }
                    }).subscribe();
        }
    }
    
    
    /** * 监听重试队列-Shared订阅模式 * @author winfun **/
    @Slf4j
    public class RetryConsumerDemo { 
    
        public static void main(String[] args) throws PulsarClientException { 
    
            PulsarClient client = PulsarUtils.createPulsarClient("pulsar://127.0.0.1:6650");
            Consumer<String> deadLetterConsumer = client.newConsumer(Schema.STRING)
                    .topic("winfun/study/test-retry-topic-retry")
                    .subscriptionName("my-subscription2")
                    .receiverQueueSize(100)
                    .ackTimeout(1, TimeUnit.SECONDS)
                    .subscriptionType(SubscriptionType.Shared)
                    .messageListener((MessageListener<String>) (consumer1, msg) -> { 
                        log.info("接收到队列「{}」消息:{}",msg.getTopicName(),msg.getValue());
                        try { 
                            consumer1.acknowledge(msg);
                        } catch (PulsarClientException e) { 
                            e.printStackTrace();
                        }
                    }).subscribe();
        }
    }

到此，我们已经将Consmuer的几种使用方式都尝试了一遍，可以说基本包含了常用的操作；但是我们可以发现，如果我们每次新建一个Consumer都需要写一堆同样的代码，那其实挺麻烦的，又不好看；并且，现在我们大部分项目都是基于 SpringBoot 来做的，而 SpringBoot 也没有一个比较大众的Starter。

所以接下来的计划就是，自己写一个编写一个关于Pulsar的SpringBoot Starter，这个组件不会特别复杂，但是会支持 Producer 和 Cousnmer 的自动配置，并且支持 Consumer 上面提到的几个点：MessageListener 监听、线程池异步并发消费、重试机制等。