Android 网络开源库之Retrofit

     

    当前的网络开源库有许多，如volley，okhttp，retrofit等，这三个库当前是比较火的，其中，okhttp和retrofit由square团队开发。关于这三个库的区别，请移步stackoverflow或者知乎查看。开发过程中选择什么样的开源库需要更具我们APP来做出选择。我们选出stackoverflow中的一段话来看下。

    

    上面说，需要与web service通信的时候，我们使用retrofit。百度百科 web service介绍，那么我们见天就来了解下retrofit。

什么是retrofit

    关于什么是retrofit，官网文档上们有一句话。A type-safe HTTP client for Android and Java。额，似乎什么也看出去来，就知道是一个类型安全的http client库。那么什么是类型安全呢？类型安全代码指访问被授权可以访问的内存位置。例如，类型安全代码不能从其他对象的私有字段读取值。它只从定义完善的允许方式访问类型才能读取。类型安全的代码具备定义良好的数据类型。更多内容百度百科-类型安全，关于这里还引用上面知乎的一句话。

      

      网络访问框架经过了从使用最原始的AsyncTask构建简单的网络访问框架（甚至不能称为框架），后来使用开源的Android-async-http库，再到使用google发布的volley库，一直不懈的寻找更好的解决方案（银弹），到现在虽然银弹没找到，也算找 到了一些更好的方案，在这里做些记录，也做共享。

目标架构如下图:

史上最难PHPer笔试题

【点击进入】

40分就能月薪过万！ 2000多人测试，85%准确率

查 看

Retrofit：Square提供的开源产品，为Android平台的应用提供一个类型安全的REST客户端

[html]  view plain  copy

1. https://github.com/square/retrofit  

RxAndroid：响应式编程框架RxJava针对Android平台的扩展。

[html]  view plain  copy

1. https://github.com/ReactiveX/RxAndroid  
2. https://github.com/ReactiveX/RxJava  

Dagger2：依赖注入(或叫ioc,用过spring的都知道这东东)框架，用于解耦的。

[html]  view plain  copy

1. https://github.com/google/dagger/  

前序：看到网上大牛的介绍上面这三个框架，自己也试着折腾折腾

以下示例通过 http://ip.taobao.com/service/getIpInfo.php?ip=21.22.11.33 获取json数据。

先看看庐山真面目，大家看了也会说，酱紫啊，搜森破！

史上最难PHPer笔试题

【点击进入】

40分就能月薪过万！ 2000多人测试，85%准确率

查 看

      

1、通过配置gradle配置将Retrofit框架引入项目。

[java]  view plain  copy

1. compile 'com.squareup.retrofit:retrofit:2.0.0-beta2'  
2. compile 'com.squareup.retrofit:converter-gson:2.0.0-beta2'  

2、编写API服务代码

     

[java]  view plain  copy

1. package com.micky.retrofitrxandroiddagger2.data.api;  
2.   
3. import com.micky.retrofitrxandroiddagger2.data.api.response.GetIpInfoResponse;  
4.   
5. import retrofit.Call;  
6. import retrofit.http.GET;  
7. import retrofit.http.Query;  
8. import rx.Observable;  
9.   
10. /** 
11.  * @Project retrofitrxandroiddagger2 
12.  * @Packate com.micky.retrofitrxandroiddagger2.data.api 
13.  * @Description 
14.  * @Author Micky Liu 
15.  * @Email [email protected] 
16.  * @Date 2015-12-21 17:22 
17.  * @Version 1.0 
18.  */  
19. public interface ApiService {  
20.     @GET("service/getIpInfo.php")  
21.     Call<GetIpInfoResponse> getIpInfo(@Query("ip") String ip);  
22. }  

3、定义接收数据的response

[java]  view plain  copy

1. package com.micky.retrofitrxandroiddagger2.data.api.response;  
2.   
3.   
4. import com.micky.retrofitrxandroiddagger2.data.api.model.IpInfo;  
5.   
6. /** 
7.  * @Project CommonProject 
8.  * @Packate com.micky.commonproject.data.api.response 
9.  * @Description 
10.  * @Author Micky Liu 
11.  * @Email [email protected] 
12.  * @Date 2015-12-21 16:39 
13.  * @Version 1.0 
14.  */  
15. public class GetIpInfoResponse extends BaseResponse {  
16.     public IpInfo data;  
17. }  

4、请求数据并显示

[java]  view plain  copy

1. package com.micky.retrofitrxandroiddagger2;  
2.   
3. import android.os.Bundle;  
4. import android.support.design.widget.FloatingActionButton;  
5. import android.support.v7.app.AppCompatActivity;  
6. import android.support.v7.widget.Toolbar;  
7. import android.view.View;  
8. import android.view.Menu;  
9. import android.view.MenuItem;  
10. import android.widget.ProgressBar;  
11. import android.widget.TextView;  
12. import android.widget.Toast;  
13.   
14. import com.micky.retrofitrxandroiddagger2.common.utils.CrashHandler;  
15. import com.micky.retrofitrxandroiddagger2.data.api.ApiService;  
16. import com.micky.retrofitrxandroiddagger2.data.api.response.GetIpInfoResponse;  
17.   
18. import retrofit.Call;  
19. import retrofit.Callback;  
20. import retrofit.GsonConverterFactory;  
21. import retrofit.Response;  
22. import retrofit.Retrofit;  
23. import retrofit.RxJavaCallAdapterFactory;  
24. import rx.Subscriber;  
25. import rx.android.schedulers.AndroidSchedulers;  
26. import rx.functions.Action1;  
27. import rx.schedulers.Schedulers;  
28.   
29. /** 
30.  * @Project retrofitrxandroiddagger2 
31.  * @Packate com.micky.retrofitrxandroiddagger2 
32.  * @Description 
33.  * @Author Micky Liu 
34.  * @Email [email protected] 
35.  * @Date 2015-12-21 17:35 
36.  * @Version 1.0 
37.  */  
38. public class MainActivity extends AppCompatActivity {  
39.   
40.     private static final String ENDPOINT = "http://ip.taobao.com";  
41.     private TextView mTvContent;  
42.     private ProgressBar mProgressBar;  
43.   
44.     @Override  
45.     protected void onCreate(Bundle savedInstanceState) {  
46.         super.onCreate(savedInstanceState);  
47.         setContentView(R.layout.activity_main);  
48.         Toolbar toolbar = (Toolbar) findViewById(R.id.toolbar);  
49.         setSupportActionBar(toolbar);  
50.         mTvContent = (TextView) findViewById(R.id.tv_content);  
51.         mProgressBar = (ProgressBar) findViewById(R.id.progress_bar);  
52.   
53.         FloatingActionButton fab = (FloatingActionButton) findViewById(R.id.fab);  
54.         fab.setOnClickListener(new View.OnClickListener() {  
55.             @Override  
56.             public void onClick(View view) {  
57.   
58.                 Retrofit retrofit = new Retrofit.Builder()  
59.                         .baseUrl(ENDPOINT)  
60.                         .addConverterFactory(GsonConverterFactory.create())  
61.                         .build();  
62.                 ApiService apiService = retrofit.create(ApiService.class);  
63.   
64.                 mProgressBar.setVisibility(View.VISIBLE);  
65.   
66.                 Call<GetIpInfoResponse> call = apiService.getIpInfo("63.223.108.42");  
67.                 call.enqueue(new Callback<GetIpInfoResponse>() {  
68.                     @Override  
69.                     public void onResponse(Response<GetIpInfoResponse> response, Retrofit retrofit) {  
70.                         mProgressBar.setVisibility(View.GONE);  
71.                         GetIpInfoResponse getIpInfoResponse = response.body();  
72.                         mTvContent.setText(getIpInfoResponse.data.country);  
73.                     }  
74.   
75.                     @Override  
76.                     public void onFailure(Throwable t) {  
77.                         mProgressBar.setVisibility(View.GONE);  
78.                         mTvContent.setText(t.getMessage());  
79.                     }  
80.                 });  
81.             }  
82.         });  
83.     }  
84.   
85.     @Override  
86.     public boolean onCreateOptionsMenu(Menu menu) {  
87.         getMenuInflater().inflate(R.menu.menu_main, menu);  
88.         return true;  
89.     }  
90.   
91.     @Override  
92.     public boolean onOptionsItemSelected(MenuItem item) {  
93.         int id = item.getItemId();  
94.         if (id == R.id.action_settings) {  
95.             return true;  
96.         }  
97.   
98.         return super.onOptionsItemSelected(item);  
99.     }  
100. }  

就这么简单，上述代码已经实现通过retrofit访问restful api获取数据并显示。

下载地址：http://download.csdn.net/my