知识卡片
实例不是模式
要准确向对端描述数据,就应创建数据模式,而不是用示例描述:示例有助于了解总体,但不够准确。以BookZone的图书目录为例,表中的具体条目即实例数据会随时间有进有出,而包含书名、ISBN、作者和定价四列的YANG结构保持不变。发散:接口设计最容易犯的错,是拿几条样例JSON当协议。
这张卡片看不懂?
这张卡片的反馈已满 10 条,暂时无法继续提交。
已有反馈 · 0 / 10 条
还没有人提交反馈。
原书出处
参考来源
- 位置:《基于YANG的可编程网络 用YANG、NETCONF、RESTCONF和gNMI实现网络自动化架构》第3章《对YANG的阐释》(源文件:_epub-src/OEBPS/Text/000039.xhtml)
- 结论依据:书中以BookZone图书目录说明应创建数据模式准确描述数据而非用示例,实例数据有进有出而YANG结构保持不变。
- 原始内容:为了组织数据,需要创建数据模式,以便准确地向对端描述数据,而不是使用示例进行描述。……示例有助于了解总体,但不够准确。……随着时间的推移,实例数据(即此表中的具体条目)可能有进有出,但包含这四列的YANG结构保持不变。