大家前后端规范是怎么制定的呢？

[wojfsdj]

比如使用 JSON 格式，那么怎么有效的表示空数据呢？ 空字符串是返回 null， 还是"" ，数字是返回 null，还是 0 呢，集合是[]，还是 null?

其他方面还有哪些是需要前后端一些协商规范的呢？希望大家指点一二

[gbc123456]

我回复的时候,点击:40 次,没人回答你啊?

那我讲讲我这里的规范,空字符串 定义为 "",数字定义为 0 , 集合你应该猜到了,当然是 []

什么?你问我为啥?
因为,数据做签名处理, AES 加密什么的,比较好做,不会出现一些解密失败的情况

以上就是看看,觉得有问题请指出,谢谢

[silencefent]

口口相传

[ChefIsAwesome]

“你这地方怎么挂了？”
“我看看…因为你回了个 null ”
“你不能判断下吗？”
“你不能判断下吗？”

[RainFinder]

后端定好，前端看着办

[leeyom]

可以看看阿里巴巴的[《 Java 开发手册》]( https://github.com/alibaba/p3c)，里面讲的很详细。

[sagaxu]

尽量用 null 表示空值，并且序列化时忽略 null 字段

[hhvv23911k]

最讨厌的就是后端返回 null，文档全写的是 String 类型，到时候有数据了，什么 number、bool、对象、集合都出来了，程序就到处都崩瞎卡拉卡(别问我为啥不和后台沟通)，二手私活，后端也是外包的！找不到人！所以现在都是数据请求回来自己先判断一波，把数据处理好了再用，一个不靠谱的后端的随时都可能在数据中埋雷让程序崩溃！(菜鸟个人观点,后端大佬勿喷,理性分析)

[wizardoz]

就数字来说，0 和 null 是两种含义，字符串的 null 和""、数组[]和 null 同理。
你说用 0 代表空数据，那你用什么代表 0 ？

[yimity]

空字符串定义为 "",数字定义为 0 , 集合你应该猜到了,当然是 []

[littleshy]

除集合外，其他可为 null。

[wojfsdj]

@leeyom 之前看过，但是好像没有找到这方面的规范

[wojfsdj]

@v2410117 o(︶︿︶)o 那你可能判断的类型就有点多了

[wojfsdj]

@gbc123456 数字空定义为 0，那如果是想表示 0 怎么办呢？

[hhvv23911k]

@wojfsdj 遇到这种情况了能咋办呢，难不成找到后端让他改，不现实吧，反正都是在基类里判断，也不多吧，无非就是判断下集合和对象，其他的统一转成 String 处理了。

[queuey]

瞎几把搞的 json 格式能把人坑死

[night98]

字符串 null,数字 null，数组或集合[],其他待定，后端确定就好了，前端跟着后端规范走

[netlxl]

json 是序列成字符串的简单对象，支持 null。所以，能用 null 的就别做无谓的转换。
""显然不可取，除非它就表示空字符串而不是 null （另外既然前后端分离了，那后端自然也不需要考虑 null 显示成空白的设计了。）。
数字最好也是 null，但用 0 也可以，取决与前后端的协商。不过建议还是用 null，虽然这需要前端反序列化后的 JavaScript 对象中，这个字段的类型不能是基本类型，至少也得是 Numbei 对象。
数组应该没啥说了，null 和[]在绝大多数情况下都是表示一个含义。

[resturlaub]

自己去看代码啊

[BearD01001]

空字符串定义为 ""，数字我偏向于定义为 null，因为有时候确实需要区分 0 数据与无数据，集合当然是 []。最烦没数据都返回 null 的，拿到数据用的时候都要小心翼翼的，特别是多维集合，每一层每一个数据用之前都要 if 判断一遍，烦死了！

[h1367500190]

@ChefIsAwesome 和我司后端一个卵样，返回的数据什么类型的都有

[BearD01001]

@v2410117 我一般遇到这种情况都会直接在群里怼后端，文档定义不规范开发成品不规范，接口对接起来烦的一批！🙂

[BearD01001]

@v2410117 不过我们公司接口定义文档是由需求人员写的，群里吼出来！让需求跟接口开发内撕去！

[rb6221]

通过与测试撕逼的经验总结，不能靠规范，要靠自己
我认为「你不能判断下吗」暴露的其实是撒手不管的无责任感

[hhvv23911k]

@BearD01001 自家的文档还是很规范，专人负责，后端也不会这样搞，关键是之前弄的都是些外包，要的是速度，后端也啥都不管，文档乱写，你怼他，他就觉得“你自己加个 if 判断一下不就完事了”，感觉这事根本就不是后端的事，就是我们前台偷懒不想搞才叫他弄似的，后端都是大佬，觉得我们就是画界面的(个例，不范围攻击，我只表达我遇到的个人情况，勿喷)

[stach]

我是后端，我的原则是：
数据库表的设计，除了 datetime 可以为 null，都采用默认值，不允许为 null ；
联表查询的时候，确实没有数据，那就是 null ；
在使用 id 的时候，因为 id 从 0 开始，如果要用一个数字表示全部，就用 -1 或者 null 来表示。

总结来说：数据库尽量不要有 null 的出现，程序中或者应用场景需要就特别定义和处理它。

[mhycy]

看来楼上各位没碰上连 HTTP 请求参数在内都是拼接出来的后端程序员。。
还强制要求按顺序拼回去验证（然而拼接并没有按规范转义）

[bhaltair]

空值返回''

[netlxl]

@gbc123456 再定义个序列化规范：要么序列化所有字段，要么都不序列化 null，举手就能解决掉签名的问题，你非要搞这么容易出错的方案。
@v2410117 如果前端不参与接口定义，就是这种结果。前后端分离开发，最合理的接口设计方式时，需求出需求层面数据模型->后端出设计层面数据模型->前端透彻理解需求层面数据模型并了解设计层面数据模型->前端定义接口->后端找刺->回归定义->前后端同时开发->前后端单独单元测试（前端先用测试桩模拟接口）->继承测试。两个重点：前端定义接口；前端也要了解后台的数据模型。
@BearD01001 建议你去看看阿里 java 开发规范。为了解耦、主动防御、减少重复判断，是否为 null 的判断，应该是消费方 /调用方处理，而不是生产方 /被调用方处理。这个规范不限于接口定义，而是内部编码也要遵守的。

[netlxl]

@stach 你应该没用过 Hibernate 或者的 ORM 框架，说实话，我最讨厌的就是后端还跟数据库耦合。

[stach]

@netlxl 没有用过 java 的 ORM，用过很多其他语言的，老兄有什么好的设计直接说，说的太抽象，看不懂。

[zjp]

@stach 数据库中不推荐使用 null 是因为对 null 值的优化有限吧。
代码层面没有这个问题，还是按着语义来选择 null 或者空字符串。对于集合，Efficient Java 推荐用空集合而不是 null

[stach]

@netlxl 你直接说每种字段类型怎么定义就可以了，这个和 ORM 没有任何关系。

[stach]

@zjp null 本身就是个不稳定状态，容易出状况，对于可能出现 null 的都要判断的。

[ChefIsAwesome]

既然后端会验证，会报错，那么前端还要验证提交的数据吗？
前端需要做个列表页，后端会只把 id 全取出来，再让前端一个一个取详情吗？
不是谁干的活多谁干的活少的问题，也不是怎么设计，能让你代码结构不那么恶心的问题。技术是拿来做产品的，产品是拿来服务用户的。牺牲用户体验的东西都是瞎搞。

[stach]

@zjp 比如 golang 里面的类型都会强制默认值，我是很喜欢的。

[stach]

@ChefIsAwesome 该做验证的不能省事，前后端都得做。
列表页你说的这种，我都是把数据加工好给前端的。

[jinzhe]

作为前端超不喜欢后端给 null，这样渲染的时候还要一个个判断。

[hhvv23911k]

@netlxl 感谢，学习了！

[netlxl]

@stach 要说理论都很抽象，我就举个 Java Hibernate 的例子吧。
Java 对象：
class Entity{
Integer intValue = null;
Integer intValueHasDefault = 2;
String stringValue = null;
Decimal decimalValue = null;
Boolean isSuccess = false;
Boolean isHasError = true;
}
默认映射方式下的数据库表：
create table entity(
int_value int default null,
int_value_has_default int default 2,
string_value varchar(255) default null,
decimal_value number default null,
is_success bit/tinyint default 0,
is_has_error bit/tinyint default 1,
)

java 对象这边，默认值是否是 null，完全取决于业务的需要，不用考虑数据库。查询更新数据操作的都是 Java 对象，不是 SQL 语句。
数据库这边，如果 DBA 确定性能上不适合用 null，那么修改数据库和映射关系。

上面这种设计方式，必须要完整 ORM （本例中是 Hibernate ）的支持，在国内还不是主流。国内用得多的是半 ORM （ MyBatis ），还没有解开业务开发和数据库开发。

[netlxl]

@jinzhe 渲染时候的 null 判断应该交给前端框架处理。

[oswuhan]

制定与实施规范的权责必须分离，开发者在任意时刻不能同时担任规范制定者与执行者双重角色。

具体实践的时候，可以引入类似于 http://yapi.demo.qunar.com/这样的工具。

[wojfsdj]

@netlxl 清晰很多了。对于 Java 而言，是否 DTO，或者请求的 Param 也用 Intger 等包装类来接受对应的参数了，这样才能有 null 了

[Zzde]

None null 混着 傻傻分不清

[netlxl]

@wojfsdj 作为数据对象的 pojo 最好都用包装类。有个极端说法是：除非是方法内部使用的变量，都要用包装类。另外只有 Boolean 类型的布尔值，可以命名为 isXXX，基本 boolean 类型布尔值，是不能名名称 isXXX 的。

[lsls931011]

@ChefIsAwesome 验证这事情， 前后端都要进行，这是两道防线。 而且前端验证可以减缓服务器压力，提升服务器的并发。后端验证是为了处理那些非常规请求

[Mutoo]

用 GraphQL 多省事，前端想怎么整就怎么整，不需要后端插手。

[stach]

@netlxl 所以你的设计其实是偏向于用 null 的，不去限制 null 的产生，我的原则是把 null 统统干掉。
你假想不管是前端，还是后端，都有成熟的框架，都能帮你去处理 null 的判断问题。
我假想的是不管有没有框架，纯 sql 也好，ORM 也好，都能很稳定，让数据可预期，而不是不确定，有歧义。

[gamexg]

坚决抵制 null。

[akira]

只要都遵循一个规范，都可以

[v2chou]

我们后端看他心情返回 什么样的都有 '' [] null 1 '2' 要什么有什么

[v2chou]

我是日了🐶了

[lamada]

建议前端自己写一个校验 response 的规则

[faceRollingKB]

有些容易被踩的坑规范下，免得出问题老得给新人讲
有些有争议的做法规范下，免得老得说服别人怎么写

[tjsdtc]

只要规范统一就行，比如空数组不要一会返回[]一会返回 null 就行

[liyj144]

后端返回 "", 0, []. 不过前端最好也都校验一把。对于嵌套较深的 Object，后端很容易漏处理。

[silhouette]

字符串为空就不要 null 而是空字符串，其他的该 Null 就 Null

[eloah]

我本来想过来吐槽一下我们公司后台什么规范都没有,大家写代码都随心所欲的
然后看了一下描述的 JSON 的问题,感觉我们公司还没这么不规范
Doge

[colorwin]

我是前端，我们的后端 {} 为空的时候返回 null, 他说返回 {} 这样很麻烦，他用的是 Java，请问是这样吗?

[lovedebug]

全都字符串化，不用扯皮了。

[wojfsdj]

@colorwin 也不麻烦呢，就初始化一下

[shuizhengqi]

厉害了，我就没有这种烦恼，因为前后端都是我

[repus911]

swagger

[repus911]

安利 swagger 吧，统一接口定义，接口校验，接口文件生产，在线接口文档，省不少事情

[zpf124]

拍脑袋定 (#滑稽)



说正经的

数组 对象 之类的尽量不使用 null，[]或者{}表示。

其他类型的，则 统一标准，null 或者直接不存在这个属性的 key，我更倾向于直接不包含这个 key。
string 也类似，只不过统一的选择除了 null 和 undefined 还有个 ""。

[zpf124]

漏了一个字。

数组 对象 之类的尽量不使用 null，用 []或者{}表示。

[xiangyuecn]

比如 java：int 类型的变量没法手写赋值为 null，所以接口返回的数字类型就尽量别扯 null 了，不过有人喜欢当 object 处理，比如我

null 这个玩意在数据库最好给默认值妥妥的，字符串""，数字 0，日期给默认值 1800-01-01/2100-01-01

前端其实比后端简单多了，js 的||运算符用合理了，管后端传的什么炸弹都全部通吃 （滑稽

[fcoolish]

你们天天不得开进度会嘛

[wojfsdj]

@xiangyuecn 可以用包装类 嘿嘿 →_→