APP 后端设计根据 object 而不是页面来设计 api,你们怎样看?

2016-05-28 13:18:28 +08:00
 lyaohe

看到《app 后端设计》的文章,当然要感谢一下 @newjueqi 总结的经验,摘要部分:

“这个设计原则最简单的应用就是根据 object 而不是页面来设计 api 。最开始的时候, app 的一个页面需要什么数据, api 就返回什么数据。结果随着 app 的 UI 不断改版,需要的数据不断变化,不停地修改 api ,最后当 api 的改动会影响以前的版本的时候,只能写一个新的 api 版本,最后弄得 api 中有很多_V2,V3 这样的标志,恶梦!”

最近不停地修改 api ,也非常困惑,看到 [根据 object 而不是页面来设计 api ] 这观点感觉很有道理,但深入想一下,实际很难做到这样,很多时候需要的数据不断变化,更多是业务调整或者完善导致的数据变化, V 友们是怎样避免接口不断修改?

3083 次点击
所在节点    程序员
7 条回复
mhtt
2016-05-28 15:06:59 +08:00
我写了个接口工具,填入一些内容,就可以自动生成接口,方便了不少
Ouyangan
2016-05-28 15:10:39 +08:00
不要直接输出实体类 , 重新封装一个 dto 即使和实体类一摸一样 .
RihcardLu
2016-05-28 18:02:09 +08:00
@Ouyangan 请问这么做的原因是什么?
ryanking8215
2016-05-28 18:06:43 +08:00
我觉得按照 object 来不对。
从 restful 的角度看应该按照 resource 来设计 api , resource 应该是在业务层就确定好的。 object 是具体的实现,页面会变, object 实现因为性能或者架构会发生变化。用变量来设计 api 当然会变~~~。
Ouyangan
2016-05-28 19:08:04 +08:00
@RihcardLu 如果数据库结构变了不会影响到 api 数据结构,序列化至少不会出错.
zhiyou18
2016-05-28 20:35:08 +08:00
relay
ibigbug
2016-05-28 20:51:18 +08:00
数据的变化不是因为页面改版,而是业务的变化。当业务发生变化时,不管是页面还是后端模型都会发生变化。如果业务变化大到一定程度,甚至变成一个新的软件,需要重新设计, API 变化是没法避免的。

至于什么 dto ,真是呵呵了,你写 get/set 不嫌麻烦?

这是一个专为移动设备优化的页面(即为了让你能够在 Google 搜索结果里秒开这个页面),如果你希望参与 V2EX 社区的讨论,你可以继续到 V2EX 上打开本讨论主题的完整版本。

https://www.v2ex.com/t/281857

V2EX 是创意工作者们的社区,是一个分享自己正在做的有趣事物、交流想法,可以遇见新朋友甚至新机会的地方。

V2EX is a community of developers, designers and creative people.

© 2021 V2EX