async-http-client-netty

https://github.com/AsyncHttpClient/async-http-client/tree/master/providers
最近由于项目需求，研究netty，本想自己利用netty封装个异步httpclient，可惜设计能力有限。在git上发现了这个开源的工程，遂研究一番，设计的非常好。
简要记录下：
1. 主要包括以下几个工程：
async-http-client-api  这个是所有基类接口
async-http-client-netty-provider 在netty基础上封装的异步httpclient
async-http-client-grizzly-provider 在grizzly基础上封装的异步httpclient
async-http-client-apache-provider 在apache的httpclient基础上封装的异步httpclient

2. 既然我要在封装netty，那么就需要async-http-client-api和async-http-client-netty-provider 就好。

3. 在API使用上，初始化过程，首先需要配置一个config类，netty对应的是NettyAsyncHttpProviderConfig。
基类中AsyncHttpClientConfig会通过NettyAsyncHttpProviderConfig生成一个config。
初始化客户端时，

if (config == null) {
            return new AsyncHttpClient();
        } else {
            return new AsyncHttpClient(config);
        }

注意AsyncHttpClient 是在基类中定义的。netty中对应的客户端类是NettyAsyncHttpProvider
在AsyncHttpClient中，需要注意的是：
定义了一个静态变量：

    private static final String[] DEFAULT_PROVIDERS = {
        "com.ning.http.client.providers.netty.NettyAsyncHttpProvider",
        "com.ning.http.client.providers.grizzly.GrizzlyAsyncHttpProvider",
        "com.ning.http.client.providers.apache.ApacheAsyncHttpProvider",
        "com.ning.http.client.providers.jdk.JDKAsyncHttpProvider"
    };

而AsyncHttpClient的构造函数中就用到了这个DEFAULT_PROVIDERS

public AsyncHttpClient(AsyncHttpClientConfig config) {
        this(loadDefaultProvider(DEFAULT_PROVIDERS, config), config);
    }

private static AsyncHttpProvider loadDefaultProvider(String[] providerClassNames,
                                                               AsyncHttpClientConfig config) {
        AsyncHttpProvider provider;
        for (final String className : providerClassNames) {
            provider = loadProvider(className, config);
            if (provider != null) {
                return provider;
            }
        }
        throw new IllegalStateException("No providers found on the classpath");
    }

继续深入代码，发现他是通过加载JVM中当前线程中的类名来加载的，他会依次寻找com.ning.http.client.providers.netty.NettyAsyncHttpProvider等这些包名，如果找到则返回，所以如果代码中存在多个（存在netty，grizzly）也只会加载netty的而已。
（ps：在AsyncHttpProvider的注释中有写到：

/**
 * Interface to be used when implementing custom asynchronous I/O HTTP client.
 * By default, the {@link com.ning.http.client.providers.netty.NettyAsyncHttpProvider} is used.
 */

）
因此，整体的流程是先配置好config，然后AsyncHttpClient会根据加载在jvm中的包名去实现具体的httpclient（netty或grizzly或apache）。
还有要说明的一点，如果初始化的config不是netty的config，而是别的类型，在NettyAsyncHttpProvider中会进行判断，如果不是，则重新生成一个config。也就是说如果有netty的代码，即使你声明的是grizzly的config，也只会实例化一个netty的客户端的。
所以如果需要使用grizzly或者apache的，请把netty的代码去除。

if (config.getAsyncHttpProviderConfig() != null
                && NettyAsyncHttpProviderConfig.class.isAssignableFrom(config.getAsyncHttpProviderConfig().getClass())) {
            asyncHttpProviderConfig = NettyAsyncHttpProviderConfig.class.cast(config.getAsyncHttpProviderConfig());
        } else {
            asyncHttpProviderConfig = new NettyAsyncHttpProviderConfig();
        }

4. netty客户端类NettyAsyncHttpProvider继承了SimpleChannelUpstreamHandler
非常巧妙的实现，主方法里就可以实现messageReceived方法了。