V2EX = way to explore
V2EX 是一个关于分享和探索的地方
现在注册
已注册用户请  登录
lyaohe
V2EX  ›  程序员

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

  •  
  •   lyaohe · 2016-05-28 13:18:28 +08:00 · 3210 次点击
    这是一个创建于 3098 天前的主题,其中的信息可能已经有所发展或是发生改变。

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

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

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

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

    至于什么 dto ,真是呵呵了,你写 get/set 不嫌麻烦?
    关于   ·   帮助文档   ·   博客   ·   API   ·   FAQ   ·   实用小工具   ·   5110 人在线   最高记录 6679   ·     Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 · 25ms · UTC 09:35 · PVG 17:35 · LAX 01:35 · JFK 04:35
    Developed with CodeLauncher
    ♥ Do have faith in what you're doing.