知识卡片

结构图卡

生产者拦截器回调时序

理解等级:中级

自定义生产者拦截器实现 ProducerInterceptor,它继承 Configurable。onSend 在记录序列化和计算分区前触发,可改写待发记录;onAcknowledgement 在消息获应答前或发送失败时触发,且先于用户的 Callback。后者运行在生产者 I/O 线程,耗时统计会拖慢发送,应保持简短。close 负责清理资源。接口说明了两个扩展点的位置,也说明拦截器不是独立于发送路径运行的后台任务。

结构图: 类图中实线空心箭头表示接口继承,虚线空心箭头表示示例类实现接口;回调时序详见正文。

classDiagram
    class Configurable {
        <<interface>>
        +configure(Map configs) void
    }
    class ProducerInterceptor {
        <<interface>>
        +onSend(ProducerRecord record) ProducerRecord
        +onAcknowledgement(RecordMetadata metadata, Exception exception) void
        +close() void
    }
    class ProducerInterceptorPrefix
    Configurable <|-- ProducerInterceptor
    ProducerInterceptor <|.. ProducerInterceptorPrefix
这张卡片看不懂?

已有反馈 · 0 / 10 条

    还没有人提交反馈。

    原书出处

    参考来源

    - 位置:《深入理解Kafka:核心设计与实践原理 2019》第2章《生产者》2.1.5「生产者拦截器」(源文件:`_epub-src/OEBPS/Text/chapter3.xhtml`;接口和示例代码截图 `46_3.jpg`、`47_1.jpg`、`48_1.jpg`) - 结论依据:原文给出三个回调的触发位置、`onAcknowledgement` 的 I/O 线程约束及 `Configurable` 父接口;代码截图核对接口签名与示例实现。 - 原始内容:KafkaProducer在将消息序列化和计算分区之前会调用生产者拦截器的onSend()方法来对消息进行相应的定制化操作。……KafkaProducer 会在消息被应答(Acknowledgement)之前或消息发送失败时调用生产者拦截器的 onAcknowledgement()方法,优先于用户设定的 Callback 之前执行。这个方法运行在Producer 的 I/O 线程中,所以这个方法中实现的代码逻辑越简单越好,否则会影响消息的发送速度。……close()方法主要用于在关闭拦截器时执行一些资源的清理工作。