详细设计文档 (含系统说明书,源代码说明书)

合集下载

详细设计说明书

详细设计说明书

详细设计说明书1.导言(Introduction)本章对该文档的目的、功能范围、术语、相关文档、参考资料、版本更新进行说明。

1.1 目的(Purpose)本文档的目旨在推动软件工程的规范化,使设计人员遵循统一的详细设计书写规范,节省制作文档的时间,降低系统实现的风险,做到系统设计资料的规范性与全面性,以利于系统的实现、测试、维护、版本升级等。

详细设计的详细程度,应达到可以编写程序的程度。

1.2 范围(Scope)本文档用于软件设计阶段的详细设计,它的上游(依据的基线)是《概要设计说明书》,它的下游是源程序清单及单元测试计划,并为单元测试报告提供测试依据。

该范围应覆盖《概要设计说明书》中的功能点列表、性能点列表、接口列表。

软件详细设计的范围是:各子系统的公用模块实现设计、专用模块实现设计、存储过程实现设计、触发器实现设计、外部接口实现设计、部门角色授权设计、其他详细设计等。

按照3层结构(B/A/S)的布局,详细设计应从下面3个方面进行。

数据库服务器上的面向数据的设计:数据字典物理设计、基本表物理设计、中间表物理设计(报表设计)、临时表物理设计、视图物理设计、存储过程物理设计、触发器物理设计。

应用服务器上的面向业务逻辑的设计:接口数据设计、中间件设计、数据通信传输设计、可视构件设计、非可视构件设计、角色授权设计、功能点设计(功能点列表设计)。

浏览器上的面向对象的设计:录入修改界面设计、浏览查询界面设计、登录注册界面设计、信息发布界面设计。

1.3 术语定义(Terms Glossary)术语定义,如表6-16所示。

表6-16 术语定义1.4 参考资料(References)[1] 《概要设计说明书》[2] 《需求分析说明书》[3] 《软件合同》[4] 命名规范[5] 程序设计规范[6] 界面设计规范1.5 相关文档(Related Documents)[1] 源程序清单[2] 单元测试计划及报告[3] 《用户使用手册》1.6 版本更新记录(V ersion Updated Rcord)版本更新记录,如表6-17所示。

源代码说明文档模板

源代码说明文档模板

源代‎码说‎明文‎档模‎板‎篇‎一:‎程‎序代‎码文‎档模‎板‎代码‎文档‎模板‎整‎体的‎概述‎:‎系统‎运行‎要求‎主‎要功‎能介‎绍.‎数‎据库‎部分‎:‎程序‎代码‎部分‎:‎程序‎入口‎程‎序到‎配置‎清单‎程‎序的‎依赖‎环境‎详情‎程‎序的‎启动‎方式‎程‎序的‎注意‎事项‎数‎据库‎地址‎:‎数据‎库涉‎及到‎的库‎数‎据库‎设计‎到的‎表‎所有‎表字‎段的‎诠释‎所‎有表‎的示‎例数‎据篇‎二:‎代‎码说‎明书‎系‎统编‎码规‎范‎1‎.‎目的‎为‎了统‎一开‎发过‎程中‎关于‎代码‎编写‎时的‎编写‎规范‎和具‎体开‎发工‎作时‎的编‎程规‎范,‎保证‎代码‎的一‎致性‎,便‎于交‎流和‎维护‎,特‎制定‎此规‎范。

‎‎2.‎适‎用范‎围‎本规‎范适‎用于‎开发‎组全‎体人‎员,‎为详‎细设‎计,‎代码‎编写‎和代‎码审‎核提‎供参‎考和‎依据‎。

‎3‎.‎代码‎格式‎在‎编写‎代码‎过程‎中,‎建议‎遵循‎以下‎规则‎。

‎(‎1)‎缩进‎规‎则:‎使‎用四‎个空‎格作‎为每‎层次‎代码‎的缩‎进值‎。

‎(‎2)‎在括‎号对‎对齐‎的位‎置垂‎直对‎齐左‎右括‎号,‎如:‎F‎o r‎(i‎=0‎;i‎++‎)‎{‎….‎}‎‎(3‎)沿‎逻辑‎结构‎行缩‎进代‎码,‎如:‎I‎f…‎t h‎e n‎I‎f…‎t h‎e n‎…‎E‎l s‎e‎…‎E n‎d‎i f‎E‎l s‎e‎…‎E n‎d‎i f‎‎(4‎)为‎了防‎止在‎阅读‎代码‎时左‎右滚‎动代‎码编‎辑器‎,每‎行代‎码或‎注释‎不得‎超过‎一个‎显示‎屏。

‎‎(5‎)当‎一行‎分别‎为几‎行时‎,通‎过将‎串联‎运算‎符放‎在每‎行的‎末尾‎而不‎是开‎头,‎清楚‎地表‎示没‎有后‎面的‎行是‎不完‎整的‎。

‎(‎6)‎C a‎s e‎规‎则:‎d‎e f‎a u‎l t‎c‎a s‎e‎总应‎该存‎在,‎如果‎不允‎许到‎达,‎则应‎该保‎证:‎若‎到达‎了就‎会触‎发一‎个错‎误。

软件开发文档说明(又全又详细)

软件开发文档说明(又全又详细)

软件开发文档说明(又全又详细)-CAL-FENGHAI.-(YICAI)-Company One1在软件行业有一句话:一个软件能否顺利的完成并且功能是否完善,重要是看这个软件有多少文档,软件开发文档是一个软件的支柱,如果你的开发文档漏洞百出,那么你所开发出来的软件也不可能会好;开发文档的好坏可以直接影响到所开发出来软件的成功与否。

一、软件开发设计文档:软件开发文档包括软件需求说明书、数据要求说有书、概要设计说明书、详细设计说明书。

1.软件需求说明书:也称为软件规格说明。

该说明书对所开发软件的功能、性能、用户界面及运行环境等做出详细的说明。

它是用户与开发人员双方对软件需求取得共同理解基础上达成的协议,也是实施开发工作的基础。

软件需求说明书的编制目的的就是为了使用户和软件开发者双方对该软件的初始规定有一个共同的理解、并使之面成为整个开发工作的基础。

其格式要求如下:1 引言 1.1 编写目的。

1.2 背景 1.3 定义2 任务概述 2.1 目标 2.2 用户的特点 2.3 假定和约束3 需求规定 3.1 对功能的规定 3.2 对性能的规定 3.2.1 精度 3.2.2 时间特性的需求 3.2.3 灵活性 3.3 输入输出要求 3.4 数据管理能力要求 3.5 故障处理要求 3.6 其他专门要求4 运行环境规定 4.1 设备 4.2 支持软件 4.3 接口 4.4 控制2.概要设计说明书:又称系统设计说明书,这里所说的系统是指程序系统。

编制的目的是说明对程序系统的设计考虑,包括程序系统的基本处理。

流程、程序系统的组织结构、模块划分、功能分配、接口设计。

运河行设计、数据结构设计和出错处理设计等,为程序的详细设计提供基础。

其格式要求如下:1 引言 1.1 编写目的 1.2 背景 1.3 定义 1.4 参考资料2 总体设计 2.1 需求规定 2.2 运行环境 2.3 基本设计概念和处理流程 2.4 结构 2.5 功能需求与程序的关系 2.6 人工处理过程 2.7 尚未解决的问题3 接口设计 3.1 用户接口 3.2 外部接口 3.。

系统详细设计说明书(模板)

系统详细设计说明书(模板)

XXXXXXXXXXXXXXXXXXX项目名称详细设计说明书XXX公司二〇X X年X月文档修改记录版本号示例:、、、、……目录第一章引言 (4)目的 (4)背景 (4)术语定义 (4)参考资料 (4)第二章系统概述 (6)第三章程序1设计说明 (7)程序描述 (7)模块架构图 (7)功能 (7)类图 (7)增加功能(功能点) (8)程序流程 (9)测试和限制条件 (9)备注 (9)第四章程序2设计说明 (10)第五章公用接口程序说明 (11)全局变量 (11)公用界面或接口 (11)公用方法和过程 (11)第六章附件 (12)详细设计评审意见 (13)第一章引言1.1目的提示:简要说明编写这份详细设计说明书的目的,指出预期的读者。

本详细设计说明书的适用读者为:软件开发者、测试人员1.2背景1.3术语定义1.4参考资料提示:列出所本文档所使用的参考资料,包括:A 本软件开发所经核准的合同或标书或可行性报告等文档B 软件开发计划书C 需求分析报告D 测试方案(若存在初稿的话)E 概要设计说明书F 与本项目有关的已发表的文件或资料G 本文件中各处引用的文件、资料,所采用的软件开发标准和规范注意:必须列出文件、资料的作者、标题、编号、发表日期和出版单位,以说明这些文件资料的来源。

若某些文档有保密要求的,则要说明其保密级别。

第二章 系统概述画出系统的体系结构图,以说明系统体系结构的实现技术,所用到的数据库主体的描述、如何实现访问数据库、如何划分程序的主体部分。

可以采用MVC 模式表述、也可以采用UML 中的系统设计主要是基于MVC 设计模式,M 代表模型Model ,V 代表视图 View , C 代表控制器Controller 。

MVC 模式将系统分为三层,层与层之间通过又一定的模式联系,使数据实体与业务逻辑、业务逻辑与页面展现分离。

MVC 模式图举例如下图:图2-1 MVC 模式图第三章程序1设计说明提示:从本章开始,逐步将各模块的功能和设计思想、内容等进行逐层解剖分析3.1程序描述提示:给出对该程序的简要描述,主要说明安排设计本程序的目的意义,并且,还要说明本程序的特点。

软件详细设计文档模板(最全面)

软件详细设计文档模板(最全面)
研发生产中心
文档编号
版本
A1
密级
商密A
项目名称
Xx系统
项目来源
Xxx系统
详细设计说明书
(内部资料请勿外传)
编写:
日期:
检查:
日期:
审核:
日期:
批准:
日期:
XX公司
版权所有不得复制
文档变更记录
序号
变更(+/-)说明
作者
版本号
日期
批准
1
2
1.
1.1
此文档的背景
1.2
说明写这份详细设计说明书的目的。
本详细设计说明书编写的目的是说明程序模块的设计考虑,包括程序描述、输入/输出、算法和流程逻辑等,为软件编程和系统维护提供基础。本说明书的预期读者为系统设计人员、软件开发人员、软件测试人员和项目评审人员。
6.4.2
设计系统内部各功能模块间的调用关系和数据接口。
6.4.3
规定人机界面的内容、界面风格、调用方式等,包括所谓的表单设计、报表设计和用户需要的打印输出等设计。此部分内容可能比较多。
7.
7.1
7.2
- Development evnironment: programming lanuague, database
详细设计应用系统的各个构成模块完成的功能及其相互之间的关系,用IPO或结构图描述各模块的组成结构、算法、模块间的接口关系,以及需求、功能和模块三者之间的交叉参照关系。
每个模块的描述说明可参照以下格式:
模块编号:
模块名称:
输入:
处理:
算法描述:
输出:
其中处理和算法描述部分主要采用伪码或具体的程序语言完成。
即使IF,While是单语句,也要使用“{ }”来划分程序块。

详细设计说明书范例

详细设计说明书范例

详细设计说明书,范例篇一:[例子]详细设计说明书详细设计说明书1引言1. 1编写目的根据《需求规格说明书》、《概要设计说明书》,在仔细考虑讨论之后,我们对《图书管理系统》软件的功能划分、数据结构、软件总体结构的实现有了进一步的想法。

我们将这些想法记录下来,作为详细设计说明书,为进一步设计软件、编写代码打下基础。

1.2背景随着社会信息量的与日俱增,作为信息存储的主要媒体之一图书,数量、规模比以往任何时候都大的多,不论个人还是图书管理部门都需要使用方便而有效的方式来管理自己的书籍。

在计算机日益普及的今天,对个人而言若采用一套行之有效的图书管理系统来管理自己的书籍,会方便许多。

对图书管理部门而言,以前单一的手工检索已不能满足人们的要求,为了便于图书资料的管理需要有效的图书管理软件。

本图书管理系统软件是一套功能比较完善的数据管理软件,具有数据操作方便高效迅速等优点。

该软件采用功能强大的数据库软件开发工具进行开发,具有很好的可移植性,可在应用范围较广的DOS、WINDOWS系列等操作系统上使用1.3定义文档中采用的专门术语的定义及缩略词简要如下:LMS:Library Management System,图书管理系统1.4参考资料[1]费贤举关于图书管理系统的批文 [2]郑人杰,殷人昆,陶永雷。

《实用软件工程》(第二版)。

北京:清华大学出版社,1997。

[3]王立福,麻志毅。

《软件工程》(第二版)。

北京:北京大学出版社,XX。

[4]唐学忠,王文。

《Visual Basic 程序设计教程》北京:中国电力出版社,XX。

2程序系统的结构3程序(标识符)设计说明3.1主模块 ? 功能建立与数据库连接获取系统设置运行主对话框根据输入调用子模块退出系统时断开与数据库的连接? 输入项目用户鼠标点击输入? 程序逻辑见右图? 存储分配内部数据:数据库连接m_pConnection _ConnectionPtr 数据库连接指针 m_IsConnected BOOL 数据库连接指示系统设置 m_MaxLBNum int 可借图书数上限m_MaxLBDay int 借书天数上限子对话框m_BookOutDlg CBookOutDlg 借书对话框 m_BookInDlg CBookInDlg 还书对话框 m_BookQuiryDlg CBookQuiryDlg 图书查询对话框 m_SysDlgCSysDlg系统操作对话框 ? 测试要点数据库连接情况:正常情况,数据库文件缺少,外部系统异常。

软件开发资料文档说明(完整编辑经过流程)

软件开发资料文档说明(完整编辑经过流程)

在软件行业有一句话:一个软件能否顺利的完成并且功能是否完善,重要是看这个软件有多少文档,软件开发文档是一个软件的支柱,如果你的开发文档漏洞百出,那么你所开发出来的软件也不可能会好;开发文档的好坏可以直接影响到所开发出来软件的成功与否。

一、软件开发设计文档:软件开发文档包括软件需求说明书、数据要求说有书、概要设计说明书、详细设计说明书。

1、软件需求说明书:也称为软件规格说明。

该说明书对所开发软件的功能、性能、用户界面及运行环境等做出详细的说明。

它是用户与开发人员双方对软件需求取得共同理解基础上达成的协议,也是实施开发工作的基础。

软件需求说明书的编制目的的就是为了使用户和软件开发者双方对该软件的初始规定有一个共同的理解、并使之面成为整个开发工作的基础。

其格式要求如下:1 引言1.1 编写目的。

1.2 背景1.3 定义2 任务概述2.1 目标2.2 用户的特点2.3 假定和约束3 需求规定3.1 对功能的规定3.2 对性能的规定3.2.1 精度3.2.2 时间特性的需求3.2.3 灵活性3.3 输入输出要求3.4 数据管理能力要求3.5 故障处理要求3.6 其他专门要求4 运行环境规定4.1 设备4.2 支持软件4.3 接口4.4 控制2、概要设计说明书:又称系统设计说明书,这里所说的系统是指程序系统。

编制的目的是说明对程序系统的设计考虑,包括程序系统的基本处理。

流程、程序系统的组织结构、模块划分、功能分配、接口设计。

运河行设计、数据结构设计和出错处理设计等,为程序的详细设计提供基础。

其格式要求如下:1 引言1.1 编写目的1.2 背景1.3 定义1.4 参考资料2 总体设计2.1 需求规定2.2 运行环境2.3 基本设计概念和处理流程2.4 结构2.5 功能需求与程序的关系2.6 人工处理过程2.7 尚未解决的问题3 接口设计3.1 用户接口3.2 外部接口3.。

3 内部接口4 运行设计4.1 运行模块的组合4.2 运行控制4.3 运行时间5 系统数据结构设计5.1 逻辑结构设计要点5.2 物理结构设计要求5.3 数据结构与程序的关系6 系统出错处理设计6.1 出错信息6.2 补救措施6.3 系统维护设计。

软件开发文档说明(完整流程)

软件开发文档说明(完整流程)

软件开发文档说明(完整流程)在软件行业有一句话:一个软件能否顺利的完成并且功能是否完善,重要是看这个软件有多少文档,软件开发文档是一个软件的支柱,如果你的开发文档漏洞百出,那么你所开发出来的软件也不可能会好;开发文档的好坏可以直接影响到所开发出来软件的成功与否。

一、软件开发设计文档:软件开发文档包括软件需求说明书、数据要求说有书、概要设计说明书、详细设计说明书。

1、软件需求说明书:也称为软件规格说明。

该说明书对所开发软件的功能、性能、用户界面及运行环境等做出详细的说明。

它是用户与开发人员双方对软件需求取得共同理解基础上达成的协议,也是实施开发工作的基础。

软件需求说明书的编制目的的就是为了使用户和软件开发者双方对该软件的初始规定有一个共同的理解、并使之面成为整个开发工作的基础。

其格式要求如下:1引言1.1编写目的。

1.2背景1.3定义2任务概述2.1目标2.2用户的特点2.3假定和束缚3需求规定3.1对功能的规定3.2对性能的规定3.2.1精度3.2.2时间特性的需求3.2.3灵活性3.3输入输出要求3.4数据管理能力要求3.5故障处理要求3.6其他专门要求4运转环境规定4.1设备4.2支持软件4.3接口4.4掌握2、提要设计说明书:又称系统设计说明书,这里所说的系统是指程序系统。

编制的目的是说明对程序系统的设计考虑,包孕程序系统的根本处理。

流程、程序系统的组织布局、模块划分、功能分配、接口设计。

运河行设计、数据布局设计和出错处理设计等,为程序的具体设计提供基础。

其格式要求如下:1引言1.1编写目的1.2背景1.3定义1.4参考资料2总体设计2.1需求规定2.2运行环境2.3基本设计概念和处理流程2.4结构2.5功能需求与程序的关系2.6人工处理进程2.7尚未解决的问题3接口设计3.1用户接口3.2外部接口3.。

3内部接口4运行设计4.1运行模块的组合4.2运行控制4.3运转时间5系统数据布局设计5.1逻辑结构设计要点5.2物理结构设计要求5.3数据结构与程序的关系6系统出错处理设计6.1出错信息6.2补救措施6.3系统维护设计。

软件详细设计文档模板(最全面)-详细设计文档[2]

软件详细设计文档模板(最全面)-详细设计文档[2]

软件详细设计文档模板(最全面)-详细设计文档1. 引言1.1 编写目的1.2 项目背景1.3 参考资料2. 总体设计2.1 需求概述本节概述软件系统的功能需求,详细需求请参见《软件需求规格说明书》。

(在此列出软件系统的主要功能需求,可以使用列表或者表格的形式)2.2 系统架构本节描述软件系统的总体架构设计,包括系统的层次结构、组成部份、运行环境等。

(在此使用图文结合的方式展示系统的架构图,并对各个部份进行简要说明)2.3 设计约束本节描述软件系统在设计过程中需要遵守的约束条件,包括技术约束、性能约束、安全约束等。

(在此列出软件系统的设计约束条件,并对其原因和影响进行说明)3. 模块设计本章描述软件系统各个模块的详细设计,包括模块功能、模块结构、模块接口、模块数据流等。

3.1 模块一3.1.1 模块功能本节描述模块一的功能需求,包括功能目标、功能输入、功能输出、功能处理等。

(在此使用图文结合的方式展示模块一的功能图,并对各个功能进行说明)3.1.2 模块结构本节描述模块一的内部结构,包括子模块划分、类图设计、状态图设计等。

(在此使用图文结合的方式展示模块一的结构图,并对各个子模块或者类进行说明)3.1.3 模块接口本节描述模块一与其他模块之间的接口定义,包括接口名称、接口参数、接口返回值、接口异常处理等。

(在此使用表格或者代码段的形式展示模块一的接口定义,并对各个接口进行说明)3.1.4 模块数据流本节描述模块一内部或者外部的数据流程,包括数据来源、数据目标、数据转换、数据存储等。

(在此使用图文结合的方式展示模块一的数据流图,并对各个数据流进行说明)3.2 模块二(按照上述格式挨次描述其他模块)4. 算法设计本章描述软件系统中涉及到的重要或者复杂的算法设计,包括算法原理、算法流程、算法伪代码、算法分析等。

4.1 算法一4.1.1 算法原理本节描述算法一的原理,包括算法目的、算法思想、算法依据等。

(在此使用文字或者公式的形式展示算法一的原理,并对其进行说明)4.1.2 算法流程本节描述算法一的流程,包括算法输入、算法输出、算法步骤等。

详细设计文档 (含系统说明书,源代码说明书)

详细设计文档 (含系统说明书,源代码说明书)

东北师范大学外语培训机构数据库详细设计文档雷蕾张丽云丁鼎孔祥楠2009-11-1目录第一章引言 (1)1.1项目说明 (1)1.2文档目的 (1)1.3参考资料 (1)第二章设计流程图 (3)2.1注册功能流程图 (3)2.2用户登录功能流程图 (4)2.3搜索课程功能流程图 (5)2.3前台用户下载资料或留言功能流程图 (5)2.3后台管理员功能流程图 (6)第三章类规格说明 (7)2.1模块类图 (7)3.2 jsp页面说明 (8)3.3类说明 (10)第四章程序设计说明 (15)第一章引言1.1项目说明1、在互联网络高速发展的今天,网站是企业在因特网上全面介绍公司信息的一个发布平台:可以把任何想让人们知道的东西放入网站,如公司简介、公司的厂房、生产设施、研究机构、产品的外观、功能及其使用方法等,都可以展示于网上。

2、网站树立培训机构形象,让别人看到自己,展示培训机构的实力。

培训机构就能够在国内和世界"亮相",无疑是一种宣传机构、产品和服务的机会。

从广告意义上看,培训机构网站事关机构形象建设,没有网站也谈不上机构形象。

3、主动抢占先机,培训机构建设自己的网站,这是时代发展的必然,任何一家培训机构要想跟上时代发展的潮流,必须要有展示自己的一个信息平台。

为了不被竞争对手建立网站抢占先机,为了不落后于时代潮流,应该考虑建站的必要性。

4、可以扩大业务范围,可以与潜在客户建立商业联系:这是该网址最重要的功能之一,也是为什么那么多的国外企业非常重视网站建设的根本原因。

现在,世界各国大的采购商主要都是利用互联网络来寻找新的产品和新的供应商,因为这样做费用最低,效率最高。

原则上,全世界任何地方的人,只要知道了公司的网址,就可以看到公司的产品。

因此,关键在于如何将公司网址推介出去。

一种非常实用而有效的方法是将公司的网址登记在全球著名的搜索引擎(如Google,百度,雅虎等)上,并选择与公司的产品及服务有关的关键字,则可以使潜在的客户能够容易地找到公司和产品。

系统详细设计说明书

系统详细设计说明书

系统详细设计说明书文件编码(008-TTIG-UTITD-GKBTT-PUUTI-WYTUI-8256)XXXXXX XXXXXXXXXXXXX项目名称详细设计说明书XXX公司二〇X X年X月目录第一章引言1.1目的提示:简要说明编写这份详细设计说明书的目的,指出预期的读者。

本详细设计说明书的适用读者为:软件开发者、测试人员1.2背景1.3术语定义参考资料提示:列出所本文档所使用的参考资料,包括:A 本软件开发所经核准的合同或标书或可行性报告等文档B 软件开发计划书C 需求分析报告D 测试方案(若存在初稿的话)E 概要设计说明书F 与本项目有关的已发表的文件或资料G 本文件中各处引用的文件、资料,所采用的软件开发标准和规范注意:必须列出文件、资料的作者、标题、编号、发表日期和出版单位,以第二章 系统概述画出系统的体系结构图,以说明系统体系结构的实现技术,所用到的数据库主体的描述、如何实现访问数据库、如何划分程序的主体部分。

可以采用MVC 模式表述、也可以采用UML 中的系统设计主要是基于MVC 设计模式,M 代表模型Model ,V 代表视图 View , C 代表控制器Controller 。

MVC 模式将系统分为三层,层与层之间通过又一定的模式联系,使数据实体与业务逻辑、业务逻辑与页面展现分离。

MVC 模式图举例如下图:图2-1 MVC 模式图第三章程序1设计说明提示:从本章开始,逐步将各模块的功能和设计思想、内容等进行逐层解剖分析3.1程序描述提示:给出对该程序的简要描述,主要说明安排设计本程序的目的意义,并且,还要说明本程序的特点。

3.1.1模块架构图提示:给出模块的代码结构,如典型的三层结构,可以用UML的组件图表达。

3.1.2功能提示:简要进行功能描述,可采用IPO(即输入-处理-输出图)表示。

3.1.3类图提示:用UML类图利用面向对象思想设计模块代码实现,用类图表达出完整的类结构,包括类名,属性,主要方法名称,方法参数,关键的方法或算法可以用标注的方法,用伪码表达出来。

软件详细设计文档模板(最全面)-详细设计文档

软件详细设计文档模板(最全面)-详细设计文档

Xxx系统详细设计说明书(内部资料请勿外传)编写:日期:检查:日期:审核:日期:批准:日期:XX公司版权所有不得复制文档变动记录目录1. 引言41.1 编写目的和范围41.2 术语表41.3 参考资料41.4 使用的文字处置和绘图工具42. 全局数据结构说明52.1 常量52.2 变量52.3 数据结构53. 模块设计53.1 用例图53.2 功能设计说明53.2.1 模块153.2.2 模块264. 接口设计74.1 内部接口74.2 外部接口74.2.1 接口说明74.2.2 调用方式85. 数据库设计86. 系统平安保密设计86.1 说明86.2 设计86.2.1 数据传输部份86.2.2 IP过滤分部86.2.3 身份验证部份87. 系统性能设计98. 系统犯错处置91.引言1.1布景此文档的布景1.2编写目的和范围说明写这份详细设计说明书的目的.本详细设计说明书编写的目的是说明法式模块的设计考虑,包括法式描述、输入/输出、算法和流程逻辑等,为软件编程和系统维护提供基础.本说明书的预期读者为系统设计人员、软件开发人员、软件测试人员和项目评审人员.1.3术语表界说系统或产物中涉及的重要术语,为读者在阅读文档时提供需要的参考信息.1.4参考资料列出有关资料的名称、作者、文件编号或版本等.参考资料包括:a.需求说明书、架构设计说明书等;b.本项目的其他已发表的文件;c.引用文件、资料、软件开发标准等.1.5使用的文字处置和绘图工具文字处置软件:[编写设计文档使用的文字处置软件,如RedOffice ]绘图工具:[使用的UML工具,如Rose、Jude、Visio]2.设计概述2.1任务和目标2.1.1需求概述2.1.2运行环境概述2.1.3条件与限制2.1.4详细设计方法和工具3.系统详细需求分析主要对系统级的需求进行分析.首先应对需求分析提出的企业需求进一步确认,并对由于情况变动而带来的需求变动进行较为详细的分析.3.1详细需求分析3.1.1详细功能需求分析3.1.2详细性能需求分析3.1.3详细资源需求分析3.1.4详细接口需求分析3.1.5详细系统运行环境及限制条件分析4.总体方案确认着重解决系统总体结构确认及界面划分问题.4.1系统总体结构确认对系统组成、逻辑结构及条理进行确认,对应用系统、支撑系统及各自实现的功能进行确认,细化集成设计及系统工作流程,特别要注意因软件的引进造成的系统自己结构和公司其他系统的结构变动.包括:4.1.1系统组成、逻辑结构及条理确认4.1.2应用系统结构确认4.1.3支撑系统结构确认4.1.4系统集成确认4.1.5系统工作流程确认4.2系统详细界面划分4.2.1应用系统与支撑系统的详细界面划分应用系统与支撑系统之间的界面包括系统主服务器与其他服务器的服务范围及访问方式,网络及数据库对应用系统的支撑方式,全局数据的管理与存取方式等.4.2.2系统内部详细界面划分系统各功能之间的界面包括覆盖范围,模块间功能调用涉及到的系统模块及方法,全局数据格式,系统性能要求等.5.全局数据结构说明本章说明本法式系统中使用的全局数据常量、变量和数据结构.5.1常量包括数据文件名称及其所在目录,功能说明,具体常量说明等.5.2变量本章说明本法式系统中使用的全局数据常量、变量和数据结构.5.3数据结构包括数据结构名称,功能说明,具体数据结构说明(界说、注释、取值)等.6.系统详细设计6.1功能结构图6.2系统结构设计及子系统划分对系统的组成及逻辑结构进行设计前确认.划分系统功能模块或子系统(如果有或者有需要,特别是年夜型的软件系统).6.3系统功能模块详细设计按结构化设计方法,在系统功能逐层分解的基础上,对系统各功能模块或子系统进行设计.此为详细设计的主要部份之一.用条理图描述系统的总体结构、功能分解及各个模块之间的相互调用关系和信息交互,用IPO图或其他方法描述各模块完成的功能.以上建议采纳HIPO图进行功能分解与模块描述,更高的要求建议采纳IDEF0方法进行功能模型设计.详细设计应用系统的各个构成模块完成的功能及其相互之间的关系,用IPO或结构图描述各模块的组成结构、算法、模块间的接口关系,以及需求、功能和模块三者之间的交叉参照关系.每个模块的描述说明可参照以下格式:模块编号:模块名称:输入:处置:算法描述:输出:其中处置和算法描述部份主要采纳伪码或具体的法式语言完成.对详细设计更高的要求建议用IDEF0图进行各功能模块的设计.如果对软件需进行二次开发(包括功能扩展、功能改造、用户界面改造等),则相应的设计工作应该设立子课题完成.6.4系统界面详细设计系统界面说明应用系统软件的各种接口.整个系统的其他接口(如系统硬件接口、通讯接口等)在相应的部份说明.6.4.1外部界面设计根据系统界面划分进行系统外部界面设计,对系统的所有外部接口(包括功能和数据接口)进行设计.6.4.2内部界面设计设计系统内部各功能模块间的调用关系和数据接口.6.4.3用户界面设计规定人机界面的内容、界面风格、调用方式等,包括所谓的表单设计、报表设计和用户需要的打印输出等设计.此部份内容可能比力多.7.开发和测试生产环境说明7.1开发环境7.2测试及产物环境- Development evnironment: programming lanuague, databaseWindwos 2003, iis 6.0, MySQL,8.模块设计8.1用例图8.2功能设计说明8.2.1模块1模块1主要分为以下几个子模块:子模块1、子模块2和子模块N.8.2.1.1 子模块18.2.1.1.1 设计图8.2.1.1.2 功能描述简要描述子模块1的业务功能.8.2.1.1.3 输入数据详细描述用户输入的数据(包括任何输入设备)以及这些数据的有效性检验规则.详细描述从物理模型中的哪些表获取数据以及获取这些数据的条件.8.2.1.1.4 输出数据详细描述子功能1所发生的数据以及这些数据的暗示形式. 8.2.1.1.5 业务算法和流程从业务角度详细描述根据输入数据发生输出数据的业务算法和流程.8.2.1.1.6 数据设计给出本法式中的局部数据结构说明,包括数据结构名称,功能说明,具体数据结构说明(界说、注释设计、取值)等.相关数据库表,数据存储设计(具体说明需要以文件方式保管的数据文件名、数据存储格式、数据项及属性等.)8.2.1.1.7 源法式文件说明给出本法式的各源法式文件的说明,包括源法式文件名称及其所在目录,功能说明,包括的前导文件及函数名称等.8.2.1.1.8 函数说明具体说明本法式中的各个函数,包括函数名称及其所在文件,功能,格式,参数,全局变量,局部变量,返回值,算法说明,使用约束等.8.2.1.1.9 限制条件8.2.1.1.10 其他说明8.2.2模块2模块1主要分为以下几个子模块:子模块1、子模块2和子模块N.8.2.2.1 子模块18.2.2.1.1 设计图8.2.2.1.2 功能描述简要描述子模块1的业务功能.8.2.2.1.3 输入数据详细描述用户输入的数据(包括任何输入设备)以及这些数据的有效性检验规则.详细描述从物理模型中的哪些表获取数据以及获取这些数据的条件.8.2.2.1.4 输出数据详细描述子功能1所发生的数据以及这些数据的暗示形式.8.2.2.1.5 业务算法和流程从业务角度详细描述根据输入数据发生输出数据的业务算法和流程.8.2.2.1.6 数据设计给出本法式中的局部数据结构说明,包括数据结构名称,功能说明,具体数据结构说明(界说、注释设计、取值)等.相关数据库表,数据存储设计(具体说明需要以文件方式保管的数据文件名、数据存储格式、数据项及属性等.)8.2.2.1.7 源法式文件说明给出本法式的各源法式文件的说明,包括源法式文件名称及其所在目录,功能说明,包括的前导文件及函数名称等.8.2.2.1.8 函数说明具体说明本法式中的各个函数,包括函数名称及其所在文件,功能,格式,参数,全局变量,局部变量,返回值,算法说明,使用约束等.8.2.2.1.9 限制条件8.2.2.1.10 其他说明9.接口设计9.1内部接口9.2外部接口9.2.1接口说明例如:xx子系统通过xx从xx子系统取得xx等,相关标准,调用示例,可根据需要增加章节描述接口.9.2.2调用方式例如:内部接口调用:例:/***通过用户服务号码取得该客户认证密码等信息,如果该客户存在返回为0,其他情况参考毛病编码*/public RUserInfo getUserInfo (String userNo);10.数据库设计详见[xxx数据库设计说明书]如果数据库设计内容比力少,则直接在此处描述.11.系统平安保密设计11.1说明例如:由于存在与外部系统的接口,所以需要考虑访问平安的问题.11.2设计例如:分为数据传输部份,IP过滤部份,身份验证部份.[章节可弥补]11.2.1数据传输部份例如:在部份数据传递的时候,考虑以https协议,需要在布置的时候作相关处置.11.2.2IP过滤分部例如:可在系统前端通过Filter实现,该Filter实现对该地址访问的IP过滤作用.可信任IP地址通过xml文件进行配置. 11.2.3身份验证部份例如:对信任的用户,公布身份验证码,通过该标识进行身份识别.12.系统性能设计13.系统犯错处置例如:为了在系统呈现异常情况下给用户以明确的提示,可采纳两种方式予以提示:1.使用Javascript的alert()函数直接提示,这主要在输入或修改的情况下使用;2.使用统一的毛病界面提示,该界面对应于页面.毛病界面样式如下图所示:毛病提示界面14.设计和开发规范【可以列表方式列出设计开发的参考文档的索引,内容较少/关键内容可以章节方式填写】14.1数据库设计规范【拜会《XXXX数据库设计规范》】编码规范特别强调:✧详细请拜会《文档规范》✧这里只做简单论述,如有变动,会及时同事整个项目组相关人员.(1) 不要给类名加前缀.使用PascalCasing风格,不使用匈牙利命名法 .(2) 要用名词词组来给类型命名.使用PascalCasing风格 .(3) 类名少用缩写,不要使用下划线字符 (_).(4) 基类CBase的文件名为:FileBase.cs;(5) 泛型类命名:考虑用T来命名参数类型 ,类如:public class List<T>.(6) 接口(Interface)命名规范和类命名规范相同,唯一区别是接口在名字前加上“I”前缀.(7) 枚举命名:以复数结尾,标明这是一个枚举,例如:Enum ColorButtons(8) 结构命名:标明这是一个结构体,例如:Structure CustomerInfoRecord '以Record结尾✧除使用工具直接生成的类外,其它所有类的功能要有注释,即使只是一个数据对象;非罕见功能的API必需要有功能描述的注释.自力的要被应用其他功能所调用的模块的接口和公共API的注释要完备,即包括功能说明、参数和返回值说明.其它情况的API的注释尽量完备,但不强制要求.✧一次性的流翻开后必需关闭和释放.一般地,在流翻开后,都有一个try catch语句,务必加上finally块释放流资源.✧即使IF,While是单语句,也要使用“{ }”来划分法式块.✧不要有完全为调试使用的日志信息,如(“1”);如要使用,在调试完成后请及时删除.✧一些知识性代码,不需要写没需要的注释.✧不要用工具生成没用的注释.14.3代码目录结构系统架构目录结构设计图,如下:结构说明:。

详细设计说明书模板

详细设计说明书模板

<项目名称> 详细设计说明书目录1前言 (1)1.1目的 (1)1.2适用范围 (1)1.3读者对象 (1)2模块汇总 (1)3模块详细设计 (1)3.1接口与属性设计 (1)3.1.1外部接口n实现设计 (1)3.2数据结构与算法设计 (2)4功能模块实现设计 (2)4.1公用模块实现设计 (2)4.2专用模块实现设计 (3)4.3存储过程实现设计 (4)4.4触发器实现设计 (4)5其他实现设计 (5)6程序文件清单 (5)7附录 (5)7.1引用文档/参考资料 (5)7.2术语表 (5)1前言【逐项描述每个软件模块的详细设计内容。

如果设计的部分或全部依赖于系统状态或方式,则应指出这种依赖性。

如果该设计信息在多条中出现,则可只描述一次,而在其他条引用。

应给出或引用为理解这些设计所需的设计约定。

系统的接口特性可在此处描述,也可在《接口设计书》中描述。

数据库设计或用于操作/访问数据库的设计,可在此处描述,也可在《数据库结构设计》中描述。

用户界面相关的设计,可在此处描述,也可在《用户界面设计》中描述。

】1.1目的【描述编写此文档的目的与目标。

】1.2适用范围【描述此文档的适用范围。

】1.3读者对象【描述此文档的预期读者。

】2模块汇总【简单描述系统的各个模块。

】3模块详细设计3.1接口与属性设计【系统的接口特性可在此处描述,也可在《接口设计书》中描述。

】3.1.1外部接口n实现设计【描述每个模块的主要接口与属性。

如果采用面向对象方法,相当于设计类的函数和成员变量。

】(1)接口中文名称:(2)接口英文名称:(3)接口内容与功能:详细描述接口的内容与功能,如实现数据传输或数据交换。

(4)接口硬件设施:详细描述接口的硬件设施,如交换机、传感器或输出设备。

(5)接口软件或中间件:详细描述接口软件或中间件的名称、功能、使用方法、生产厂商。

(6)接口的数据结构:详细描述接口的数据结构,如文件结构、数据库表结构。

软件详细设计文档模板(最全面)-详细设计文档

软件详细设计文档模板(最全面)-详细设计文档

软件详细设计文档模板(最全面)-详细设计文档1. 引言1.1 编写目的1.2 项目背景1.3 参考资料[软件需求规格说明书][软件编码规范]2. 总体设计2.1 软件结构图本节给出软件系统的总体结构图,说明软件系统由哪些模块组成,以及模块之间的关系和接口。

(插入软件结构图)2.2 模块划分本节对软件系统的各个模块进行划分和描述,说明每一个模块的功能、输入、输出、处理流程等。

2.2.1 模块名功能描述:简要说明该模块的主要功能和作用。

输入:说明该模块的输入数据或者信号,包括数据或者信号的来源、格式、内容等。

输出:说明该模块的输出数据或者信号,包括数据或者信号的目标、格式、内容等。

处理流程:说明该模块的处理流程或者算法,可以使用伪代码、流程图、状态图等方式进行描述。

异常处理:说明该模块在遇到异常情况时的处理方式,包括异常的类型、原因、影响、解决方法等。

3. 接口设计本节给出软件系统与外部系统或者设备之间的接口设计,包括物理接口、数据接口、控制接口等。

3.1 物理接口本节说明软件系统与外部系统或者设备之间的物理连接方式,包括连接设备、连接路线、连接端口等。

3.1.1 接口名接口功能:简要说明该接口的功能和作用。

接口设备:说明该接口所连接的外部设备的名称、型号、规格等。

接口路线:说明该接口所使用的连接路线的类型、长度、颜色等。

接口端口:说明该接口所使用的连接端口的位置、编号、类型等。

3.2 数据接口本节说明软件系统与外部系统或者设备之间的数据交换方式,包括数据格式、数据内容、数据传输协议等。

3.2.1 接口名接口功能:简要说明该接口的功能和作用。

数据格式:说明该接口所交换的数据的格式,可以使用表格、结构图等方式进行描述。

数据内容:说明该接口所交换的数据的内容,包括数据的含义、单位、范围等。

数据传输协议:说明该接口所使用的数据传输协议,包括协议名称、版本、特点等。

3.3 控制接口本节说明软件系统与外部系统或者设备之间的控制信号方式,包括控制信号的类型、含义、时序等。

系统详细设计说明书

系统详细设计说明书

系统详细设计说明书 Modified by JEEP on December 26th, 2020.XXXXXXXXXXXXXXXXXXX项目名称详细设计说明书XXX公司二〇XX年X月文档修改记录目录第一章引言1.1目的提示:简要说明编写这份详细设计说明书的目的,指出预期的读者。

本详细设计说明书的适用读者为:软件开发者、测试人员1.2背景1.3术语定义提示:列出所本文档所使用的参考资料,包括:A 本软件开发所经核准的合同或标书或可行性报告等文档B 软件开发计划书C 需求分析报告D 测试方案(若存在初稿的话)E 概要设计说明书F 与本项目有关的已发表的文件或资料G 本文件中各处引用的文件、资料,所采用的软件开发标准和规范注意:必须列出文件、资料的作者、标题、编号、发表日期和出版单位,以说明这第二章 系统概述画出系统的体系结构图,以说明系统体系结构的实现技术,所用到的数据库主体的描述、如何实现访问数据库、如何划分程序的主体部分。

可以采用MVC 模式表述、也可以采用UML 中的系统设计主要是基于MVC 设计模式,M 代表模型Model ,V 代表视图 View , C 代表控制器Controller 。

MVC 模式将系统分为三层,层与层之间通过又一定的模式联系,使数据实体与业务逻辑、业务逻辑与页面展现分离。

MVC 模式图举例如下图:图二-1 MVC 模式图第三章程序1设计说明提示:从本章开始,逐步将各模块的功能和设计思想、内容等进行逐层解剖分析3.1程序描述提示:给出对该程序的简要描述,主要说明安排设计本程序的目的意义,并且,还要说明本程序的特点。

3.1.1模块架构图提示:给出模块的代码结构,如典型的三层结构,可以用UML的组件图表达。

3.1.2功能提示:简要进行功能描述,可采用IPO(即输入-处理-输出图)表示。

3.1.3类图提示:用UML类图利用面向对象思想设计模块代码实现,用类图表达出完整的类结构,包括类名,属性,主要方法名称,方法参数,关键的方法或算法可以用标注的方法,用伪码表达出来。

  1. 1、下载文档前请自行甄别文档内容的完整性,平台不提供额外的编辑、内容补充、找答案等附加服务。
  2. 2、"仅部分预览"的文档,不可在线预览部分如存在完整性等问题,可反馈申请退款(可完整预览的文档不适用该条件!)。
  3. 3、如文档侵犯您的权益,请联系客服反馈,我们会尽快为您处理(人工客服工作时间:9:00-18:30)。

东北师范大学
外语培训机构数据库详细设计文档
雷蕾张丽云丁鼎孔祥楠
2009-11-1
目录
第一章引言 (1)
1.1项目说明 (1)
1.2文档目的 (1)
1.3参考资料 (1)
第二章设计流程图 (3)
2.1注册功能流程图 (3)
2.2用户登录功能流程图 (4)
2.3搜索课程功能流程图 (5)
2.3前台用户下载资料或留言功能流程图 (5)
2.3后台管理员功能流程图 (6)
第三章类规格说明 (7)
2.1模块类图 (7)
3.2 jsp页面说明 (8)
3.3类说明 (10)
第四章程序设计说明 (15)
第一章引言
1.1项目说明
1、在互联网络高速发展的今天,网站是企业在因特网上全面介绍公司信息的一个发布平台:可以把任何想让人们知道的东西放入网站,如公司简介、公司的厂房、生产设施、研究机构、产品的外观、功能及其使用方法等,都可以展示于网上。

2、网站树立培训机构形象,让别人看到自己,展示培训机构的实力。

培训机构就能够在国内和世界"亮相",无疑是一种宣传机构、产品和服务的机会。

从广告意义上看,培训机构网站事关机构形象建设,没有网站也谈不上机构形象。

3、主动抢占先机,培训机构建设自己的网站,这是时代发展的必然,任何一家培训机构要想跟上时代发展的潮流,必须要有展示自己的一个信息平台。

为了不被竞争对手建立网站抢占先机,为了不落后于时代潮流,应该考虑建站的必要性。

4、可以扩大业务范围,可以与潜在客户建立商业联系:这是该网址最重要的功能之一,也是为什么那么多的国外企业非常重视网站建设的根本原因。

现在,世界各国大的采购商主要都是利用互联网络来寻找新的产品和新的供应商,因为这样做费用最低,效率最高。

原则上,全世界任何地方的人,只要知道了公司的网址,就可以看到公司的产品。

因此,关键在于如何将公司网址推介出去。

一种非常实用而有效的方法是将公司的网址登记在全球著名的搜索引擎(如Google,百度,雅虎等)上,并选择与公司的产品及服务有关的关键字,则可以使潜在的客户能够容易地找到公司和产品。

这正是国际商业上通行的做法,而且被实践证明是十分有效的。

5、给广大热爱外语,渴望了解外语信息的群体提供一个方便快捷的平台。

1.2文档目的
该文档的阅读群体是该项目组的全部成员,为了让所有成员能对本网站的数据库构成,数据流向有个深刻的了解,方便在以后的编程中合理运用。

1.3参考资料
数据库原理及应用教程2版
北京人民邮电出版社
著者:陈志泊王春玲
数据库原理与应用
北京清华大学出版社
著者:狄文辉宋真君白劲波
面向对象技术与工具
北京电子工业出版社
陈文宇白忠建白忠建
软件工程
北京清华大学出版社
李代平
软件需求工程
北京科学出版社
刘璘金英金芝
UML系统建模与分析设计课程设计
北京机械工业出版社
刁成嘉刁奕
UML及建模
北京清华大学出版社北京交通大学出版社郭宁
数据库技术与应用
北京清华大学出版社
王珊
网络资源:
第二章设计流程图2.1注册功能流程图
2.3前台用户下载资料或留言功能流程图
第三章类规格说明2.1模块类图
3.2 jsp页面说明3.2.1 登录页面
3.2.2修改用户信息界面
3.3类说明3.3.1Admin类
3.3.2 AdminDao类
3.3.3 AdminDaoImpl类
3.3.4 User类
3.3.5 UserDao类
3.3.6 UserDaoImpl类
第四章程序设计说明
4.1程序描述
本系统的程序可以分为两个大类,一类是类程序,一类是jsp程序。

以下表格可以充分说明这些程序各自的特点和设计目的:
表格 4.1-1程序描述
4.2功能
(1)、首页设计
首页设计应该清晰简单、美观大方,同时还要做到信息充足,突出网站的特点和操作的入口。

(2)、信息管理
只有的登录后的用户可以修改自己的信息以及发布在网站上的一切信息。

本站管理员登录后可以对自己的信息进行更新操作,以及对用户信息进行增加,删除,修改操作;并且可发布新闻以及上传文件等操作。

本站不能因为商业目的向外界公开,个人信息完全由个人来控制其内容,程序应提供个人信息维护的页面。

(3)、信息浏览
根据网站的不同页面,用户可以浏览到相关分类信息。

另外可以通过本网站提供的站内搜索搜到自己想要的信息。

(4)、安全管理
安全方面的管理,防止恶意攻击、非法入侵和对数据的篡改。

4.3性能
4.3.1精度
1、个人信息:注册用户名不能超过12个字符(6个汉字);密码区分大小写,只
能使用大小写字母和数字的组合;邮件地址必须有效;验证码必须正确。

2、各分类信息:
考试的许愿墙中每条记录不超过30个字符;
博客中的留言板可以是任意字符。

3、用户选择或者输入数据,进行信息查询,应不区分大小写;
4、用户选择或者输入数据,进行信息查询,应执行不完全匹配的模糊查询;
3.3.2时间特性要求
1、用户登录请求、个人信息填写完毕后的提交、个人信息更改、删除的操作,响应时间应该在2s之内——用户不应感到系统有延迟的时间;
2、用户执行信息查询,返回记录在100行之内的,响应时间应不超过2s,超过20行记录的情况,应该进行分页显示,每页显示10-30行(具体由设计人员来设定)结果信息;
3.3.3灵活性
A、操作方式
程序在通常的应用环境下使用鼠标和键盘进行输入操作,对于执行按钮,通常使用鼠标的点击完成,但是,IE页面要求全部支持键盘的定位操作(在不安装鼠标的计算机上,也能够使用该网站)。

B、运行环境
程序在通常的条件下,在Win98/NT/2000/XP/7及vista,后续的MS的操作系统上,只要已经安装了IE6.0或者后续版本或者是IE内核的其他版本浏览器,都能够浏览所公布的页面、执行对应的操作。

页面服务器的环境应安装tomcat,正常启动Web服务,数据库服务器及详细的配置和安装参考以下硬件和软件的支持。

4.4 注释设计
实现注释的格式(Implementation Comment Formats)
程序可以有4种实现注释的风格:块(block)、单行(single-line)、尾端(trailing)和行末(end-of-line)。

4.4.1块注释(Block Comments)
块注释通常用于提供对文件、方法、数据结构和算法的描述。

块注释被置于每个文件的开始处以及每个方法之前。

它们也可以被用于其他地方,比如方法内部。

在功能和方法内部的块注释应该和它们所描述的代码具有一样的缩进格式。

块注释之首应该有一个空行,用于把块注释和代码分割开来,比如:
/*
* Here is a block comment.
*/
块注释可以以/*-开头,这样indent(1)就可以将之识别为一个代码块的开始,而不会重排它。

/*-
* Here is a block comment with some very special
* formatting that I want indent(1) to ignore.
*
* one
* two
* three
*/
4.4.2单行注释(Single-Line Comments)
短注释可以显示在一行内,并与其后的代码具有一样的缩进层级。

如果一个注释不能在一行内写完,就该采用块注释。

单行注释之前应该有一个空行。

以下是一个Java 代码中单行注释的例子:
if (condition) {
/* Handle the condition. */
...
}
4.4.3尾端注释(Trailing Comments)
极短的注释可以与它们所要描述的代码位于同一行,但是应该有足够的空白来分开代码和注释。

若有多个短注释出现于大段代码中,它们应该具有相同的缩进。

以下是一个Java代码中尾端注释的例子:
if (a == 2) {
return TRUE; /* special case */
} else {
return isPrime(a); /* works only for odd a */
}
4.4.4行末注释(End-Of-Line Comments)
注释界定符"//",可以注释掉整行或者一行中的一部分。

它一般不用于连续多行的注释文本;然而,它可以用来注释掉连续多行的代码段。

以下是所有三种风格的例子:
if (foo > 1) {
// Do a double-flip.
...
}
else {
return false; // Explain why here.
}
//if (bar > 1) {
//
// // Do a triple-flip.
// ...
//}
//else {
// return false;
//}。

相关文档
最新文档