c# DotNetty

对于 .NET 开发者来说，DotNetty 是一个开源、高性能的网络库，它是对 Java 平台上流行的 Netty 异步事件驱动网络应用程序框架的一个端口。DotNetty 适用于创建各种网络应用程序，如 IoT (物联网)、游戏服务器以及消息传递系统等。 以下是对 DotNetty 核心组件的简要说明：

1. Bootstrap 类 —— 这个类用于简化创建服务器和客户端的初始化操作。对于服务器而言，通常使用 ServerBootstrap，而客户端使用 Bootstrap。
2. EventLoopGroup —— 用于处理所有的事件操作，如接受新的连接、读写数据等。通常会有两组：一个负责接受客户端连接的 bossGroup 和另一个用于处理客户端活动如读写的 workerGroup。
3. Channel —— 表示一个到远程节点的或从远程节点过来的活动连接。在服务器端，通常使用 IChannel 接口中定义的 TcpServerSocketChannel。
4. Handler —— 在 DotNetty 中，网络事件由 ChannelHandler 处理。这些处理程序通常负责应用程序逻辑，如接受客户端发来的数据并进行相应处理。
5. Pipeline —— 是 ChannelHandler 的容器，它定义了用于处理入站（IChannelRead）和出站（IChannelWrite）操作的处理程序链。每个 Channel 都有自己的 Pipeline。
6. Buffer —— DotNetty 提供了 ByteBuffer 类用以操作字节数据。你可以从 Channel 中读取数据到 ByteBuffer，也可以将数据从 ByteBuffer 写入到 Channel。
7. Codec —— 编解码器，用于数据转换，将从 Channel 读取的原始字节数据转换为应用程序可以处理的格式，或者将应用程序的消息转换为字节数据发送。 举一个 DotNetty 的实际使用例子，创建一个简单的回声服务器（Echo Server）的核心组件代码如下：

安装 DotNetty：

• 首先，你需要通过 NuGet 包管理器来安装 DotNetty。打开你的项目，在 Package Manager Console 中输入以下命令：

  Install-Package DotNetty -Version 
  

  创建一个 EchoServerHandler 类，继承自 ChannelHandlerAdapter。在这个类中，你将重写 ChannelRead 方法来处理接收到的消息，并将其发送回客户端：

  using DotNetty.Transport.Channels;
  public class EchoServerHandler : ChannelHandlerAdapter
  {
      public override void ChannelRead(IChannelHandlerContext context, object message)
      {
          // 将接收到的消息发送回客户端
          context.WriteAndFlushAsync(message);
      }
      public override void ExceptionCaught(IChannelHandlerContext context, Exception exception)
      {
          // 打印异常信息
          Console.WriteLine("Exception: " + exception.ToString());
          context.CloseAsync();
      }
  }
  

  接下来的一步是创建包含服务端逻辑的 EchoServer 类。这个类负责使用 ServerBootstrap 来设置服务器需要的相关配置。

  // 确保引用了这些必需的命名空间
  using DotNetty.Transport.Channels;
  using DotNetty.Transport.Bootstrapping;
  using DotNetty.Transport.Channels.Sockets;
  using System.Threading.Tasks;
  using System;
  public class EchoServer
  {
      private readonly int port;
      public EchoServer(int port)
      {
          this.port = port;
      }
      public async Task RunServerAsync()
      {
          var bossGroup = new MultithreadEventLoopGroup(1); // 处理传入的连接
          var workerGroup = new MultithreadEventLoopGroup(); // 处理已被接受的连接
          try
          {
              var bootstrap = new ServerBootstrap();
              bootstrap
                  .Group(bossGroup, workerGroup)
                  .Channel() // 指定使用 TcpServerSocketChannel 作为服务器的通道类型
                  .ChildHandler(new ActionChannelInitializer(channel =>
                  {
                      // 配置新连接的 ChannelPipeline
                      IChannelPipeline pipeline = channel.Pipeline;
                      pipeline.AddLast("echo", new EchoServerHandler()); // 添加你的 handler
                  }));
              IChannel boundChannel = await bootstrap.BindAsync(port); // 绑定并开始接受传入的连接
              Console.WriteLine("EchoServer running on port " + port + ".");
              await boundChannel.CloseCompletion; // 关闭服务器
          }
          finally
          {
              // 优雅关闭
              bossGroup.ShutdownGracefullyAsync().Wait();
              workerGroup.ShutdownGracefullyAsync().Wait();
          }
      }
  }
  public static class Program
  {
      public static void Main(string[] args)
      {
          int port = 8080; // 举例使用 8080 端口
          var server = new EchoServer(port);
          server.RunServerAsync().Wait();
      }
  }