1、实用软件工程实用软件工程-ITIT企业软件的开发与管理企业软件的开发与管理赵池龙赵池龙 第第8章章 软件软件实现实现 本章导读:本章导读: 从从宏观上宏观上讲,软件实现包括详细设计、编程实现、讲,软件实现包括详细设计、编程实现、单元测试和集成测试。从单元测试和集成测试。从微观上微观上讲,软件实现是讲,软件实现是指编程和单元测试。本章只讲编程实现方法,包指编程和单元测试。本章只讲编程实现方法,包括编码风格、界面定义、帮助信息,以及用户指括编码风格、界面定义、帮助信息,以及用户指南书写的参考指南。南书写的参考指南。 要求要求理解理解:编码风格、界面定义、帮助和提示信编码风格、界面定义、帮助和提示信
2、息息 要求要求掌握掌握: 1 1)用户使用手册用户使用手册的编写方法的编写方法 2 2)用户安装手册用户安装手册的编写方法的编写方法 8.1 软件实现方法软件实现方法 软件实现的软件实现的输入输入是是详细设计说明书详细设计说明书,输出输出是是源程序、目标程序及用户指南。根据源程序、目标程序及用户指南。根据“五个面向五个面向理论理论”,编程实现的主要方法是编程实现的主要方法是“面向对象实面向对象实现现”。因为现在流行的编程语言,基本上都是面。因为现在流行的编程语言,基本上都是面向对象的语言。向对象的语言。 “面向对象实现面向对象实现”的的目标目标是:按照是:按照详细设计说详细设计说明书明书的要求
3、,从软件公司的函数库、类库、构的要求,从软件公司的函数库、类库、构件库中挑选有关的零部件,遵照软件公司的程序件库中挑选有关的零部件,遵照软件公司的程序设计规范,用面向对象的语言,通过穿针引线的设计规范,用面向对象的语言,通过穿针引线的方法,将这些零部件组装起来,分别实现各模块方法,将这些零部件组装起来,分别实现各模块的功能,从而实现目标系统的功能、性能、接口、的功能,从而实现目标系统的功能、性能、接口、界面等要求。界面等要求。 软件实现方法软件实现方法 1新增函数的实现及函数库的管理新增函数的实现及函数库的管理 2 2新增存储过程的实现及存储过程库的管理新增存储过程的实现及存储过程库的管理 3
4、 3新增类的实现及类库的管理新增类的实现及类库的管理 4 4新增构件的实现及构件库的管理新增构件的实现及构件库的管理 5 5新增中间件的实现及中间件的管理新增中间件的实现及中间件的管理 6 6部件组装部件组装 7 7程序设计风格与编程规范程序设计风格与编程规范 (1).(1).程序设计风格程序设计风格的内容包括:规范化的程序内部的内容包括:规范化的程序内部文档、数据结构的详细说明、清晰的语句结构、遵守某文档、数据结构的详细说明、清晰的语句结构、遵守某一编程规范。一编程规范。 (2).(2).编程规范编程规范的内容包括:命名规范、界面规范、的内容包括:命名规范、界面规范、提示及帮助信息规范、热键
5、定义等。提示及帮助信息规范、热键定义等。4.2 源程序设计风格源程序设计风格 良好的程序设计风格,能使程序员进行良好的程序设计风格,能使程序员进行“无私程序设无私程序设计计”,避免程序员与其所产生的代码之间的关系过于密,避免程序员与其所产生的代码之间的关系过于密切,提高程序代码的规范化程度,使程序代码易读、易切,提高程序代码的规范化程度,使程序代码易读、易懂、易修改,实现程序员之间相互进行程序测试和维护懂、易修改,实现程序员之间相互进行程序测试和维护的目的。的目的。 程序设计要求:程序设计要求: (1 1)依照所确定的规范进行程序设计。)依照所确定的规范进行程序设计。 (2 2)模块本身要高内
6、聚,模块之间要低耦合。)模块本身要高内聚,模块之间要低耦合。 (3 3)每个程序模块的行数不做规定。对于程序模块中相)每个程序模块的行数不做规定。对于程序模块中相对独立性较强的程序块,提炼成为一个函数或构件。对独立性较强的程序块,提炼成为一个函数或构件。 (4 4)尽量为程序块加上明确的注释。对于较复杂的程序)尽量为程序块加上明确的注释。对于较复杂的程序或算法需要有注释文件,并在程序中注明注释文件名,或算法需要有注释文件,并在程序中注明注释文件名,在注释文件中注明程序名。在注释文件中注明程序名。 4.3 屏幕界面设计屏幕界面设计 屏幕界面上看得见的窗口、画面、图像、按钮等屏幕界面上看得见的窗口
7、、画面、图像、按钮等对象,在设计与实现中,统称为对象,在设计与实现中,统称为“控件控件”。 构件构件分为可视构件和非可视构件两种,控件是一分为可视构件和非可视构件两种,控件是一种可视构件,它是构件的一种表现形式。种可视构件,它是构件的一种表现形式。 控件的有机排列和组合,就构成了用户需求的各控件的有机排列和组合,就构成了用户需求的各种屏幕界面。种屏幕界面。 屏幕界面设计的内容包括:屏幕界面设计的内容包括:( (1)1)控件级设计控件级设计;(2);(2)窗口级定义窗口级定义;(3);(3)系统级定义。系统级定义。 屏幕界面设计遵从的原则是:界面简洁朴素,控屏幕界面设计遵从的原则是:界面简洁朴素
8、,控件摆放整齐,颜色风格统一,照顾客户习惯。件摆放整齐,颜色风格统一,照顾客户习惯。4.3.1 控件级定义控件级定义 这里讲的控件,是指屏幕界面上的控件,它是屏这里讲的控件,是指屏幕界面上的控件,它是屏幕窗口中的基本元素,是构件的一种表现形式。幕窗口中的基本元素,是构件的一种表现形式。 控件控件1 1:按钮(:按钮(ButtonButton) 属性:属性:Height=92Height=92,WidthWidth依具体情况而定;按钮依具体情况而定;按钮在窗口右下方或右方排列,当控件中包含按钮时,在窗口右下方或右方排列,当控件中包含按钮时,按钮不应和控件外的按钮在同一方向上排列。按钮不应和控件外
9、的按钮在同一方向上排列。控件控件1:按钮(:按钮(Button)控件控件2:分组框(:分组框(Group Box)控件控件3:单行编辑器、下拉列表框、图形下拉:单行编辑器、下拉列表框、图形下拉列表框、数字转盘列表框、数字转盘控件控件4:图表(:图表(Graph)控件控件5:复选框、单选钮:复选框、单选钮控件控件6:图片(:图片(Picture)控件控件7:标签(:标签(Tab)4.3.2 窗口级定义窗口级定义 窗口级定义包括:窗口级定义包括: (1)(1)系统主窗口系统主窗口; ; (2) (2)基本参数(又称代码或数据字典)维基本参数(又称代码或数据字典)维护窗口护窗口; ; (3) (3)
10、录入查询修改窗口录入查询修改窗口; ; (4) (4)统计窗口统计窗口; ; (5) (5)对话框窗口等等。对话框窗口等等。 在面向对象的编程语言中,窗口定义是一在面向对象的编程语言中,窗口定义是一件较简单的事情。件较简单的事情。(1)系统主窗口定义系统主窗口定义(2)基本参数维护窗口定义基本参数维护窗口定义(3)录入录入/ /查询查询/ /修改窗口定义修改窗口定义录入录入/ /查询查询/ /修改窗口定义修改窗口定义 (1 1)选中记录选中记录:移动鼠标到该条记录上,并单击它。:移动鼠标到该条记录上,并单击它。 (2 2)浏览记录浏览记录:用鼠标拖动滚动条,这样可以看到更:用鼠标拖动滚动条,这
11、样可以看到更多的参数。多的参数。 (3 3)增加记录增加记录:按下:按下“插入插入”按钮,在左边的数据窗按钮,在左边的数据窗口中将会增加一条空白记录。按下口中将会增加一条空白记录。按下“保存保存”按钮,就会按钮,就会将它存入数据库中。将它存入数据库中。 (4 4)删除记录删除记录:选中将要删除的记录,按下:选中将要删除的记录,按下“删除删除”按钮。按下按钮。按下“保存保存”按钮,就会从数据库中删除该记录。按钮,就会从数据库中删除该记录。 (5 5)修改记录修改记录:选中需要修改的记录,就可以修改。:选中需要修改的记录,就可以修改。 (6 6)放弃修改放弃修改:对数据进行了改动,允许放弃改动。:
12、对数据进行了改动,允许放弃改动。办法是按下右边的办法是按下右边的“查询查询”按钮。按钮。 (7 7)打印记录打印记录:按下:按下“打印打印”按钮,就得到所需的报按钮,就得到所需的报表。表。 (4)统计窗口定义统计窗口定义统计窗口定义统计窗口定义(5)对话框窗口定义对话框窗口定义4.3.3 系统级定义系统级定义 (1)(1)系统结构图系统结构图定义定义 用彩色示意图,形象地表示该系统的总体结构。用彩色示意图,形象地表示该系统的总体结构。 (2)(2)起始画面起始画面定义定义 用于显示系统的名称和版权人等信息。用于显示系统的名称和版权人等信息。 (3)(3)登录登录定义定义 用户录入名称和口令,登
13、录等待过程需加入动画。用户录入名称和口令,登录等待过程需加入动画。 (4)(4)菜单菜单定义定义 同一层菜单项之间,功能不同者用同一层菜单项之间,功能不同者用“横线横线”隔开;主菜隔开;主菜单项名称用单项名称用“两个字符两个字符”表达;子系统功能相同的菜单表达;子系统功能相同的菜单项必须用同一名称。项必须用同一名称。 (5)(5)快捷键快捷键定义定义4.4 帮帮 助助 信信 息息 帮助信息与用户指南有所不同。前者是帮助信息与用户指南有所不同。前者是联联机在线动态机在线动态帮助,后者是帮助,后者是脱机静态脱机静态指导。指导。 联机动态帮助与程序运行之间,存在动态联机动态帮助与程序运行之间,存在动
14、态对应关系。对应关系。 脱机静态帮助,是一种宏观静态说明。脱机静态帮助,是一种宏观静态说明。 帮助信息又分为:在线帮助和提示信息两帮助信息又分为:在线帮助和提示信息两部分,此处专门介绍帮助信息的实现方法。部分,此处专门介绍帮助信息的实现方法。4.4.1 在线帮助在线帮助 程序代码与在线帮助的关系采用程序代码与在线帮助的关系采用间接调用间接调用方式处理。在方式处理。在帮助菜单或按钮中,先调用帮助关键字,再根据关键字帮助菜单或按钮中,先调用帮助关键字,再根据关键字查找帮助主题。这样可以使程序代码开发和帮助书写工查找帮助主题。这样可以使程序代码开发和帮助书写工作分离,便于开发过程中整体工作的协调安排
15、。作分离,便于开发过程中整体工作的协调安排。 (1)(1)在线帮助的使用规定在线帮助的使用规定 所有的业务功能(如录入、修改、查询、制单处理、所有的业务功能(如录入、修改、查询、制单处理、总账处理、明细账处理)或者较复杂的非业务功能(如总账处理、明细账处理)或者较复杂的非业务功能(如任意汇总查询、数据通信和传输)中都要提供在线帮助;任意汇总查询、数据通信和传输)中都要提供在线帮助;使用按钮操作的窗口,在线帮助使用按钮;使用菜单操使用按钮操作的窗口,在线帮助使用按钮;使用菜单操作的窗口,在线帮助使用菜单;对于查询功能,查询结作的窗口,在线帮助使用菜单;对于查询功能,查询结果形成前的响应窗口应提供
16、在线帮助。果形成前的响应窗口应提供在线帮助。 在线帮助在线帮助 (2)(2)在线帮助的处理过程在线帮助的处理过程 在所有需要帮助的地方,调用一个自定义的公用函数,在所有需要帮助的地方,调用一个自定义的公用函数,由该函数负责打开在线帮助。公用函数的格式如下:由该函数负责打开在线帮助。公用函数的格式如下: GifHelp(String psHelpIdGifHelp(String psHelpId) ) 参数参数psHelpIdpsHelpId 为为帮助关键字帮助关键字。 (3)(3)帮助关键字的构造规范帮助关键字的构造规范 帮助关键字帮助关键字 = = 系统编号(系统编号(2 2位)位)+ |
17、+ + | + 对象名字对象名字( (不不定位定位)+ | + )+ | + 语义序号语义序号 (4)(4)在线帮助函数的调用方法及规定在线帮助函数的调用方法及规定 psHelpIdpsHelpId按照上述规定的规范形成。各程序员都要形成按照上述规定的规范形成。各程序员都要形成一个积累帮助的文件,文件名规定为一个积累帮助的文件,文件名规定为Help+Help+程序员名字程序员名字缩写,每调用一次,都要向该文件中加入一行信息,以缩写,每调用一次,都要向该文件中加入一行信息,以登记调用情况,文件格式的规定,如表登记调用情况,文件格式的规定,如表8-38-3所示。所示。表表8-3 帮助文件的格式帮助
18、文件的格式 子系统子系统模块模块帮助关键字帮助关键字在线帮助在线帮助 (5)(5)帮助关键字与帮助主题的对应关系帮助关键字与帮助主题的对应关系 为了保证程序中所调用的帮助关键字能够同帮助文件为了保证程序中所调用的帮助关键字能够同帮助文件中帮助主题完全对应,特定义一个保存这种对应关系的中帮助主题完全对应,特定义一个保存这种对应关系的文件,该文件称为对应关系文件,它作为一个客户端的文件,该文件称为对应关系文件,它作为一个客户端的配置文件存在,不在数据库中单独列表。配置文件存在,不在数据库中单独列表。 配置文件名:配置文件名:HLPTOPIC.INIHLPTOPIC.INI 格式:格式: 子系统代码
19、子系统代码 HelpId = HelpTopic HelpId = HelpTopic,HelpFileHelpFile 例如:例如: ZWZW zw|w_kmzd|kmsr zw|w_kmzd|kmsr = = 帮助主题,帮助文件帮助主题,帮助文件 zw|w_pzcl|pzsrzw|w_pzcl|pzsr = = 帮助主题,帮助文件帮助主题,帮助文件4.4.2 提示信息提示信息 1 1提示信息的分类提示信息的分类 可将系统中所有提示信息分为可将系统中所有提示信息分为4 4类:类: (1 1)引导性提示信息:该类提示信息一般在需要用户)引导性提示信息:该类提示信息一般在需要用户干预时出现,要求
20、用户决定下一步的操作。如在退出时干预时出现,要求用户决定下一步的操作。如在退出时提示提示“修改的数据尚未存盘,存盘否?修改的数据尚未存盘,存盘否?”。 (2 2)错误性提示信息:该类提示信息一般在软件运行)错误性提示信息:该类提示信息一般在软件运行出错时出现,告诉用户软件遇到了问题。如出错时出现,告诉用户软件遇到了问题。如“系统运行系统运行出现故障,请与系统管理员联系!出现故障,请与系统管理员联系!”。 (3 3)状态性提示信息:该类提示信息一般在软件处于)状态性提示信息:该类提示信息一般在软件处于“忙忙”状态下提示,告诉用户软件正在进行什么操作,状态下提示,告诉用户软件正在进行什么操作,让用
21、户耐心等待。如让用户耐心等待。如“正在进行数据传输,请稍待正在进行数据传输,请稍待”。 (4 4)位置性提示信息:该类提示信息一般根据鼠标的)位置性提示信息:该类提示信息一般根据鼠标的位置进行提示,告诉用户鼠标正指向什么功能。如位置进行提示,告诉用户鼠标正指向什么功能。如“报报表打印表打印”。提示信息提示信息 2 2提示信息的提示方法提示信息的提示方法 对 于 所 有 提 示 信 息 , 可 使 用 函 数对 于 所 有 提 示 信 息 , 可 使 用 函 数gsShowMessage(psMessIdgsShowMessage(psMessId,psErrMesspsErrMess) ),其
22、中,其中psMessIdpsMessId为提示信息的为提示信息的IDID号,号,psErrMesspsErrMess为根据系统获得的错误为根据系统获得的错误信息,该参数只对错误性提示信息有效。信息,该参数只对错误性提示信息有效。(1 1)对于引导性提示信息,使用)对于引导性提示信息,使用MessageBoxMessageBox进行提示。进行提示。(2 2)对于错误性提示信息,显示时只显示信息表中提供)对于错误性提示信息,显示时只显示信息表中提供的信息,提供详细按钮,执行时将详细的错误信息显示的信息,提供详细按钮,执行时将详细的错误信息显示出来。出来。(3 3)对于状态性提示信息,显示一个固定窗
23、口,同时提)对于状态性提示信息,显示一个固定窗口,同时提供一个函数供一个函数gsCloseMessgsCloseMess( )( ),对于该类提示信息,在执,对于该类提示信息,在执行完毕后,执行函数将提示窗口关闭。行完毕后,执行函数将提示窗口关闭。(4 4)位置性提示信息显示在状态提示栏中。)位置性提示信息显示在状态提示栏中。提示信息提示信息 3 3信息序号的编码规则及使用时应做的工作信息序号的编码规则及使用时应做的工作 (1). (1). 信息序号的规则如下:信息序号的规则如下: 信息序号信息序号 = = 信息类别(两位)信息类别(两位)+ +信息代号(八位)信息代号(八位)(2). “(2
24、). “信息类别信息类别”表示为以下信息中的一种:表示为以下信息中的一种: (1 1). LE . LE 引导性信息引导性信息 (2 2). ER . ER 错误性信息错误性信息 (3 3). ST . ST 状态性信息状态性信息 (4 4). PO . PO 位置性信息位置性信息(3). “(3). “信息级别信息级别”仅对仅对ERER有效,级别在最后统一编排。有效,级别在最后统一编排。(4). “(4). “提问方式提问方式”仅对仅对LELE有效,表示如何提示用户,以有效,表示如何提示用户,以便于用户回答:便于用户回答:YesNoYesNo( (是否是否) );YesNoCancelYes
25、NoCancel( (是否取消是否取消) );OkCancelOkCancel ( (确认取消确认取消) );Ok(Ok(确认确认) )。提示信息提示信息 4 4提示信息的时机及内容编写规定提示信息的时机及内容编写规定 (1 1)引导性提示主要是引导用户进行下一步操作,一)引导性提示主要是引导用户进行下一步操作,一般出现的机会比较多,如般出现的机会比较多,如“修改的数据未存盘,存盘修改的数据未存盘,存盘否?否?”。 (2 2)错误性提示在测试比较好的情况下应极少出现,)错误性提示在测试比较好的情况下应极少出现,它出现的原因不外乎两种:一种为测试不够;另一种可它出现的原因不外乎两种:一种为测试不
26、够;另一种可能为数据出现错误,如服务器运行异常等。对于这种情能为数据出现错误,如服务器运行异常等。对于这种情况一定要将错误原因详尽提示出来,由程序员在新的版况一定要将错误原因详尽提示出来,由程序员在新的版本中改正错误,或维护人员根据错误原因解决问题。本中改正错误,或维护人员根据错误原因解决问题。 (3 3)状态性提示要明确简单,让用户确实了解系统目)状态性提示要明确简单,让用户确实了解系统目前正在前正在“忙忙”什么。什么。 (4 4)要将位置性提示准确显示在状态提示栏中。)要将位置性提示准确显示在状态提示栏中。提示信息提示信息 5 5热键定义及使用规范热键定义及使用规范 对于各种对象(如菜单、
27、按钮等)的对于各种对象(如菜单、按钮等)的热键,在各种对象的介绍中已经规定,在热键,在各种对象的介绍中已经规定,在此不再做重复规定,这里只规定整个系统此不再做重复规定,这里只规定整个系统的热键,如表的热键,如表8-58-5所示。所示。 4.4.3 其他规定其他规定 (1 1)对于数字型(除)对于数字型(除IntegerInteger型)列,从表中取出后,型)列,从表中取出后,必需进行四舍五入处理。必需进行四舍五入处理。 (2 2)使用通配符的地方,一律使用)使用通配符的地方,一律使用“?”表示。表示。 (3 3)在退出时,检查数据窗口中的数据是否做过改动,)在退出时,检查数据窗口中的数据是否做
28、过改动,如做过改动,应提示用户是否存盘。如做过改动,应提示用户是否存盘。 (4 4)在存盘之前,应检查数据窗口中各项数据的正确)在存盘之前,应检查数据窗口中各项数据的正确性,如有不符合条件的项,应提示,改正后再行存盘,性,如有不符合条件的项,应提示,改正后再行存盘,提示的内容应为提示的内容应为“错误信息错误信息”+ +“改正方法改正方法”。 (5 5)对于日期型数据的显示及输入格式,规定为)对于日期型数据的显示及输入格式,规定为yyyy.mm.ddyyyy.mm.dd,不得使用其他任何格式。,不得使用其他任何格式。 (6 6)每行数据输入、删除或修改后,要能够及时提交。)每行数据输入、删除或修
29、改后,要能够及时提交。 (7 7)在输入某一项数据时,如果该项不在可视屏内,)在输入某一项数据时,如果该项不在可视屏内,则应将该项移动到可视屏内。则应将该项移动到可视屏内。其他规定其他规定 (8 8)可以在事件中调用函数,但一般不在函数中触发)可以在事件中调用函数,但一般不在函数中触发事件。函数体内的语句出错时,要返回错误代码(如事件。函数体内的语句出错时,要返回错误代码(如1 1表示成功,表示成功,1 1表示失败)等。表示失败)等。 (9 9)规定:事件的触发应不超过三级,视图的连续层)规定:事件的触发应不超过三级,视图的连续层数应不超过三层。数应不超过三层。 (1010)在数据更新中,动态
30、)在数据更新中,动态SQLSQL语句或嵌入式语句或嵌入式SQLSQL语句执语句执行后都要进行判断,根据执行结果来决定下一步操作。行后都要进行判断,根据执行结果来决定下一步操作。 (1111)在某一子系统的主菜单下打开一窗口时,如果该)在某一子系统的主菜单下打开一窗口时,如果该窗口是窗口是MainMain(主)窗口,则以(主)窗口,则以OpenSheetOpenSheet( )( )打开。打开。 (1212)规定全程变量表,是各系统实现前要做的一项重)规定全程变量表,是各系统实现前要做的一项重要的工作。至于各子系统所使用的全程变量,则要待各要的工作。至于各子系统所使用的全程变量,则要待各子系统设
31、计完成后,由高级程序员根据情况定义,但通子系统设计完成后,由高级程序员根据情况定义,但通用全程变量各子系统都要使用。用全程变量各子系统都要使用。4.5 软件实现文档软件实现文档 1 1实现文档的组成实现文档的组成 软件实现文档由软件实现文档由源程序清单和用户指南源程序清单和用户指南组成。由组成。由于面向对象的语言与面向过程的语言有所不同,于面向对象的语言与面向过程的语言有所不同,所以完整的源程序清单有时打印不出来,往往只所以完整的源程序清单有时打印不出来,往往只能打印出部分源程序清单。一般的做法是:不打能打印出部分源程序清单。一般的做法是:不打印出源程序清单,只保留其电子版本。印出源程序清单,
32、只保留其电子版本。 用户指南主要包括用户指南主要包括用户使用手册用户使用手册和和用户安用户安装手册装手册 。 在特殊情况下,例如,数据库服务器上的存储管在特殊情况下,例如,数据库服务器上的存储管理、数据维护、数据备份、数据传输等问题较复理、数据维护、数据备份、数据传输等问题较复杂时,在用户指南中还要增加杂时,在用户指南中还要增加系统管理员手册系统管理员手册的内容。的内容。软件实现文档软件实现文档 2 2用户指南的编写要求用户指南的编写要求 (1 1)统一采用编写工具)统一采用编写工具WordWord进行编写。进行编写。 (2 2)用统一的风格和确定的方法,描述产品提)用统一的风格和确定的方法,
33、描述产品提供的所有功能。描述之后的功能,应该具有如下供的所有功能。描述之后的功能,应该具有如下特点:对于每一项功能的描述应该完整。特点:对于每一项功能的描述应该完整。 (3 3)术语部分包括系统术语和基本概念。系统)术语部分包括系统术语和基本概念。系统术语在整个系统的含义是统一的,放在前言部分术语在整个系统的含义是统一的,放在前言部分描述。基本概念在各有关章节进行描述。描述。基本概念在各有关章节进行描述。 (4 4)语言要简洁明快,表达准确。一句话不要)语言要简洁明快,表达准确。一句话不要太长,中间可以断句几次。太长,中间可以断句几次。 (5 5)指南格式应统一。)指南格式应统一。软件实现文档
34、软件实现文档 3 3用户指南的排版建议用户指南的排版建议 (1 1).2.2人以上合作编写,一定要有一人负责统稿。人以上合作编写,一定要有一人负责统稿。 (2(2). .交稿前一定要最后一次仔细审读。交稿前一定要最后一次仔细审读。 (3 3). .图以章为序,如图图以章为序,如图5.15.1或图或图5-15-1(半字线连接章号(半字线连接章号和图号)。和图号)。 (4(4). .表以章为序,如表表以章为序,如表3.13.1或表或表3-23-2。 (5 5). .命令格式。操作步骤中使用的命令按钮、菜单命命令格式。操作步骤中使用的命令按钮、菜单命令项、标签项等名称用【】界定。如:打开【开始】菜令
35、项、标签项等名称用【】界定。如:打开【开始】菜单选择【程序】项单选择【程序】项 (6 6). .例题格式。例题以章为序,并用【】界定。如例题格式。例题以章为序,并用【】界定。如【例【例3.53.5】或【例】或【例3-53-5】。】。软件实现文档软件实现文档 4 4用户指南的编写原则用户指南的编写原则 (1 1)列出应编制文档的目录。)列出应编制文档的目录。 (2 2)提示编制文档应参考的标准。)提示编制文档应参考的标准。 (3 3)指定文档管理员。)指定文档管理员。 (4 4)提供编制文档所需要的条件,落实文档编写人员、)提供编制文档所需要的条件,落实文档编写人员、主管和主管和所需经费以及编制
36、工具等。所需经费以及编制工具等。 (5 5)明确保证文档质量的方法,为了确保文档内容的)明确保证文档质量的方法,为了确保文档内容的正确性、合理性,应采取一定的措施,如评审、审稿、正确性、合理性,应采取一定的措施,如评审、审稿、鉴定等。鉴定等。 (6 6)绘制进度表,以图表形式列出各阶段应产生的文)绘制进度表,以图表形式列出各阶段应产生的文档、编制人员、编制档、编制人员、编制主管、主管、编制日期、完成日期、评审编制日期、完成日期、评审日期等。日期等。软件实现文档软件实现文档 5 5用户指南的审核鉴定用户指南的审核鉴定 为了保证文档的质量以及文档内容的正确为了保证文档的质量以及文档内容的正确性、合
37、理性,软件工程管理部门应对用户指南进性、合理性,软件工程管理部门应对用户指南进行评审和鉴定工作,提出改进意见,有利于整个行评审和鉴定工作,提出改进意见,有利于整个文档质量的提高。文档质量的提高。 6 6软件实现管理文档软件实现管理文档 软件实现管理文档包括软件实现管理文档包括用户指南评审报用户指南评审报告告,模块源程序行统计表(行模块源程序行统计表(行/ /模块名)模块名),源程序工作量统计表(行源程序工作量统计表(行/ /人天)人天)。这些管。这些管理文档均较简单,作为习题,由读者自己完成。理文档均较简单,作为习题,由读者自己完成。4.6 本本 章章 小小 结结 对于有经验的程序员来说,只要
38、对于有经验的程序员来说,只要详细设计说明详细设计说明书书设计合理、制作规范、评审通过(不符合项设计合理、制作规范、评审通过(不符合项为零),软件实现是一件轻松愉快的事情。若为零),软件实现是一件轻松愉快的事情。若ITIT企业十分成熟,积累的软件财富丰厚,类库、构企业十分成熟,积累的软件财富丰厚,类库、构件库强大,规范和标准齐全,软件过程管理到位,件库强大,规范和标准齐全,软件过程管理到位,那么软件实现更加简单。那么软件实现更加简单。 按照本章介绍的软件实现方法、程序设计风格、按照本章介绍的软件实现方法、程序设计风格、屏幕界面控件设计、窗口级定义、系统级定义、屏幕界面控件设计、窗口级定义、系统级
39、定义、帮助信息和用户指南编写等各种规范,就可以逐帮助信息和用户指南编写等各种规范,就可以逐步实现步实现详细设计说明书详细设计说明书的内容,使企业走上的内容,使企业走上规范化的经营之路。规范化的经营之路。思考题思考题 8 8.1 8.1 软件实现的输入软件实现的输入/ /输出是什么?输出是什么? 8.2 8.2 “面向对象实现面向对象实现”的目标是什么?的目标是什么? 8.3 8.3 软件实现要做的工作包括哪几项?软件实现要做的工作包括哪几项? 8.4 8.4 软件实现方法的细节有哪些?软件实现方法的细节有哪些? 8.5 8.5 简述良好的程序设计风格的内容。简述良好的程序设计风格的内容。 8.6 8.6 界面设计应遵从哪些原则?界面设计应遵从哪些原则? 8.8 8.8 用户使用手册包括哪些内容?用户使用手册包括哪些内容? 8.9 8.9 用户安装手册包括哪些内容?用户安装手册包括哪些内容? 8.10 8.10 面向对象程序设计的特点是什么?它与面向过程面向对象程序设计的特点是什么?它与面向过程程序设计有何差异?程序设计有何差异? 8.12 8.12 请设计出请设计出系统管理员手册系统管理员手册的格式与内容。的格式与内容。