宿迁网站建设【宿迁网络公司】宿迁做网站、宿迁微信公众号开发、宿迁网站设计、宿迁小程序制作

宿迁网站建设【宿迁网络公司】宿迁做网站、宿迁微信公众号开发、宿迁网站设计、宿迁小程序制作

宿迁，简称宿，别称水城，古称下相、宿豫、钟吾等，江苏省地级市，宿迁位于长三角北翼，江苏省北部，是长三角北翼区域性综合交通枢纽， [1]  地处徐州、连云港、淮安中心地带。宿迁是江苏省沿海地区向中西部辐射的重要门户城市 [2]  ，是徐州都市圈、江淮生态经济区核心城市 [3]  、一带一路节点城市 [4]  。截至2020年6月，宿迁下辖2区3县 [5]  ，总面积8555平方千米。截至2019年末，宿迁户籍人口592.36万 [6]  。

宿迁是西楚霸王项羽的故乡，有着5000多年的文明史和2700多年的建城史，曾是泗水国、钟吾国、宿国都城，历史悠久，人文荟萃，素有“华夏文明之脉、江苏文明之根、淮河文明之源、楚汉文化之魂”之称 [7]  。宿迁是酒文化的发源地之一，有中国白酒之都称号 [8]  ，洋河、双沟两大名酒出产于此。宿迁是典型的苏北水乡，坐拥骆马湖、洪泽湖两大淡水湖，大运河、古黄河、淮沭新河等众多河流镶嵌其间。乾隆皇帝六下江南五次驻跸于此，赞叹宿迁为“第一江山春好处” [9]  。

宿迁是首批12个社会信用体系建设示范城市 [10]  ，是中国优秀旅游城市 [11]  、国家园林城市 [12]  、国家卫生城市 [13]  、全国文明城市 [8]  。2020年10月，宿迁被评为全国双拥模范城（县） [14]  。

作者/Martin Reddy

是软件行业的一名老兵，有着15年以上的从业经验，共撰写过40多篇论文，拥有3项软件专利，并与他人合著了Level of Detail for 3D Graphics。另外，他还是ACM以及IEEE的会员。

早年，他曾在SRI International供职5年，主要从事分布式三维地形可视化技术方面的工作，他成功创建了在Web上描述3D地球空间信息模型的ISO标准，并且还连续两年被选为Web3D协会的会长。

他曾在Pixar动画工作室工作过6年，担任内部动画系统的首席工程师，设计并实现了很多高性能API，这些API在一些奥斯卡获奖及提名影片的制作中都发挥了关键作用，这些影片有《海底总动员》《超人总动员》《赛车总动员》《料理鼠王》，以及《机器人总动员》等。

他还开办了一家咨询公司Code Reddy，为各家软件公司提供技术咨询，主要客户有Linden Lab和Planet 9 Studios，为大型在线3D虚拟世界《第二人生》设计了API并改善了其基本架构。

现在他担任ToyTalk公司的首席技术官。

这里主要回答下面的问题：优质的API应该具有哪些基本特征？绝大多数开发者都会同意这样的观点：优质的API应该设计精巧且实用性强。它不仅能带来愉悦的使用体验，且能与各种应用程序完美融合，甚至让使用者感觉不到其存在（Henning, 2009）。这些定性的表述都没错，但是应该怎样设计API才能够使之拥有这些特征呢？很显然，每个API都是不同的，但是高质量API的设计具有某些共同的特征。API开发者应该尽量遵循这些特征，同时尽量避免那些导致糟糕设计的特征。

API设计没有放之四海而皆准的方法，不可能用一组固定规则应对所有情况。当遇到某些特别的项目时，你可能不会采用建议的方法设计API，但是这样做的前提是你已经合理而周全地考虑了该设计方案。这里提到的原则是设计API通常应该遵循的基本准则。

这里重点讨论API所具有的通用的、与语言无关的特征，比如信息隐藏、一致性以及松耦合。虽然我们是在C++语境下解释这些概念，但是，不管你使用的是C++、Java、C#还是Python，这里的建议大体上都能适用。

问题域建模

编写API的目的是解决特定的问题或完成具体的任务。因此， API应该首先为问题提供一个清晰的解决方案，同时能对实际的问题域进行准确的建模。例如， API应该对问题域进行很好的抽象并且模塑出问题域的核心对象，这样会使API更便于用户使用和理解，因为它与使用者已有的知识和经验关联密切。

提供良好的抽象

API应该对它所解决的问题提供逻辑抽象。也就是说，在设计API时，应该阐述在选定问题域内有意义的深层概念，而不是公开低层实现细节。当你把API文档提供给一位非程序员时，他应当能够理解接口中的概念并且知道它的工作机制。

对于非技术人员， API提供的一组操作应该合乎逻辑且共属同一单元。每个类都应该有一个主旨，且这个主旨应该能通过类名和类包含的方法名体现出来。有可能的话，还可以让非技术人员看看接口，要是连他们都能看懂接口的运行机制，那说明接口的抽象就非常到位了。

得出好的抽象并非易事。需要注意的是，任何问题的正确抽象不止一种。绝大多数API都能以多种方式建模，每种建模方式都能提供良好的抽象和易用的接口。关键是API应该具有一致且合理的支撑体系。

例如，为一个简单的地址簿程序设计API。从概念上讲，地址簿包含许多人的详细信息。因此，我们的API应当提供一个AddressBook对象，它包含一个Person对象集合，每个Person对象描述了单个联系人的姓名和地址。此外还要能进行如下操作——向地址簿中添加联系人和从地址簿中删除联系人。这些操作都会更新地址簿状态，因此逻辑上它们应是AddressBook对象的一部分。我们的初始设计可以使用UML（Unified Modeling Language，统一建模语言）描述这个API结构，如图3-1所示。

图3-1　地址簿API的高层次UML抽象

宿迁网站建设【宿迁网络公司】宿迁做网站、宿迁微信公众号开发、宿迁网站设计、宿迁小程序制作