【051】Dubbo3从0到1系列之HeaderExchanger

2.23 HeaderExchanger

HeaderExchanger 是 Dubbo 框架中实现 Exchanger 接口的一个具体类，它负责创建带有消息头（header）支持的客户端和服务器端连接。这个类的主要作用是为 Dubbo 提供一种基于头部信息交换的通信机制。

2.23.1 Exchange层

@SPI(value = HeaderExchanger.NAME, scope = ExtensionScope.FRAMEWORK)
public interface Exchanger {
    // ...    
}

2.23.2 主要功能点

1. 🥇 创建 ExchangeClient

• 当调用 connect 方法时，会通过 Transporters.connect() 建立一个底层网络连接。
• 使用了装饰器模式，在传入的 ExchangeHandler 外层包装了 HeaderExchangeHandler 和 DecodeHandler 来处理协议解析与请求响应逻辑。
• 最终返回的是一个 HeaderExchangeClient 实例，它是对原始客户端连接的一层封装，增加了对消息头的支持。

2. ➡️ 绑定 ExchangeServer

• 在 bind 方法中根据 URL 参数决定是否启用端口统一服务（Port Unification Server, PU Server）。这允许单个端口上运行多种协议。
• 如果启用了 PU Server，则使用 PortUnificationExchanger.bind() 绑定；否则直接使用 Transporters.bind() 进行常规绑定。
• 同样地，这里也采用了多层处理器结构：HeaderExchangeHandler 负责处理特定于 header 的交互逻辑，而 DecodeHandler 则用来解码收到的数据包。
• 返回值是一个 HeaderExchangeServer 对象，代表了一个能够处理带 header 信息的消息的服务端实例。

3. 🚀 关键组件说明

• HeaderExchangeHandler: 专门用于处理带有 header 的消息交换逻辑。
• DecodeHandler: 解码从网络接收到的字节流，并将其转换成合适的内部对象以便进一步处理。
• Transporters: 提供了一种抽象方式来获取不同类型的传输层实现（如 Netty、Mina 等），使得上层可以不依赖具体的网络库。
• PortUnificationExchanger: 支持在同一端口上同时监听并处理多个协议（例如 HTTP 和 Dubbo 自身协议）的能力。

4. 🎲 设计模式应用

• 使用了装饰者模式来动态地给基本功能添加额外职责（比如编码/解码以及 header 相关的操作）而不改变原有行为。
• 采用工厂方法模式的思想隐藏了复杂对象的创建过程，简化了对外接口的设计。

总结来说，HeaderExchanger 类通过对底层 transport 层进行适当的封装与增强，实现了更加丰富且灵活的消息交换能力，尤其适合需要携带额外元数据（即 headers）的应用场景。这种架构不仅提高了系统的可扩展性和维护性，也为未来可能引入的新特性打下了坚实的基础。