webservice学习笔记

   近期公司需要开发webservice,在网上找了一些资料，发现基础很重要，有基础才能看明白别人的残码，摘取了一些自己觉得有用的文章。以备其它人学习，看别人的残码。

   　Web Services简单的来说就是网络服务，譬如一个商业客户在网络上通过SOAP协议发送一个请求，服务端接收这个请求并处理它，然后发送一个响应给客户端。Web Service程序在服务端需要用容器配置，这个容器可以是一个Servlet容器，如：Tomcat或者是基于EJB之上的J2EE 容器。Web Service还用WSDL（Web Service Description Language）描述自己，这种描述包括Web Service的名字、可以被调用的方法名、这些方法的参数以及发送请求的位置等，这样用户就可以方便地通过WSDL去发现Web Service并取得服务，然后利用Java API for XML-based RPC（JAX-RPC）实现对Web Service的调用。

      JAX-RPC中有一个工具：xrpcc，它可以根据WSDL产生一个stub类作为客户端的代理，以及一个tie类作为服务端的代理。JAX-RPC将客户端调用转换成一个基于HTTP请求的SOAP消息发送给服务器，服务器收到客户请求，把SOAP消息转换成方法调用并调用服务器的Web Service方法，再通过JAX-RPC将结果包装成SOAP消息形式返回给客户。

　　用JAX-RPC开发Web Service非常的容易。一个Web Service有两个文件：一个是接口，用来定义Web Service的远端可以调用的方法；另外一个实现了这个接口方法的类。

　　举一个典型的例子，如有个商家想订购商品，他可以直接到去每一家供货商询问，但有一个方便的方法是通过UDDI（Universal Description，Discovery and Integration）注册中心去查找供货商，发现哪些才是自己要找的供货商。因为供货商在注册中心注册他们的Web Service，这样就能被网络潜在的客户所发现。
如定义了Web Service方法的接口：

　　package coffees;

　　import java.rmi.Remote;

　　import java.rmi.RemoteException;

　　public interface CoffeeOrderIF extends Remote {

　　public Coffee [] getPriceList() //Web Service方法

　　throws RemoteException;

　　public String orderCoffee(String coffeeName, int quantity) //Web Service方法

　　throws RemoteException;

　　}

　　实现了上述接口的类如：

　　package coffees;

　　public class CoffeeOrderImpl implements CoffeeOrderIF {

　　public Coffee [] getPriceList() throws RemoteException; {

　　//方法

　　}

　　public String orderCoffee(String coffeeName, int quantity)

　　throws RemoteException; {

　　//方法
　　}

　　定义了Web Service，客户就可以进行远端调用了。一个典型的客户调用程序如下：

　　package coffees;

　　public class CoffeeClient {

　　public static void main(String[] args) {

　　try {

　　CoffeeOrderIF coffeeOrder = new

　　CoffeeOrderServiceImpl().getCoffeeOrderIF();//调用服务端的Web Service方法

　　Coffee [] priceList =

　　coffeeOrder.getPriceList()://调用服务端的Web Service方法

　　for (int i = 0; i < priceList.length; i++) {

　　System.out.print(priceList[i].getName() + " ");

　　System.out.println(priceList[i].getPrice());

　　}

　　} catch (Exception ex) {

　　ex.printStackTrace();}}

      }

　　JAX-RPC可以创建基于RPC(remote procedure calls)和XML的“客户-服务”程序。因为使用的是分布的“客户-服务”模式，RPC机制能使客户运行其它系统的程序。

　　一个远端调用是靠基于XML技术之上的SOAP协议描述与传输的。SOAP协议定义消息封装结构，编码规则和一个描述响应的协定。这些调用和响应是靠SOAP传输的，目前JAX-RPC是基于SOAP1.1和HTTP1.1。

　　尽管JAX-RPC是依靠复杂的协议（SOAP），但JAX-RPC的API对开发者隐藏了复杂性。在服务端，开发者指定接口中可以被远端调用的方法，开发者可以写一个或多个类去实现这些方法。而客户端程序非常容易去编写。通过指定服务端的URI，客户可以简单的调用这些方法。

　　使用JAX-RPC，客户和服务器有一个非常大的优势：平台独立性。并且JAX-RPC不受限制，如：一个JAX-RPC客户能够调用不同平台的Web Service，反之亦然。

　　因为JAX-RPC是使用W3C（World Wide Web Consortium）技术，所以具有扩展性。

　　W3C包括：HTTP、SOAP和WSDL。

　　下面有一个简单的例子说明JAX-RPC的实现：

 

       　　微软公司提出.Net概念后很快就被认为是以后网络服务的发展方向，其中的Web service概念更被认为是将来的工业标准（其中的SOAP、WSDL、UDDI已经是标准了）。而作为微软公司的老对手SUN公司自然不甘心落后，不久就开发了SUN-ONE（Sun[tm] Open Net Environment）用来开发Web Services，并提供了Java WSDP(Java Web Services Developer Pack)工具包。

　　Web Services简单的来说就是网络服务，譬如一个商业客户在网络上通过SOAP协议发送一个请求，服务端接收这个请求并处理它，然后发送一个响应给客户端。Web Service程序在服务端需要用容器配置，这个容器可以是一个Servlet容器，如：Tomcat或者是基于EJB之上的J2EE 容器。Web Service还用WSDL（Web Service Description Language）描述自己，这种描述包括Web Service的名字、可以被调用的方法名、这些方法的参数以及发送请求的位置等，这样用户就可以方便地通过WSDL去发现Web Service并取得服务，然后利用Java API for XML-based RPC（JAX-RPC）实现对Web Service的调用。

　　举一个典型的例子，如有个商家想订购商品，他可以直接到去每一家供货商询问，但有一个方便的方法是通过UDDI（Universal Description，Discovery and Integration）注册中心去查找供货商，发现哪些才是自己要找的供货商。因为供货商在注册中心注册他们的Web Service，这样就能被网络潜在的客户所发现。

　　JAX-RPC中有一个工具：xrpcc，它可以根据WSDL产生一个stub类作为客户端的代理，以及一个tie类作为服务端的代理。JAX-RPC将客户端调用转换成一个基于HTTP请求的SOAP消息发送给服务器，服务器收到客户请求，把SOAP消息转换成方法调用并调用服务器的Web Service方法，再通过JAX-RPC将结果包装成SOAP消息形式返回给客户。

　　用JAX-RPC开发Web Service非常的容易。一个Web Service有两个文件：一个是接口，用来定义Web Service的远端可以调用的方法；另外一个实现了这个接口方法的类。

　　如定义了Web Service方法的接口：

　　package coffees;

　　import java.rmi.Remote;

　　import java.rmi.RemoteException;

　　public interface CoffeeOrderIF extends Remote {

　　public Coffee [] getPriceList() //Web Service方法

　　throws RemoteException;

　　public String orderCoffee(String coffeeName, int quantity) //Web Service方法

　　throws RemoteException;

　　}

　　实现了上述接口的类如：

　　package coffees;

　　public class CoffeeOrderImpl implements CoffeeOrderIF {

　　public Coffee [] getPriceList() throws RemoteException; {

　　//方法　　

      }

　　public String orderCoffee(String coffeeName, int quantity)

　　throws RemoteException; {

　　//方法　　

      }

　　定义了Web Service，客户就可以进行远端调用了。一个典型的客户调用程序如下：

　　package coffees;

　　public class CoffeeClient {

　　public static void main(String[] args) {

　　try {

　　CoffeeOrderIF coffeeOrder = new

　　CoffeeOrderServiceImpl().getCoffeeOrderIF();//调用服务端的Web Service方法

　　Coffee [] priceList =

　　coffeeOrder.getPriceList()://调用服务端的Web Service方法

　　for (int i = 0; i < priceList.length; i++) {

　　System.out.print(priceList[i].getName() + " ");

　　System.out.println(priceList[i].getPrice());

　　}

　　} catch (Exception ex) {

　　ex.printStackTrace();

　　}

　　}

　　}

　　JAX-RPC可以创建基于RPC(remote procedure calls)和XML的“客户-服务”程序。因为使用的是分布的“客户-服务”模式，RPC机制能使客户运行其它系统的程序。

　　一个远端调用是靠基于XML技术之上的SOAP协议描述与传输的。SOAP协议定义消息封装结构，编码规则和一个描述响应的协定。这些调用和响应是靠SOAP传输的，目前JAX-RPC是基于SOAP1.1和HTTP1.1。

　　尽管JAX-RPC是依靠复杂的协议（SOAP），但JAX-RPC的API对开发者隐藏了复杂性。在服务端，开发者指定接口中可以被远端调用的方法，开发者可以写一个或多个类去实现这些方法。而客户端程序非常容易去编写。通过指定服务端的URI，客户可以简单的调用这些方法。

　　使用JAX-RPC，客户和服务器有一个非常大的优势：平台独立性。并且JAX-RPC不受限制，如：一个JAX-RPC客户能够调用不同平台的Web Service，反之亦然。

　　因为JAX-RPC是使用W3C（World Wide Web Consortium）技术，所以具有扩展性。

　　W3C包括：HTTP、SOAP和WSDL。

　　下面有一个简单的例子说明JAX-RPC的实现：

　　1. 调用一个远端程序：HelloClient程序调用本地stub对象中描述远端Web Service的方法；

　　2. stub对象通过JAX-RPC系统调用程序；

　　3. 系统将远端程序调用转换成SOAP消息并通过HTTP把它传输到服务器去；

　　4. 当服务器接收到客户的SOAP消息，通过JAX-RPC系统将SOAP消息转换成方法调用；

　　5. 调用tie对象中的方法；

　　6. tie调用实现了HelloWorld服务的方法；

　　7. 系统将调用方法的结果转换成SOAP消息响应给客户；

　　8. 客户接收响应来的SOAP消息，分析它并取得方法调用的结果。

　　服务端程序如下：

　　定义Web方法的接口HelloIF.java：

　　package hello;

　　import java.rmi.Remote;

　　import java.rmi.RemoteException;

　　public interface HelloIF extends Remote {

　　public String sayHello(String s) throws RemoteException; // Web 方法，可以被客户调用

　　实现Web方法的类HelloImpl.java：

　　package hello;

　　public class HelloImpl implements HelloIF {

　　public String message ="Hello";

　　public String sayHello(String s) { //具体方法实现

　　return message + s;

　　}

　　}

　　客户程序HelloClient.java：

　　package hello;

　　import javax.xml.rpc.Stub;

　　public class HelloClient {

　　public static void main(String[] args) {

　　try {

　　Stub stub = createProxy();//实现远端调用的对象

　　stub._setProperty(

　　javax.xml.rpc.Stub.ENDPOINT_ADDRESS_PROPERTY,

　　args[0]);

　　HelloIF hello = (HelloIF)stub;

　　System.out.println(hello.sayHello("Duke!"));//调用服务端的方法

　　} catch (Exception ex) {

　　ex.printStackTrace();

　　}

　　}

　　private static Stub createProxy() {

　　// Note: HelloWorld_Impl is implementation-specific.

　　return (Stub)(new HelloWorld_Impl().getHelloIFPort());

　　}

　　}

　　当配置好服务端并编译了客户端HelloClient.java，可以运行客户程序如：ant run ，如果一切正确，将显示：

   webservice 三剑客 UDDI,SOAP,WSDL(web services description language).

   webservice 的实现方式有很多：axis,axis2,Xfire.

   axis支持三种webservice的部暑和开发：  1、Dynamic Invocation Interface ( DII)， 2、Stubs方式， 3、Dynamic Proxy方式。

 

 

一、概述

　　Web服务定义语言(Web Services Definition Language，WSDL)是一个建议性标准，用于描 述Web服务的技术调用语法。WSDL定义了一套基于 XML的语法，将Web服务描述为能够进行消息交换的服务访问点的集合，从而满足了这种需求。WSDL服务定义为分布式系统提供了可机器识别的SDK文档，并且可用于描述自动执行应用程序通信中所涉及的细节。WSDL的当前版本是1.1，规范可以从http://www.w3.org/TR/wsdl获得。　　WSDL就是描述XMLWeb服务的标准XML格式，WSDL由Ariba、Intel、IBM和微软等开发商提出。它用一种和具体语言无关的抽象方式定义了给定Web服务收发的有关操作和消息。就其定义来说，你还不能把WSDL当作一种对象接 口定义语言，例如，CORBA或COM等应用程序体系结构就会用到对象接口定义语言。 WSDL保持协议中立，但它确实内建了绑定SOAP的支持，从而同SOAP建立了不可分割的联系。　　WSDL服务描述是一个XML文档，它与WSDL模式(schema)的定义一致。WSDL文档并不是完整的服务描述，而只包括了服务描述任务的较低层次，即：服务接口的原始技术描述。WSDL是Web服务的接口定义语言IDL（Interface Definition Language，），本质上，WSDL描述说明的是Web服务的以下三个基本属性：　　服务做些什么--服务所提供的操作(方法)。
　　如何访问服务--数据格式详情以及访问服务操作的必要协议。
　　服务位于何处--由特定协议决定的网络地址，如URL。

二、WSDL文档结构

• WSDL信息模型充分利用了抽象规范与规范具体实现的分离方法，也就是分离了服务接口定义(抽象接口)与服务实现定义(具体端点)。
•  抽象接口规范描述了终端的处理能力，它在WSDL中表示为portType。
• 束定机制 (binding mechanism)在WSDL中表示为binding元素，它使用特定的通信协议、数据编码模型和底层通信协议，将Web服务的抽象定义映射至特定实现。
• 若束定结合了实现的访问地址，抽象端点也就成为可供服务请求者调用的具体端点(concrete endpoint)，WSDL的port元素表示了这一结合。
• 抽象接口可以支持任何数量的操作(operations)。
• 操作是由一组消息(messages)定义，消息定义了操作的交互定式。
• 与抽象的消息、操作概念相对应的具体实现是由binding元素指定。

与XML应用相同，WSDL模式定义了几个高层元素，或称为主要元素。在WSDL中，Web服务描述中的主要元素如下：

　　Types，定义了Web服务使用的所有数据类型集合，可被元素的各消息部件所引用。它使用某种类型系统(一般地使用XMLSchema中的类型系统)。

　　Message，通信消息数据结构的抽象类型化定义。使用Types所定义的类型来定义整个消息的数据结构。

　　Operation，对服务中所支持操作的抽象描述。一般单个Operation描述了一个访问入口的请求/响应消息对。

　　PortType，对于某个访问入口点类型所支持操作的抽象集合。这些操作可以由一个或多个服务访问点来支持。

　　Binding，包含了如何将抽象接口的元素(portType)转变为具体表示的细节，具体表示也就是指特定的数据格式和协议的结合；特定端口类型的具体协议和数据格式规范的绑定。

　　Port，定义为协议/数据格式绑定与具体Web访问地址组合的单个服务访问点。

　　Service，这是一个粗糙命名的元素，代表端口的集合；相关服务访问点的集合。

　因此，portType(与message和type元素的细节相结合)描述了Web服务是什么，binding元素描述了如何使用Web服务，port及service元素描述了Web服务的位置。

图1 WSDL信息模型

　　图1体现了WSDL信息模型的一个可能结构，它清楚反映了portType元素包含的抽象消息/操作和binding元素的具体消息/操作间的关系。图中的黑体字突出了WSDL规范中的术语。WSDL使用的元素名称有些含糊，由于不存在能够区分抽象和具体概念的一致命名原则，因此必须记住哪一个元素代表抽象概念，哪一个元素代表具体的概念。

2、WSDL对象结构图

　　从图2所示的WSDL对象结构图可知，一个WSDL文档中可以包含一个Types，多个Message、PortType、Binding和Service。

图2 WSDL对象结构图

　　其中，Types是一个数据类型定义的容器，包含了所有在消息定义中需要的XML元素的类型定义。　　Message具体定义了在通信中使用的消息的数据结构，Message元素包含了一组Part元素，每个Part元素都是最终消息的一个组成部分，每个Part都会引用一个DataType来表示它的结构。Part元素不支持嵌套(可以使用DataType来完成这方面的需要)，都是并列出现。　　PortType具体定义了一种服务访问入口的类型（传入/传出消息的模式及其格式），一个PortType可以包含若干个Operation，而一个Operation则是指访问入口支持的一种类型的调用。在WSDL里面支持四种访问入口调用的模式：1) 单请求; 2) 单响应; 3) 请求/响应; 4) 响应/请求。在这里请求指的是从客户端到Web服务端，而响应指的是从Web服务端到客户端。PortType的定义中会引用消息定义部分的一个到两个消息，作为请求或响应消息的格式。 　　Service描述的是一个具体的被部署的Web服务所提供的所有访问入口的部署细节，一个Service往往会包含多个服务访问入口，而每个访问入口都会使用一个Port元素来描述。　　Port描述的是一个服务访问入口的部署细节，包括通过哪个Web地址(URL)来访问，应当使用怎样的消息调用模式来访问等。其中消息调用模式则是使用Binding结构来表示。　　Binding结构定义了某个PortType与某一种具体的网络传输协议或消息传输协议相绑定，从这一层次开始，描述的内容就与具体服务的部署相关了。比如可以将PortType与SOAP/HTTP绑定，也可以将PortType与MIME/SMTP相绑定等。

　　3、WSDL文档类型

　　WSDL文档被分为两种类型：服务接口（service interface ）和服务实现（service implementations）。（如下图3所示）

图3 WSDL文档类型

　　服务接口由 WSDL文档来描述，这种文档包含服务接口的 types、import、message、portType 和 binding 等元素。服务接口包含将用于实现一个或多个服务的 WSDL服务定义。它是 Web 服务的抽象定义，并被用于描述某种特定类型的服务。　　通过使用一个 import 元素，一个服务接口文档可以引用另一个服务接口文档。例如，一个仅包含 message 和 portType 元素的服务接口可以被另一个仅包含此 portType 的绑定的服务接口引用。　　WSDL服务实现文档将包含 import 和 service 元素。服务实现文档包含实现一个服务接口的服务的描述。import 元素中至少会有一个将包含对 WSDL服务接口文档的引用。一个服务实现文档可以包含对多个服务接口文档的引用。　　WSDL服务实现文档中的 import 元素包含两个属性。namespace 的属性值是一个与服务接口文档中的 targetNamespace 相匹配的URL。location 属性是一个用于引用包含完整的服务接口定义的 WSDL文档的 URL。port 元素的 binding 属性包含对服务接口文档中的某个特定绑定的引用。　　服务接口文档由服务接口提供者开发和发布。服务实现文档由服务提供者创建和发布。服务接口提供者与服务提供者这两个角色在逻辑上是分离的，但他们可以是同一个商业实体。 　　一个完整的 WSDL服务描述是由一个服务接口和一个服务实现文档组成的。

　　4、WSDL工具

　　你可以手工创建WSDL文件，不过，你还可以采用相当多的工具通过WSDL来为你自动处理和定义Web服务。推荐工具软件如下：　　Omniopera----图形用户界面的WSDI、XML和XSD编辑器。
　　Microsoft的SOAP Toolkit----一种工具包，其中包括根据WSDL定义创建COM接口的向导程序，还包括根据COM接口创建WSDL的向导程序。
　　IBM的Web Services Toolkit----一种工具包，其中包括产生WSDL和SOAP部署说明的向导程序。