Retrofit基本使用
Posted awodefengduanwu
tags:
篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了Retrofit基本使用相关的知识,希望对你有一定的参考价值。
1.Retrofit基本使用
首先来了解下Retrofit是什么,在官网中对于Retrofit的描述是这样的:
A type-safe HTTP client for android and Java.
适用于Android和Java的类型安全的HTTP客户端。
可以理解成一个封装好的网络请求库。
接下来学习一下Retrofit的基本使用方法:
在app根目录的build.gradle文件中加入依赖:
compile 'com.squareup.retrofit2:retrofit:2.3.0'
定义请求参数接口:
public interface RetrofitService {
/**
* 获取快递信息
*
* @param type 快递类型
* @param postid 快递单号
* @return Call<PostInfo>
*/
@GET("query")
Call<PostInfo> getPostInfo(@Query("type") String type, @Query("postid") String postid);
}
定义一个接口RetrofitService,和普通的接口类相同,在里面定义一个方法getPostInfo,可以看到这个方法使用了@GET(“query”)注解,代表这是一个GET请求,请求接口为query(完整请求地址中域名/到?之间的字段),方法返回值为Call实体,这个稍后会用于具体的网络请求,PostInfo就是我们刚刚定义的实体类。参数中也使用了注解@Query,用于拼接传入的字段(type=yuantong&postid=11111111111)。
网络请求:
Retrofit retrofit = new Retrofit.Builder()
.baseUrl("http://www.kuaidi100.com/")
.addConverterFactory(GsonConverterFactory.create())
.build();
RetrofitService service = retrofit.create(RetrofitService.class);
Call<PostInfo> call = service.getPostInfo("yuantong", "11111111111");
call.enqueue(new Callback<PostInfo>() {
@Override
public void onResponse(Call<PostInfo> call, Response<PostInfo> response) {
Log.i("http返回:", response.body().toString() + "");
}
@Override
public void onFailure(Call<PostInfo> call, Throwable t) {
}
});
可以看到Retrofit使用了Builder模式,首先传入baseUrl,由于返回的数据是json类型的,还需要添加转换工厂类,这需要在build.gradle文件中加入依赖:
compile 'com.squareup.retrofit2:converter-gson:2.3.0'
然后调用Retrofit的create方法创建RetrofitService的实体类,得到实体类之后就可以调用其中的getPostInfo方法并传入参数,getPostInfo方法会返回一个Call实体类,接着调用Call的enqueue方法,传入Callback回调,重写onResponse(请求成功回调)和onFailure(请求失败回调)方法,response参数中包含了请求结果中的所有信息(body、code、headers等)。
OK,到这里Retrofit的基本用法就讲完了,接下来我们来了解一下Retrofit的其他用法。
2.Retrofit更多用法
请求方法
在RetrofitService的getPostInfo方法中,我们使用了@GET注解,说明这是一个GET方法,当然也可以写成HTTP协议中的其他请求方法(比如POST、PUT、DELETE、HEAD等)。
请求参数
在getPostInfo方法的参数中使用了@Query注解,除此之外还可以使用@QueryMap、@Path、@Body、@FormUrlEncoded/@Field、@Multipart/@Part、@Header/@Headers。
- @Query()
@GET("query")
Call<PostInfo> getPostInfo(@Query("type") String type, @Query("postid") String postid);
相当于
@GET(query?type=type&postid=postid)
Call<PostInfo> getPostInfo(@Query("type") String type, @Query("postid") String postid);
- @QueryMap
当参数很多的时候可以使用Map集合:
@GET("query")
Call<Book> getSearchBook(@QueryMap Map<String, String> parameters);
- @Path
用于替换url中的某些字段,当url中字段不确定时可以使用:
@GET("group/{id}/users")
Call<List<User>> groupList(@Path("id") int groupId);
id可以为任意字段,需要和@Path(“id”)中的字段保持一致,如果需要请求参数,也可以使用@Query拼接:
@GET("group/{id}/users")Call<List<User>> groupList(@Path("id") int groupId, @Query("sort") String sort);
- @Body
可以使用实体类作为请求体,Retrofit会帮我们自动转换:
@POST("users/new")Call<User> createUser(@Body User user);
- @FormUrlEncoded/@Field
用于传送表单数据,注意在头部需要加上@FormUrlEncoded,first_name代表key,first代表value:
@FormUrlEncoded@POST("user/edit")Call<User> updateUser(@Field("first_name") String first, @Field("last_name") String last);
- @Multipart/@Part
用于上传文件:
@Multipart@PUT("user/photo")Call<User> updateUser(@Part("photo") RequestBody photo, @Part("description") RequestBody description);
- @Header/@Headers
用于设置请求头:
@GET("user")Call<User> getUser(@Header("Authorization") String authorization)
也可以通过@Headers设置:
@Headers("Cache-Control: max-age=640000")@GET("widget/list")Call<List<Widget>> widgetList();@Headers({ "Accept: application/vnd.github.v3.full+json", "User-Agent: Retrofit-Sample-App"})@GET("users/{username}")Call<User> getUser(@Path("username") String username);
转换器
Retrofit支持的序列化库:
- Gson: com.squareup.retrofit2:converter-gson
- Jackson: com.squareup.retrofit2:converter-jackson
- Moshi: com.squareup.retrofit2:converter-moshi
- Protobuf: com.squareup.retrofit2:converter-protobuf
- Wire: com.squareup.retrofit2:converter-wire
- Simple XML: com.squareup.retrofit2:converter-simplexml
- Scalars (primitives, boxed, and String): com.squareup.retrofit2:converter-scalars
3.Retrofit + RxJava结合使用
如果你对RxJava还不太了解,可以看下这篇文章《给 Android 开发者的 RxJava 详解》。
首先在build.gradle文件中加入依赖:
compile 'com.squareup.retrofit2:adapter-rxjava:2.3.0'compile 'io.reactivex:rxandroid:1.2.1'
将RetrofitService类中getPostInfo方法的返回值修改为Observable(被观察者):
public interface RetrofitService { /** * 获取快递信息 * Rx方式 * * @param type 快递类型 * @param postid 快递单号 * @return Observable<PostInfo> */ @GET("query") Observable<PostInfo> getPostInfoRx(@Query("type") String type, @Query("postid") String postid);}
在创建Retrofit时添加RxJava支持:
Retrofit retrofit = new Retrofit.Builder() .baseUrl("http://www.kuaidi100.com/") .addConverterFactory(GsonConverterFactory.create()) .addCallAdapterFactory(RxJavaCallAdapterFactory.create()) // 支持RxJava .build();
获取被观察者:
RetrofitService service = retrofit.create(RetrofitService.class);Observable<PostInfo> observable = service.getPostInfoRx("yuantong", "11111111111");
订阅:
observable.subscribeOn(Schedulers.io()) // 在子线程中进行Http访问 .observeOn(AndroidSchedulers.mainThread()) // UI线程处理返回接口 .subscribe(new Observer<PostInfo>() { // 订阅 @Override public void onCompleted() { } @Override public void onError(Throwable e) { } @Override public void onNext(PostInfo postInfo) { Log.i("http返回:", postInfo.toString() + ""); } });
在RxJava中,由于链式调用的影响,是被观察者订阅观察者。
到这里Retrofit + RxJava结合使用就讲完了,由于Retrofit、RxJava属于同门师兄弟,结合使用还是很容易的。
4.Retrofit打印请求参数
Retrofit中无法打印请求参数,由于Retrofit是基于OkHttp进行封装的,可以对OkHttp添加日志拦截器来打印请求参数:
在build.gradle文件中加入依赖:
compile 'com.squareup.okhttp3:logging-interceptor:3.8.0'
OkHttp添加拦截器:
public class RetrofitUtils { /** * 获取OkHttpClient * 用于打印请求参数 * * @return OkHttpClient */ public static OkHttpClient getOkHttpClient() { // 日志显示级别 HttpLoggingInterceptor.Level level = HttpLoggingInterceptor.Level.BODY; // 新建log拦截器 HttpLoggingInterceptor loggingInterceptor = new HttpLoggingInterceptor(new HttpLoggingInterceptor.Logger() { @Override public void log(String message) { Log.i("Http请求参数:", message); } }); loggingInterceptor.setLevel(level); // 定制OkHttp OkHttpClient.Builder httpClientBuilder = new OkHttpClient.Builder(); // OkHttp进行添加拦截器loggingInterceptor httpClientBuilder.addInterceptor(loggingInterceptor); return httpClientBuilder.build(); }}
将定制的OkHttpClient添加到Retrofit中:
Retrofit retrofit = new Retrofit.Builder() .baseUrl(Constant.SERVER_URL) .addConverterFactory(GsonConverterFactory.create()) .client(RetrofitUtils.getOkHttpClient()) // 打印请求参数 .build();
大功告成!
compile 'com.squareup.retrofit2:retrofit:2.3.0'compile 'com.squareup.retrofit2:converter-gson:2.3.0'compile 'com.squareup.retrofit2:adapter-rxjava2:2.3.0'compile 'com.squareup.okhttp3:logging-interceptor:3.8.0'compile 'io.reactivex.rxjava2:rxandroid:2.0.1'
以上是关于Retrofit基本使用的主要内容,如果未能解决你的问题,请参考以下文章