Retrofit2.0-Turing

刚开始探索……

第一步先了解要请求的json数据

如我要请求的是：图灵机器人最简单的json数据：请求示例为：

请求示例：
{
“key”:“APIKEY”,
“info”:“你好”
}

返回的数据：

{
“code”:100000,
“text”:”你也好 嘻嘻”
}

那么就根据这个来创建一个简单的NewsBean实体类：

public class NewsBean implements Serializable {
private int code;
private String text;
private String url;

public NewsBean() {

}

public NewsBean(String text) {
    this.text = text;
}

public NewsBean(int code, String text) {
    this.code = code;
    this.text = text;
}

public NewsBean(int code, String text, String url) {
    this.code = code;
    this.text = text;
    this.url = url;
}

public int getCode() {
    return code;
}

public void setCode(int code) {
    this.code = code;
}

public String getText() {
    return text;
}

public void setText(String text) {
    this.text = text;
}

public String getUrl() {
    return url;
}

public void setUrl(String url) {
    this.url = url;
}

}
这里有一点需要特别注意的是：保证我们定制的javabean对象的字段要和服务器返回的数据字段一一对应，不然解析会出错(PS ^_^复杂的数组类型有待探索，更新….. —————————————————————————————
基本使用：
1、get请求：
要请求的URL 和 KEY 为：
public class TulingParams {

public static final String TULING_URL = "http://www.tuling123.com/openapi/";
public static  final String TULING_KEY = "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx";  //自己去图灵注册一个 免费

}
由上面的数据分析可知 要请求的参数为”key” 和 “info”，定义服务接口对象：
public interface RetrofitApi {

@GET("api")
Call<NewsBean> getTuringInfo(@Query("key") String key, @Query("info") String info);

}
@GET标识为get请求，@GET中所填写的value值和TULING_URL组成完整的路径，TULING_URL在构造retrofit对象时给出；@Query 标识为接口查询的关键字，有两个参数标记为两;
当我们的参数过多的时候我们可以通过@QueryMap注解和map对象参数来指定每个表单项的Key，value的值。
在MainActivity中定义一个requestApiByRetrofit方法：
private void requestApiByRetrofit(String info) {
Retrofit retrofit = new Retrofit.Builder()
.baseUrl(TuringParms.TULING_URL)
.addConverterFactory(GsonConverterFactory.create())
.build();

RetrofitApi api = retrofit.create(RetrofitApi.class);

Call<NewsBean> call = api.getTuringInfo(TuringParms.TULING_KEY, info);
call.enqueue(new Callback<NewsBean>() {
    @Override
    public void onResponse(Call<NewsBean> call, Response<NewsBean> response) {//打印返回结果
        NewsBean news = null;
        news = response.body();//将返回的数据解析成一个NewsBean对象
        showText.setText(news.getCode()+" -和- "+news.getText());

    }

    @Override
    public void onFailure(Call<NewsBean> call, Throwable t) {
        //进行异常情况处理
    }
});

}
Retrofit的构建使用的是构造者模式，指定一个baseUrl，添加一个对象转换器，用于将服务器返回的数据转换成对应实体类对象。
构造完成以后，调用create方法就可以拿到我们的接口实例。然后再调用我们之前定义好的获取城市的方法，得到一个call对象，通过call.enqueue即可完成异步的网络请求。
最后在数据请求成功的时候，通过response.body()即可拿到我们定义在Call< T >中需要返回的对象，数据请求失败的时候，进行异常的处理。
TextView打印的结果为：

————————————————待更新———————————————————-