如何写接口可以让对方通过接口推送数据代码示例_API接口开发（一）：接口开发返回结果解决方案...

摘要

采用前后端分离的方式进行项目开发，那么前后端交互比较好的方式是采用HTTP+JSON。如何让接口返回结果更加简洁，更加优雅，也更加合理，并且让前端开发人员看得明白，后端开发者也并不会因此而增加工作量呢？

正文开始

Hello，各位，好久不见了。一直在筹划个人网站2020版本改版的事情，所以，本篇文章，也是2019年最后一篇了，当然，也得花一些心思，争取把我想要说的话，都一一说出来，说明白，说透彻。

采用前后端分离的方式进行项目开发，那么前后端交互比较好的方式是采用HTTP+JSON。如何让接口返回结果更加简洁，更加优雅，也更加合理，并且让前端开发人员看得明白，后端开发者也并不会因此而增加工作量呢？

为此，我写了一套关于API接口开发返回结果解决方案， api-result，已将其开源，并上传到中央仓库，欢迎各位批评和指正。

API讲解

实体类

提供了满足各场景使用的实体类，如下：

ResultModel

这个类是基础实体类，有如下属性：

success：返回结果标识，是一个布尔值，true / false（成功 / 失败）

message：描述信息，错误时，可以在这里填写错误的详细信息

data：数据，是一个泛型，可以是数组或者对象等等，成功并且需要返回数据时，才有该参数

ApiResultModel

结构关系如下：

ResultModel
 └── ApiResultModel

在这个类里面增加了 code 属性，也是一个泛型，你可以自定义你的返回码类型，可以是整数，或者字符串。

PageResultModel

结构关系如下：

ResultModel
 └── PageResultModel

这个类主要主要分页返回结果，所以，增加了以下属性：

total：数据总条数，Long型

size：每页条数，整数

pages：总页数，Long型

current：当前页，Long型

Helper工具类

帮助我们操作实体类，具体有哪些helper呢？如下：

ResultHelper

ResultHelper是与ResultModel对应的

success(String message)

成功，携带描述信息

success(String message, T data)

成功，携带描述信息和数据

error(String message)

错误，携带详细的描述信息

ApiResultHelper

ApiResultHelper是与ApiResultModel对应的

success(S code, String message)

成功，携带返回码和描述信息

success(S code, String message, T data)

成功，携带返回码、描述信息和数据

error(S code, String message)

错误，携带错误码和详细描述信息

PageResultHelper

PageResultHelper是与PageResultModel对应的

success(String message)

成功，携带描述信息

success(String message, T data)

成功，携带描述信息和数据

success(String message, T data, long total, int size, long pages, long current)

成功，携带描述信息、数据、总数、每页条数、总页数、当前页

error(String message)

错误，携带详细的描述信息

快速入门

我们为你提供了三个实体类，以满足不同场景，ResultModel适用于通常返回结果，ApiResultModel适用于接口开发返回结果，PageResultModel适用于分页返回结果。也分别为这三个实体类提供了各自的Helper，所以，你可以直接使用这些Helper进行返回。当然，我推荐的使用方式是，先为各Helper编写工具类，再通过工具类进行返回，这样可能更加合理定制自