看到《app 后端设计》的文章,当然要感谢一下 @newjueqi 总结的经验,摘要部分:
“这个设计原则最简单的应用就是根据 object 而不是页面来设计 api 。最开始的时候, app 的一个页面需要什么数据, api 就返回什么数据。结果随着 app 的 UI 不断改版,需要的数据不断变化,不停地修改 api ,最后当 api 的改动会影响以前的版本的时候,只能写一个新的 api 版本,最后弄得 api 中有很多_V2,V3 这样的标志,恶梦!”
最近不停地修改 api ,也非常困惑,看到 [根据 object 而不是页面来设计 api ] 这观点感觉很有道理,但深入想一下,实际很难做到这样,很多时候需要的数据不断变化,更多是业务调整或者完善导致的数据变化, V 友们是怎样避免接口不断修改?
1
mhtt 2016-05-28 15:06:59 +08:00
我写了个接口工具,填入一些内容,就可以自动生成接口,方便了不少
|
2
Ouyangan 2016-05-28 15:10:39 +08:00
不要直接输出实体类 , 重新封装一个 dto 即使和实体类一摸一样 .
|
4
ryanking8215 2016-05-28 18:06:43 +08:00
我觉得按照 object 来不对。
从 restful 的角度看应该按照 resource 来设计 api , resource 应该是在业务层就确定好的。 object 是具体的实现,页面会变, object 实现因为性能或者架构会发生变化。用变量来设计 api 当然会变~~~。 |
6
zhiyou18 2016-05-28 20:35:08 +08:00
relay
|
7
ibigbug 2016-05-28 20:51:18 +08:00 1
数据的变化不是因为页面改版,而是业务的变化。当业务发生变化时,不管是页面还是后端模型都会发生变化。如果业务变化大到一定程度,甚至变成一个新的软件,需要重新设计, API 变化是没法避免的。
至于什么 dto ,真是呵呵了,你写 get/set 不嫌麻烦? |