接口设计说明书模板

目  录

1 引言 1

1.1 设计目标 1

1.2 适用范围 1

1.3 相关术语 1

1.4 参考资料 1

2 分析设计 1

2.1 设计思想 1

2.2 接口结构 1

2.3 数据流分析 2

3 中间库接口 2

3.1 中间库说明 2

3.2 传输交互方法 2

3.3 中间库接口结构 2

3.3.1 XXX1/视图 2

3.3.2 XXX2/视图 2

3.3.3 XXX1方法/函数 2

4 页面集成接口 3

4.1 对外提供 3

4.2 外部调用 3

5 Tuxedo接口 3

5.1 接口功能1 3

5.1.1 接口子功能1 3

5.1.2 接口子功能2 4

6 WebService服务接口 4

6.1 接口综述 4

6.1.1 WebService概述 4

6.1.2 认证机制 4

6.1.3 数据规约 5

6.2 接口功能1 5

6.2.1 接口子功能1 5

7 文件接口 6

7.1 文件名称 6

7.2 文件格式定义 6

7.3 传输方法 6

7.4 {其他约定} 7

8 标准代码 7


 

1 引言

1.1 设计目标

无相关图表的章节中,可自行根据需要加入图表说明,下同。

要达到的目的简述,例如说明需要支持的功能目标等。

1.2 适用范围

文档的适用范围,比如是在全公司适用还是在某个产品部适用等。预期的读者是哪些等。

1.3 相关术语

列出本文件中用到的专门术语的定义,例如中间库在本项目中的的含义,如果没有需特别要说明的,可删除此章节

 

术语

解释

 

 

 

1.4 参考资料

列出有关的参考资料

2 分析设计

2.1 设计思想

说明本模块的基本设计概念,比如对需求是如何考虑的,为什么要把对应的需求转换成这样的设计处理,以及接口的概况性的描述、要求】

2.2 接口结构

说明接口的系统、功能的分布关系,优先图示说明,如果需要,可以列出接口功能清单。

2.3 数据流分析

为说明数据流向描述功能模块实现对应需求的数据流程图,说明数据经过处理后的输出传输情况。可选

3 中间库接口

通常不建议使用此接口方式实现,没有此接口方式可以删除此目录.

3.1 中间库说明

说明传输数据库版本等

3.2 传输交互方法

说明数据交互的频率、主动、触发等方式。

3.3 中间库接口结构

3.3.1 XXX1/视图

如果是表采用下表描述结构

序号

字段中文名

字段英文名

字段类型

字段含义

1

抄表接口数据标识

DATA_ID

NUMBER(15)

本实体记录的唯一标识,产生规则为流水号。

下装时填写

2

申请编号

APP_NO

VARCHAR2(16)

流程实例的唯一标识,可自行编码。

下装时填写

3.3.2 XXX2/视图

相关内容同表1

3.3.3 XXX1方法/函数

功能说明

提供客户的基本信息查询

调用位置

所在的包,直接调用存储过程或函数不用说明

函数方法

 

输入参数

参数代码

数据类型

参数说明

 

 

 

 

 

 

 

 

 

输出参数

参数代码

数据类型

参数说明

 

 

 

示例

使用开发代码举例说明如何调用

 

4 页面集成接口

没有此接口方式可以删除此目录

4.1 对外提供

序号

功能说明

页面调用路径

入参

出参

备注

1

 

 

 

 

可说明调用的示例等

2

 

 

 

 

 

4.2 外部调用

序号

功能说明

页面调用路径

入参

出参

备注

1

 

 

 

 

可说明提供方的相关信息

2

 

 

 

 

 

 

5 Tuxedo接口

没有此接口方式可删除此章节目录。

5.1 接口功能1

如提供给银行的“查询电费”功能,一些需要说明的信息在此说明;如果功能比较复杂,可以根据需要设立下级子功能的目录结构。TUXDEO服务的使用表格描述。

 

5.1.1 接口子功能1

如果功能简单,此级目录可以不要,使用TUXDEO服务表格描述。

TUXDO接口服务表格如下:

服务名称

说明服务的CODE和名称

描述

 

输入参数

参数名称

数据长度

参数说明

 

 

 

输出参数

参数名称

数据长度

参数说明

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

错误信息

 

部署情况

 

示例

使用开发代码举例说明如何调用

 

5.1.2 接口子功能2

结构示意如果功能简单,此级目录可以不要。

 

 

 

 

6 WebService服务接口

没有此接口方式可以删除此目录

6.1 接口综述

综述WebService接口相关的技术,如简介认证、压缩、数据规约及需要描述的一些规定等,根据需要增加下级目录说明,下述目录为建议性质.

6.1.1 WebService概述

本节可根据需要增删。

6.1.2 认证机制

本节可根据需要增删。

说明认证机制

6.1.3 数据规约

说明格式约定、DTD

 

6.2 接口功能1

如提供给银行的“查询电费”功能,一些需要说明的信息在此说明;如果功能比较复杂,可以根据需要设立下级子功能的目录结构。Webservice服务的使用表格描述。

6.2.1 接口子功能1

如果功能简单,此级目录可以不要,使用Webservice服务表格描述。

Webservice接口服务表格如下:

方法名称

说明服务的CODE和名称

描述

 

发布路径

 

输入参数

参数代码

参数名称

数据类型

参数说明

 

 

 

 

输出参数

参数代码

参数名称

数据类型

参数说明

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

错误信息

 

 

 

部署情况

 

 

示例

使用开发代码举例说明如何调用

 

 

 

 

7 文件接口

7.1 文件名称

说明传输文件的名称规则及格式,如MRDATA.DBF

7.2 文件格式定义

根据需要,说明文件的列分割,行分割等条件,建议用表格方式。例如字段可以使用下列表格。

序号

字段中文名

字段英文名

字段类型

字段含义

1

抄表接口数据标识

DATA_ID

NUMBER(15)

本实体记录的唯一标识,产生规则为流水号。

下装时填写

2

申请编号

APP_NO

VARCHAR2(16)

流程实例的唯一标识,可自行编码。

下装时填写

 

7.3 传输方法

说明定期传递, FTP或者指定目录等,如果使用方法,则参照类似格式:

功能说明

向抄表机中传输文件

调用位置

例如DLL/OCX等文件的路径名称等,如sendFileToHc.dll

函数方法

Public String qryOwe(String szStringRequest) throws RemoteException, Uexception, Exception;

输入参数

参数代码/名称

数据类型

参数说明

PORT

char

通讯端口号,参见标准代码PORT_NO

BAUDRATE

char

通讯波特率,参见标准代码BAUD_RATE

 

 

 

输出参数

参数代码/名称

数据类型

参数说明

 

 

 

示例

int SendFileToHc(char PORT,char BAUDRATE,char DATAFILE, char APPFILE, char PROMPT);

SendFileToHc(1, ‘05,C:\F1.DBF; F2.DBF, C:\F3.dwn; F4.mid’,1);

注:参数11表述端口号为COM1,见标准代码PORT_NO

参数205表示波特率为115.2k,见标准代码BAUD_RATE

参数3F2.DBF的路径同F1.DBF的路径。

参数4F4.mid的路径同F3.dwn的路径。

 

 

 

7.4 {其他约定}

标题名称自定,例如可以约定目录结构、某某协议内容等,自行扩展。

 

8 标准代码

约定的标准参数代码、返回代码等,自行扩展。

 


你可能感兴趣的:(开源系统及开发API)