Android Retrofit的使用

关于Retrofit的学习，我算是比较晚的了，而现在Retrofit已经是Android非常流行的网络请求框架了。之前，我没有学过Retrofit，但最近公司的新项目使用了Retrofit、Rxjava和OkHttp来进行封装，使用起来非常简便，增加代码的美观程度，也降低了耦合度，这是一个非常棒的框架，特别是这三者一起使用。

简介

Retrofit（https://square.github.io/retrofit/）是Square公司开发的一款针对Android网络请求的框架，现在已经更新到2.3版本了。Retrofit的最大特点是使用运行时注解的方式提供功能。

Retrofit的使用

关于Retrofit的使用，其实还是很简单的，而且逻辑思路也比较清晰，所以开发者是很容易上手的。

添加依赖

build.gradle文件的dependencies下添加以下依赖：

// Retrofit库

compile 'com.squareup.retrofit2:retrofit:2.3.0'

//gson

compile 'com.squareup.retrofit2:converter-gson:2.3.0'

上面除了添加Retrofit依赖，还添加了gson依赖，来解析请求得到的json数据。

定义使用的数据集合

这是返回结果的集合，使用了kotlin来写

需要的内容集合类

请求

需要一个接口，并且编写请求的方法

调用请求

以上就是Retrofit的get请求方式。GET请求需要在请求方法之前添加一个GET注解来标明这是一个GET请求,同样，如果是POST请求需要一个POST注解。

@POST

POST请求，需要添加一个@POST的注解，并且需要还需要使用@FormUrlEncoded 注解来表明，这是一个表单，使用@Field注解，传入表单需要的参数。

@Body

@Body注解是针对POST的请求方式，如传输数据JSON格式

@Path

使用@Path可以动态的配置URL地址。

@Query

@Query即动态指定查询条件

@Query是查询单一的条件，但是如果是多个条件的话，就不适用了，那么就需要用到@QueryMap注解。@QueryMap就是动态指定查询条件组。

文件上传

使用@Part注解来表示单个文件上传，而@PartMap注解跟单文件上传是类似的，是不过是使用了Map集合来封装了上传的文件，即多文件上传。

除了以上的注解，还有@Header，即表示加入消息报头，因为在http请求的时候，为了防止攻击、过滤不安全的访问和添加特殊加密的访问来保证安全，需要在消息报头中携带一些特殊的消息处理，而在Retrofix中使用@Header即可实现添加消息报头。

从上面的Retrofix实践和注解的讲解中，我们知道使用Retrofix可以很简单的，而且代码逻辑比较清晰的做http请求，其提供非常多的注解来给开发者使用，简化了代码。

参考文章

《用 Retrofit 2 简化 HTTP 请求》

地址：https://academy.realm.io/cn/posts/droidcon-jake-wharton-simple-http-retrofit-2/