.jpg)
carvscops相关介绍,随着大数据、公共平台等互联网技术的成熟，API接口的重要性越来越大，从公司的角度来看，API可以被视为公司巨大的资产，公共API可以捕获用户，为公司做出很多贡献。 对于个人来说，只要你编程，你就是一个随着大数据、公共平台等互联网技术的成熟，API接口的重要性越来越大，从公司的角度来看，API可以被视为公司巨大的资产，公共API可以捕获用户，为公司做出很多贡献。
了解了一款优秀API所具备的特征后，一起再来看看如何设计优秀的API，有哪些流程和规则可循，开发者在设计时需要注意哪些事项。
在开始之前，你可能会收到一些解决方案，它们不一定会比现有的方案好，而你的任务是以用例的形式提取真实需求，并制定真正合适的解决方案，这样构建出来的东西就会更加有价值。
• 获得信任之后将其具体化，在此之中，编程很重要。
• “三次原则”（“The Rule of Threes”）：指的是当某个功能第三次出现时，才进行”抽象化”。
• 对可能会犯的错误进行预计，要用发展的思维来编写API。
大家可以点击加入群：【Java高级架构进阶群】：854180697 里面有Java高级大牛直播讲解知识点 走的就是高端路线 ，（如果你想跳槽换工作 但是技术又不够 或者工作上遇到了瓶颈 ，我这里有一个JAVA的免费直播课程 ，讲的是高端的知识点基础不好的误入哟 ，只要你有1-5年的开发经验可以加群找我要课堂链接 ，注意：是免费的 没有开发经验误入哦）
• 每个API接口应该只专注一件事，并做好：如果它很难命名，那么这或许是个不好的征兆，好的名称可以驱动开发、并且只需拆分与合并模块即可
• API应尽可能地轻小：满足需求、对有疑问的地方可以暂时不使用（函数、类、方法、参数等，你可以不添加，但千万不要删除）、概念性的东西比体积重要、寻找一个良好的动力体积比；
• 实现不要影响API：关注实现细节（不要迷惑用户、不要随便改变实现方式）、意识到具体的实现细节（不要有越权的方法行为，例如不要制订哈希函数、所有的调优参数都是可疑的）；
• 不要让实现细节“泄露”到API（例如on-disk和on-the-wire格式等异常情况）；
• 最小化可访问：设计人员应尽量把类及成员设为私有，公共类不应该有公共字段（包括异常实例），最大限度地提高信息隐藏，允许模块可以被使用、理解、构建、测试和独立调试；
• 命名问题：应该见名知意，避免含糊的缩写、对同一样东西的命名应该有个一致性的前缀（遍及整个平台API）、讲究对称、代码应该易读。如下所示：
开发API时要意识到文档的重要性。组件重用不是纸上谈兵的东西，既需要好的设计，也需要优秀的文档，这二者缺一不可，即使我们看到了良好的设计而未见文档，那么组件重用也是不妥的。
• API设计决策对性能的影响是真实永久的；
• 不得打包API来提升性能（潜在的性能问题可能会得到修复，但救的了一时，救不了一世）；
• 良好的设计通常与好的性能是一致的。
• 养成良好的习惯：遵守标准的命名约定、避免陈旧的参数和返回类型、核心API和语言的模仿模式；
• 如果是可变类，最好保持很小的状态空间、定义良好的结构，因时制宜地去调用方法。
用户API只需根据需求来设计即可，不必让客户感到惊讶，小心弄巧成拙：
• 即使你能分清，也最好不要这样做，最好起个不同的名字
• 在方法上参数顺序要一致，尤其是参数类型相同时，则尤为重要
• 三个或三个以内的参数是最完美的
• 使用接口来减少概念权重：较高的动力重量（power-to-weight）比
API设计是一件非常高端大气上档次的工艺，对程序员、终端用户和公司都会有所提升。不要盲目地去遵守文中所提及的规则、说明等，但也不要去侵犯他们，API设计不是件简单的工艺，也不是一种可以孤立行动的活。
.jpg)
.jpg)
.jpg)
.jpg)
.jpg)
.jpg)
