Android Retrofit的使用详解
作者:锯齿流沙
关于Retrofit的学习,我算是比较晚的了,而现在Retrofit已经是Android非常流行的网络请求框架了。之前,我没有学过Retrofit,但最近公司的新项目使用了Retrofit、Rxjava和OkHttp来进行封装,使用起来非常简便,增加代码的美观程度,也降低了耦合度,这是一个非常棒的框架,特别是这三者一起使用。
简介
Retrofit是Square公司开发的一款针对Android网络请求的框架,现在已经更新到2.3版本了。Retrofit的最大特点是使用运行时注解的方式提供功能。
Retrofit的使用
关于Retrofit的使用,其实还是很简单的,而且逻辑思路也比较清晰,所以开发者是很容易上手的。
添加依赖
build.gradle文件的dependencies下添加以下依赖:
compile 'com.squareup.retrofit2:retrofit:2.3.0' compile 'com.squareup.retrofit2:converter-gson:2.3.0'
上面除了添加Retrofit依赖,还添加了gson依赖,来解析请求得到的json数据。
定义使用的数据集合
class Result <T>{ var status: Int? = -1//请求结果 lateinit var message: String; var content :T?= null }
这是返回结果的集合,使用了kotlin来写
class Content { var name: String?= null var mobile :String?= null var address :String?= null }
需要的内容集合类
请求
需要一个接口,并且编写请求的方法
interface HttpService { @GET("index.php?m=Api&c=User&a=userInfo") fun getUserInfo(): Call<Result<Content>> }
调用请求
private void request() { Retrofit retrofit = new Retrofit.Builder() .baseUrl("http://one.sinalwj.cn//") .addConverterFactory(GsonConverterFactory.create()) .build(); HttpService service = retrofit.create(HttpService.class); Call<Result<Content>> call = service.getUserInfo(); call.enqueue(new Callback<Result<Content>>() { @Override public void onResponse(Call<Result<Content>> call, Response<Result<Content>> response) { Log.i("tag", response.body().getContent().getName()); } @Override public void onFailure(Call<Result<Content>> call, Throwable t) { Log.i("tag", "失败"); } }); }
以上就是Retrofit的get请求方式。GET请求需要在请求方法之前添加一个GET注解来标明这是一个GET请求,同样,如果是POST请求需要一个POST注解。
@POST
POST请求,需要添加一个@POST的注解,并且需要还需要使用@FormUrlEncoded 注解来表明,这是一个表单,使用@Field注解,传入表单需要的参数。
@FormUrlEncoded //表单 @POST("index.php?m=Api&c=User&a=userInfo") fun getUserInfo( @Field("user_id") user_id: String //参数 ): Observable<BaseResult<User>> //返回数据类型
@Body
@Body注解是针对POST的请求方式,如传输数据JSON格式
class Content { var name: String?= null lateinit var sn:SN class SN{ var out :String ?= null var errNo :Int ?= -1 } }
@GET("ajax.php") fun getInfo(@Body content: Content): Call<Result<Content>>
@Path
使用@Path可以动态的配置URL地址。
@GET("{path/}{index.php?m=Api&c=User&a=userInfo") fun getUserInfo(@Path("path")path: String): Call<Result<Content>>
@Query
@Query即动态指定查询条件
@GET("ajax.php") fun getInfo(@Query("id")id: String): Call<Result<Content>>
@Query是查询单一的条件,但是如果是多个条件的话,就不适用了,那么就需要用到@QueryMap注解。@QueryMap就是动态指定查询条件组。
文件上传
使用@Part注解来表示单个文件上传,而@PartMap注解跟单文件上传是类似的,是不过是使用了Map集合来封装了上传的文件,即多文件上传。
除了以上的注解,还有@Header,即表示加入消息报头,因为在http请求的时候,为了防止攻击、过滤不安全的访问和添加特殊加密的访问来保证安全,需要在消息报头中携带一些特殊的消息处理,而在Retrofix中使用@Header即可实现添加消息报头。
从上面的Retrofix实践和注解的讲解中,我们知道使用Retrofix可以很简单的,而且代码逻辑比较清晰的做http请求,其提供非常多的注解来给开发者使用,简化了代码。
以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持脚本之家。