知识卡片
序列化器三方法契约
Serializer<T> 规定生产者如何把应用对象转成传输用的 byte[]:configure 接收配置,serialize 执行转换,close 释放资源。书中的 StringSerializer 和自定义 CompanySerializer 都实现这一接口,因此可分别按键或值的类型替换。StringSerializer 未配置自定义编码时使用 UTF-8;配置与编码是两个不同步骤。close 可能被生产者调用多次;自定义实现若占有资源,重复关闭也应安全。接口只统一调用形式,具体字节格式仍须与消费者反序列化器约定,见 [[序列化是契约]]。
结构图:
类图中的虚线空心箭头表示实现接口;Company 是示例数据类型,不是序列化器的父类。
classDiagram
class Serializer~T~ {
<<interface>>
+configure(Map configs, boolean isKey) void
+serialize(String topic, T data) byte[]
+close() void
}
class StringSerializer {
+serialize(String topic, String data) byte[]
}
class CompanySerializer {
+serialize(String topic, Company data) byte[]
}
class Company
Serializer~String~ <|.. StringSerializer
Serializer~Company~ <|.. CompanySerializer
CompanySerializer ..> Company : 序列化其字段
这张卡片看不懂?
这张卡片的反馈已满 10 条,暂时无法继续提交。
已有反馈 · 0 / 10 条
还没有人提交反馈。
原书出处
参考来源
- 位置:《深入理解Kafka:核心设计与实践原理 2019》第2章《生产者》2.1.3「序列化」(源文件:`_epub-src/OEBPS/Text/chapter3.xhtml`;接口及实现代码截图 `40_3.jpg`、`41_1.jpg`、`42_2.jpg`、`43_1.jpg`)
- 结论依据:原文列出 `Serializer` 的三个方法并说明 `close` 的幂等性;截图展示 `StringSerializer` 与 `CompanySerializer` 实现接口,以及后者接收 `Company` 数据。
- 原始内容:除了用于String类型的序列化器,还有ByteArray、ByteBuffer、Bytes、Double、Integer、Long这几种类型,它们都实现了org.apache.kafka.common.serialization.Serializer接口,此接口有3个方法: configure()方法用来配置当前类,serialize()方法用来执行序列化操作。而close()方法用来关闭当前的序列化器,一般情况下 close()是一个空方法,如果实现了此方法,则必须确保此方法的幂等性……所以一般情况下encoding的值就为默认的“UTF-8”。