android retrofit2使用全解

出自：http://blog.csdn.net/u012702547/article/details/52143090

Retrofit、Retrofit、Retrofit，越来越多的人在玩这个网络请求框架，这个由squareup公司开源的网络请求框架确实挺好用，今天我们就来看一下这个东东怎么玩！

Retrofit作为一个简化的HTTP请求库其实已经有很长一段时间了，只不过在早期的版本里有些地方用的不是特别爽，Retrofit从2.0开始修改了许多之前的痛点，现在不仅更好用而且功能也更加的强大。我们可以在Retrofit中利用接口、方法和注解参数等来声明定义一个请求该如何被创建。同时它还有一个非常鲜明的特点就是支持REST风格的请求，同时它还很好的解决了线程异步访问问题，支持RxJava等。好了，废话不多说，我们先来看看今天要实现的效果图。

我们就来做这样一个简单的列表，看看如何使用Retrofit来实现。OK，这里主要通过如下四步来使用Retrofit。

1.导包

2.定义API接口

3.初始化Retrofit

4.发起网络请求

1.导包

要使用Retrofit，首先肯定是导包，我这里导入两个包，如下：

[java] view plain copy print ?

1. compile 'com.squareup.retrofit2:retrofit:2.1.0'  
2.     compile 'com.squareup.retrofit2:converter-gson:2.1.0'  

一个包是Retrofit的包，还有一个是Json转换的工具包（具体作用看第三小节）。

2.定义API接口

接下来我们来定义相关的网络请求接口，在Retrofit2.0中，APIService的定义也将是一个非常简单的事情，比如我们这个案例，我定义的APIService如下：

[java] view plain copy print ?

1. public interface ApiService {  
2.   
3.     //获取TabLayout上的数据  
4.     @GET("api/lore/classify")  
5.     Call<ClassfyBean> getClassfyData();  
6.       
7.     //获取首页列表的数据  
8.     @GET("api/lore/list")  
9.     Call<CateItemBean> getListData(@Query("id") int id);  
10.   
11.     //获取详情数据  
12.     @GET("api/lore/show")  
13.     Call<DetailBean> getDetailData(@Query("id") int id);  
14. }  

@GET表示该请求为一个get请求，常用的还有@POST表示该请求为一个POST请求。@GET后面的参数表示请求的路径但是不包括域名，第一个方法由于是获取TabLayout上的数据，这个接口不需要参数，第二第三个方法在请求数据时都需要传递参数，所以该方法带有参数，@Query("id")表示该参数名为id。以第二个方法为例，带参数的请求实际上等同这样：api/lore/list?id=id，这里需要注意的是，这种方式适用于get请求，POST请求还需要添加上@FormUrlEncoded注解，表示以表单的方式来提交参数。举个栗子：

[java] view plain copy print ?

1. @FormUrlEncoded  
2.     @POST("api/lore/list")  
3.     Call<CateItemBean> getListData(@Field("id") int id);  

Call请求接收一个泛型参数，该参数表示该请求的返回对象，Retrofit在收到返回值之后会根据我们传递的对象转换工厂方法将返回值转为该对象。

3.初始化Retrofit

定义好了APIService之后，接下来我们就可以初始化Retrofit了，Retrofit的初始化很简单，如下：

[java] view plain copy print ?

1. Retrofit retrofit = new Retrofit.Builder()  
2.                 .baseUrl("http://www.tngou.net/")  
3.                 .addConverterFactory(GsonConverterFactory.create())  
4.                 .build();  

baseUrl其实就是我们请求地址的域名，这个域名配合上文的APIService中的参数才是一个完整的请求路径。addConverterFactory表示一个添加一个转换工厂，因为我这里请求的数据是为JSON数据，所以添加GsonConverterFactory.create()，表示将接收到的Json数据转换为一个DAO，官方提供的转换工厂除了我们用的这个之外，还有如下几个：

[java] view plain copy print ?

1. Gson: com.squareup.retrofit:converter-gson  
2. Jackson: com.squareup.retrofit:converter-jackson  
3. Moshi: com.squareup.retrofit:converter-moshi  
4. Protobuf: com.squareup.retrofit:converter-protobuf  
5. Wire: com.squareup.retrofit:converter-wire  
6. Simple XML: com.squareup.retrofit:converter-simplexml  

如果需要使用则把相应的包添加进来即可。

OK，这是一个最最基本的配置，Retrofit的网络请求使用了OKHttp，但是我们这里怎么没有配置呢？如果你不配置，系统会默认创建一个OKHttp对象，如果你配置了那也没问题，配置方式如下：

[java] view plain copy print ?

1. OkHttpClient client = new OkHttpClient.Builder()  
2.         .connectTimeout(5, TimeUnit.SECONDS)  
3.         .readTimeout(10,TimeUnit.SECONDS)  
4.         .build();  
5. Retrofit retrofit = new Retrofit.Builder()  
6.         .baseUrl("http://www.tngou.net/")  
7.         .addConverterFactory(GsonConverterFactory.create())  
8.         .client(client)  
9.         .build();  

4.发起网络请求

做完上面几步之后，接下来我们就可以发起一个网络请求了，代码如下：

[java] view plain copy print ?

1. ApiService apiService = retrofit.create(ApiService.class);  
2. Call<ClassfyBean> call = apiService.getClassfyData();  
3. call.enqueue(new Callback<ClassfyBean>() {  
4.     @Override  
5.     public void onResponse(Call<ClassfyBean> call, Response<ClassfyBean> response) {  
6.         ClassfyBean body = response.body();  
7.         List<Fragment> fragments = new ArrayList<Fragment>();  
8.         for (int i = 0; i < body.getTngou().size(); i++) {  
9.             fragments.add(BaseFragment.getInstance(body.getTngou().get(i).getId()));  
10.         }  
11.         VpAdapter adapter = new VpAdapter(getSupportFragmentManager(), fragments, body);  
12.         viewPager.setAdapter(adapter);  
13.         tabLayout.setupWithViewPager(viewPager);  
14.     }  
15.   
16.     @Override  
17.     public void onFailure(Call<ClassfyBean> call, Throwable t) {  
18.         Log.d("google_lenve", "onFailure: "+t.getMessage());  
19.     }  
20. });  

在这里，我们先通过retrofit.create方法获取 一个APIService实例，然后调用该实例中对应的获取数据的方法，获取一个call，拿到call之后我们有两个选择（类似于OKHttp中的call），一个是调用call中的execute()方法获取一个Response对象，代码如下：

[java] view plain copy print ?

1. Response<ClassfyBean> execute = call.execute();  

但是这个方法会阻塞线程，在Android中如果调用这个方法需要我们将这一行代码放在子线程中执行，这无疑会增大我们的代码量。所以一个推荐的方法是调用call中的enqueue方法，这是一个异步请求，类似于OKHttp中的enqueue，不同的是这里的两个回调方法onResponse和onFailure都是在主线程中执行，意味着我们可以直接在这两个回调方法中更新UI，爽吧！

5.其他

以上几个知识点已经可以实现我们的需求了，但是既然说到了Retrofit，那我们就再来聊聊它的其他一些功能点。

在Retrofit中还有一个注解叫做@Path，这个表示URL地址的一个占位符，使用方式如下：

[java] view plain copy print ?

1. @GET("api/{id}/delete")  
2.     Call<DetailBean> getData(@Path("id")String id);  

还有一个注解@Header，表示添加请求头信息。。还有很多其他注解，由于用的比较少，我这里就不再介绍了。

OK，这篇介绍就到这里，后面我们再来说说Retrofit配合RxJava使用的问题。

以上。。。

文章一开始的项目地址：https://github.com/lenve/Retrofit