宿迁微信公众号开发【宿迁网络推广】宿迁建站、宿迁网站维护、宿迁网页制作、宿迁微信小程序代运营公司

宿迁微信公众号开发【宿迁网络推广】宿迁建站、宿迁网站维护、宿迁网页制作、宿迁微信小程序代运营公司

宿迁，简称宿，别称水城，古称下相、宿豫、钟吾等，江苏省地级市，宿迁位于长三角北翼，江苏省北部，是长三角北翼区域性综合交通枢纽， [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]  。

(1) 地址簿（Address Book）：包含零个或多个Person对象，包括AddPerson()、DeletePerson()以及UpdatePerson()操作。

(2) 联系人（Person）：完整地描述联系人的详细信息，包括零个或多个地址和电话号码。每个联系人用UUID唯一标识。

(3) 地址（Address）：描述地址，包括一个类型字段，例如Home或者Work。

(4) 电话号码（Telephone Number）：描述电话号码，包括一个类型字段，例如Home或者Cell。还要支持IsValid()和GetFormattedNumber()操作。

更新后的对象模型如图3-2所示。

图3-2　地址簿API关键对象的UML图

要特别注意的是，API的对象模型可能需要随时变化。由于产生的新需求或要添加新功能，之前切合需求的类和方法可能不再符合。因此，明智之举是根据新需求重新评估对象模型，以判断能否在重新设计中获益。例如，你预计可能会需要用到国际地址，或决定创建更加通用的Address对象以满足需求。然而，不要太过极端，不要尝试创建过于通用的对象模型。同时，确保理解最小完备性！

隐藏实现细节

创建API的主要原因是隐藏所有的实现细节，以免将来修改API对已有客户造成影响。因此，API最重要的特征就是要切实达到这一目标。也就是说，任何内部实现细节（那些很可能变更的部分）必须对该API的客户隐藏。David L. Parnas称此概念为信息隐藏（Parnas, 1972）。

主要有两种技巧可以达到此目标：物理隐藏和逻辑隐藏。物理隐藏表示只是不让用户获得私有源代码。逻辑隐藏则需要使用语言特性限制用户访问API的某些元素。

物理隐藏：声明与定义

在C和C++中，声明和定义是有特定含义的精确术语。声明只是告诉编译器一个名字以及它的类型，并不为其分配任何内存。与之相对，定义提供了类型结构体的细节，如果是变量则为其分配内存。

（C程序员所使用的术语“函数原型”与术语“函数声明”是等价的。）例如，以下都是声明：

extern int i;class MyClass;void MyFunc(int value);复制代码

而以下都是定义：

int i=0;class MyClass{public:
   float x,y,z;};void MyFunc(int value){
   printf("In MyFunc(%d).", value);}复制代码

提示　声明告诉编译器某个标识符的名称及类型。定义提供该标识符的完整细节，即它是一个函数体还是一块内存区域。

从类和方法的角度来说，以下代码定义了一个类，该类只声明了一个方法。

class MyClass{public:
   void MyMethod();};复制代码

在方法的定义中包含其实现（体）。

void MyClass::MyMethod(){
   printf("In MyMethod() of MyClass.\n");}

宿迁微信公众号开发【宿迁网络推广】宿迁建站、宿迁网站维护、宿迁网页制作、宿迁微信小程序代运营公司