Webservices开发文档

Webservices开发文档<o:p></o:p>

1. 主要内容包括<o:p></o:p>

1、关于webservice的基本概念<o:p></o:p>

2、Axis相关概念和命令。<o:p></o:p>

3、开发和测试工具，代码实例。<o:p></o:p>

4、开发客户端和服务器端的开发流程。<o:p></o:p>

5、开发的详细的命令介绍。<o:p></o:p>

6、如何测试的方法。<o:p></o:p>

7、发布的步骤。<o:p></o:p>

8、日志跟踪机制。<o:p></o:p>

9、其他优秀文章。 <o:p></o:p>

10、             相关参考资料的介绍。<o:p></o:p>

11、             其他文档的发布路线图。<o:p></o:p>

2. Web Service基本概念<o:p></o:p>

2.1   什么是 Webservice？<o:p></o:p>

WebServices 是使应用程序可以以与平台和编程语言无关的方式进行相互通信的一项技术。Web 服务是一个软件接口，它描述了一组可以在网络上通过标准化的 XML 消息传递访问的操作。它使用基于 XML 语言的协议来描述要执行的操作或者要与另一个 Web 服务交换的数据。一组以这种方式交互的 Web 服务在面向服务的体系结构（Service-Oriented Architecture，SOA）中定义了特殊的 Web 服务应用程序。<o:p></o:p>

2.2    基本组成<o:p></o:p>

webservices由两部分组成:<o:p></o:p>

·SOAP--Web Service之间的基本通信协议。<o:p></o:p>

·WSDL--Web Service描述语言，它定义了Web Service做什么，怎么做和查询的信息。<o:p></o:p>

2.3    什么是SOAP？<o:p></o:p>

SOAP（Simple Object Access Protocol ）简单对象访问协议是在分散或分布式的环境中交换信息并执行远程过程调用的轻量级协议，是一个基于XML的协议。使用SOAP，不用考虑任何特定的传输协议（最常用的还是HTTP协议），可以允许任何类型的对象或代码，在任何平台上，以任何一种语言相互通信。<o:p></o:p>

SOAP包括四个部分：SOAP封装(envelop)，封装定义了一个描述消息中的内容是什么，是谁发送的，谁应当接受并处理它以及如何处理它们的框架；SOAP编码规则（encoding rules），用于表示应用程序需要使用的数据类型的实例；SOAP RPC表示(RPC representation)，表示远程过程调用和应答的协定；SOAP绑定（binding），使用底层协议交换信息。<o:p></o:p>

应用中比较关注的是envelop，由一个或多个Header和一个Body组成。<o:p></o:p>

SOAP在可互操作的基础 Web 服务协议栈中的位置。<o:p></o:p>

2.4    什么是WSDL？<o:p></o:p>

WSDL（Web Service Description Language）Web服务器描述语言是用XML文档来描述Web服务的标准，是Web服务的接口定义语言，由Ariba、Intel、IBM、MS等共同提出，通过WSDL，可描述Web服务的三个基本属性：<o:p></o:p>

·服务做些什么——服务所提供的操作（方法）<o:p></o:p>

·如何访问服务——和服务交互的数据格式以及必要协议<o:p></o:p>

·服务位于何处——协议相关的地址，如URL<o:p></o:p>

WSDL文档以端口集合的形式来描述Web服务，WSDL 服务描述包含对一组操作和消息的一个抽象定义，绑定到这些操作和消息的一个具体协议，和这个绑定的一个网络端点规范。<o:p></o:p>

WSDL在Web 服务概念性协议栈中的位置。<o:p></o:p>

WSDL描述语言一般包含三部分<o:p></o:p>

       What部分：包括了type、message和portType元素<o:p></o:p>

Type：定义了Web Service使用的数据结构（使用XML Schema定义）<o:p></o:p>

Message：一个Message是SOAP的基本通信元素。每个Message可以有一个或多个Part，每个Part代表一个参数。<o:p></o:p>

PortType：消息汇总为不同的操作并归入到一个被称为portType的实体中。一个portType代表一个接口（Web Service支持的操作集合），每个Web Service可以有多个接口，它们都使用portType表示。每个操作又包含了input和 output部分。<o:p></o:p>

       How部分：包含binding元素
binding元素将portType绑定到特定的通信协议上（如HTTP上的SOAP协议）<o:p></o:p>

      Where部分：由service元素组成<o:p></o:p>

它将portType,binding以及Web Service实际的位置（URI）放在一起描述<o:p></o:p>

2.5    什么是WSDD？<o:p></o:p>

WSDD就是WEB服务分布描述（Web Service Deployment Descriptor）, 它定义了WEB服务的接口，如服务名、提供的方法、方法的参数等信息。<o:p></o:p>

2.6    什么是UDDI？<o:p></o:p>

UDDI就是统一描述、发现和集成（Universal Description, Discovery, and Integration）。UDDI用于集中存放和查找WSDL描述文件，起着目录服务器的作用。<o:p></o:p>

Web 服务中的角色、操作和构件。<o:p></o:p>

服务提供者。从企业的角度看，这是服务的所有者。从体系结构的角度看，这是托管访问服务的平台。 <o:p></o:p>

服务请求者。从企业的角度看，这是要求满足特定功能的企业。从体系结构的角度看，这是寻找并调用服务，或启动与服务的交互的应用程序。服务请求者角色可以由浏览器来担当，由人或无用户界面的程序（例如，另外一个 Web 服务）来控制它。 <o:p></o:p>

服务注册中心。<o:p></o:p>

这是可搜索的服务描述注册中心，服务提供者在此发布他们的服务描述。在静态绑定开发或动态绑定执行期间，服务请求者查找服务并获得服务的绑定信息（在服务描述中）。对于静态绑定的服务请求者，服务注册中心是体系结构中的可选角色，因为服务提供者可以把描述直接发送给服务请求者。同样，服务请求者可以从服务注册中心以外的其它来源得到服务描述，例如本地文件、FTP 站点、Web 站点、广告和服务发现（Advertisement and Discovery of Services，ADS）或发现 Web 服务（Discovery of Web Services，DISCO）。<o:p></o:p>

2.7    客户端和服务器端<o:p></o:p>

<st2:chsdate isrocdate="False" month="12" day="30" islunardate="False" w:st="on" year="1899">2.7.1</st2:chsdate>    客户端<o:p></o:p>

根据wsdl文件生成的一组相关的客户端类。然后，通过wsdl地址可以访问其他系统或应用所提供的功能。<o:p></o:p>

通常Web Service可以有三种类型的客户<o:p></o:p>

       商业伙伴（Business Partner）--包括分发商，零售商以及大型消费者）<o:p></o:p>

此类客户通过SOAP、WSDL、ebXML、UDDI等XML技术与Web Service连接<o:p></o:p>

         瘦客户--包括Web浏览器、PDA以及无线设备<o:p></o:p>

该类客户通常经由轻量协议(如HTTP)与Web Service连接<o:p></o:p>

        肥客户--包括Applet、各类应用以及现存系统
通常使用重量级协议（如IIOP）连接Web Service<o:p></o:p>

<st2:chsdate isrocdate="False" month="12" day="30" islunardate="False" w:st="on" year="1899">2.7.2</st2:chsdate>     服务器端<o:p></o:p>

也就是对外提供的一个接口（本质上就是：方法），让其他不同的系统或应用可以来进行访问，本系统的功能。它包括的内容：<o:p></o:p>

1．一个对外接口<o:p></o:p>

2．该接口的实现类<o:p></o:p>

3．一个部署描述文件，描述这个服务（接口）。部署文件中的服务的信息，是可以通过axis的命令来生成的。 <o:p></o:p>

这些文件都是将包含在一个完整的web应用中的，当启动web容器的时候，就可以其他系统进行访问了。<o:p></o:p>

<!---->3       <!---->.Axis概念、命令和方法<o:p></o:p>

3.1     AXIS详细介绍 <o:p></o:p>

Apache Axis 是Apache WebService项目中的子项目，其最初起源于IBM的"SOAP4J"，应该属于最早的一批用于构造基于SOAP应用的Framework。 目前Apache Axis已经发展到了第三代，其核心是一个SOAP处理器，用于开发包括客户端，服务器端，SOAP Gateway等各种应用。事实上Apache Axis在了1.0版后，其发行版本还包括了完整的J2EE服务器插件, WSDL支持和生成，TCP/IP监视器等组件，从这个意义上来说Apahce Axis已不仅仅是个SOAP框架了，它包含了除了UDDI外对整个Web Service协议栈(Protocol Stack)的支持。<o:p></o:p>

3.2   Axis工具简单操作命令和基本概念<o:p></o:p>

1．显示帮助信息：java -Djava.ext.dirs=lib org.apache.axis.wsdl.WSDL2Java <o:p></o:p>

生成客户端代码实例：前提是必须的在dos切换到axis的lib目录。然后执行这个命令。 java -Djava.ext.dirs=lib org.apache.axis.wsdl.WSDL2Java -a -H -d -s -t -S true -p com.xino.adc.webServices http://192.168.6.15/ADCWeb/HzGsyj.asmx?wsdl<o:p></o:p>

2．WSDL2Java工具用于从WSDL文件生成客户端存根（stub）代码，服务端框架（skeleton）代码以及WSDL中的数据类型文件(生成与之对应的Java代码)。<o:p></o:p>

Wsdl2java命令参数参考：<o:p></o:p>

-h, --help<o:p></o:p>

 打印帮助信息后退出<o:p></o:p>

-v, --verbose<o:p></o:p>

 打印报告信息<o:p></o:p>

-n, --noImports<o:p></o:p>

 只生成直接的WSDL代码文档<o:p></o:p>

-O, --timeout <argument><o:p></o:p>

 超时秒数(默认45秒, -1表示不限定)<o:p></o:p>