接口 Producer

  • 所有超级接口:
    Admin
    所有已知实现类:
    ProducerBean

    public interface Producer
    extends Admin
    消息生产者接口.

    1. 线程安全性: 本接口的实现类都是线程安全的, 可以多线程并发发送消息.
    2. 一个实例可以发送多个主题的消息
    3. 正常情况下, 一个实例足够高效完成本模块的发送任务, 无需创建多个实例
    • 方法详细资料

      • start

        void start()
        启动服务
        指定者:
        start 在接口中 Admin
      • shutdown

        void shutdown()
        关闭服务
        指定者:
        shutdown 在接口中 Admin
      • send

        SendResult send​(Message message)
        同步发送消息,只要不抛异常就表示成功
        参数:
        message - 要发送的消息对象
        返回:
        发送结果,含消息Id, 消息主题
      • sendOneway

        void sendOneway​(Message message)
        发送消息,Oneway形式,服务器不应答,无法保证消息是否成功到达服务器
        参数:
        message - 要发送的消息
      • sendAsync

        void sendAsync​(Message message,
                       SendCallback sendCallback)
        发送消息,异步Callback形式
        参数:
        message - 要发送的消息
        sendCallback - 发送完成要执行的回调函数
      • setCallbackExecutor

        void setCallbackExecutor​(ExecutorService callbackExecutor)
        设置异步发送消息执行Callback的目标线程池。

        如果不设置,将使用公共线程池,仅建议执行轻量级的Callback任务,避免阻塞公共线程池 引起其它链路超时。

        参数:
        callbackExecutor - 执行Callback的线程池