知识卡片
生产者拦截器回调时序
自定义生产者拦截器实现 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
这张卡片看不懂?
这张卡片的反馈已满 10 条,暂时无法继续提交。
已有反馈 · 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()方法主要用于在关闭拦截器时执行一些资源的清理工作。