UML

服务模块设计文档

模块/子系统概要设计

模块/子系统的概要设计，由架构师参与，核心设计和开发人员负责的方式进行。
在概要设计工作中，我们需要在架构确定的开发路线的指导下，完成模块功能实现的关键设计工作。在概要设计阶段，需要关注于模块的核心功能和难点进行设计。这个过程中更多推荐的采用UML来进行概要设计，需要进行：

• 模块实现机制设计
• 模块接口设计
• 关键类设计
• 画出时序图
• 交互图等。

模块详细设计

在瀑布式开发模型中，模块的详细设计会要求比较严格，将所有类进行详细设计。据我所知，除了一些对于系统健壮性要求非常严格的软件项目，如国防项目，金融项目还要求有详细设计文档之外。其他的项目大多采用其他方式来处理这样的工作，如自动化测试等。

综上所述，软件设计文档作为软件开发团队的沟通、理解、知识共享的手段，具有非常重要的意义。而根据软件团队的规模，对于文档上承载的信息详细程度可以有不同程度的要求。我们软件团队对于如何使用设计文档有一个统一的理解，并坚持更新设计文档，这就是软件设计的最佳实践！

UML(Unified Modeling Language)类图

类的UML图示

类名

属性名

可见性  名称:类型 [ = 默认值 ]

操作方法

可见性  名称(参数1:参数1类型，[参数n:参数n类型]) [ : 返回类型]

类之间的关系

泛化关系(Generalization)

泛化关系也就是Java中的继承，类和类，接口和接口都可以是继承关系，父类又称作基类或超类，子类又称作派生类，类继承父类后可以实现父类的所以功能，并能拥有父类没有的功能。在UML中，泛化关系可以用带空心三角形的直线来表示；例如我们创建两个Java类Teachers和Students类如下代码

实现关系(Realization)

实现关系在java中就是一个类和接口之间的关系，接口中一般是没有成员变量，所有操作都是抽象的（abstract修饰），只有声明没有具体的实现，具体实现需在实现该接口的类中。在UML中用与类的表示法类似的方式表示接口，区别可在UML中类图中看出。如我们创建一个交通工具类接口IVehicle,并有一个形式速度方法声明travelSpeed，Java代码如下

对于交通工具，有很多种，不同交通工具都有一个速度，我们举两个例子，如HighSpeedRail（高铁，时速288KM）和Bicycle（自行车类时速20KM）,则两个实现类代码为

依赖关系(Dependence)

依赖关系是类与类之间最弱的关系，依赖可以简单的理解一个类使用了另一个类，这种使用关系具有临时性特征，但是一个类又会由于另一个类的改变而受到影响，例如在上面举的例子中，假如我们的Students类拥有一个Bicycle，那么要获取移动速度则需要使用Bicycle中获取速度的方法travelSpeed()方法。此时Students代码如下

关联关系(Association)

关联关系表示一个类和另一类有联系，例如在上面的举例中每个Teachers都有个家庭住址与之对应，而此时Teacher和Address就形成了一对一的关联关系。如下

关联关系是一种包含关系，在UML中用一个带箭头的实线表示，箭头指向被包含类。在上图中你可能会发现在线上有1 …1,这个是说明包含关系的。在UML类中有如下几种。

1..1 表示另一个类的一个对象只与该类的一个对象有关系

0..* 表示另一个类的一个对象与该类的零个或多个对象有关系

1..* 表示另一个类的一个对象与该类的一个或多个对象有关系

0..1 表示另一个类的一个对象没有或只与该类的一个对象有关系

* 任意多个对象关联

聚合关系(Aggregation)

聚合关系是表示整体与部分的关系，但是部分可以脱离整体而存在。例如一个Teachers对象有一辆汽车Car，此时Car就是Teachers的一部分，但是Car可以脱离Teachers而存在。在UML类中聚合关系用带空心菱形的直线表示。

组合关系(Composition)

ar，此时Car就是Teachers的一部分，但是Car可以脱离Teachers而存在。在UML类中聚合关系用带空心菱形的直线表示。

组合关系(Composition)

组合关系也是一种部分和整体的关系，但是部分存活周期受到整体的影响，若整体不存在则部分也将不存在。此时部分需在整体的构造方法中创建。在UML类中，组合关系用带实心菱形的直线表示。