搭建第一个Netty服务器和客户端

搭建第一个Netty应用程序

本篇文章主要记录如何搭建一个简单的Netty服务器和客户端。

依赖环境:

  • Java 8
  • Netty4

    
        io.netty
        netty-all
        4.1.11.Final
    

编写Echo服务器

所有的Netty服务器都需要以下两个部分。

  • 至少一个ChannelHandler:用来处理业务逻辑
  • 引导:配置服务器启动代码,将服务器绑定到监听连接请求的端口上。

EchoServerHandler类:用来处理核心业务逻辑

@ChannelHandler.Sharable
public class EchoServerHandler extends ChannelInboundHandlerAdapter{

    @Override
    public void channelRead(ChannelHandlerContext context, Object msg) {
        ByteBuf in = (ByteBuf) msg;
        System.out.println("server received: " + in.toString(CharsetUtil.UTF_8));
        context.write(in);
    }

    @Override
    public void channelReadComplete(ChannelHandlerContext ctx) {
        ctx.writeAndFlush(Unpooled.EMPTY_BUFFER).addListener(ChannelFutureListener.CLOSE);
    }

    @Override
    public void exceptionCaught(ChannelHandlerContext context, Throwable couse) {
        couse.printStackTrace();
        context.close();
    }
}

EchoServer类:配置服务器,并将入站消息通知给EchoServerHandler实例。

public class EchoServer {

    private final int port;

    public EchoServer(int port) {
        this.port = port;
    }

    public static void main(String[] args) throws Exception {
        System.err.println("Usage: " + EchoServer.class.getSimpleName() + "");
        int port = 8999;
        new EchoServer(port).start();
    }

    public void start() throws Exception{
        final EchoServerHandler serverHandler = new EchoServerHandler();
        EventLoopGroup group = new NioEventLoopGroup();
        try {
            ServerBootstrap b = new ServerBootstrap();
            b.group(group).channel(NioServerSocketChannel.class)
             .localAddress(new InetSocketAddress(port)).childHandler(new ChannelInitializer() {
                @Override
                protected void initChannel(SocketChannel socketChannel) throws Exception {
                    socketChannel.pipeline().addLast(serverHandler);
                }
            });
            ChannelFuture future = b.bind().sync();
            future.channel().closeFuture().sync();
        } finally {
            group.shutdownGracefully().sync();
        }
    }
}

服务器主要的代码组件

  • EchoServerHandler实现业务逻辑
  • main()引导服务器

引导过程:

  • 创建一个ServerBootstap实例以引导和绑定服务器;
  • 创建并分配一个NioEventLoopGroup实例以进行事件的处理,如接受新连接以及读写数据;
  • 指定服务器绑定的本地的InetSocketAddress;
  • 使用一个Handler实例初始化新的Channel;
  • 调用ServerBootstap.bind()方法以绑定服务器;

编写Echo客户端

Echo客户端:

  1. 连接服务器
  2. 发送一个或多个消息
  3. 对于每个消息,等待并接受从服务器发回的相同的消息
  4. 关闭连接

ChannelHandler类:实现客户端逻辑

  • channelActive()和服务器建立连接后调用
  • channelRead()从服务器接受到一条信息后调用
  • exceptionCaught()处理过程中出现异常时被调用
@ChannelHandler.Sharable
public class EchoClientHandle extends SimpleChannelInboundHandler{

    @Override
    public void channelActive(ChannelHandlerContext context) {
        context.writeAndFlush(Unpooled.copiedBuffer("Netty rocks", CharsetUtil.UTF_8));
    }

    @Override
    protected void channelRead0(ChannelHandlerContext channelHandlerContext, ByteBuf byteBuf) throws Exception {
        System.out.println("Client received: " + byteBuf.toString(CharsetUtil.UTF_8));
    }

    @Override
    public void exceptionCaught(ChannelHandlerContext context, Throwable cause) {
        cause.printStackTrace();
        context.close();
    }
}

EchoClient类:引导客户端

public class EchoClient {

    // 使用的是服务器的地址
    private final String host;
    private final int port;

    public EchoClient(String host, int port) {
        this.host = host;
        this.port = port;
    }

    public void start() throws Exception{
        EventLoopGroup group = new NioEventLoopGroup();
        try {
            Bootstrap b = new Bootstrap();
            b.group(group)
             .channel(NioSocketChannel.class)
             .remoteAddress(new InetSocketAddress(host, port))
             .handler(new ChannelInitializer() {
                 @Override
                 protected void initChannel(SocketChannel socketChannel) throws Exception {
                     socketChannel.pipeline().addLast(new EchoClientHandle());
                 }
             });
            ChannelFuture future = b.connect().sync();
            future.channel().closeFuture().sync();
        } finally {
            group.shutdownGracefully().sync();
        }
    }

    public static void main(String[] args) throws Exception {
        new EchoClient("localhost", 8999).start();
    }
}

GitHub地址:https://github.com/huangbuhuan/netty-demo

参考连接

  • 《Netty In Action》

你可能感兴趣的