
详细设计说明书(模板).doc
21页 详细设计说明书
1.2. 应用模块总体描述描述应用模块的总体功能 1.3. 应用模块接口描述简要描述本应用模块的公共接口,具体接口会在相应的类中进行具体描述建议采用列表的方式1.4. 假设条件列出在问题领域,项目方案及其它影响系统设计的可能方面内,应当成立的假设条件包括系统的约束条件和应遵循的标准第二章 设计模式(Design pattern)请列出本模块设计时使用的设计模式,请参考 “Design Patterns” By Erich Gramma, Helm, Johnson & Vlissides, gang of four ISBN 0-201-63361-z (中文《设计模式》-机械工业出版社)第三章 类设计类图(Class Diagram)描述类和类之间的静态关系与数据模型不同,它不仅显示了信息的结构,同时还描述了系统的行为 在类图的基础上,利用状态图、关系图等进一步描述了系统其他方面的特性类图主要描述了: 类(包括类的实例) 属性(表示知识型责任或数据) 方法(表示操作责任或功能) 类之间的关联关系 类之间的聚合关系 在父类及子类之间的继承关系 正式或非正式的约束描述(可选)本节针对每个构件的进行了详细描述, 记录每个类的实例数,每个实例的占用数据库空间的平均大小等信息。
类图的设计在整个项目生命周期内通过迭代的方法得到方案的复杂程度决定迭代的次数 在考虑初始(initial)或概念(conceptual)角度类图时,我们讨论系统作什麽,该阶段即传统意义上的分析阶段,通过理解业务模型的哪些业务模型应在软件系统中实现来定义问题和需求在这点上设计保持技术中立,但并不意味着丝毫不考虑技术,因为此时对于如何构造软件系统的决定不是首要的关注问题 下一步,设计逻辑(logical)或具体(specification)角度类图时,开始关心系统如何实施和定义方案的整体结构诸如并行及分发,协作及共享,交易及存储,用户界面性能,及系统接口例如通讯接口在设计阶段,设计依赖于技术和架构,同时设计决策也会影响技术和架构 最后的迭代是设计物理或实施角度类图,基于所选的实施语言细化架构设计为了处理特定的实施细节,我们可能引入新的类或对现有的类进行重新定制请明确本节描述的是何种角度的类图类图的目的在于通过研究业务、用户及系统的需求,制定全面的软件模型创建完善的类图有助于完成如下工作: 通过研究系统中包含的对象,优化并精简系统 是系统应用架构某些层次设计的出发点,如用户界面、数据库建模 通过分析问题所在及其相关领域,恰当建立对象模型,有助于明确分工,以支持并行开发。
通过使用简洁明了的表示方法,进一步确认系统设计 全面考虑使用合适的应用设计模型、方法,避免不必要的重复工作 遵循正确的设计原则,方法以提高设计质量在开发组合客户中更好的理解系统的设计有助于系统的重复利用和增量开发使用CASE工具生成图表3.1. 分块类图本段按照模块的不同部分的分块描述类图对于小的模块不须分块3.1.1. <类图1>画一个类图仅描述与该部分相关的那些特征3.1.2. <类图n>对每个部分重复上面的段落要求3.2. 整体继承关系下面的图表描述整个应用模块的类图,在此仅显示类名及类型的3.3. 类描述本章描述上述章节中提到类的详细信息若有可能,使用CASE工具生成这些类描述类列表:请在类名出提供连接指向类的具体描述类名简要描述是否为接口类3.3.1. <类名1> Class DescriptionClassCSampleXXXXPackageClass Formatpublic class CSampleXXXXExtendsImplementsPropertiesNameType Default ValuePub/Prv/ProGetSetPurposeMethodsName(Pub/Prv/Pro)ParametersReturn ValueExceptionsDescriptionEventsNameConditionParametersPurpose约束条件 (可选)实例个数 (可选)实例平均大小 (可选)pseudo -Code for Important Method(重要方法伪码)注:Pub/Prv/Pro 代表private, protected, public3.3.2. <类名n> Class DescriptionClassCSampleXXXXPackageClass Formatpublic class CSampleXXXXExtendsImplementsPropertiesNameType Default ValuePub/Prv/ProGetSetPurposeMethodsName(Pub/Prv/Pro)ParametersReturn ValueExceptionsDescriptionEventsNameConditionParametersPurpose约束条件 (可选)实例个数 (可选)实例平均大小 (可选)pseudo -Code for Important Method(重要方法伪码)注:Pub/Prv/Pro 代表private, protected, public第四章 交互图交互图以图形方式描述了系统之间的交互关系。
初始的交互图仅显示分析阶段主要业务对象间主要的消息流动后续的交互图中包含更多的控制类, 接口类,通讯,分布和存储等功能类初始行为仅描述使用案例或具体情景中所描述的功能,后续交互图中会描述更多系统内部的行为交互图是实例级的图,它描述了具体对象实例间消息的沟通及参数的传递,描述了系统动态交互交互图作为功能性需求说明和类图之间的桥梁,帮助确定对象行为,发现问题,协助设计决定,选择其他设计方法作为类图的补充交互图也可帮助评估类的设计是否能满足功能性需求,交互图和类图都是叠代开发的本文仅对复杂情况使用交互图描述请为不同的情景进行编号 并在交互图列表的情景编号处提供联接交互图列表:情景编号情景名称情景描述相关使用案例4.1. <情景编号1: 情景名称>4.1.1. 交互图描述主要的流程,建议使用Rational Rose 工具示例:4.1.2. 例外情况及条件描述可能的例外情况及条件4.2. <情景编号n: 情景名称>对每个交互图重复上面的段落要求第五章 状态图状态图描述了某一具体类的行为或生命周期它描述了其可能的状态表现,由外界刺激引起的状态变化状态图描述了某个类与其它类交互时复杂的状态变化以图形方式描述状态相关的行为能力,阐明了触发的事件,触发条件,及相应的行为。
本章描述了复杂的主要的状态转换请为不同的状态图进行编号 并在状态图列表的编号处提供联接状态图列表:状态图编号名称描述相关类5.1. <状态图编号1:状态图名称>示例:建议使用Rational Rose 工具必要时可提供下表帮助描述状态子状态入口动作内部动作出口动作状态子状态事件条件变化新状态5.2. <状态图编号n:状态图名称>对每个交互图重复上面的段落要求第六章 时序流程图通过时序图描述一个事件、功能的顺序处理过程图示方式表叔,并文字描述每步过程示例:第七章 用户界面设计说明用户界面设计说明描述用户期待看到的屏幕序列(窗口,对话框,及提示)及其与其与系统的交互用户界面设计也包括详细的屏幕设计、对象、窗口小部件、选项、菜单、按键、视觉、对话框、按键状态、屏幕行为、用户意外处理及错误信息、及所有的外部用户帮助7.1. 用户界面关系使用图显示用户界面的关系通过矩形表示每个界面。
