使用Netty 构造一个异步的httpclient

使用Netty 构造一个异步的httpclient

   这篇文档目的是通过一个 Netty构造的Http客户端demo，来说名如何使用 Netty。

1   示例代码

     HttpClient.java  

     HttpClientPipelineFactory.java  

     HttpResponseHandler.java  

2 Httpclient 使用方法，详见代码HttpClient.java中main函数。

     HttpClient   hc  =   new   HttpClient ();

      ChannelPipeline line   =  hc . get ( "http://www.sohu.com" )

    line . addLast ( "handler" ,   new   HttpResponseHandler ());

    

    第一步构造HttpClient实例hc ，hc是可以反复使用的，可以多线程 多个请求的并发使用。

    第二步使用HttpCleint的get方法访问sohu首页。HttpCleint支持Http的GET PUT HEAD......方法。与其对应的是函数成员函数get put head......。

    第三步get方法（其他方法如 put post...也一样） 会返回一个ChannelPipeline ，line维护着一个或者多个handler 用于异步的处理I/O数据，如HttpResponseHandler是一个处理get访问返回数据的handler。这里向line里添加了一个handler 也可以添加多个。

    此段代码不会阻塞，都是立即返回。

3 代码详情

    下边吧程序展开成顺序执行的代码 来说明。

   a 主要流程

             //以下代码在 HttpClient.java HttpClient()中

            bootstrap = new ClientBootstrap( 

                                        new NioClientSocketChannelFactory(                                  

                                                    Executors.newCachedThreadPool(),                            

                                                    Executors.newCachedThreadPool()

                                                                                            )

                                                           );

            bootstrap.setPipelineFactory(new HttpClientPipelineFactory()); 

 

    ClientBootstrap 是Netty中的助手类。帮助建立Netty程序，维护主要的Netty类。如bootstrap 包括一个    

    ChannelFactory，一个PipelineFactory，

    Channel，Pipeline的作用和使用方法后边介绍。然后程序进行如下：

    

             //以下代码在 HttpClient.java retrieve()中

              ChannelFuture future = bootstrap.connect(new InetSocketAddress(“host”, port));

              future.addListener(new ConnectOk(request));

     bootstrap.connect方法是打开一个channel，这里可以看出channel是一个类似链接，事实上channel确实是Netty抽象出来的“链接”，统一了tcp udp  Nio Oio等网络接口的访问方式。 而这个channel 是由ChannelFactory产生的， NioClientSocketChannelFactory  打开的Channel使用了java的Nio 异步接口。所以coonect方法并没有返回一个Channel 而是一个 ChannelFuture。 ChannelFutre提供添加一个addListener的方法，使得这个channel真正被打开的时候

调用用户设置的回调。这里使用自定一个的一个类ConnectOk    （实现了ChannelFutureListener接口）。当channel被真正打开的时候，会调用ConnectOk     的operationComplete方法。operationComplete方法里才可以往channel里写入请求。

在写入之前 还得做些工作。如下：

     

             //以下代码在 HttpClient.java retrieve()中,略有区别

               ChannelPipeline line  = future.getChannel().getPipeline();

             line . addLast ( "handler" ,   new   HttpResponseHandler ());

      这些代码的目的就是设置 等到网络应答，也就是获得http响应后应做哪些工作。ClientBootstrap 会为每个channel生成一个ChannelPipeline。ChannelPipeline的作用就是处理channel上的数据。至于如何处理就要看ChannelPipeline上有哪些ChannelHandler，下边详述 先看ChannelPipeline是如何产生的。

      ClientBootstrap 中包含了一个HttpClientPipelineFactory 这是一个实现了ChannelPipelineFactory接口的getPipeline方法的类。 在getPipeline方法中可以按照自己需求定义生成一个PipeLine。

 

             //以下代码在 HttpClientPipelineFactory.java getPipeline()中

             ChannelPipeline pipeline = pipeline();

             pipeline.addLast("decoder", new HttpResponseDecoder());

             pipeline.addLast("aggregator", new HttpChunkAggregator(1048576));

             pipeline.addLast("encoder", new HttpRequestEncoder());

       这里根据自己定义生成一个pipeline。 pipeline()是Netty提供的生成pipeline的静态函数。因为要做的是http访问所以在getPipeline中配置了 Netty提供的访问http的几个ChannelHandler。分别是把http响应数据解码成HttpResponse对象的HttpResponseDecoder，合并chunk数据的HttpChunkAggregator，把HttpRequest对象编码成http请求协议的HttpRequestEncoder。  ChannelPipeline不仅设置了处理channel的handler 而且设置了处理顺序 ，这个可以参考文档。大体顺序是从channel流入的数据一步步被解析生成为程序的对象，流出的时候是把程序中的对象一步步解析生成通讯协议。

        在设置好这些后。可以往channel里边写入数据了。 

           

             //以下代码在 HttpClient.java ConnectOk类中 operationComplete ()中

            Channel channel = future.getChannel();                                                                            

            channel.write(request);    

        上边说到当channel真正被打开后会调用ConnectOk的operationComplete方法。在这里可以获得这个准备好的channel 然后调用write方法。这可以看到往channel里边写入了一个 HttpRequest对象。这个HttpRequest对象会被pipeline 编码成http请求最终发给服务器。注意write放法也是异步的，它会马上返回一个

ChannelFuture 对象。如果想要在write完成后做点什么 可以给这个ChannelFuture对象添加一个Listener 等待回调。

        等得到http应答后 pipeline会把channel中的数据一步步解析成HttpResponse对象，里边包括了 header cookie request ....一切信息。后边就是提供一个自己定义的handler 来处理这个response

       代码的基本流程就是这样。