Android网络请求框架之Retrofit

Android网络请求框架之Retrofit Retrofit之前言Retrofit是square家族开源系列的精品之一，是一个简单好用的网络请求框架，基于REST 的架构风格，本框架的主要开发人Jake Wharton想必大家也有所耳闻，他也是REST的忠实拥护者和践行者。

引入开源框架，大部分开发者的目的是为了更快速的开发应用，省掉一些复杂的逻辑处理，Retrofit封装了网络请求，让开发者面向接口去请求服务，使用注解和代理去发起真正的请求，让开发者省掉所有网络请求的代码。

你不用担心android6.0不支持httpclient方式的请求，你也不用引入gson去转换数据与对象，所有的这一切，Retrofit都已帮你完美实现。

Retrofit之用法声明：1.以下例子是基于1.9.0版本的，后面还有2.0.0版的，下一篇文章我将给大家展示他们之间的区别；2.列子代码是基于AndroidStudio的。

1.在build.gradle文件里引入Retrofit需要的版本com.squareup.retrofit:retrofit:1.9.0，当然，如果了解RxJava和RxAndroid的童鞋也可以引入io.reactivex:rxjava:1.0.14 、io.reactivex:rxandroid:1.0.1，配合Retrofit使用会更加好用。

2.实现Callback接口public abstract class RCallback<T> implements retrofit.Callback<T> {@Overridepublic abstract void success(T t, Response response);@Overridepublic void failure(RetrofitError error) {Global.ProcException(error);}}看到泛型T，估计大家就知道意味着什么了吧？我们可以直接指定返回的对象了，不用再去解析json数据了！3.封装请求的载体public class RestAdapterFactory {private HashMap<String, SoftReference<RestAdapter>> adapters;private static volatile RestAdapterFactory maker;private RestAdapterFactory() {adapters = new HashMap<>();}/*** 获取创建RestAdapter的工厂** @return*/public synchronized static RestAdapterFactory getInstance() {synchronized (RestAdapterFactory.class) {if (null == maker) {synchronized (RestAdapterFactory.class) {maker = new RestAdapterFactory();}}}return maker;}/*** 创建RestAdapter** @param url* @return*/public synchronized RestAdapter build(final String url) {//这就是发起请求的对象RestAdapter adapter = null==adapters.get(url)?null:adapters.get(url).get();if (null == adapter) {final CellInfo cellInfo = Utils.getCellInfo();//添加一些headerRequestInterceptor requestInterceptor = new RequestInterceptor() {@Overridepublic void intercept(RequestFacade request) {request.addHeader("Authorization", String.format("Bearer %s", MainApp.getToken()));request.addHeader("LoyoPlatform", cellInfo.getLoyoPlatform());request.addHeader("LoyoAgent", cellInfo.getLoyoAgent());request.addHeader("LoyoOSVersion", cellInfo.getLoyoOSVersion());request.addHeader("LoyoVersionName", Global.getV ersionName());request.addHeader("LoyoVersionCode",String.valueOf(Global.getV ersion()));}};//指定url，设置log级别，设置拦截器。

adapter = new RestAdapter.Builder().setEndpoint(url).setLogLevel(RestAdapter.LogLevel.FULL).setRequestInte rceptor(requestInterceptor).build();adapters.put(url, new SoftReference<>(adapter));}return adapter;}}对于这个类就不详细解释了，就是封装了RestAdapter，用于发起请求。

4.定义请求接口和发起请求public interface ITask {@GET("/task/{Id}")void getTask(@Path("Id") String Id, retrofit.Callback<Task> cb);@DELETE("/task/{Id}")void deleteTask(@Path("Id") String Id, retrofit.Callback<Task> cb);@GET(FinalVariables.tasks + "template/{id}")void getTpl(@Path("id") String id, Callback<TaskTpl> cb);@DELETE(FinalVariables.tasks + "template/{id}")void deleteTpl(@Path("id") String id, Callback<TaskTpl> cb);@GET("/task/query")void getTasks(@QueryMap HashMap<String, Object> body,Callback<PaginationX<Task>> callback);@POST("/task")void create(@Body HashMap<String, Object> body, retrofit.Callback<Task> cb);}先解释一下一些注解，其实也不用解释，看单词的意思大家也明白啦。

方法上的：@PUT-修改，@DELETE-删除，@POST-创建，@GET-获取。

方法上的注解后面括号里的字符串就是这些请求指向的服务端地址，比如说服务器主地址是http://192.168.3.1:9527,那么getTask指向的地址就是http://192.168.3.1:9527/task,所需参数是一个String类型的id，查询后返回的对象就是Task。

是不是很简单？方法变量的：@Path-查询主键，@QueryMap-查询所需的参数集合，可以是任意对象。

比如我们查询Task列表@Overridepublic void GetData() {//这就是@QueryMap需要的参数HashMap<String, Object> map = new HashMap<>();map.put("pageIndex", pagination.getPageIndex());//当前页标map.put("pageSize", isTopAdd ? lstData.size() >= 20 ? lstData.size() : 20 : 20);//需要的数量map.put("joinType", mJoinType);//任务的类型map.put("status", mStatus);//任务的状态map.put("endAt", System.currentTimeMillis() / 1000);//截止时间smap.put("startAt", DateTool.getDateToTimestamp("2014-01-01", app.df5) / 1000);//起始时间s//发起请求，这里create方法返回的其实是ITask的代理类RestAdapterFactory.getInstance().build(Config_project.API_URL()).create(ITask.class).getTasks( map, new RCallback<PaginationX<Task>>(){@overidepublic void success(PaginationX<Task> paginationXTasks,Response r){//获取分页里的数据ArrayList<Task> tasks=paginationXTasks.getData();mAdapter.setData(tasks);mAdapter.notifyDataSetChanged();}@Overidepublic void failure(RetrofitError e){});}这里返回的是我们封装过的PaginationX对象，是一个分页数据封装，里面最终的数据就是Task数组。