Retrofit学习(一)官网原文翻译

· 官网地址 

http://square.github.io/retrofit/#restadapter-configuration

· 概念介绍：

Android和Java的类型安全HTTP客户端

· 开始翻译了，你瞅啥

Retrofit将HTTP API转换为Java接口。

public interface GitHubService｛

@GET("user/{user}/repos") Call > listRepo (@Path ("user") String user);

｝

本Retrofit类生成的实现GitHubService接口。

Retrofit retrofit = new Retrofit.Bulider().baseUrl("你的网址").build();

在后面加上 created();

GitHubService service = retrofit.create(GitHubService.class);

每个Call从创建的GitHubService可以向远程Web服务器发出同步或异步HTTP请求。

Call> repos = service.listRepo("octocat");

· API声明 接口方法及其参数的注释指示如何处理请求、GET 

资源的相对URL在注释中指定。

@GET("user/list")

您还可以在URL中指定查询参数。

@GET("user/list ? sort = desc")

URL操作

可以使用替换块和方法上的参数动态更新请求URL。替换块是由{和包围的字母数字字符串}。相应的参数必须@Path使用相同的字符串注释。

@GET("user/{id}/userinfo") Call> userInfo (@Path("id") int id);

也可以添加查询参数。

@GET("user/{id}/info") Call > userInfo (@Path ("id") int id ,@Query("scort") String scort);

对于复杂查询参数组合aMap可以使用。

@GET("group/{id}/users") Call > userInfo(@Path("id") int id ,@QueryMap 

Map options);

· API声明 接口方法及其参数的注释指示如何处理请求、POST

可以指定一个对象用作具有注释的HTTP请求主体@Body。

@POST（“users / new”）调用 createUser（@Body User user）;

对象也将使用Retrofit实例上指定的转换器进行转换。如果没有添加转换器，只能RequestBody使用。

表单编码和分组

方法也可以声明为发送表单编码和多部分数据。

当@FormUrlEncoded存在于方法上时，发送表单编码的数据。每个键值对都注释有@Field包含名称和提供值的对象。

@FormUrlEncoded

@POST （“user / edit”）

Call updateUser（@Field（“first_name”）String first，@Field（“last_name”）String last）;

请注意，标头不会相互覆盖。具有相同名称的所有标头将包含在请求中。

可以使用@Header注释动态更新请求标头。必须提供相应的参数@Header。如果值为null，则将省略标题。否则，toString将调用该值，并使用结果。

@GET（“user”）Call  getUser（@Header（“Authorization”）String authorization）

需要添加到每个请求的标头可以使用OkHttp拦截器指定。

· 这里有一个使用GsonConverterFactory类来生成接口实现的GitHubService例子，它使用Gson进行反序列化。 

Retrofit retrofit = new Retrofit.Builder().baseUrl("www.baidu.com").addConverterFactory(GsonConverterFactory.creat()).builder();

自定义转换器

如果您需要与使用Retrofit不支持开箱即用的内容格式（例如YAML，txt，自定义格式）的API进行通信，或者希望使用其他库来实现现有格式，则可以轻松创建你自己的转换器。创建一个类来扩展Converter.Factory类并在构建适配器时传递实例。

最新JAR

Retrofit的源代码，其样本和本网站可在GitHub上获得。

GRADLE

compile'c​​om.squareup.retrofit2：retrofit +:'