知识卡片

结构图卡

序列化器三方法契约

理解等级:中级

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 : 序列化其字段
这张卡片看不懂?

已有反馈 · 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”。