Retrofit2 使用
1.导入引用
compile 'com.google.code.gson:gson:2.7'
compile 'com.squareup.okhttp3:okhttp:3.3.1'
compile 'com.squareup.retrofit2:retrofit:2.1.0'
compile 'com.squareup.retrofit2:converter-gson:2.1.0'
2.初始化请求
* 方法1:
public interface APIService {
@GET("getIpInfo.php")
Call<IP> getIP(@Query("ip") String ip);
}
使用:
Retrofit retrofit = new Retrofit.Builder()
.baseUrl("http://ip.taobao.com/service/")
.addConverterFactory(GsonConverterFactory.create())
.build();
APIService apiService = retrofit.create(APIService.class);
Call<IP> call = apiService.getIP("202.202.32.202");
call.enqueue(new Callback<IP>() {
@Override
public void onResponse(Call<IP> call, Response<IP> response) {
IP body = response.body();
String area = body.getData().getArea();
tvRetrofit.setText(area);
}
@Override
public void onFailure(Call<IP> call, Throwable t) {
t.printStackTrace();
}
});
* 方法2:
public class AppStores {
public interface TaobaoIPService {
@GET("getIpInfo.php")
Call<IP> getIP(@Query("ip") String ip);
@FormUrlEncoded
@POST("getIpInfo.php")
Call<IP> postIP(@Field("ip") String ip);
}
static Retrofit retrofit = new Retrofit.Builder()
.baseUrl("http://ip.taobao.com/service/")
.addConverterFactory(GsonConverterFactory.create())
.build();
public static AppStores.TaobaoIPService taobaoIPService =
retrofit.create(AppStores.TaobaoIPService.class);
}
建立AppStores请求类,此类只要做一种功能请求(Retrofit是类似与RESTful风格的网络请求)。
在此初始化网络请求。
3.发送请求
- retrofit2 发送请求时不区分get/post请求,区分同步/异步请求。
- Call 每个对象实例只能调用一次,如果想重复调用一个接口,可以通过Clone方法来创建一个一模一样的实例,这个开销是很小的。
比如说:你可以在每次决定发请求前 clone 一个之前的实例。(call2 = call.clone();)
- 请求中断:call.cancel();
同步请求
// 同步请求在主线程中,需要开启子线程发送请求。
new Thread(new Runnable() {
@Override
public void run() {
Call<IP> call1 = AppStores.taobaoIPService.getIP("202.202.32.202");
try {
Response<IP> response = call1.execute();
IP ip = response.body();
final String area = ip.getData().getArea();
runOnUiThread(new Runnable() {
@Override
public void run() {
tvRetrofit.setText(area);
}
});
} catch (IOException e) {
e.printStackTrace();
}
}
}).start();
异步请求
Call<IP> call = AppStores.taobaoIPService.postIP("202.202.32.202");
call.enqueue(new Callback<IP>() {
@Override
public void onResponse(Call<IP> call, Response<IP> response) {
IP body = response.body();
String result = body.getData().getCountry();
// 可以直接更改UI,因为onResponse方法已经在UI线程中。
tvRetrofit.setText(result);
call.cancel();
}
@Override
public void onFailure(Call<IP> call, Throwable t) {
tvRetrofit.setText(t.toString());
t.printStackTrace();
}
});
4.解析响应
参考上面代码
- 默认使用Gson解析json数据: addConverterFactory(GsonConverterFactory.create());
- OnResponse响应返回:Response<IP> response;
- 在body中获取解析数据:IP body = response.body();
- 更新UI在主线程中。异步请求OnResponse是在主线程中的,同步请求是在子线程中进行,所以更新UI应该runOnUiThread运行在主线程中。
5.其他知识点
Response
class Response<T> {
okhttp3.Response raw()
int code() // 请求成功 code:200
String message()
Headers headers()
boolean isSuccessful()
T body()
ResponseBody errorBody()
}
通用的请求链接
interface GitHubService {
@GET("/repos/{owner}/{repo}/contributors")
Call<List<Contributor>> repoContributors(
@Path("owner") String owner,
@Path("repo") String repo);
// 此种方式,可以传入Url
@GET
Call<List<Contributor>> repoContributorsPaginate(
@Url String url);
}
Call<List<Contributor>> call =
gitHubService.repoContributors("square", "retrofit");
请求参数
* @Query(“key”) -- 用于GET请求查询参数
* @QueryMap -- 用于参数映射
* @Body -- 与@POST注解一起使用,提供查询主体内容
同步请求另外的写法
private class NetworkCall extends AsyncTask<Call, Void, String> {
@Override
protected String doInBackground(Call… params) {
try {
Call<List<Contributor>> call = params[0];
Response<List<Contributor>> response = call.execute();
return response.body().toString();
} catch (IOException e) {
e.printStackTrace();
}
return null;
}
@Override
protected void onPostExecute(String result) {
final TextView textView = (TextView) findViewById(R.id.textView);
textView.setText(result);
}
}
// 点击
Button button = (Button) findViewById(R.id.button);
button.setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View view) {
GitHubService gitHubService = GitHubService.retrofit.create(GitHubService.class);
final Call<List<Contributor>> call = gitHubService.repoContributors("square", "retrofit");
new NetworkCall().execute(call);
}
});
请求结果判断
if (response.isSuccessful() && response.errorBody() == null) {
// 请求成功
Log.d(TAG, "str:" + response.body().toString());
} else {
// 请求失败
Log.d(TAG, "error code:" + response.code());
Log.d(TAG, "error message:" + response.message());
}
鸣谢
http://ip.taobao.com/service/getIpInfo.php?ip=202.202.32.202
此地址是在网上找到的,感谢_