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请求，其提供很是多的注解来给开发者使用，简化了代码。

参考文章

《用 Retrofit 2 简化 HTTP 请求》