感觉好久没有写Android的文章了，囧囧囧！因为Retrofit实在是太火了， 火得我一直跃跃欲试，但是由于种种原因吧，一直都没有用过。周末闲来无事，利用一个以前开发中用过的服务器API来小试牛刀一下，非常简单，记录自己的第一次Retrofit之旅。
重要说明：由于涉及到商业机密，所以对请求的数据和服务器地址进行了处理。自己实验时，请换成自己的服务器。
一、添加依赖、配置项目
这一步就不详细说了，会的都会，基本就是添加两个依赖和网络访问权限。
compile 'com.squareup.retrofit2:retrofit:2.1.0'
compile 'com.squareup.retrofit2:converter-gson:2.1.0'
<uses-permission android:name="android.permission.INTERNET" />
二、根据服务器端返回的JSON数据配置自己的JavaBean
在项目中用Retrofit的时候，肯定和服务器端的哥们商量好了如何交互，也就是说已经知晓了服务器端会返回什么样的数据（基本都是JSON，只是内容不一样而已），这些数据你可以直接用字符串接收，然后自己处理，但是这么low的事情，Retrofit肯定可以帮我处理了，用上面的converter-gson就可以自动将JSON转成我们的对象，前提是需要与返回的JSON字段进行映射，默认情况下字段名一样就不会出什么问题，但是我却踩了一个坑，下文会介绍。
- 服务器端返回的JSON数据如下：
{"message":"ok","list":["id":"","abstract":"","title":"","url":""},...]
- 根据上面的JSON数据创建JavaBean
import com.google.gson.annotations.SerializedName;
import java.util.List;
/**
* Created by yangfan on 2017/1/7.
*/
//与服务器端数据进行字段映射
public class NewsInfo {
private String message;
private List<News> list;
public String getMessage() {
return message;
}
public void setMessage(String message) {
this.message = message;
}
public List<News> getList() {
return list;
}
public void setList(List<News> list) {
this.list = list;
}
public static class News {
private String id;
//@SerializedName：后面是服务器端返回的数据字段名 可以与本地不一样 该关键字就是用来映射的
@SerializedName("abstract")
private String _abstract;
private String title;
private String url;
public String getId() {
return id;
}
public void setId(String id) {
this.id = id;
}
public String get_abstract() {
return _abstract;
}
public void set_abstract(String _abstract) {
this._abstract = _abstract;
}
public String getTitle() {
return title;
}
public void setTitle(String title) {
this.title = title;
}
public String getUrl() {
return url;
}
public void setUrl(String url) {
this.url = url;
}
}
}
踩坑记录：服务器端居然有一个abstract字段，但是这个是Java关键字啊，怎么办？用@SerializedName告诉Retrofit，我想你把该字段映射成我自定义的名字。
配置访问服务器API的接口
这个就是真正的访问服务器的本地API了，我这里只用了GET，其实远不止这个功能，可以参考官方文档。
import retrofit2.Call;
import retrofit2.http.GET;
import retrofit2.http.Query;
/**
* Created by yangfan on 2017/1/7.
*/
public interface NewsInterface {
//获取服务器的新闻列表，由于新闻类型和分页显示的需要，需要传递三个参数
@GET("news/list")
Call<NewsInfo> newsList(@Query("type") String type, @Query("pn") String pn, @Query("ps") String ps);
}
Activity
配置好以上信息以后，就可以开始写Android的程序了。因为我的程序比较简单，所以我很快就成功获取数据了，这一块没怎么踩坑。
public class MainActivity extends AppCompatActivity {
private TextView tvResult;
//服务器的基地址 与 @GET("news/list")拼接
private static final String baseUrl = "http://服务器地址/";
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
tvResult = (TextView) findViewById(R.id.tvResult);
initRetrofit();
}
private void initRetrofit() {
Retrofit retrofit = new Retrofit.Builder().baseUrl(baseUrl).addConverterFactory(GsonConverterFactory.create())
.build();
NewsInterface newsInterface = retrofit.create(NewsInterface.class);
Call<NewsInfo> callNewsInfo = newsInterface.newsList("1", "1", "10");
callNewsInfo.enqueue(new Callback<NewsInfo>() {
@Override
public void onResponse(Call<NewsInfo> call, Response<NewsInfo> response) {
//成功
if (response.code() == 200) {
//将返回的数据转换成自定义的对象
NewsInfo newsInfo = response.body();
if(newsInfo.getMessage().equals("ok")){
//最爽的地方---直接可以进行UI操作
tvResult.setText(newsInfo.getList().get(0).get_abstract());
}
} else {
//请求失败
tvResult.setText("查询失败！响应码为：" + response.code());
}
}
@Override
public void onFailure(Call<NewsInfo> call, Throwable t) {
//请求失败
t.printStackTrace();
tvResult.setText("查询失败！错误原因：" + t.getCause());
}
});
}
}
运行结果
Retrofit小试牛刀.gif
Retrofit功能非常强大，我也看了很多文档，上面用的只是冰山一角。目前感觉最大的好处就是可以直接在回调中操作主线程的UI，再也不需要用Handler了，其他牛逼的功能和好处待学习、待发掘。
