Netty技术全解析：CombinedChannelDuplexHandler详解

❃博主首页 ： 「码到三十五」 ，同名公众号 :「码到三十五」，wx号 : 「liwu0213」
☠博主专栏 ： <mysql高手> <elasticsearch高手> <源码解读> <java核心> <面试攻关>
♝博主的话 ： 搬的每块砖，皆为峰峦之基；公众号搜索「码到三十五」关注这个爱发技术干货的coder，一起筑基

---

Netty是一个高性能、异步事件驱动的NIO框架，广泛应用于开发网络应用程序。在Netty中，ChannelHandler是处理网络事件的核心组件，而CombinedChannelDuplexHandler则是一个特殊的ChannelHandler，它同时实现了ChannelInboundHandler和ChannelOutboundHandler接口，因此能够处理入站和出站事件。

本文将深入介绍CombinedChannelDuplexHandler的技术细节，包括其工作原理、使用方法以及源码解析。

一、CombinedChannelDuplexHandler介绍

CombinedChannelDuplexHandler是一个便捷的处理器，它结合了入站和出站事件的处理能力。这意味着你可以在一个处理器中同时处理进入和离开Netty应用程序的网络事件。

当一个新的入站事件到达时，CombinedChannelDuplexHandler会调用其channelRead、channelActive等入站方法进行处理。同样地，当你需要发送一个出站事件时，可以调用write、flush等出站方法，CombinedChannelDuplexHandler会相应地处理这些事件。

二、CombinedChannelDuplexHandler的工作原理

CombinedChannelDuplexHandler能够处理入站和出站事件。这种设计使得开发者可以在一个处理器中同时处理数据的接收和发送逻辑，提高了代码的可维护性和复用性。其工作原理总结如下：

1. 类定义与泛型参数

CombinedChannelDuplexHandler是一个抽象类，通常需要通过继承它来创建具体的处理器实现。它接受两个泛型参数I和O，分别代表入站和出站事件的消息类型。这使得开发者可以在编译时就确定消息的类型，从而避免了运行时的类型转换错误。

2. 管道中的位置

在Netty的ChannelPipeline中，CombinedChannelDuplexHandler可以被放置在任意位置。由于它同时处理入站和出站事件，因此它的位置取决于开发者希望在哪里处理这些事件。通常，它会被放置在靠近ChannelPipeline两端的位置，以便尽早或尽晚地处理数据。

3. 入站事件处理

当Netty接收到一个新的入站事件（如数据报、连接事件等）时，它会按照ChannelPipeline中的顺序调用相应的ChannelInboundHandler。如果CombinedChannelDuplexHandler被配置在管道中，那么它的channelRead方法将被调用。

• 类型检查：在channelRead方法中，CombinedChannelDuplexHandler首先检查接收到的消息类型是否与泛型参数I匹配。如果匹配，则继续处理；如果不匹配，则通过ctx.fireChannelRead(msg)将消息传递给下一个ChannelInboundHandler。
• 消息处理：如果消息类型匹配，CombinedChannelDuplexHandler会将消息转换为泛型参数I指定的类型，并调用channelRead0方法进行具体处理。channelRead0是一个抽象方法，需要由子类实现。

4. 出站事件处理

当Netty需要发送一个出站事件（如写数据、关闭连接等）时，它会按照ChannelPipeline中的逆序调用相应的ChannelOutboundHandler。如果CombinedChannelDuplexHandler被配置在管道中，那么它的write方法将被调用。

• 类型检查：与入站事件类似，CombinedChannelDuplexHandler在write方法中也会检查要发送的消息类型是否与泛型参数O匹配。
• 消息处理：如果消息类型匹配，CombinedChannelDuplexHandler会将消息转换为泛型参数O指定的类型，并调用write0方法进行具体处理。同样，write0也是一个抽象方法，需要由子类实现。

5. 上下文传递与事件传播

在处理入站和出站事件时，CombinedChannelDuplexHandler通过ChannelHandlerContext与ChannelPipeline进行交互。ChannelHandlerContext提供了丰富的API来触发事件传播、修改管道、存储属性等。这使得CombinedChannelDuplexHandler能够灵活地与其他处理器协作，共同完成复杂的网络事件处理逻辑。

6. 总结

CombinedChannelDuplexHandler通过其独特的设计——同时实现入站和出站事件处理能力——为Netty开发者提供了一种高效、便捷的方式来处理网络事件。通过泛型参数确保类型安全，通过ChannelPipeline中的灵活位置确保处理逻辑的可定制性，CombinedChannelDuplexHandler无疑是Netty框架中一个非常重要的组件。开发者可以通过继承这个类并实现相应的抽象方法来创建自己的处理器，以满足各种复杂的网络应用需求。

三、使用CombinedChannelDuplexHandler

要使用CombinedChannelDuplexHandler，你需要创建一个继承自它的类，并实现你需要的入站和出站方法。以下是一个简单的例子：

public class MyCombinedChannelDuplexHandler extends CombinedChannelDuplexHandler {
    @Override
    public void channelRead(ChannelHandlerContext ctx, Object msg) throws Exception {
        // 处理入站事件
        System.out.println("Received message: " + msg);
        // 可以将消息传递给下一个ChannelHandler
        ctx.fireChannelRead(msg);
    }

    @Override
    public void write(ChannelHandlerContext ctx, Object msg, ChannelPromise promise) throws Exception {
        // 处理出站事件
        System.out.println("Sending message: " + msg);
        // 实际上将消息写出到网络
        ctx.write(msg, promise);
    }
}

在这个例子中，MyCombinedChannelDuplexHandler类同时处理了入站和出站事件。当接收到一个入站消息时，它会打印出来，并可以选择将消息传递给下一个ChannelHandler。当需要发送一个出站消息时，它也会打印出来，并通过调用ctx.write方法将消息写出到网络。

四、源码解析

以下是CombinedChannelDuplexHandler的部分源码，展示了它是如何处理入站和出站事件的：

public abstract class CombinedChannelDuplexHandler<I, O> extends ChannelDuplexHandler {
    // ...

    @Override
    public void channelRead(ChannelHandlerContext ctx, Object msg) throws Exception {
        if (acceptInboundMessage(msg)) {
            @SuppressWarnings("unchecked")
            I imsg = (I) msg;
            channelRead0(ctx, imsg);
        } else {
            ctx.fireChannelRead(msg);
        }
    }

    // ...

    protected abstract void channelRead0(ChannelHandlerContext ctx, I msg) throws Exception;

    // ...

    @Override
    public void write(ChannelHandlerContext ctx, Object msg, ChannelPromise promise) throws Exception {
        if (acceptOutboundMessage(msg)) {
            @SuppressWarnings("unchecked")
            O omsg = (O) msg;
            write0(ctx, omsg, promise);
        } else {
            ctx.write(msg, promise);
        }
    }

    // ...

    protected abstract void write0(ChannelHandlerContext ctx, O msg, ChannelPromise promise) throws Exception;
}

在channelRead方法中，CombinedChannelDuplexHandler首先检查接收到的消息是否是处理器所期望的类型。如果是，那么将消息转换为正确的类型，并调用channelRead0方法进行处理。如果不是，那么将消息传递给下一个ChannelInboundHandler。

类似地，在write方法中，CombinedChannelDuplexHandler也会检查要发送的消息是否是处理器所期望的类型。如果是，那么将消息转换为正确的类型，并调用write0方法进行处理。如果不是，那么直接调用ctx.write方法将消息写出到网络。

总结

CombinedChannelDuplexHandler是Netty中一个非常有用的处理器，它同时实现了入站和出站事件的处理能力。通过继承这个类并实现相应的入站和出站方法，你可以在一个处理器中同时处理进入和离开Netty应用程序的网络事件。这使得代码更加简洁、易于维护和理解。同时，CombinedChannelDuplexHandler还提供了类型安全的消息处理方法，避免了类型转换错误和运行时异常。

---

关注公众号[码到三十五]获取更多技术干货 !