不同系统之间字段统一 - V2EX
V2EX = way to explore
V2EX 是一个关于分享和探索的地方
现在注册
已注册用户请  登录
请不要在回答技术问题时复制粘贴 AI 生成的内容
DingJZ
V2EX    程序员

不同系统之间字段统一

  •  
  •   DingJZ 2022-05-25 17:40:11 +08:00 2251 次点击
    这是一个创建于 1282 天前的主题,其中的信息可能已经有所发展或是发生改变。

    比如一个订单号,有的系统叫 orderCode, 有的叫 orderId, 有的叫 orderNo, 最后就是上下游系统、数据库,前端、后端字段都乱七八糟

    这事有没有解,或者大厂是怎么做的

    8 条回复    2022-05-26 10:25:39 +08:00
    frandy
        1
    frandy  
       2022-05-25 20:49:30 +08:00
    不同的系统由不同的开发人员开发,这种名词统一,一方面是代码 CR 问题,
    对于同一系统内部一个名词从表结构到出口都一个名词定义,
    系统和系统之间调用,得到的响应值做一次名词转化。
    那现实世界来说,一个番茄南北方叫法还不同呢,不同的地区还叫法不同呢
    这是无法避免的,只能说到了自己这儿,自己做个名词转化,尽可能保证自身系统的字段统一。
    ryougifujino
        2
    ryougifujino  
       2022-05-25 22:27:34 +08:00 via iPhone
    可以去看一下 DDD 相关的书籍,就好理解了。其实这种不同就是因为限界上下文的不同造成的。只要在限界上下文之内形成统一语言就可以了。
    37Y37
        3
    37Y37  
       2022-05-25 22:39:15 +08:00
    你如果接过云厂商的 SDK/API ,你会发现大厂更乱,不仅乱还会给代码下毒

    举一个例子,对于返回数据有创建时间的,有的字段名叫 create_time ,有的叫 created_time ,有的叫 createTime ,有的叫 createdTime ,有的返回 UTC 时间,有的返回本地时间,有的返回时间类型有的返回字符串,有的返回时分秒,有的返回时分,这些还都是同一家云产品,只是不同接口而已

    再举一个例子,获取分页数据,有个 offset 的参数,通常情况下都表示偏移量,但有些时候人家偏偏要让它表示页码 page num ,关键是同一个产品不同的接口同样都是 offset 参数,有的表示偏移量有的表示页码

    最近在接各大云的 SDK 被搞蒙了,接了大小 n 个云厂商,每个都有这情况,没有例外
    imycc
        4
    imycc  
       2022-05-25 23:58:42 +08:00
    作为用户我的做法是将 API 拿到的结果再封装两层,第三方系统 -> APIRequest 封装(分页、鉴权、异常处理等) -> 业务抽象(名词转换及方法封装)-> 自己的业务。
    不知道那些做 toB 业务的大厂有没有更完善的规范,一个产品不同子业务也是多个人在开发的,想要风格统一,光靠自觉没用,还得有技术评审流程。
    我们搞内部系统通常就很放飞自我了,主要是当你参与进来的时候,现状已经很乱了,A 团队一个用法,B 团队一个用法,你总得选择一个。。
    Suddoo
        5
    Suddoo  
       2022-05-26 00:16:59 +08:00
    没办法,看 yapi (或者别的什么工具)上维护的接口说明,以这个为准,避免扯皮
    darksword21
        6
    darksword21  
    PRO
       2022-05-26 00:26:21 +08:00 via iPhone
    @37Y37 在此点名华为云一下
    Saxton
        7
    Saxton  
       2022-05-26 09:46:33 +08:00
    大厂都有这个问题, 你没事可以打开浏览器按 F12 看看请求 你会发现一篇新大陆的
    MarioLuo
        8
    MarioLuo  
       2022-05-26 10:25:39 +08:00 via Android
    梳理一份常见字段命名(业务和非业务),数据库评审阶段可以卡
    关于     帮助文档     自助推广系统     博客     API     FAQ     Solana     2941 人在线   最高记录 6679       Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 28ms UTC 13:48 PVG 21:48 LAX 05:48 JFK 08:48
    Do have faith in what you're doing.
    ubao msn snddm index pchome yahoo rakuten mypaper meadowduck bidyahoo youbao zxmzxm asda bnvcg cvbfg dfscv mmhjk xxddc yybgb zznbn ccubao uaitu acv GXCV ET GDG YH FG BCVB FJFH CBRE CBC GDG ET54 WRWR RWER WREW WRWER RWER SDG EW SF DSFSF fbbs ubao fhd dfg ewr dg df ewwr ewwr et ruyut utut dfg fgd gdfgt etg dfgt dfgd ert4 gd fgg wr 235 wer3 we vsdf sdf gdf ert xcv sdf rwer hfd dfg cvb rwf afb dfh jgh bmn lgh rty gfds cxv xcv xcs vdas fdf fgd cv sdf tert sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf shasha9178 shasha9178 shasha9178 shasha9178 shasha9178 liflif2 liflif2 liflif2 liflif2 liflif2 liblib3 liblib3 liblib3 liblib3 liblib3 zhazha444 zhazha444 zhazha444 zhazha444 zhazha444 dende5 dende denden denden2 denden21 fenfen9 fenf619 fen619 fenfe9 fe619 sdf sdf sdf sdf sdf zhazh90 zhazh0 zhaa50 zha90 zh590 zho zhoz zhozh zhozho zhozho2 lislis lls95 lili95 lils5 liss9 sdf0ty987 sdft876 sdft9876 sdf09876 sd0t9876 sdf0ty98 sdf0976 sdf0ty986 sdf0ty96 sdf0t76 sdf0876 df0ty98 sf0t876 sd0ty76 sdy76 sdf76 sdf0t76 sdf0ty9 sdf0ty98 sdf0ty987 sdf0ty98 sdf6676 sdf876 sd876 sd876 sdf6 sdf6 sdf9876 sdf0t sdf06 sdf0ty9776 sdf0ty9776 sdf0ty76 sdf8876 sdf0t sd6 sdf06 s688876 sd688 sdf86