课程实践介绍 第二阶段的课程实践，即进行面向对象的分析、设计 和编程实现阶段的实践任务（从11月22日开始，12月 10日完成） GBT85672006建议，在一个面向对象的软件系统 建模，一般应产生的文档有： 总体说明文档 用况图文档 类图文档 顺序图文档 协作图文档 状态图文档 活动图文档 构件图文档 部署图文档，其中有的文档有时会引入包图来管理信息组织，开发者可以根据项目的 具体情况，灵活取舍或增补。课程实践的第二阶段的要求课程实践的第二阶段的要求 当开发者强调过程控制时，也可以形成需求描述文档、分析 文档和设计文档等。期中每种文档的内容包含一个或多个图 文档。 第二次课程实践建议采用过程控制，形成以下文档 ： 需求描述文档（用况图）、 分析文档（类图、包图、选择复杂交互采用顺序图描述，也 可以选择一个复杂对象用状态图描述之） 设计文档（从问题域部分的设计、人机交互部分的设计、控 制驱动部分的设计、数据管理部分的设计四个方面对系统进 行设计，对分析文档进行补充和调整，形成设计阶段的类图 、包图、顺序图以及状态图等） 在上述文档的基础上，形成总体说明文档 以上文档（12月10日前完成，并以小组方式提交给 各助教）以上各种文档的规范格式如下： 总体说明文档（必须）要对整个系统作一些必要的说明。内容包括系统 的目标、意义、应用范围、项目背景和文档组成 等。但不必对系统的总体进行详细地说明，只需 作提纲挈领式的简单介绍。另外，还要说明系统 的文档由那几种具体的文档组成、每种文档的份 数以及对各种文档的组织等。用况图文档(必须，是软件需求描述文档)1、 图形文档即所绘制的用况图。 2、文字说明该部分由以下部分组成：用况图综述、参与者描述、用况描述、用况 图中元素间的关系描述和其他与用况图有关的说明。（1）用况图综述 从总体上阐述整个用况图的目的、结构、功能以及组 织。以文字描述文档所包含的部分。（2）参与者描述 列出一个用况图中的每个参与者的名称，可按字母顺 序或其它某种有规律的次序排列。对参与者要附有必要的文字说明， 也可以说明它所涉及到的用况和交互图的名称。（3）用况描述 对于一个用况图中的每个用况，描述其名称和并详述其 行为（参看第3章中的用况模板），并说明它与本图中的其他元素间 的关系。（4）其他与用况图有关的说明 描述与该用况图有关的但上面文档中没 有涉及的其他信息。类图文档（必须、面向对象分析和设计均包含此 图）1、 图形文档 即所绘制的类图。 2、 文字说明 该部分由以下部分组成：类图综述、类描述、关联描述、继承描述、依赖描述和 其他与类图有关的说明。在实际使用时，这些部分是可选的。 （1）类图综述 从总体上阐述整个类图的目的、结构、功能及组织。 （2）类描述 包括类整体说明、属性说明、操作说明、关联说明、聚合说明、继 承说明、依赖说明及其他说明。 a) 类的整体说明 对整个类及其对象的情况加以说明，内容包括：类名、对类的责任的文字描述、 对该类是从那些类继承而来的描述、该类（的对象）的状态图的名称列表、 该类被引用的情况、多重性，以及对有无主动性、有无永久性等的描述。 b) 属性说明 逐个地说明类的属性。每个属性的详细说明包括以下内容：属性名、属性、多重 性的作用、数据类型、实现要求，以及是否用于表明聚合关系、组合关系或 关联关系的描述。若是类属性，也要加以说明。c) 操作说明 逐个地说明类中的每个操作。每个操作的详细说明包括以下内容：操作名、操作 的作用、详细描述操作方法具体细节的活动图的名称列表、约束条件，以及 对是否具有多态性的描述。 d) 关系说明 描述该类所涉及的所有的关联、聚合、继承和依赖关系。 e）定义对象 对于该类创建的每个全局对象，按如下格式进行描述： 处理机：，； 内存对象：（n元数组）； 外存对象：； （3）关联描述 类图中的每一关联都应如有下的描述：关联名称、关联的类型（ 二元关联，聚合，组合，多元关联，自关联）、关联所连接的类、关联端点 （导航性、聚合、多重性、角色、 可见性）。 （4）继承描述 类图中的每一个继承都有如下的描述：继承关系中的一般类、继 承关系中的特殊类。 （5）依赖描述 类图中的每一个依赖都有如下的描述：名称、所涉及的类的名称 、类型、附加说明。 （6）其他与类图有关的说明 与该类图有关的但上面文档中没有涉及的其他信息 的描述。顺序图文档（必须、面向对象分析和设计均包含 此图，课程实践要求对复杂的交互用顺序图描述 ）1、 图形文档 即所绘制的顺序图。 2、 文字说明 该部分包含：顺序图综述、顺序图中的对象与参与者描述、对象接收/发送信息 的描述和其他与顺序图有关的说明。 （1）顺序图综述 从总体上描述该顺序图的目的，以及所涉及的对象和参与者。 （2）顺序图中的对象与参与者描述 对顺序图中的所有的对象和参与者，依次进 行如下的描述：对象或参与者的名称、是否为主动对象、其他与对象或参与 者有关的信息。 （3）对象接收发送消息的描述 对顺序图中的每一个对象或参与者，按照时间顺 序详细地描述其接收/发送消息的类型。对每一条消息应包含下面的内容：消 息名称、消息格式、消息类型、发送消息的对象名称、接收消息的对象名称 。 （4）其他与顺序图有关的说明 与顺序图有关的补充信息。状态图文档（可选、面向对象分析和设计均包含 此图，课程实践要求建议对复杂的对象选用状态 图描述其在生存期内的状态变化以及所做出的反 应）1、 图形文档 即所绘制的状态图。 2、文字说明 该部分包含：状态图综述、状态图的状态描述、状态图的转移描述和其他与状态 图有关的说明。 （1）状态图综述 从总体上，描述设置该状态图的目的，以及所包含的状态、事 件及转移。 （2）状态图的状态描述 描述一个状态图的所有的状态，对每一个具体状态应包 括以下各项：名称、含义、类型（简单状态，并发组合状态，顺序组合状态 ，子状态，初始伪状态，终状态）、入口动作、出口动作、内部转移、组合 状态所包含的子状态、其它与该状态有关的信息。 （3）状态图的转移描述 描述一个状态图的所有的状态转移，每一个具体转移应 包括以下各项：转移的源状态、转移的目标状态、转移串（事件特征标记 守卫条件/ 动作表达式）。 （4）其他与状态图有关的说明 与状态图有关的补充信息。包图文档（必须，从某种角度对类图或其他辅助 模型进行组织）1、图形文档 即所绘制的包图。 2、文字说明 该部分包含：包图的综述、包图中的包描述和其他与包图有关的说明。 （1）包图的综述 从总体上描述包图的名称、目的以及与其他包图的相互关系等 。 （2）包图中的包描述 包图中的每一个包包含下列描述：名称、含义、种类（类 包、用况包或其他）、该包所包含的建模元素所在的文档、与该包有关系的 其他包的信息（包的名称、与该包的关系）。 （3）其他与包图有关的说明 其他与包图有关的信息。 注：根据需要，可以在包树（按树的结构组织的包集合）文档中建立图文档的索 引，分别指向相应的图文档；也可以直接把各图文档按包树的结构组织。协作图文档（附加）1、图形文档 即所绘制的协作图。 2、 文字说明 该部分包含下列部分：协作图综述、协作图中的对象或角色描述、对象或角色接 收/发送的消息描述、对象或角色间的链描述和其他与协作图有关的说明。 （1）协作图综述 从总体上描述该协作图的目的以及其所涉及的对象。 （2）协作图中的对象描述 对协作图中的所有对象，依次列出下面的各项：名称 、是否为主动对象、其他与对象有关的信息。 （3）消息描述 每一对象应有下列描述：名称、该对象所接收/发送的全部消息 及顺序。对每一条消息应包含下面的信息：消息名称、消息的格式、消息类 型、消息的发送者、消息的接收类者。 （4）链描述 对象间的链应由下面的成分构成：链名称、链所连接的对象名称、 链上的消息、其他与链有关的信息。 （5）其他与协作图有关的说明 与协作图有关的补充信息。活动图文档（附加）1、 图形文档 即所绘制的活动图。 2、 文字说明 该部分包含：活动图综述、活动图中的动作状态描述、活动图中的转移描述和其 他与活动图有关的说明。 （1）活动图综述 从总体上，描述设置该活动图的目的、所包含的活动状态及转 移。 （2）活动图中的动作状态描述 描述一个活动图的所有的动作状态，每个具体动 作状态包括以下内容：名称、含义、类型（一般动作状态，初始伪动作状态 ，终动作状态）、活动伪码、其它与该状态有关的信息。 （3）活动图中的转移描述 描述一个活动图的所有的转移，每一个具体转移包括 以下内容：名称、源动作状态、动作状态、转移中的分支（分叉、同步条、 决策和合并）。 （4）其他与状态图有关的说明 与状态图有关的补充信息。 1 本书中没有讲述活 动图，有关内容请参看有关UML的书籍。 课程助教： 兰倩 lanqian09sei.pku.edu.cn 郭超 jorchid.ggmail.com 康亮环 kanglh09sei.pku.edu.cn