数据交换接口规范.docx

附件4：数据交换接口规范
一、概述
计量器具检定数据交换接口采用Webservice作为数据传输机制，是自包含、自描述（WSDL）、模块化的应用，由省局发布、定位、各技术机构通过web方式调用。接口基于标准的互联网协议，支持超文本传输协议(HTTP)和XML。与省局交换的数据都封装成XML格式的文件，传输前以GZIP格式将文件压缩，然后设置BASE64编码，最后在接收端将其解压，解析读取数据。
二、软件准备
JDK1.6，tomcat6.0，Webservice相关包以及数据库。
三、数据交换示意图

四、服务端接收数据过程
用户合法性校验：服务端在接收数据时同样需要进行用户合法性校验，并返回信息。
数据封装：为方便数据传输和解析，客户端通过Webservice交换的数据需要封装成可扩展标记语言XML的规范，并严格按照此规范。
数据压缩：为提高数据的传输效率和减小传输的数据量，客户端在传输之前需将数据以GZIP格式进行压缩，并设置BASE64位编码，以便基于HTTP传输。
对上传文件进行规范性校验：服务端在接收数据之前，校验客户端数据是否按照XML规范要求，并按GZIP格式进行压缩，设置BASE64编码，否则返回不合法文件格式。
返回结果：服务端进行完校验，解析成功并反馈给业务系统后，会反馈成功信息给客户端，如不成功则返回不成功。
五、客户端接收数据过程（与服务端接收过程类似。）
六、术语说明
关键词描述Webservice网络服务是一些自包含和自描述的应用程序组件，网络服务的通讯使用了开放性协议，可被其他应用软件使用。XML网络服务的基本要素，在通信服务接口中，服务的参数和返回值都是XMLBASE64编码网络上最常见的用于传输8Bit字节代码的编码方式之一WSDLWebservice描述语言(WSDL)是基于XML的语言，用于描述Webservice及其函数、参数和返回值GZIPGZIP是Internet上使用非常普遍的一种数据压缩格式，或者说一种文件格式SOAP简单对象访问协议（SOAP）是一种轻量的、简单的、基于XML的协议，它被设计成在WEB上交换结构化的和固化的信息