September 2022
Beginner to intermediate
321 pages
4h 50m
Chinese
Content preview from 语义软件设计
Become an O’Reilly member and get unlimited access to this title plus top books and audiobooks from O’Reilly and nearly 200 top publishers, thousands of courses curated by job role, 150+ live events each month,
O’Reilly covers everything we've got, with content to help us build a world-class technology community, upgrade the capabilities and competencies of our teams, and improve overall team performance as well as their engagement.I wanted to learn C and C++, but it didn't click for me until I picked up an O'Reilly book. When I went on the O’Reilly platform, I was astonished to find all the books there, plus live events and sandboxes so you could play around with the technology.I’ve been on the O’Reilly platform for more than eight years. I use a couple of learning platforms, but I'm on O'Reilly more than anybody else. When you're there, you start learning. I'm never disappointed.I'm always learning. So when I got on to O'Reilly, I was like a kid in a candy store. There are playlists. There are answers. There's on-demand training. It's worth its weight in gold, in terms of what it allows me to do.
152
｜
第
7
章
如果明确的准则确实会对业务产生重大影响（比如版本编号规则），则遵循这些指
导非常重要，你可以参考上述提到的公开准则。
遵循这些准则的主要目的如下：在构思
API
时，想一想是否创建了可缓存的
URI
。
如果是可缓存的，而且没有违反规则（比如使用
cookie
规则），也没有造成任何令
人头疼的问题，比如必须知道每个元素的实现位置才能完成某个动作，那么你的起
点应该已经高于大多数人了。
7.6
解构版本编号规则
合适的服务版本编号规则非常重要。
一些天真的开发团队以为，次要变更与主要变
更之间的区别就在于个人的工作量，也就是为了完成发布，他们熬了多少个通宵，
喝了多少咖啡。这是一个主观看法，是你个人的问题，与客户无关，而且这种判断
标准过于模糊。即便你们有四个团队，努力工作了六个月，付出了巨大的努力，最
后得到了一个蛋糕的奖励和高管的表扬，也不意味着这就是一个主要版本。主要版
本和次要版本的构成应该非常清晰，因为这对客户有很大的影响。作为解构主义设
计师，我们始终要以同理心关注客户的看法。
对于版本编号规则，有一种强烈的观点是软件中没有“版本”这种东西，新的主“版本”
必须是一个全新的、独特的、可部署的成果物。这是服务版本编号规则的解构方式，
非常简单明了。
一般来说，如果
API
中包含以下变更之一，没有破坏性（在完成实现和测试之后），
且向下兼容，就可以认为是次要变更：
•
添加输出字段。
•
添加（可选）输入参数。
•
基础模型和算法的变更，可能会产生不同的结果和值。
•
字符串值的变更，除非字符串值拥有特殊的状态 ...
Become an O’Reilly member and get unlimited access to this title plus top books and audiobooks from O’Reilly and nearly 200 top publishers, thousands of courses curated by job role, 150+ live events each month,
and much more.
Read now
Unlock full access
More than 5,000 organizations count on O’Reilly
O’Reilly covers everything we've got, with content to help us build a world-class technology community, upgrade the capabilities and competencies of our teams, and improve overall team performance as well as their engagement.Julian F.
I wanted to learn C and C++, but it didn't click for me until I picked up an O'Reilly book. When I went on the O’Reilly platform, I was astonished to find all the books there, plus live events and sandboxes so you could play around with the technology.Addison B.
I’ve been on the O’Reilly platform for more than eight years. I use a couple of learning platforms, but I'm on O'Reilly more than anybody else. When you're there, you start learning. I'm never disappointed.Amir M.
I'm always learning. So when I got on to O'Reilly, I was like a kid in a candy store. There are playlists. There are answers. There's on-demand training. It's worth its weight in gold, in terms of what it allows me to do.