Netty核心API

ChannelHandler及其实现类

ChannelHandler接口定义了许多事件处理的方法,我们可以通过重写这些方法去实现具体的业务逻辑。

我们经常需要自定义一个Handler类去继承ChannelInboundHandlerAdapter,然后通过重写相应方法实现业务逻辑,需要重写的方法:

public void channelActive(ChannelHandlerContext ctx),通道就绪事件

public void channelRead(ChannelHandlerContext ctx,Object msg),通道读取数据事件

public void channelReadComplete(ChannelHandlerContext ctx),数据读取完毕事件

public void exceptionCaught(ChannelHandlerContext ctx,Throwable cause),通道发生异常事件

Pipeline 和 ChannelPiepline

ChannelPipeline是一个handler的集合,它负责处理和拦截inbound或者outbound的事件和操作,相当于一个贯穿Netty的链。

ChannelPipeline addFirst(ChannelHandler...handlers),把一个业务处理类(handler)添加到链中的第一个位置

ChannelPipeline addLast(ChannelHandler...handlers),把一个业务处理类(handler)添加到链中的最后一个位置

ChannelHandlerContext

这是事件处理器上下文对象,pipeline链中的实际处理节点。每个处理节点ChannelHandlerContext中包含一个具体的事件处理器ChannelHandler,同时ChannelHandlerContext中也绑定了对应的pipeline和Channel的信息,方便对ChannelHandler进行调用。

常用方法:

ChannelFuture close(),关闭通道

ChannelOutboundInvoker flush(),刷新

ChannelFuture writeAndFlush(Object msg),将数据写到ChannelPipeline中当前ChannelHandler的下一个ChannelHandler开始处理(出站)

ChannelOption

Netty在创建Channel实例后,一般都需要设置ChannelOption参数。ChannelOption是Socket的标准参数,而非Netty独创的。常用的参数配置有

1.ChannelOption.SO_BACKLOG

对应TCP/IP协议listen函数中backlog参数,用来初始化服务器可连接队列大小。服务器端处理客户端连接是顺序处理的,所以同一时间只能处理一个客户端连接。多个客户端来的时候,服务器端将不能处理的客户端连接请求放在队列中等待处理,backlog参数指定了队列的大小。

2.ChannelOption.SO_KEEPALIVE,一直保持连接活动状态。

ChannelFuture

表示Channel中异步I/O操作的结果,在Netty中所有的I/O操作都是异步的,I/O的调用会直接返回,调用者并不能立刻获得结果,但是可以通过ChannelFutrue来获取I/O操作的处理状态。

常用方法:

Channel channel(),返回当前正在进行IO操作的通道

ChannelFuture sync(),等待异步操作执行完毕

EventLoopGroup和其实现类NioEventLoopGroup

EventLoopGroup是一组EventLoop的抽象,Netty为了更好的利用多核CPU资源,一般会有多个EventLoop同时工作,每个EventLoop维护着一个Selector实例。

EventLoopGroup提供next接口,可以从组里面按照一定规则获取其中一个EventLoop来处理任务。在Netty服务器端编程中,我们一般都需要提供两个EventLoopGroup,例如BossEvenLoopGroup和WorkerEventLoopGroup。

通常一个服务器端口即一个ServerSocketChannel对应一个Selector和一个EventLoop线程。BossEventLoop负责接收客户端连接并将SocketChannel交给WorkerEventLoopGroup来进行IO处理。

BossEventLoopGroup通常是一个单线程的EventLoop,EventLoop维护着一个注册了ServerSoketChannel的Selector实例,BossEventLoop不断轮询Selector将连接事件分离出来,通常是OP——ACCEPT事件,然后将连接到的SocketChannel交给WorkerEventLoopGroup,WorkerEventLoopGroup会由next选择其中一个EventLoopGroup来将这个SocketChannel注册到其他维护的Selector并对其后续的IO事件进行处理。

常用方法:

public NioEventLoopGroup(),构造方法

public Future shutdownGracefully(),断开连接,关闭线程。

ServerBootstrap和Bootstrap

ServerBootstrap是Netty中服务器端启动助手,通过它可以完成服务器端的各种配置:Bootstrap是Netty中的客户端启动助手,通过它可以完成客户端的各种配置,

常用方法:

public ServerBootstrap group(EventLoopGroup parentGroup,EventLoopGroup childGroup),该方法用于服务器端,用来设置两个EventLoop

public B channel(ClasschannelClass),该方法用来设置一个服务器端的通道实现

public B option(ChannelOptionoption,T value),用来给ServerChannel添加配置

public ServerBootstrap childOption(ChannelOption childOption,T value),用来给接收到的通道添加配置

public ServerBootstrap childHandler(ChannelHandler childHandler),该方法用来设置业务处理类(自定义的handler)

public ChannelFuture bind(int inetPort),该方法用于服务器端,用来设置占用的端口号

public ChannelFuture connect(String inetHost,int inetPort),该方法用于客户端,用来连接服务器端

Unpooled类

这是Netty提供的一个专门用于操作缓冲区的工具类,常用方法如下:

public static ByteBuf copiedBuffer(CharSequence string,Charset charset),通过给定的数据和字符编码返回一个ByteBuf对象(类似于NIO中的ByteBuffer对象)


你可能感兴趣的:(Netty核心API)