首页 > 学院 > 开发设计 > 正文

Retrofit全攻略——基础篇

2019-11-09 16:12:25
字体:
来源:转载
供稿:网友

实际开发过程中一般都会选择一些网络框架提升开发效率。随着Google对HttpClient 摒弃和Volley框架的逐渐没落,OkHttp开始异军突起,而Retrofit则对OkHttp进行了强制依赖,可以简单理解Retroifit在OKHttp基础上进一步完善。

Retrofit是由Square公司出品的针对于Android和java的类型安全的Http客户端,目前推出了2.0+的版本。

Retrofit框架项目地址:https://github.com/square/retrofit。 Retrofit官方文档地址: http://square.github.io/retrofit/

使用Retrofit

接下来我们来学习下如何使用Retrofit。 首先需要在app/build.gradle添加依赖。

dependencies { //... //retrofit compile 'com.squareup.retrofit2:retrofit:2.1.0' //如果用到gson解析 需要添加下面的依赖 compile 'com.squareup.retrofit2:converter-gson:2.1.0'}

我们以查号码归属地接口为例 https://www.juhe.cn/docs/api/id/11

Retrofit不能直接使用,需要进行初始化,在这里创建NetWork.java

public class NetWork { PRivate static Retrofit retrofit; /**返回Retrofit*/ public static Retrofit getRetrofit(){ if(retrofit==null){ Retrofit.Builder builder = new Retrofit.Builder();//创建Retrfit构建器 retrofit = builder.baseUrl("http://apis.juhe.cn/") //指定网络请求的baseUrl .addConverterFactory(GsonConverterFactory.create())//返回的数据通过Gson解析 .build(); } return retrofit; }}

Retrofit需要之地baseUrl,往往一个项目中有很多接口,接口都使用相同的服务器地址,这时候可以把接口地址相同的部分抽取到baseUrl中,Retrofit扩展性极好,可以指定返回的数据通过Gson解析,前提你需要保证项目中有Gson框架和com.squareup.retrofit2:converter-gson:2.1.0的依赖。

除了通过Gson解析还可以使用其它的方式解析,需要的依赖也不同,有如下几种:

Gson: com.squareup.retrofit:converter-gsonJackson: com.squareup.retrofit:converter-jacksonMoshi: com.squareup.retrofit:converter-moshiProtobuf: com.squareup.retrofit:converter-protobufWire: com.squareup.retrofit:converter-wireSimple xml: com.squareup.retrofit:converter-simplexml

Retrofit需要把Http的请求接口封装到一个接口文件中。

public interface NetInterface { //获取号码归属地,返回来类型是Bean, 需要两个参数分别为phone何key @GET("mobile/get") Call<Bean> getAddress(@Query("phone") String phone, @Query("key") String key);}

其中Bean是根据请求的结果创建的对象.

方法前添加@GET注解表示当前请求是Get方式请求,链接的地址是baseUrl+”mobile/get”,baseUrl在初始化Retrofit的时候指定了,拼到一起就是 http://apis.juhe.cn/mobile/get。 对于 Retrofit 2.0中新的URL定义方式,这里是我的建议:

baseUrl: 总是以 /结尾url: 不要以 / 开头

因为如果不是这种方式,拼装后的结果和你期望的是不一样的,详情参考官方文档。

除了Get请求还有下面几种请求方式

@POST 表明这是post请求 @PUT 表明这是put请求 @DELETE 表明这是delete请求 @PATCH 表明这是一个patch请求,该请求是对put请求的补充,用于更新局部资源 @HEAD 表明这是一个head请求 @OPTIONS 表明这是一个option请求 @HTTP 通用注解,可以替换以上所有的注解,其拥有三个属性:method,path,hasBody

最后的HTTP通用注解写法比较特殊,请求可以代替之前的请求。下面的写法和之前的@GET效果是一样的。

/** * method 表示请的方法,不区分大小写 * path表示路径 * hasBody表示是否有请求体 */@HTTP(method = "get",path = "mobile/get",hasBody = false)Call<Bean> getAddress(@Query("phone") String phone, @Query("key") String key);

@Quert表示查询参数,用于GET查询,注解里的字符串是参数的key值,参数会自动拼装到Url后面。 除了上面的注解,再给大家介绍几种不同的注解。

常用的注解

@Url:使用全路径复写baseUrl,适用于非统一baseUrl的场景。示例代码:

@GET Call<ResponseBody> XXX(@Url String url);

@Streaming:用于下载大文件。示例代码:

@Streaming @GET Call<ResponseBody> downloadFileWithDynamicUrlAsync(@Url String fileUrl);//获取数据的代码ResponseBody body = response.body();long fileSize = body.contentLength();InputStream inputStream = body.byteStream();

@Path:URL占位符,用于替换和动态更新,相应的参数必须使用相同的字符串被@Path进行注释

//实际请求地址会给句groupId的值发生变化--> http://baseurl/group/groupId/users@GET("group/{id}/users") Call<List<User>> groupList(@Path("id") int groupId);

@QueryMap:查询参数,和@Query类似,区别就是后面需要Map集合参数。示例代码:

Call<List<News>> getNews((@QueryMap(encoded=true) Map<String, String> options);

@Body:用于POST请求体,将实例对象根据转换方式转换为对应的json字符串参数,这个转化方式是GsonConverterFactory定义的。 示例代码:

@POST("add")Call<List<User>> addUser(@Body User user);

@Field,@FieldMap:Post方式传递简单的键值对,需要添加@FormUrlEncoded表示表单提交

@FormUrlEncoded @POST("user/edit") Call<User> updateUser(@Field("first_name") String first, @Field("last_name") String last);

@Part,@PartMap:用于POST文件上传,其中@Part MultipartBody.Part代表文件,@Part(“key”) RequestBody代表参数,需要添加@Multipart表示支持文件上传的表单。

@Multipart @POST("upload") Call<ResponseBody> upload(@Part("description") RequestBody description, @Part MultipartBody.Part file);

完成请求实例

了解了Retrofit,我们用Retrofit请求完成请求,Retrofit使用起来比较省事,核心代码如下所示:

//初始化Retrofit,加载接口NetInterface netInterface = NetWork.getRetrofit().create(NetInterface.class);//请求接口netInterface.getAddress(editText.getText().toString(),"你的app key") .enqueue(new Callback<Bean>() { @Override public void onResponse(Call<Bean> call, Response<Bean> response) { //请求成功 Bean bean = response.body(); //... } @Override public void onFailure(Call<Bean> call, Throwable t) { //请求失败 } });

Retrofit会自动在子线程中进行网络请求,请求结束切换到主线程中,而且内部使用了线程池,对网络请求的缓存控制的也非常到位,网络响应速度也是很快的,使用起来非常的爽!

RxJava和Retrofit结合

RxJava非常强大,就连Retrofit都要抱下他的大腿,Retrofit也可以用RxJava方式进行网络请求,只需要对上面的代码进行改造即可。

首先添加框架依赖。

dependencies { //... compile 'io.reactivex:rxandroid:1.2.1' compile 'io.reactivex:rxjava:1.1.6' compile 'com.google.code.gson:gson:2.8.0' compile 'com.squareup.retrofit2:retrofit:2.1.0' //如果用到gson解析 需要添加下面的依赖 compile 'com.squareup.retrofit2:converter-gson:2.1.0' //Retrofit使用RxJava需要的依赖 compile 'com.squareup.retrofit2:adapter-rxjava:2.1.0'}

修改Retrofit初始化的代码:

public class NetWork { private static Retrofit retrofit; /**返回Retrofit*/ public static Retrofit getRetrofit(){ if(retrofit==null){ //创建Retrfit构建器 Retrofit.Builder builder = new Retrofit.Builder(); //指定网络请求的baseUrl retrofit = builder.baseUrl("http://apis.juhe.cn/") //返回的数据通过Gson解析 .addConverterFactory(GsonConverterFactory.create()) //使用RxJava模式 .addCallAdapterFactory(RxJavaCallAdapterFactory.create()) .build(); } return retrofit; }}

上面代码我们通过,添加代码addCallAdapterFactory(RxJavaCallAdapterFactory.create())就变成了使用RxJava模式。

接口也需要修改,把方法的返回值类型由Call改成了RxJava中的Observable。

public interface NetInterface { //获取号码归属地,返回来类型是Bean, 需要两个参数分别为phone何key @GET("mobile/get") Observable<Bean> getAddress(@Query("phone") String phone, @Query("key") String key);}

接下来修改最终网络请求的代码,可以改成RxJava方式了。

NetInterface netInterface = NetWork.getRetrofit().create(NetInterface.class); //RxJava方式 netInterface.getAddress(editText.getText().toString(),"你的app key") .subscribeOn(Schedulers.io())//设置网络请求在子线程中 .observeOn(AndroidSchedulers.mainThread())// 回调在主线程中 .subscribe(new Action1<Bean>() { @Override public void call(Bean bean) { //请求成功 } }, new Action1<Throwable>() { @Override public void call(Throwable throwable) { //请求失败 } });

总结

这是Retrofit基础篇, 后面有时间再继续深入研究


更多精彩请关注微信公众账号likeDev 这里写图片描述


发表评论 共有条评论
用户名: 密码:
验证码: 匿名发表