spec on not found

[lepture]

定义未找到 code 时返回什么？

[fahchen]

Return prefecture level division of current division. If current division is a province, return none/null/nil.

https://github.com/cn/GB2260/blob/develop/spec.md#prefecture

[lepture]

@fahchen 不是这个，是 .get(code) 这样的 method 的返回值问题。

[fahchen]

我的意思是，既然这个方法的未找到是这样定义的，那这里是不是也应该保持一致

[damonchen]

我的实现是nil。从规范上看，这儿返回的是一个json的object，也就是其他语言的struct或者object，大部分是后，可以用空的形式来表示没有找到，我建议用none/nil/null 这样的来表示。

[gaomd]

从 REST API 的设计角度考虑

1. 如果某个资源未找到，则应该返回 404 状态，对应到 method 设计的话应该是返回值 NULL。

2. 而如果资源存在，但是资源中的某几个字段不存在，则对应字段不应省略，而是将值设为 NULL，对应到 method 设计的话应该是正常返回 struct / object，但是其中的字段没有值的话则为 NULL / ""（空字符串）。

   参考 GitHub API：Blank fields are included as null instead of being omitted.

---

针对 gb2260.get("110105") 这种方法，方案 1 应该是更合理的，代表资源未找到。

实现上就像 @damonchen 那样，如果找到该 code，则返回对应资源，反之返回 NULL。

对于某些静态类型（？）语言可能需要费一些周折，对于这类语言，可以引入 Exception，当资源未找到时触发 Exception。

[tonyseek]

IMO 使用异常，还是 nil 值，还是 Optional 类型，看各语言的 idiomatic 用法即可… spec 也可以仅要求这一点