Annotation 与 HttpClient（5）--Annotation HttpClient

Annotation HttpClient

本内容不保证正确性，如有问题请及时提出

经过前面四篇博客的铺垫，现在给出带有标记的HttpClient的实现。

1.     带标记的HttpClient的需求和定义

1）          Http的访问方法

Http的访问方法主要有两种，分别是Get和Post，对应的定义了两个Annotation，@Get和@Post分别表示实际调用执行的Http消息类型。

2）          Http的URL

URL用于定位Http访问的网络服务器地址和方法，对应定义了@URL。

3）          Http参数的类型

在Http访问中，参数可以放在URL中（@ParamUrl）、放在QueryString中（@ParamQuery）、放在Head中（@ParamHead）、放在Body中（@ParamBody）。

此外对于Multipart类型（文件类型）的消息，定义了@ParamFile和HttpFile。

4）          默认的Http参数

很多情况下，在访问远程的Http请求可以使用默认的参数，针对这种情况，定义了@ParamDefault和@ParamDefaults。

5）          返回类型

我们只实现了两种返回类型，一种是String，一种是byte[]。如果需要其他复杂类型例如xml、json等，可以先返回String，然后再转换成需要的类型。如果需要返回的是文件类型，那么返回类型为byte[].

2.     项目中的类说明

MapperProxy和MapperMethod，用于创建相应接口的代理，在代理中分析接口的Annotation，组织内部参数，生成调用Http的相应参数。

RestClient和HttpTemplate提供了MapperMethod访问Http服务需要的接口，而DefaultRestClient和DefaultHttpTemplate分别是上述两接口的实现。其中DefaultRestClient使用apache HttpClient的连接池形式实现的，而DefaultHttpTemplate则是通过继承Spring的HttpTemplate实现的，可以根据需要替换掉这两个实现（比如使用并发的HttpClient）。

3.     项目使用举例

3.1 简单的weather访问实例

Dao定义如下：

@URL("http://m.weather.com.cn/data/{city}.html")

publicinterfaceWeatherDao {

@Get

String getWeather(@ParamUrl("city")int cityCode);

}

测试程序如下执行：

WeatherDao weather = MapperProxy.newMapperProxy(WeatherDao.class,new DefaultHttpTemplate());

System.out.println(weather.getWeather(101010100));

3.2 简单的微博访问实例

Dao定义：

@URL("https://api.weibo.com/2")

publicinterface WeiBoHttpDao {

//获取短url，使用https

@Get("/short_url/shorten.json")

public String getshortUrl(@ParamQuery("access_token") String accessToken,

@ParamQuery("source")long source,

@ParamQuery("url_long") String urlLong);

}

测试程序如下执行：

WeiBoHttpDao dao = MapperProxy.newMapperProxy(WeiBoHttpDao.class,new DefaultHttpTemplate());

System.out.println(dao.getshortUrl("token",xxxx,"url"));

3.3 人人网的访问

@URL("http://api.m.renren.com/api")

@ParamDefaults({

@ParamDefault(paramname="v",value="1.0",type=ParamType.BODY),

@ParamDefault(paramname="format",type=ParamType.BODY,value="JSON")})

publicinterface RenRenHttpDao {

@Post("/photos/uploadbin")

@ParamDefaults({

@ParamDefault(paramname="voice_rate",value="44100",type=ParamType.BODY),

@ParamDefault(paramname="default_album_switch",value="2",type=ParamType.BODY),

@ParamDefault(paramname="from",value="xxxxx",type=ParamType.BODY)

})

public String share(//分享

@ParamBody("access_token") String accessToken,

@ParamBody("call_id") String callId,

@ParamBody("caption") String caption,

@ParamFile("data") HttpFile data,

@ParamFile("voicedata") HttpFile voiceData,

@ParamBody("voice_length")long voiceLength,

@ParamBody("voice_size")long voiceSize,

@ParamBody("sig") String sig

);

@Post("/user/getInfo")

public String userInfo(//获取用户信息

@ParamBody("access_token") String accessToken,

@ParamBody("call_id") String callId,

@ParamBody("type")long type,

@ParamBody("sig") String sig);

@Post("/friends/getFriends")

@ParamDefaults({

@ParamDefault(paramname="hasGender",value="1",type=ParamType.BODY),

@ParamDefault(paramname="pageSize",value="600",type=ParamType.BODY)

})

public String getFriends(//获取好友列表

@ParamBody("access_token") String accessToken,

@ParamBody("call_id")long callId,

@ParamBody("page")long page,

@ParamBody("sig") String sig

);

}

4.     小结

通过五篇博客，我希望能够将如何编写annotation的应用说明清楚，如果你理解这个过程，会觉得很简单，但是要完全说明白却是一件极其复杂的事情，通过五篇博客的形式，展现了我脑中的annotation应用的实现方式，希望对大家有帮助。

文中叙述的这种方式，源自于mybatis的源码，大家也可以去参考。

最后，我将例子中的Annotation HttpClient的源码发出来供大家参考。源码很少，也很简单，并且在我觉得必要的地方加了注释，希望能帮助大家一起探讨学习。

源码在我的csdn下载里面。http://download.csdn.net/detail/guanxinquan/6019591