实用软件工程课件第8章

(1)．在线帮助的使用规定
所有的业务功能（如录入、修改、查询、制单处理、 所有的业务功能（如录入、修改、查询、制单处理、 总账处理、明细账处理）或者较复杂的非业务功能（ 总账处理、明细账处理）或者较复杂的非业务功能（如 任意汇总查询、数据通信和传输）中都要提供在线帮助； 任意汇总查询、数据通信和传输）中都要提供在线帮助； 使用按钮操作的窗口，在线帮助使用按钮； 使用按钮操作的窗口，在线帮助使用按钮；使用菜单操 作的窗口，在线帮助使用菜单；对于查询功能， 作的窗口，在线帮助使用菜单；对于查询功能，查询结 果形成前的响应窗口应提供在线帮助。 果形成前的响应窗口应提供在线帮助。
4.3.1 控件级定义
这里讲的控件，是指屏幕界面上的控件， 这里讲的控件，是指屏幕界面上的控件，它是屏 幕窗口中的基本元素，是构件的一种表现形式。 幕窗口中的基本元素，是构件的一种表现形式。
控件1 按钮（Button） 控件1：按钮（Button）
属性：Height=92，Width依具体情况而定； 属性：Height=92，Width依具体情况而定；按钮 依具体情况而定 在窗口右下方或右方排列，当控件中包含按钮时， 在窗口右下方或右方排列，当控件中包含按钮时， 按钮不应和控件外的按钮在同一方向上排列。 按钮不应和控件外的按钮在同一方向上排列。
在线帮助
(2)．在线帮助的处理过程 在所有需要帮助的地方，调用一个自定义的公用函数， 在所有需要帮助的地方，调用一个自定义的公用函数， 由该函数负责打开在线帮助。公用函数的格式如下： 由该函数负责打开在线帮助。公用函数的格式如下： GifHelp(String psHelpId) 参数psHelpId 帮助关键字。 参数psHelpId 为帮助关键字。 (3)．帮助关键字的构造规范 系统编号（ 对象名字( 帮助关键字 = 系统编号（ 2位） + | + 对象名字(不 定位)+ | + 语义序号 定位)+ (4)．在线帮助函数的调用方法及规定 psHelpId按照上述规定的规范形成 按照上述规定的规范形成。 psHelpId按照上述规定的规范形成。各程序员都要形成 一个积累帮助的文件，文件名规定为Help+程序员名字 一个积累帮助的文件，文件名规定为Help+程序员名字 Help+ 缩写，每调用一次，都要向该文件中加入一行信息， 缩写，每调用一次，都要向该文件中加入一行信息，以 登记调用情况，文件格式的规定，如表8 所示。 登记调用情况，文件格式的规定，如表8-3所示。
软件实现方法
1．新增函数的实现及函数库的管理 ． 2．新增存储过程的实现及存储过程库的管理 3．新增类的实现及类库的管理 4．新增构件的实现及构件库的管理 5．新增中间件的实现及中间件的管理 6．部件组装 7．程序设计风格与编程规范 (1).程序设计风格的内容包括： 程序设计风格的内容包括 (1).程序设计风格的内容包括：规范化的程序内部 文档、数据结构的详细说明、清晰的语句结构、 文档、数据结构的详细说明、清晰的语句结构、遵守某 一编程规范。 一编程规范。 (2).编程规范的内容包括：命名规范、界面规范、 编程规范的内容包括 (2).编程规范的内容包括：命名规范、界面规范、 提示及帮助信息规范、热键定义等。 提示及帮助信息规范、热键定义等。
8.1 软件实现方法
软件实现的输入是 详细设计说明书》 输出是 软件实现的输入是《详细设计说明书》，输出是 输入 源程序、目标程序及用户指南。根据“ 源程序、目标程序及用户指南。根据“五个面向 理论” 编程实现的主要方法是“ 理论”，编程实现的主要方法是“面向对象实 因为现在流行的编程语言， 现”。因为现在流行的编程语言，基本上都是面 向对象的语言。 向对象的语言。 面向对象实现” 目标是 按照《 “面向对象实现”的目标是：按照《详细设计说 明书》的要求，从软件公司的函数库、类库、 明书》的要求，从软件公司的函数库、类库、构 件库中挑选有关的零部件， 件库中挑选有关的零部件，遵照软件公司的程序 设计规范，用面向对象的语言，通过穿针引线的 设计规范，用面向对象的语言， 方法，将这些零部件组装起来， 方法，将这些零部件组装起来，分别实现各模块 的功能，从而实现目标系统的功能、性能、接口、 的功能，从而实现目标系统的功能、性能、接口、 界面等要求。 界面等要求。
4.4.1 在线帮助
程序代码与在线帮助的关系采用间接调用方式处理 程序代码与在线帮助的关系采用间接调用方式处理。在 间接调用方式处理。 帮助菜单或按钮中，先调用帮助关键字， 帮助菜单或按钮中，先调用帮助关键字，再根据关键字 查找帮助主题。 查找帮助主题。这样可以使程序代码开发和帮助书写工 作分离，便于开发过程中整体工作的协调安排。 作分离，便于开发过程中整体工作的协调安排。
表8-3 帮助文件的格式
子系统 模块 帮助关键字
在线帮助
(5)．帮助关键字与帮助主题的对应关系 为了保证程序中所调用的帮助关键字能够同帮助文件 中帮助主题完全对应， 中帮助主题完全对应，特定义一个保存这种对应关系的 文件，该文件称为对应关系文件， 文件，该文件称为对应关系文件，它作为一个客户端的 配置文件存在，不在数据库中单独列表。 配置文件存在，不在数据库中单独列表。 配置文件名：HLPTOPIC. 配置文件名：HLPTOPIC.INI 格式： 格式： 子系统代码] [子系统代码] HelpTopic， HelpId = HelpTopic，HelpFile 例如： 例如： [ZW] 帮助主题， zw|w_kmzd|kmsr = 帮助主题，帮助文件 zw|w_pzcl|pzsr = 帮助主题，帮助文件 帮助主题，
4.2 源程序设计风格
良好的程序设计风格，能使程序员进行“ 良好的程序设计风格，能使程序员进行“无私程序设 计”，避免程序员与其所产生的代码之间的关系过于密 提高程序代码的规范化程度，使程序代码易读、 切，提高程序代码的规范化程度，使程序代码易读、易 易修改， 懂、易修改，实现程序员之间相互进行程序测试和维护 的目的。 的目的。
实用软件工程
----IT企业软件的开发与管理 IT企业软件的开发与管理 IT 赵池龙 zhaochilong@
第8章 软件实现 章 软件实现
本章导读： 本章导读：
从宏观上讲，软件实现包括详细设计、编程实现、 宏观上讲 软件实现包括详细设计、编程实现、 单元测试和集成测试。 微观上讲 单元测试和集成测试。从微观上讲，软件实现是 指编程和单元测试。本章只讲编程实现方法， 指编程和单元测试。本章只讲编程实现方法，包 括编码风格、界面定义、帮助信息， 括编码风格、界面定义、帮助信息，以及用户指 南书写的参考指南。 南书写的参考指南。 要求理解：编码风格、界面定义、 要求理解：编码风格、界面定义、帮助和提示信 息 要求掌握： 要求掌握： 用户使用手册》 1）《用户使用手册》的编写方法 用户安装手册》 2）《用户安装手册》的编写方法
控件6：图片（ 控件 ：图片（Picture） ）
控件7：标签（ 控件 ：标签（Tab） ）
4.3.2 窗口级定义
窗口级定义包括： 窗口级定义包括： (1)系统主窗口 系统主窗口; (1)系统主窗口; (2)基本参数 又称代码或数据字典） 基本参数（ (2)基本参数（又称代码或数据字典）维 护窗口; 护窗口; (3)录入查询修改窗口 录入查询修改窗口; (3)录入查询修改窗口; (4)统计窗口 统计窗口; (4)统计窗口; (5)对话框窗口等等 对话框窗口等等。 (5)对话框窗口等等。 在面向对象的编程语言中， 在面向对象的编程语言中，窗口定义是一 件较简单的事情。 件较简单的事情。
(1)．系统主窗口定义 ．
(2)．基本参数维护窗口定义 ．
(3)．录入/查询/修改窗口定义 ．录入/查询/
录入/查询/修改窗口定义 录入/查询/
选中记录：移动鼠标到该条记录上，并单击它。 （1）选中记录：移动鼠标到该条记录上，并单击它。 浏览记录：用鼠标拖动滚动条， （ 2 ） 浏览记录 ： 用鼠标拖动滚动条 ， 这样可以看到更 多的参数。 多的参数。 增加记录：按下“插入”按钮， （ 3 ） 增加记录 ： 按下 “ 插入 ” 按钮 ， 在左边的数据窗 口中将会增加一条空白记录。按下“保存”按钮， 口中将会增加一条空白记录。按下“保存”按钮，就会 将它存入数据库中。 将它存入数据库中。 删除记录：选中将要删除的记录，按下“删除” （ 4 ） 删除记录 ： 选中将要删除的记录 ， 按下 “ 删除 ” 按钮。按下“保存”按钮，就会从数据库中删除该记录。 按钮。按下“保存”按钮，就会从数据库中删除该记录。 修改记录：选中需要修改的记录，就可以修改。 （5）修改记录：选中需要修改的记录，就可以修改。 放弃修改：对数据进行了改动，允许放弃改动。 （ 6 ） 放弃修改 ： 对数据进行了改动 ， 允许放弃改动 。 办法是按下右边的“查询”按钮。 办法是按下右边的“查询”按钮。 打印记录：按下“打印”按钮， （7）打印记录：按下“打印”按钮，就得到所需的报 表。
程序设计要求： 程序设计要求：
依照所确定的规范进行程序设计。 （1）依照所确定的规范进行程序设计。 模块本身要高内聚，模块之间要低耦合。 （2）模块本身要高内聚，模块之间要低耦合。 （3）每个程序模块的行数不做规定。对于程序模块中相 每个程序模块的行数不做规定。 对独立性较强的程序块，提炼成为一个函数或构件。 对独立性较强的程序块，提炼成为一个函数或构件。 尽量为程序块加上明确的注释。 （4）尽量为程序块加上明确的注释。对于较复杂的程序 或算法需要有注释文件，并在程序中注明注释文件名， 或算法需要有注释文件，并在程序中注明注释文件名， 在注释文件中注明程序名。 在注释文件中注明程序名。
4.4 帮 助 信 息
帮助信息与用户指南有所不同。前者是联 帮助信息与用户指南有所不同。前者是联 机在线动态帮助 后者是脱机静态指导。 帮助， 脱机静态指导 机在线动态帮助，后者是脱机静态指导。 联机动态帮助与程序运行之间， 联机动态帮助与程序运行之间，存在动态 对应关系。 对应关系。 脱机静态帮助，是一种宏观静态说明。 脱机静态帮助，是一种宏观静态说明。 帮助信息又分为： 帮助信息又分为：在线帮助和提示信息两 部分，此处专门介绍帮助信息的实现方法。 部分，此处专门介绍帮助信息的实现方法。