【电子行业标准(SJ)】 面向对象的软件系统建模规范 第3部分:文档编制

ICS35.008
备案号：12036—2003
中华人民共和国电子行业标准
SJ/T11291—2003
面向对象的软件系统建模规范
第3部分：文档编制
Specification of object-oriented software system modelingPart3:Documentation
2003-06-04发布
2003-10-01实施
中华人民共和国信息产业部发布前
《面向对象的软件系统建模规范》系列标准分为三部分：SJ/T11290一2003《面向对象的软件系统建模规范第1部分：概念与表示法》SJ/TXXXX一XXXX《面向对象的软件系统建模规范第2部分：过程指导》SJ/T11291-2003《面向对象的软件系统建模规范第3部分：文档编制》附录A是资料性附录。
本标准由中国电子技术标准化研究所归口。本标准由北京大学负责起草。
本标准主要起草人：麻志毅、蒋严冰、王立福、邵维忠。SJ/T11291—2003
SJ/T1t291—2003
文档是软件的重要组成部分，是对研制过程进行管理的重要手段。文档的形式可以是多种多样的。在面向对象的软件系统建模过程中经常用到的文档，可以是图形的，也可以是文本的。图形文档具有清晰、直观及简练等特点；文本文档具有容易理解、具体及详细等特点。二者相互补充和相互依赖，都是不可少的。在本标准中要求同时使用这两种文档。其中的图形文档的绘制方法在SJ/T11290一-2003《面向对象的软件系统建模规范第1部分：概念和表示法》中已有了详细的规定。本标准主要规定与各图形文档相对应的文本文档格式。严格地说，尽管图形文档和文本文档的表现形式不同，但其本质内容都是一致的。在编制的过程中要充分地注意到这一点，力求图形文档中的元素和文本文档中的各组成部分一一对应。在每种文本文档中对各个组成部分分类描述，并注重描述不同组成部分的关系，这样就使得文本文档中的组成部分组织严密，便于相关人员从不同的角度使用所需要的组成部分。在图形文档中，为了管理信息组织的复杂度而引入了包的机制。为了更好地用文本的方式描述这种机制，在本标准中用递归的方法描述带有包的文档。本标准对用况图文档、类图文档、顺序图文档、协作图文档、状态图文档、活动图文档、构件图文档、部署图文档和包图文档的格式分别做了详细的描述。对每种文档的结构以及可能包含的组成部分分别出了规定。本标准最后提供了一个样式，以便于有关人员实际操作时参考。1范围
面向对象的软件系统建模规范
第3部分：文档编制
SJ/T11291—2003
本标准规定了对面向对象的软件系统建模过程中所生成的文档的编制要求，并给出了编制提示。本部分适用于软件系统的分析和设计，我和维护。
ANDARD
2引用标准
日期的到引用文件，其随后所有的下列文件中的条款通过本标准的的用而成为本标准的条款
修改单（不包括勘误的内容）或修订版均不适用于本标准，然而，鼓病断根据本标准达成协议的各方研究是否可使用这些文件的最新版本。凡是不注日期的引用文件，其最新版本适用于本标准。SJ/T11290
SJ/TXXX
3文档的编制要求
面向对象的软件系统建模规范第1部分：概念争表示法面询对象的软件系统建模规范第2部分：射程指导7MA
向对象的软件系统建模中，一般地说，应产生下列文档：总体说期文档：
用况图
类图文权
顺序图文
协作图文程
状态图文档；
活动图文档：
构件图文档：
部署图文档：
其中有的文档有时会引入也因来合理值理@RM开发者也可根据所承担项目的实际情况灵活取
当开发者按照《面向对象的软件系统建模规范第2部分：过程指导》开发软件系统时，可以按开发阶段组织文档，分别形成：
需求定义文档、分析文档和设计文档。其中每种文档的内容包含一个或多个上面提到的各种图的文档，具体的要求见《面向对象的软件系统建模规范第2部分：过程指导》。4文档的编写提示
4.1总体说明文档
以文本方式，对整个系统作一些必要的说明。内容包括系统的目标、意义、应用范围、项目背景和文档组成等。但不必对系统的总体进行详细地说明，只需作提纲挚领式的简单介绍。另外，还要说明系统的建模文档由那几种具体的文档组成、每种文档的份数以及对各种文档的组织等。4.2用况图文档
SJ/T11291--2003
4.2.1图形文档
即所绘制的用况图。
4.2.2文字说明
用况图文档由以下部分组成：用况图综述、参与者描述、用况描述、用况图中元素间的关系描述和其他与用况图有关的说明。
4.2.2.1用况图综述
从总体上阐述整个用况图的目的、结构、功能以及组织。以文字描述文档所包含的部分。4.2.2.2参与者描述
列出一个用况图中的每个参与者的名称，可按字母顺序或其它某种有规律的次序排列。必要时要对参与者附有必要的文字说明，也可以说明它所涉及到的用况和交五图的名称。4.2.2.3用况描述
对于个用况图中的每个用况，记录如下的信息。要按某种顺序排列它们。a）名称
每个用况有一个在图内唯一的名字，并且该名字要反映出它所描述的功能。书写位置是在用况描述的第一行。
行为描述
用自然语言分别描述参与者的行为和系统行为，建议把参与者的行为靠左对齐书写，把系统行为靠较右的位置对齐书写。
在描述较复杂的含有循环或条件分支的行为时，可使用一些结构化编程语言的控制语句，如while，for，if-then-else等。当要表明控制语句的作用范围时，可使用括号，如[、］或begin、end等，也可以使用标号，以便更清楚地表示控制走向。
如有必要，可使用顺序图、状态图或协作图描述参与者的行为和系统行为。用况图中元素间的关系描述
产生一份描述用况图中的参与者与用况间、用况间以及参与者间关系的文字性描述文档。具体地由下面几部分构成：
1）关系的名称；
2）关系的类型：关联，泛化，包含，扩展：3）关系所涉及的类日：对关系所连接的类目应指明名称和类型（参与者或用况）。其他与用况图有关的说明
与该用况图有关的但上面文档中没有涉及的其他信息的描述。4.3类图文档
4.3.1图形文档
即所绘制的类图。
4.3.2文字说明
文字描述由以下部分组成：类图综述、类描述、关联描述、泛化描述、依赖描述和其他与类图有关的说明。在实际使用时，这些部分是可选的。4.3.2.1类图综述
从总体上阐述整个类图的目的、结构、功能及组织。以文字描述文档所包含的部分。4.3.2.2类描述
类描述包括类整体说明、属性说明、服务说明、关联说明、泛化说明、依赖说明及其他说明。a）类的整体说明
对整个类及其对象的情况加以说明，内容包括：2
1）：类名：应是中文名或英文名：解释：对类的责任的文字描述；2）：
3）一般类：描述该类是从那些类泛化而来的；状态转换图：措述该类的实例的状态图的名称列表：4）
主动性：有无主动性；
永久性：有无永久性；
SJ/T11291—2003
引用情况：若此类为其它类图所定义，则要标明它所属于的类图；若此类被其它类图引用，则标明所引用的类图：
多重性
9）其它：是否有特别的数据完整性或安尘性要求名PDS
属性说明
逐个地说明类的属性。链
接个后性的语
属性名：
不文赢性名或英文属性名：
该属性
的多重性：
该属性赖作用；
数据类型：
如果这个属性的作用是为了表明聚合关系，则程这早说明这种关系：聚台关系
美率，如巢这个底性的作期是为了表明组合关系，则器这里说签种关系；组奇柔
关关系：如巢这个属性是为于实现该类的对象和其审对之间的舒投留的，则在这里明确地说明这一点：
实现要求：
传质佳的取值范围、精压
地说期卖
服务名
初始值及其它描述
的每个服务。每个服务的详扭说明包括以本内文服务名或英文服务名
天动2有
多志性·有无多态性：
解释，该事务的作用：
服务的活动图，详细摄述活动具体细节的活动图的名称可约束条件及艾它：服务的斑行有前置条件、后翼条体或裁行时间的要求等其它需要说INFORM
明的事项，则在冰说明。
描述该类所涉及的所有的关联。每个与该类相关的关联可有关联名。泛化
描述该类所涉及的所有的泛化。每个与该类相关的关联可有泛化名。依赖
描述该类所涉及的所有依赖。每个与该类相关的依赖可有依赖名。4.3.2.3关联描述
类图中的每一关联都应有如下的描述：关联名称：中文关联名或英文关联名：a
关联的类型：应是一般二元关联，聚合，组合，多元关联，自关联，限定关联，导出关联，其他关联：
关联所连接的类：按照一定顺序列举出关联所连接的类关联端点：对每一个关联端点描述如下：3
SJ/T11291—2003
1）导航性：是否有导航性；
2）排序：是否排序；
聚合；是否有聚合，如果有，则要指明是聚合还是组合：3）
多重性；
5）可变性：应是无、只增加、冻结：6)
角色：角色名用中文名和英文名表示均可。7）可见性：用+、一、#表示，
接口说明符
4.3.2.4泛化描述
类图中的每一个泛化都有如下的描述：泛化关系中的父类；
泛化关系中的子类；
泛化关系中的区分器；
泛化关系中的限制符：应是完全、不完全、重叠和不相交。4.3.2.5依赖描述
类图中的每一个依赖都有如下的描述：a)
依赖名称；
依赖所涉及的类的名称：
依赖的类型；
依赖的附加说明。
4.3.2.6其他描述文档
与该类图有关的但上面文档中没有涉及的其他信息的描述。4.4顺序图文档
4.4.1图形文档
即所绘制的顺序图。
4.4.2文字说明
顺序图的文字说明文档应包含：顺序图综述、顺序图中的对象与参与者描述、对象接收/发送信息的措述和其他与顺序图有关的说明。4.4.2.1序图综述
从总体上描述该顺序图的目的，以及所涉及的对象和参与者。4.4.2.2顺序图中的对象与参与者描述对顺序图中的所有的对象和参与者，依次进行如下的描述：a）对象类型：是参与者还是类；b）对象名称：
是否为主动对象：是或否，此描述针对对象而言，对于参与者不应有此描述；c)
d）其他与对象或参与者有关的信息。4.4.2.3对象接收发送消息的描述对顺序图中的每一个对象或参与者，详细地描述其接收/发送消息的类型、时序及与其他消息之间的触发关系。对每一个对象和参与者应按照时间顺序分别列出该对象或参与者所接收/发送的全部消息。对每一条消息应包含下面的内容：a）消息名称：
是发送消息还是接受消息：bzxz.net
消息类型；
若为接收消息，应列出该消息所直接触发的消息的名称列表；d)
是否为自接收消息：
消息的发送对象名称；
消息的接收对象名称。
4.4.2.4其他与顺序图有关的说明与顺序图有关的补充信息。
4.5协作图文档
4.5.1图形文档
即所绘制的协作图。
4.5.2文字说明
SJ/T112912003
熟作图综还量协作图中的对象或角色描述、对象或角色接收！协作图的文字说明应包含下列部分：发送消息的描述、对象或色间的链辅述4.5.2.1协作图综述
从总体上描述该协作图的的以及其所涉及的对象或类元角色。4.5.2.2协作图中的对象或角色描述对协作图中的所有类无角鱼或对象，依次列出下面的各项：a）名称
b）类型：
类角色或对象
。）是香为台幼寸或钓色：是或否；d）其他与突元对象有美的信息。4.5.2.3对象或角免接收/发送消息的描述对协作图中的每一个类百有色或实例，详细地描速其接收/发送消息的类型IN
息的触发关索
类目角色或实例应有下列描述
新接收/发遥的部滑
列出谁对象
消名称
消息的格
参见概念和表示法部分；
是发送息还是接收消息：
消息类型：
若为接收消息应列出该消息所控触是否为自接收消息；
消息的发送类目角色或实例；
消息的接收类目角色或实例。
4.5.2.4对象或角色间的链描述
对象间或角色间的链应由下面的成分构成：a)
链名称：
链所连接的角色或对象的名称：链上的角色名，每个角色应包含下列信息：1）角色名：中文名或英文名：
2）可见性：+、一或#：
条消息包下面的信息？
3）特殊的衍型：Global、Local、Parameter、Self、Vote、Broadcast：d）其他与链有关的信息。
4.5.2.5其他与协作图有关的说明以及与其他消
SJ/T11291—2003
与协作图有关的补充信息。
4.6状态图文档
4.6.1图形文档
即所绘制的状态图。
4.6.2文字说明
状态图的文字说明应包含：状态图综述、状态图的状态描述、状态图的转换描述和其他与状态图有关的说明。
4.6.2.1状态图综述
从总体上，该状态图描述一个对象在外部激励的作用下进行的状态变迁、所涉及到的状态和转换以及设置该状态图的目的等。
4.6.2.2状态图的状态描述
描述一个状态图的所有的状态，对每一个具体状态应包括以下各项：a）状态的名称：中文名或英文名：状态的类型：简单状态，并发组合状态，顺序组合状态，子状态，初始伪状态，终状态，结合b）
状态，历史状态，引用状态，桩状态，同步状态：c）入口动作；
出口动作：
内部转换：由一系列的内部转换项组成。每个内部转换项有下列格式：动作标号/动作表达式：
若为组合状态应列举出其所包含的子状态：f)
g）其它与该状态有关的信息。
4.6.2.3状态图的转换描述
本文档用来描述一个状态图的所有的状态转换，每一个具体转换应包括以下各项：a）转换的源状态；
转换的目标状态；
转换串：事件特征标记“［”监护条件“，“动作表达式：c)
转换中的分支：同步条、结合点、动态选择点。d)
4.6.2.4其他与状态图有关的说明与状态图有关的补充信息。
4.7活动图文档
4.7.1图形文档
即所绘制的活动图。
4.7.2文字说明
活动图的文字说明包含：活动图综述、活动图中的动作状态描述、活动图中的转换描述和其他与活动图有关的说明。
4.7.2.1活动图综述
从总体上，活动图描述一个对象的一个操作的活动序列，或者是多个对象为完成某一目的而进行的协作所涉及的活动序列，以及设置该活动图的目的等。若活动图用于描述系统的其他目的，也按本格式描述。
4.7.2.2活动图中的动作状态描述本文档用来描述一个活动图的所有的动作状态，每个具体动作状态包括以下内容：a）名称：中文名或英文名：
b）类型：一般动作状态，子动作状态，信号发送，信号接收，初始伪动作状态，终动作状态，历史状态：
入口转换：
出口转换：
活动伪码；
其它与该状态有关的信息。
4.7.2.3活动图中的转换描述
本文档用来描述一个活动图的所有的转换，每一个具体转换包括以下内容：a)
转换的名称；
源动作状态：
终动作状态：
转换中的分支：包括分叉、同步条决策和会并 EXANDARD
转换中的控制分叉：包插控制分两e)
与状态图有关的补充信
4.8构件图文档
4.8.1图形文档
即所绘制的构件图
4.8.2文字说朗
构件图的文字说
好泳造的划分、对象流、
SJ/T11291—2003
相连的入口和出口元素的名称。量接收等信息。
联和馈
文档包金检性图综速、构件图中的构件描述、件图有关的说明
4.8.2.1格件图的综述
从总体上，构件图描述构件间的依赖关系、4.8.2.2.构件图中的构件描述点构件图中的
a）构作名称
个构件包含下列描述：
构件的接
构件所涉好关
在逻辑人构纤所实现的类；
构件的类型
构件图中的关系猫述
关系的名称：
设置该构件图的目的等
内件图中的
关系错述和其他与构
INFORMAY
关系的起始构件的名称
关系的结束构件的名称；
关系的类型：实现依赖、使用依赖或其他依赖。d)
4.8.2.4其他与构件图有关的说明其他与构件图有关的信息。
4.9部署图文档
4.9.1图形文档
即所绘制的部署图。
4.9.2文字说明
部署图的文字说明文档包含：部署图综述、部署图中的节点描述、部署图中的关系描述和其他与部署图有关的说明。
4.9.2.1部署图综述
从总体上描述部署图的自的以及节点之间的相互关系等。4.9.2.2部署图中的节点描述
SJ/T11291—2003
对部署图中的每一个节点包含下列描述：a）节点名称；
节点中的构件实例；
节点所涉及的链的名称；
节点的类型。
4.9.2.3部署图中的关系描述
关系的名称：
关系的起始节点（或构件）的名称；关系的结束节点（或构件）的名称：c)
关系的类型：实现依赖、使用依赖、其他依赖或通讯链。4.9.2.4其他与部署图有关的说明其他与部署图有关的信息。
4.10包图文档
为了管理模型的信息组织的复杂性，在比较复杂的模型中，通常将关系联系比较密切的图形元素划分到一个包里面。最常见的是在用况图和类图中使用包图。一般情况下，包图与前面提到的几种图搭配使用，而不单独使用。
4.10.1图形文档
即所绘制的包图。
4.10.2文字说明
包图的文字说明文档包含：包图的综述、包图中的包描述和其他与包图有关的说明。4.10.2.1包图的综述
从总体上描述包图的名称、目的以及与其他包的相互关系等。4.10.2.2包图中的包描述
包图中的每一个包包含下列描述a)
包的名称：
包的种类：类包、用况包或其他：详细描述该包所包含的建模元素所在的文档；与该包有关系的其他包，应包括如下信息：包的名称；
2）与该包的关系：依赖（访问和移入）、泛化，要注明方向性。4.10.2.3其他与包图有关的说明其他与包图有关的信息。
A.1文档的封面格式
文档的封面格式如下：
附录A
(资料性附录）
文档编写样式
TANDARDS
（需求、分析、
软系统建模
SJ/T11291—2003
没计）
SINORMATIO
编写单位
编写人
校对人
编写日期
小提示：此标准内容仅展示完整标准里的部分截取内容，若需要完整标准请到上方自行免费下载完整标准文档。