Retrofit2.2说明-简单使用
作者：Zyao89；转载请保留此行，谢谢；
很久前就想学习下Retrofit了，不过总是没有时间，正好最近新项目要用到网络请求，正好研究了下Retrofit2.2的简单使用方法，大致记录如下：
Retrofit与okhttp共同出自于Square公司，retrofit就是对okhttp做了一层封装。网络请求依赖Okhttp，我们只需要通过简单的配置就能使用retrofit来进行网络请求了。
增加依赖：
compile 'com.squareup.retrofit2:retrofit:2.2.0'//Retrofit2所需要的包
compile 'com.squareup.retrofit2:converter-gson:2.2.0'//ConverterFactory的Gson依赖包
这里需要值得注意的是导入的retrofit2包的版本必须要一致，否则就会报错。
这里我建立的请求地址 baseUrl 是
http://200.200.200.182:9999/
创建一个Retrofit对象：
Retrofit retrofit = new Retrofit.Builder()
.baseUrl("http://200.200.200.182:9999/")
//增加返回值为Gson的支持(以实体类返回)
.addConverterFactory(GsonConverterFactory.create())
.build();
接着只需要定义对应请求的接口，用来返回一个Call对象，下面举个栗子：
假设，我需要一个登录用户的操作，服务端给我的API请求地址是：
http://200.200.200.182:9999/login
请求协议是json格式，如：
{
"username" : "admin",
"password" : "123456"
}
@POST
这里先采用POST请求，使用注解@POST("login")，有如下两种方式：
方法一：
public interface RetrofitService
{
@FormUrlEncoded
@POST("login")
Call<ResponseBody> login(@Field("username") String username, @Field("password") String password);
}
方法二：
public interface RetrofitService
{
@Headers({"Content-type:application/json"})
@POST("login")
Call<ResponseBody> login(@Body User user);
}
//------------- User.java --------------------
/**
* Created by zyao89 on 2017/2/24.
*/
public class User
{
String username;
String password;
public User(String username, String password)
{
this.username = username;
this.password = password;
}
@Override
public String toString()
{
return "User{" +
"username='" + username + '\'' +
", password='" + password + '\'' +
'}';
}
}
接下来我们用之前的Retrofit对象创建一个mRetrofitService接口对象，也就是我们上面定义的那个RetrofitService接口，并且得到我们的Call对象，如下：
mRetrofitService = retrofit.create(RetrofitService.class);//这里采用的是Java的动态代理模式
接着用mRetrofitService调用我们上面定义的接口中方法，如：
public void login(View view)
{
// 方法一
Call<ResponseBody> login = mRetrofitService.login("admin", "123456");
// 方法二
// User user = new User("admin", "123456");
// Call<ResponseBody> login = mRetrofitService.login(user);
login.enqueue(getCallback());
}
利用得到的Call对象，然后我们就发出网络请求了，这里介绍下enqueue是异步操作，execute()为同步操作。
private Callback<ResponseBody> getCallback()
{
return new Callback<ResponseBody>() {
@Override
public void onResponse(Call<ResponseBody> call, Response<ResponseBody> response)
{//请求成功
printLogCat("Code: " + response.code());
printLogCat("Message: " + response.message());
printLogCat("isSuccessful: " + response.isSuccessful());
try
{
printLogCat("Body: " + response.body().string());
}
catch (IOException e)
{
e.printStackTrace();
}
printLogCat("");
}
@Override
public void onFailure(Call<ResponseBody> call, Throwable t)
{//请求失败
printLogCat("ERROR: " + t.getMessage());
printLogCat("");
}
};
}
@GET
同样的协议，我们可以用GET请求来一遍，使用注解@ GET("")，有如下两种方式：
方式一：
public interface RetrofitService
{
@Headers({"Content-type:application/json"})
@GET("login")
Call<ResponseBody> login(@Query("username") String username, @Query("password") String password);
}
public void login(View view)
{
Call<ResponseBody> login = mRetrofitService.login("bacdd", "333444");
login.enqueue(getCallback());
}
请求URL：
URL: /login?username=bacdd&password=333444
方法二：
public interface RetrofitService
{
@Headers({"Content-type:application/json"})
@GET("{url}")
Call<ResponseBody> login(@Path("url") String url, @Query("username") String username, @Query("password") String password);
}
@Path() 为占位符，可被参数动态替换；
public void login(View view)
{
Call<ResponseBody> login = mRetrofitService.login("login", "admin", "123444");
login.enqueue(getCallback());
}
请求URL：
URL: /login?username= admin&password= 123444
@DELETE & @PUT
用法与前两者基本相同，这里就不阐述了；
参考代码如下：
@Headers({"Content-type:application/json"})
@PUT("put")
Call<ResponseBody> put(@Body User user);
@Headers({"Content-type:application/json"})
@HTTP(method = "DELETE", path = "/delete", hasBody = true)
Call<ResponseBody> delete(@Body DeleteID id);
备注下，Retrofit2.0以后，貌似DELETE请求是不可以带@Body参数的，所以，可改写成以上方式。
总结
- @Path：所有在网址中的参数（URL的问号前面）；
- @Query：URL问号后面的参数；
- @QueryMap：相当于多个@Query ；
- @Field：用于POST请求，提交单个数据 ；（使用@Field时记得添加@FormUrlEncoded）
- @Body：相当于多个@Field，以对象的形式提交
若需要重新定义接口地址，可以使用@Url，将地址以参数的形式传入即可。如：
@GET
Call<User> getUser(@Url String url);
Demo演示
Github项目地址：zyao89/DemoRetrofit
个人博客：http://zyao89.me
