概要设计规约
概要设计规约指明软件的组织结构,其主要内容包括:
详细设计规约
详细设计规约是对软件各组成部分内部属性的描述,它是概要设计的细化。即在概要设计规约的基础上,增加以下内容:
设计规约格式
1. 引言
1.1 编写目的
说明编写本软件设计说明书的目的。
1.2 背景说明
(1)给出待开发的软件产品的名称;
(2)说明本项目的提出者、开发者及用户;
(3)说明该软件产品将做什么,如有必要,说明不做什么;
1.3 术语定义
列出本文档中所用的专门术语的定义和外文首字母组词的原词组。
1.4 参考文献
列出本文档中所引用的全部资料,包括标题、文档编号、版本号、出版日期及出版单位等,必要时注明资料来源。
2. 总体设计
2.1 需求规定
说明对本软件的主要输入、输出、处理等功能及性能要求。
2.2 运行环境
简要说明对本软件运行的软件、硬件环境和支持环境的要求。
2.3 处理流程
说明本软件的处理流程,尽量使用图、文、表的形式。
2.2 软件结构
在 DFD 图的基础上,用模块结构图来说明各层模块的划分及其相互关系,划分原则上应细到程序级(即程序单元),每个单元必须执行单独一个功能(即单元不能再分了)。
3. 运行设计
3.1 运行模块的组合
说明对系统施加不同的外界运行控制时所引起的各种不同的运行模块的组合,说明每种运行所经历的内部模块和支持软件。
3.2 运行控制
说明各运行控制方式、方法和具体的操作步骤。
4. 系统出错处理
4.1 出错信息简要说明每种可能的出错或故障情况出现时,系统输出信息的格式和含义。
4.2 出错处理方法及补救措施
说明故障出现后可采取的措施,包括:
(1)后备技术。当原始系统数据万一丢失时启用的副本的建立和启动的技术,如周期性的信息转储;
(2)性能降级。使用另一个效率稍低的系统或方法(如手工操作、数据的人工记录等),以求得到所需结果的某些部分;
(3)恢复和再启动。用建立恢复点等技术,使软件再开始运行。
5. 模块设计说明
以填写模块说明表的形式,对每个模块给出下述内容:
(1)模块的一般说明,包括名称、编号、设计者、所在文件、所在库、调用本模块的模块名称和本模块调用的其他模块名;
(2)功能概述;
(3)处理描述;
(4)引用格式;
(5)返回值;
(6)内部接口,说明本软件内部各模块间的接口关系,包括:
(a)名称;
(b)意义;
(c)数据类型;
(d)有效范围;
(e)I/O 标志;
(7)外部接口,说明本软件同其他软件及硬件间的接口关系,包括:
(a)名称;
(b)意义;
(c)数据类型;
(d)有效范围;
(e)I/O 标志;
(f)格式,指输入或输出数据的语法规则和有关规定;
(g)媒体;
(8)用户接口,说明将向用户提供的命令和命令的语法结构,以及软件的回答信息,包括:
(a)名称;
(b)意义;
(c)数据类型;
(d)有效范围;
(e)I/O 标志;
(f)格式,指输入或输出数据的语法规则和有关规定;
(g)媒体
模块结构图
模块结构图(Module Structure Diagram, MSD)是用来表示系统的模块划分与层次分解关系,表示模块的调用关系、模块间数据流与控制流的传递关系以及模块与外界或数据存储的信息接口的规范化图形,是结构化系统设计的一种重要的图表描述工具。
组成元素
作用
描述模块间参数交换情况、评价模块间耦合情况、确定模块间的接口。结构图一般不列入设计文档,只用于设计阶段检查模块设计的正确性和模块独立性。
变换设计
变换设计就是从变换型数据流图映射出软件模块结构的过程,也称以变换为中心的设计。
变换设计的基本方法有两步:
图1 变换设计
图2 变换设计
图3 变换设计
事务设计
事务设计就是从事务型数据流图映射出软件模块结构的过程,也称为以事务为中心的设计。
事务设计的基本方法有两步:
图4 事务设计
图5 事务设计
图6 事务设计
模块及模块化思想
系统的模块数目增加,每个模块的规模减小,开发单个模块的成本减小,但是,随着模块数目增加,设计模块间接口的工作量增也加。所以随着模块数目的增加,系统的总成本先降低后增加,总成本曲线出现一个最小成本区。如果一个大型程序仅有一个模块,它将很难被人所理解,模块化的目的之一是为了让一个大型的程序更容易被人所理解。
采用模块化原理可以使软件结构更加清晰,更加易于阅读和理解。程序错误通常出现在部分模块及它们间的接口,所以模块化思想使软件更加容易测试和调试,提高了软件的可靠性,模块化使得一个大型的程序分解成不同的模块,对难易程度不同的模块可以分配技术熟练程度不同的程序员编写,有助于软件开发的组织管理。模块化的缺点是会造成性能损耗,系统逐步分层,调用链长,模块间通信很耗性能。
逐步求精中每一层中的模块都是对系统抽象层次的一次精化。软件结构顶层的模块,控制系统的主要功能。软件结构底层的模块,完成对数据的一个具体处理,软件结构中,首先抽象出系统的主要功能,然后逐步实现低层细节采用自顶向下,由抽象到具体的方式分配控制,提高了软件的可理解性和可测试性。
信息隐藏与局部化。在软件结构中,各个模块间的信息应该彼此相对独立,隐藏模块的实现细节,仅允许访问其他模块中为了完成系统功能所需要的的信息,在模块中使用局部数据元素有助于实现信息隐藏。编写系统的不同模块时,可以根据实际需要自由命名局部变量。模块独立的概念是模块化、抽象、信息隐藏和局部化概念的直接结果。
案例介绍
项目背景及介绍
电商系统致力于提供产品展示及订购,为核心的网上购物服务宣传自己商店的商品并将自己的产品展现给用户,让客户通过网站能自由地选择购买产品。
该网站是通过用户登录浏览商品、查看公告、购买、确定购买、实现用户模块功能。其中订单的生成,网站后台系统,通过系统管理员管理商品、订单、用户来实现。用户可以在商城前台进行浏览商品,加入购物车,下单等操作。后台管理模块可以对商品、订单、会员以及库存进行管理。
功能需求
功能块划分
网上商城共分两个部分,一部分是面向用户的部分,包括:顾客在线注册、购物、提交订单、付款等操作;另外一部分是商城管理部分,这部分的内容包括:产品的添加、删除、查询、订单的管理、操作员的管理、注册用户的管理等。三,商家(增,删,改)
功能块描述
(一)面向用户部分功能
(二) 后台管理部分功能
耦合原则
如果模块间必须存在耦合,就尽量使用数据耦合、少用控制耦合、限制公共耦合的范围以及坚决避免使用内容耦合。
内聚定义
内聚(Cohesion)是指一个模块之内各成分之间相互依赖程度的度量。
常见内聚类型(由低到高)
闯关要求
案例介绍
网上商城系统致力于提供产品展示及订购,为核心的网上购物服务宣传自己商店的商品并将自己的产品展现给用户,让客户通过网站能自由地选择购买产品。
用户可以在商城前台进行浏览商品,加入购物车,下单等操作。后台管理模块可以对商品、订单、会员以及库存进行管理。
题目
请根据网上商城系统案例描述以及相关知识点,完成相应题目。
1.改进软件结构提高模块独立性
耦合定义
耦合(Coupling)是指不同模块之间相互依赖程度的度量。
常见耦合类型(由强到弱)
设计出软件的初步结构以后,应该审查分析这个结构,通过模块分解或合并,力求降低耦合提高内聚。例如,多个模块公有的一个子功能可以独立成一个模块,由这些模块调用;有时可以通过分解或合并模块以减少控制信息的传递及对全程数据的引用,并且降低接口的复杂程度。
2.模块规模应该适中
过大不易理解;太小则接口开销过大。
经验表明,一个模块的规模最好能写在一页纸内(通常不超过60行语句)。
3.深度、宽度、扇出和扇入都应适当
深度:表示软件结构中控制的层数。
深度能粗略地标志一个系统的大小和复杂程度,深度和程序长度之间有粗略的对应关系
宽度:表示软件结构中控制的总跨度。
宽度是同一个层次上的模块总数的最大值,宽度越大系统越复杂;对宽度影响最大的因素是模块的扇出。
扇出:表示一个模块直接控制(调用)的模块数目扇出为3-4,上限扇出为5-9。
扇入:表示有多少个上级模块直接调用该模块扇入越大则共享该模块的上级模块数目越多。
4.模块的作用域应该在控制域之内
模块的控制域:这个模块本身以及所有直接或间接从属于它的模块的集合。
模块的作用域:受该模块内一个判定影响的所有模块的集合。
在一个设计得很好的系统中,所有受判定影响的模块应该都从属于做出判定的那个模块,最好局限于做出判定的那个模块本身及它的直属下级模块。
5.力争降低模块接口的复杂程度
模块接口复杂是软件发生错误的一个主要原因。应该仔细设计模块接口,使得信息传递简单并且和模块的功能一致。接口复杂或不一致(即看起来传递的数据之间没有联系),是紧耦合或低内聚的征兆,应该重新分析这个模块的独立性。接口复杂可能表明模块的独立性差。
6.设计单入口单出口的模块
这条启发式规则警告软件工程师不要使模块间出现内容耦合。当从顶部进入模块并且从底部退出来时,软件是比较容易理解的,因此也是比较容易维护的。
7.模块功能应该可以预测
模块的功能应该能够预测,但也要防止模块功能过分局限。