1.软件接口说明文档怎么写1 引言
1.1编写目的
【软件接口怎么写】说明编写这份详细设计说明书的目的,指出预期的读者 。
1.2背景
说明:
a.待开发软件系统的名称;
b.本项目的任务提出者、开发者、用户和运行该程序系统的计算中心 。
1.3定义
列出本文件中用到专门术语的定义和外文首字母组词的原词组 。
1.4参考资料
列出有关的参考资料,如:
a.本项目的经核准的计划任务书或合同、上级机关的批文;
b.属于本项目的其他已发表的文件;
c.本文件中各处引用到的文件资料,包括所要用到的软件开发标准 。列出这些文件的标题、文件编号、发表日期和出版单位,说明能够取得这些文件的来源 。
2 程序系统的结构
用一系列图表列出本程序系统内的每个程序(包括每个模块和子程序)的名称、标识符和它们之间 的层次结构关系 。
3 程序1(标识符)设计说明
从本章开始,逐个地给出各个层次中的每个程序的设计考虑 。以下给出的提纲是针对一般情况的 。对于一个具体的模块,尤其是层次比较低的模块或子程序,其很多条目的内容往往与它所隶属的上一层 模块的对应条目的内容相同,在这种情况下,只要简单地说明这一点即可 。
3.1程序描述
给出对该程序的简要描述,主要说明安排设计本程序的目的意义,并且,还要说明本程序的特点(如 是常驻内存还是非常驻?是否子程序?是可重人的还是不可重人的?有无覆盖要求?是顺序处理还是并发 处理卜…..等) 。
3.2功能
说明该程序应具有的功能,可采用IPO图(即输入一处理一输出图)的形式 。
3.3性能
说明对该程序的全部性能要求,包括对精度、灵活性和时间特性的要求 。
3.4输人项
给出对每一个输入项的特性,包括名称、标识、数据的类型和格式、数据值的有效范围、输入的方式 。数量和频度、输入媒体、输入数据的来源和安全保密条件等等 。
3. 5输出项
给出对每一个输出项的特性,包括名称、标识、数据的类型和格式,数据值的有效范围,输出的形式、数量和频度,输出媒体、对输出图形及符号的说明、安全保密条件等等 。
3.6算法
详细说明本程序所选用的算法,具体的计算公式和计算步骤 。
3.7流程逻辑
用图表(例如流程图、判定表等)辅以必要的说明来表示本程序的逻辑流程 。
3.8接口
用图的形式说明本程序所隶属的上一层模块及隶属于本程序的下一层模块、子程序,说明参数赋值和调用方式,说明与本程序相直接关联的数据结构(数据库、数据文卷) 。
3.9存储分配
根据需要,说明本程序的存储分配 。
3.10注释设计
说明准备在本程序中安排的注释,如:
a. 加在模块首部的注释;
b.加在各分枝点处的注释; 对各变量的功能、范围、缺省条件等所加的注释;
d.对使用的逻辑所加的注释等等 。
3.11限制条件
说明本程序运行中所受到的限制条件 。
3.12测试计划
说明对本程序进行单体测试的计划,包括对测试的技术要求、输入数据、预期结果、进度安排、人员职责、设备条件驱动程序及桩模块等的规定 。
3.13尚未解决的问题
说明在本程序的设计中尚未解决而设计者认为在软件完成之前应解决的问题 。
4 程序2(标识符)设计说明
用类似3的方式,说明第2个程序乃至第N个程序的设计考虑 。
2.软件接口的定义我们把这种人-软件之间的接口称作“用户界面”,也就是“UI” 。这里要讨论的前一种定义: 软件不同部分之间的交互接口 。通常就是所谓的API――应用程序编程接口,其表现的形式是源代码 。API的发明和发展大大促进了计算机产业的进步,同时API几乎决定着日常运算的各个方面 。