web服务的说明文档

web服务的说明文档篇一：websevice说明文档

Webservice接口描述

1. 接口文档(点击html文件查看

)

Longsuncard.html

2. 返回Return对象的subcode和submsg

001 = "人员编号不能为空";

002 = "人员名称不能为空";

003 = "人员编号已存在";

004 = "此人员编号不存在,或已删除";

005 = "此人员组织机构编号不能为空";

011 = "组织机构编号不能为空";

012 = "组织机构名称不能为空";

013 = "此组织机构编号已存在";

014 = "此组织机构编号不存在,或已删除";

015 = "组织机构父节点不能为空";

031 = "人员id不能为空";

032 = "有限时间不能为空";

033 = "读卡器编号不能为空";

034 = "此读卡器编号不存在,或已经删除";

035 = "此人员编号不存在,或已经删除";

036 = "有效期格式不正确,正确格式应该为:yyyy-mm-dd";

037 = "没有找到对应的信息,请核实";

038 = "该数据已存在";

041 = "会议地点不能为空";

042 = "会议开始时间不能为空";

043 = "会议结束时间不能为空";

044 = "会议开始时间格式不正确,正确格式应该为:yyyy-mm-dd hh:MM:ss"; 045 = "会议结束时间格式不正确,正确格式应该为:yyyy-mm-dd hh:MM:ss";

3. 对象说明(双击文档查看)

Webservice中对象说明

1，人员信息FkPersonnel

Integerid;//自增长ID

Stringpnum;//人员编号

Stringpname;//人员姓名

Stringpchar;//助记符

Integersex;//性别

Stringphoto;//人员照片路径

Integerage;//年龄

Stringorganizationid;//部门编号

Stringdocumentid;//证件名称

Stringdnum;//证件号码

Stringbirthday;//出生年月

Integerpositions;//职务

Stringptitle;//职称

Stringpnational;//民族

Stringaccount;//户口

Stringorigin;//籍贯

Integerpsort;//人员类别

Stringadderss;//地址

Stringremark;//备注

Integerpstate;//人员状态

Stringmobiletel;//手机

Stringtel;//电话

Stringemail;//邮箱

Stringpassword;//自助密码

2，部门信息FkOrganization

Stringorgnum;//部门编号

Stringoname;//部门名称

Integeronumber;//人数

Stringoperson;//负责人

Stringorespons;//职责

Stringoremark;//备注

Stringofatherid;//父节点ID

Integerostate;//状态

3，权限信息LmNewmjProle

Integerpid;//人员ID

Integertimeid;//时间表编号

Stringvdate;//有效期

Integerrdid;//读卡器ID

Integerisdown;//是否下载

web服务的说明文档篇二：详细设计说明书(web)

目录

第一章 绪论 ........................................................................................ 1

1.1课题简介 ................................................................................................... 1

1.2设计目的 ................................................................................................... 1

1.3设计内容 ................................................................................................... 2

第二章 需求分析 ................................................................................ 4

2.1 需求分析的任务 ...................................................................................... 4

2.2 需求分析的过程 ...................................................................................... 4

2.3 数据字典 .................................................................................................. 5

第三章 概念结构设计 ........................................................................ 9

3.1 概念结构设计的方法与步骤 .................................................................. 9

3.1.1 概念结构设计的方法 .................................................................................... 9

3.1.3 概念结构设计的步骤 .................................................................................... 9

3.2 数据抽象与局部视图设计 ...................................................................... 9

3.3视图的集成 ............................................................................................. 10

第四章 逻辑结构设计 ...................................................................... 12

4.1 ER图向关系模型的转换 ....................................................................... 12

4.2 数据模型的优化 .................................................................................... 12

4.3 数据库的结构 ........................................................................................ 13

第五章 数据库的实施与运行 .......................................................... 16

5.1 数据的载入 ............................................................................................ 16

5.2 数据库的运行 ........................................................................................ 16

总 结 .................................................................................................. 30

第一章 绪论

1.1课题简介

信息时代已经来临,信息处理的利器——计算机应用于火车站售票的日常管理为

火车站售票的现代化带来了从未有过的动力和机遇，为火车站票务管理领域的飞速发展提供了无限潜力。采用计算机管理信息系统已成为火车站票务管理科学化和现代化的重要标志，给火车站票务带来了明显的经济效益和社会效益。在此背景下，本文论述了列车票务管理系统（的设计实现。通过对各种数据库管理系统的模型分析，结合火车站票务销售查询过程的实际需求，同时本文还说明了火车订票管理系统的开发过程及各种技术细节。本系统是适应时代发展的需要，提高管理的效率而开发设计的。 列车票务管理系统的主要任务，通过实现票务信息的计算机管理，以提高工作效率。实现计算机管理的最佳技术就是数据库技术。我们可以利用数据库将整个火车站的票务情况存入计算机，再配置上功能丰富的用户接口，以满足用户需求。一个火车站售票信息管理系统应达到的目标是提供及时、广泛的信息服务，加快信息检索的效率，实况灵活的查询，减轻管理人员制作报表和统计分析的负担，且系统规模不太大但又要保证支持日常工作的要求，以便系统应易于扩充，方便日后统一联网与管理，提高管理水平。

考虑到售票员对售票事务起着直接的作用,所以我们讨论认为系统对售票员来进行管理是非常有必要的,所以在课程设计中加入了售票员登陆这一功能,只有售票员输入唯一的工作证号和正确的密码之后才能进行正常的售票工作,这样也方便了铁路部门对售票员的考勤和统计售票员的工作成绩.售票是以已有的列车资源为基础,在系统中有列车管理功能,可以新增车次,修改车次和撤消车次,这些选择可由已售出的列车票表信息提供参考。系统根据已售票和已退票进行各种汇总,统计.

1.2设计目的

在当今社会，计算机占据了非常重要的位置，这些大部分都是通过使用软件而提

高生产、管理效率来体现的。本文研究的火车票售票系统正好就是这样性质的一个软件。铁路运输一直都是我国重要的经济命脉，而且由于我国是内陆国家，这铁路运输的意义就显得更加突出了，对于这样重要的一件事，当然需要良好的管理了。经过几

十年的发展，事实早就证明了使用计算机软件来辅助自己比单纯的人工处理手段高明的多，在这样的背景下，研究这样的课题的意义也就不言而明了。

在以前，像售票这样的事，都是人工处理的，人工处理的缺点是显而易见的，成本大、处理的速度慢、出错的几率比较大，效率是很低的。现在，在世界各国，火车售票使用的基本上都是员工操作计算机的模式，在这里，计算机主要是借助软件用来存储、更新数据的，并有统计帐目的功能。严格的说，这并不是智能化，但是，这样的处理模式比已往的人工处理的好处显然还是很明显的，所有的数据都由数据库管理，可以随时动态的提取、存储数据，并可以将修改后的数据覆盖掉原有的数据；使用售票软件，虽然公司需要投入一定的资金，但同时却可以使处理速度成倍、成十倍的增加，使在固有的时间内能让尽量多的旅客办理完手续，增加了销售收入，而且可以减少员工数量，是公司更加精简；由于计算机是一种高精度的机器，所以使用计算机软件辅助后，出错的几率也就变得非常低了。

1.3设计内容

1．需求分析

需求分析的任务是准确了解并分析列车票务管理系统的需要和要求，弄清列车票

务管理系统要达到的目标和实现的功能，得到数据字典和数据流图。

2．概念结设计

将需求分析得到的用户需求抽象为信息结构即概念模型（ER图）。先逐一设计

ER图，然后集成得到的ER图，最后通过消除不必要的冗余，设计基本ER图。

3．逻辑设计

逻辑设计的任务就是把概念设计阶段设计好的基本ER图转换为与选用的DBMS

产品所支持的数据模型相符合的逻辑结构。首先按照ER图向数据模型转换的规则，将概念结构转换为DBMS所支持的数据模型；然后对数据模型进行优化，得到至少5个关系模式。

4．数据库的实施

（1）表的建立

需要明确数据库需要建立多少表，以及每个表中所要包括的内容。在建立表的过

程中。要对每个表进行字段属性的设置。

（2）表之间关系的设置

为数据库设置了不同的表之后必须告诉DBMS如何将这些信息合并在一起，因此

要定义表之间的关系。

（3）完成相关查询包括已售出的列车票表信息、预定车票、售票、退票、车次查询、报表、列车管

理功能,可以新增车次,修改车次和撤消车次等功能。

第二章 需求分析

第二章 需求分析

2.1 需求分析的任务

随着旅游业的逐渐的成熟发达，铁路客运量大幅度的提高，各大省市的列车都显著的增加，这些都对列车票务管理系统提出了更高的要求，所以要不断的完善更新列车票务管理系统，提高列车售票系统的工作效率。随着科学的不断进步，计算机应用已经遍布整个社会的每个角落。目前社会正处于健保发展方兴未艾的时代，各火车站莫不兢兢业业地改善本身的体制或管理方式，以适应健保越来越严格的规范。列车在我国的人员流动、物资运输中占据着举足轻重的地位。全国有大量的人员通过搭乘火车到达目的地。而与火车的特殊性及可能经过多个城市，每个城市的车站可以出售此火车的车票。而且同一车站可能有多辆车经过。许多希望以最快的方式选择自己想来乘坐的那一趟列车。所以以人工的方式是不可能实现这种功能的。一种可行的方案是基于客户端服务器的体系结构。服务器为数据库系统，存储所有必要的信息。客户端通过连接到服务的应用程序快速、准确地完成相应的工作。列车票务管理系统的实施，将会在一定程度上促进铁路客运生产力和生产关系的变革，增强市场竞争能力，提高铁路部门的工作效率，提升管理水平，减少劳动强度，方便广大旅客购票，有一定的社会和经济效益。

2.2 需求分析的过程

列车票务管理是铁路运输业务管理的一项最基本业务。表面上看，它只是铁路运输业务的一个简单部分，但是它涉及的业务量大、客户多，还

涉及资金管理与客户服务等多方面，因此这项业务关不像看上去那么简单。过去传统的售票方式已不能满足现代铁路运输业务流量剧增的客观要求，本系统便是利用目前最先进、最新型的开发工具DB2开发一个列车票务管理系统。它能方便快捷地运用在火车业务的营运之中。列车在我国的人员流动、物资运输中占据着举足轻重的地位。全国有大量的人员通过搭乘火车到达目的地。而与火车的特殊性及可能经过多个城市，每个城市的车站可以出售此火车的车票。而且同一车站可能有多辆车经过。许多希望以最快的方式选择自己想来乘坐的那一趟列车。所以以人工的方式是不可能实现这种功能的。一种可行的方案是基于客户端服务器的体系结构。服务器为数据库系统，存储所有必要的信息。客户端通过连接到服务的应用程序快速、准确地完成相应的工作。

web服务的说明文档篇三：Webservice配置说明文档

1: 从专门的webservice网站获取WSDL描述文件。

.cn/zh_cn/web_services.aspx?offset=2

这里我采用QQ在线状态查询服务。

2: 下载wdsl文件的方式为在wsdl地址上右键另存为。

3: 使用已经下载好的gsoap工具进行头文件编译。具体方式如下

(1) 通过命令行，进行gsoap目录下的bin文件夹中。 (2) 键入命令wsdl2h -o <具体wsdl全路径名>回车即可 如果正确编译则会出现类似下面的信息。

我的gsoap工具目录为D:\Program Files\gsoap\bin\win32 我的wsdl描述文件目录为e:\qq_online_query.wsdl

编译完的头文件路径为D:\Program Files\gsoap\bin\win32\onlineQuery.h

4: 通过编译好的头文件再使用soapcpp2进行存根文件编译。编译好的一些存根文件则包

含了代理类，以及代理类的输入，输出参数的结构描述。 如果需要STL支持则需要将对应的头文件拷贝到编译目录(和上面的onlineQuery.h同目录下)。 键入编译命令正常完成状态应该如下

编译完成后则将需要的文件拷贝到自己的工程中进行使用。

值得注意的是上面编译选项使用了-C ，代表只生产客户端client需要的文件，默认是服务端和客户端都生成。注意选项参数C为大写，小写代表的意义为编写为纯C格式文件，在C++项目中会出现编译问题。

注意拷贝的时候需要将其中的一个.nsmap命令空间声明文件一同拷贝到项目目录下。

还需要soap自己的stdsoap.h stdsoap.cpp两个文件。我们需要直接使用的一般是代理类。 *Proxy.h文件。

在引用的时候，直接使用

#include"*.nsmap" //来包含命令空间文件

#include"soapH.h"

#include"*Proxy.h"

注意：如果生成有 *ClientLib.cpp则不用/不要加入工程

//以及代理类头文件

创建服务&发布服务&调用服务

1: 创建服务

(1) 声明服务函数体

函数名必须以“ns__”开始,否则soap工具无法完成存根文件编译。

(2) 使用gsoap工具进行存根文件编译。正常完成编译控制台信息应该如下图

-S是指只编译服务端存根文件， -I是指编译的类继承自soap结构。

完成后会生成ns.nsmap命名空间文件 , soapC.cpp ,soapH.h , soapService.cpp

soapService.h ,soapStup.h

技巧: 可以使用-p命令来对生成的文件重命名

如上面的想改成同服务功能贴切(GetNode)

则可以使用下面形式的命令

Soapcpp2 –S –I –pGetNodesensor.h

注:在编译的时候需要将soap自带import文件夹中的stlvectory.h文件拷贝到编译目录才能成功。

(3) 将生成的文件(.cpp , .h , .nsmap)拷贝到工程目录下，并将其加入控制。

记得拷贝soap自己的stdsoap2.cpp，stdsoap2.h文件。

并将必要的预编译头#include"stdafx.h"加上,并要在stdsoap2.cpp中加入命名空间引用。

(4) 这个时候应该还是会提示link错误，原因是存根文件只生成了接口文件，但并没有

给出你提供的服务函数的函数体。需要在service中创建函数体。

(5) 创建完服务函数，则需要启动服务，在主程序中。使用service类创建一个对象，并

run起来(这个时候处于阻塞状态，所以建议使用多线程来运行服务。)

2: 发布服务

(1) 服务端的工装已经完成，需要将服务发布给客户端进行调用。

将服务端创建存根文件时，生成的ns.wsdl服务描述文件发布给调用客户端。

客户端则根据这个描述文件来创建客户端存根文件。

使用如下命令wsdl2h –o <生成的文件名.h><描述文件名.wsdl>

-o是指output to file。命令运行正常应该状态如下

(2) 再将刚刚生成的头文件，编译为存根文件。

Soapcpp2 –C <头文件名>

这条命令同样可以使用–p重命名参数进行重命名操作。

正常运行状态如下

(3) 将生成的*H.h , *C.cpp , *client.cpp , *.h , *proxy.h,*stup.h拷贝到工程目录下。进行

和服务端类型修改编译。

(4) 调用则是直接使用proxy文件中的代理类来完成。

(5) 服务端需要手动添加服务关闭代码。

(6) 在service类中添加函数

void {}; Close() soap_end(this); soap_done(this); 调用该函数后可以再次使用run进行服务开启

采用XML方式进行数据收集