系统平台软件架构设计文档模板

1、系统平台软件架构设计文档版本项目名称版本：软件架构设计文档日期：修订历史记录日期版本说明作者详细信息章洪岩目录 TOC o 1-5 h z HYPERLINK l bookmark47 o Current Document 简介5 HYPERLINK l bookmark51 o Current Document 目的5 HYPERLINK l bookmark55 o Current Document 范围5 HYPERLINK l bookmark59 o Current Document 定义、首字母缩写词和缩略语5 HYPERLINK l bookmark63 o Current Do

2、cument 参考资料5 HYPERLINK l bookmark67 o Current Document 概述5 HYPERLINK l bookmark71 o Current Document 整体说明5 HYPERLINK l bookmark75 o Current Document 简介5 HYPERLINK l bookmark79 o Current Document 构架表示方式5 HYPERLINK l bookmark83 o Current Document 构架目标和约束5 HYPERLINK l bookmark87 o Current Document 用例视图

3、6 HYPERLINK l bookmark91 o Current Document 核心用例6 HYPERLINK l bookmark95 o Current Document 用例实现6 HYPERLINK l bookmark99 o Current Document 逻辑视图6 HYPERLINK l bookmark103 o Current Document 逻辑视图6 HYPERLINK l bookmark107 o Current Document 分层64.2.1应用层64.2.2业务层74.2.3中间层74.2.4系统层7 HYPERLINK l bookmark11

4、1 o Current Document 架构模式7 HYPERLINK l bookmark115 o Current Document 设计机制7 HYPERLINK l bookmark119 o Current Document 公用元素及服务7 HYPERLINK l bookmark123 o Current Document 进程视图7 HYPERLINK l bookmark127 o Current Document 部署视图7 HYPERLINK l bookmark131 o Current Document 实施视图8 HYPERLINK l bookmark135 o

5、 Current Document 概述8 HYPERLINK l bookmark139 o Current Document 层8 HYPERLINK l bookmark143 o Current Document 部署8 HYPERLINK l bookmark147 o Current Document 数据视图8 HYPERLINK l bookmark151 o Current Document 大小和性能8 HYPERLINK l bookmark155 o Current Document 质量8 HYPERLINK l bookmark159 o Current Docum

6、ent 其它说明8 HYPERLINK l bookmark163 o Current Document 附录A指南8 HYPERLINK l bookmark167 o Current Document 附录B规范9 HYPERLINK l bookmark171 o Current Document 附录C模版9 HYPERLINK l bookmark175 o Current Document 附录D示例9软件架构设计文档简介软件构架文档的简介应提供整个软件构架文档的概述。它应包括此软件构架文档的目的、范围、定义、首 字母缩写词、缩略语、参考资料和概述目的本文档将从构架方面对系统进行综

7、合概述，其中会使用多种不同的构架视图来描述系统的各个方面。它用 于记录并表述已对系统的构架方面作出的重要决策本节确定此软件构架文档在整个项目文档中的作用或目的，并对此文档的结构进行简要说明。应确定此文 档的特定读者，并指出他们应该如何使用此文档范围简要说明此软件构架文档适用的范围和影响的范围定义、首字母缩写词和缩略语本小节应提供正确理解此软件构架文档所需的全部术语的定义、首字母缩写词和缩略语。这些信息可以通 过引用项目词汇表来提供参考资料本小节应完整地列出此软件构架文档中其他部分所引用的所有文档。每个文档应标有标题、报告号（如果 适用）、日期和出版单位。列出可从中获取这些参考资料的来源。这些信

8、息可以通过引用附录或其他文档 来提供概述本小节应说明此软件构架文档中其他部分所包含的内容，并解释此软件构架文档的组织方式整体说明简介在此简单介绍软件架构的整体情况，包括用例视图、逻辑视图、进程视图、实施视图和部署视图的简单介 绍。另外，简要介绍各种视图的作用和针对的用户构架表示方式本节说明当前系统所使用的软件构架及其表示方式。还会从用例视图、逻辑视图、进程视图、部署视图和 实施视图中列出必需的那些视图，并分别说明这些视图包含哪些类型的模型元素构架目标和约束本节说明对构架具有某种重要影响的软件需求和目标，例如：安全性、保密性、市售产品的使用、可移植 性、分销和重复使用。还应记录可能适用的特殊约束

9、：设计与实施策略、开发工具、团队结构、时间表、 遗留代码等用例视图本节列出用例模型中的一些用例或场景，这些用例或场景应体现最终系统中重要的、核心的功能；或是在 构架方面涉及范围很广（使用了许多构架元素）；或强调或阐明了构架的某一具体的细微之处在此可以直接引用需求中的相关文档，比如ROSE模型；用例描述等对于本系统和其它系统的关系，在用例图上可以清楚的看到，因为其它系统在用例图上被表示为主角根据项目的实际情况，此节可以省略不写核心用例在此引用ROSE模型中的用例图即可用例实现本节通过几个精选的用例（场景）实现来阐述软件的实际工作方式，并解释不同的设计模型元素如何促成 其功能的实现逻辑视图逻辑视图

10、在此用图形的方式显示此软件架构的分层、子系统、包之间的关系，并且加入必要的文字说明，特别是架 构的分层、机制和模式的说明在此，还需要将和本系统有接口关系的其它系统都表示出来，这样可以清楚的看到本系统和其它系统的接 口逻辑视图，并且还需要将在本系统中负责接口的子系统表示出来分层在此说明逻辑分层的每一层和每一层中的包、子系统。对于每个重要的包，都用一个小节来加以说明，其 中应包括该包的名称、简要说明以及显示该包中所有重要的类和包的图。对于该包中的每个重要类，应包括其名称、简要说明，还可选择包括对其部分主要职责、操作和属性的说 明下面预先设置应用层、业务层、中间层和系统层，实际使用中可以根据需要进行

11、修改4.2.1应用层在此说明软件架构子系统的高层组织，是系统面向外部（主角）、面向功能（用例）的子系统。在这一层 中的子系统，要根据中间层的约定继续分区（tier）4.2.2业务层在此说明软件架构子系统的高层组织，是应用层子系统公用的、为应用层子系统提供服务的、和业务相关 的子系统。在这一层中的子系统，要根据中间层的约定继续分区4.2.3中间层在此说明软件架构子系统的底层组织，是面向系统内部（技术）、面向非功能（补充规约）的子系统（框 架、包、机制、模式）。在这一层的子系统，通常包括分区、支持分区的框架、架构模式、设计机制（事 务、存储等）、公用元素及服务（邮件、翻页、列表控件、树控件、按钮控

12、件等）等4.2.4系统层在此说明软件架构的操作系统、运行平台（应用服务器、数据库等）、开发语言、第三方技术（比如GIS、 CORBA、 J2EE、 COM. .net）等架构模式在此说明软件架构采用的核心模式，此模式形成整个软件架构的骨架，在此以一次交互为主来表达设计机制在此说明软件架构各相关设计机制的处理方案，包括2个部分，一是全局的设计机制，包括事务的处理、 持续性的处理等；二是特殊、局部的设计机制，包括权限管理、OID生成、连接池，JSP2SB等，初始化操 作、功能表等公用元素及服务在此说明软件架构通用的设计元素及提供的和相关服务进程视图本节说明将系统分解为轻量级进程（单个控制线程）和重

13、量级进程（成组的轻量级进程）的情况。本节的 内容按照各个通信或交互的进程组来进行组织。说明进程之间的主要通信模式，例如消息传递、中断和会 合根据项目的实际情况，此节可以省略不写部署视图本节说明用来部署和运行该软件的一种或多种物理网络（硬件）配置。对于每种配置，它至少应该指出执 行该软件的物理节点（计算机、CPU）及其互连情况（总线连接、LAN连接、点到点连接等）在此还需要包括在安装部署时要注意的特殊问题，可能还有和安装部署有关的设计内容 在此还需要表示本系统和其它系统的在部署上的关系，比如本系统部署的物理节点和其它系统部署的物理 节点之间的连接等实施视图本节说明实施模型的整体结构、软件分解为实

14、施模型中的层和子系统的情况，以及所有在构架方面具有重 要意义的构件概述本小节指定并定义各个层及其内容、添加到指定层时要遵循的规则以及各层之间的边界。还应包括一个显 示层间关系的构件图如果使用JAVA做为实施语言，要求明确指定各层各子系统的包前缀层对于每个层，都用一个小节来加以说明，其中包括该层的名称和一个构件图，并列举位于该层的子系统如果使用JAVA做为实施语言，要求明确指定各子系统内分区的包前缀部署在此说明各个部署单元、每个部署单元的实施元素。在J2EE中，即表示要将应用打成多少个包，每个包的 名称以及每个包包含的源文件数据视图从永久性数据存储方面来对系统进行说明。如果几乎或根本没有永久性数据，或者设计模型与数据模型之 间的转换并不重要，那么本节就为可选根据项目的实际情况，此节可以省略不写大小和性能说明软件中会对构架产生影响的主要尺寸特征，以及目标性能约束质量说明软件构架如何促成诸如可扩展性、可靠性、可移植性等所有系统能力（而非功能）的实现。如果这些 特征具有特殊的意义（例如在安全性或保密性方面的意义），则应该对它们进行详细的说明其它说明在