Retrofit系列文章翻译7—在请求体里发送对象

原文链接：https://futurestud.io/blog/retrofit-send-objects-in-request-body
本篇介绍了如何定义和利用 Retrofit 使用HTTP请求体发送数据。下面的列表显示了该系列的所有文章:

Retrofit 系列目录

开始创建android客户端[已翻译]
Android上的基本认证[已翻译]
Android上的令牌认证[已翻译]
Android上的OAuth
多个 Query 参数使用同一名字[已翻译]
同步与异步请求[已翻译]
在请求体里发送对象
自定义一个响应转换器[已翻译]
添加自定义请求头
可选的 Query 参数
如何集成 XML 转换器
使用 Log Level 调试请求
如何上传文件
Series Round-Up
Retrofit 2 — 1.9 升级指南
Retrofit 2 — 如何上传文件
Retrofit 2 — Log 请求与响应
Retrofit 2 — Android 上的 Hawk 认证
Retrofit 2 — 简单错误处理
如何在 Retrofit 1 里使用 OkHttp 3
Retrofit 2 — 图书更新发布庆典
提交表单数据 — Urlencoded
提交表单数据 — Urlencoded 使用FieldMap
Retrofit 2 — 在 OkHttp 拦截器里管理请求头部
Retrofit 2 — 如何给每一个请求添加 Query 参数
Retrofit 2 — 使用QueryMap 添加多个 Query 参数
Retrofit 2 — 如何在请求时使用动态 Url
Retrofit 2 — Url 处理，分辨和解析
Retrofit 2 — POST 和PUT 请求里的常量, 默认值和逻辑值
Retrofit 2 — 如何下载文件
Retrofit 2 — 取消请求
Retrofit 2 — 重用分析请求
Retrofit 2 — 如何在运行时修改 API Base Url
可选Path参数
如何刷新 Access Token
Retrofit 2 — 如何提交文本请求体
Retrofit 2 — 使用 Query 参数来分页
Retrofit 2 — 使用链接头和动态 Url 来分页(比如GitHub)
Retrofit 2 — 使用范围头字段来分页 (比如 Heroku)
Retrofit 2 — 转换器介绍
Retrofit 2 — 添加并自定义 Gson 转换器
Retrofit 2 — 实现自定义转换器
Retrofit 2 — 只在开发环境里启用日志
Retrofit 2 — 如何上传多个文件
Retrofit 2 — Passing Multiple Parts Along a File with @PartMap
Retrofit 2 — 模仿服务端响应基本概念
Retrofit 2 — 模仿服务端响应自定义网络行为
Retrofit 2 — 使用 @HeaderMap 定义动态请求头

将对象做为请求体发送

Retrofit 提供了在请求体里发送对象的能力. 对象可以通过使用 @Body 注解被指定为 HTTP 请求体. Retrofit 的 @Body 注解在版本2里并未改变.

Retrofit 1.9

public interface TaskService {      @POST("/tasks")    void createTask(@Body Task task, Callback cb);}

Retrofit 2

public interface TaskService {      @POST("/tasks")    Call createTask(@Body Task task);}

已定义的RestAdapter的转换器（如GSON）将映射定义的对象为JSON, 该JSON字符串将被作为请求体发送到你的服务器上.

示例

让我们看一个具体的例子.

public class Task {      private long id;    private String text;    public Task(long id, String text) {        this.id = id;        this.text = text;    }}

通过填充 id 和text属性实例化一个新的Task对象. 然后，传递对象到service 类时，对象的字段和值将被转换为JSON.

Retrofit 1.9

Task task = new Task(1, "my task title");  taskService.createTask(task, new Callback)() {});

Retrofit 2

Task task = new Task(1, "my task title");  Call call = taskService.createTask(task);  call.enqueue(new Callback() {});

调用CreateTask服务方法会将task的属性转换成JSON表示. task的JSON 看起来像这样:

{    "id": 1,    "text": "my task title"}

祝您使用愉快! 如果遇到任何问题或想要更多细节请 Twitter @futurestud_io.

Retrofit 系列目录

将对象做为请求体发送

示例

更多相关文章

随机推荐