一个简单WEBSERVICE应用的开发、部署、及各部分意义

最重要的事情是协同工作

由于所有主要的平台均可通过 Web 浏览器来访问 Web，不同的平台可以借此进行交互。为了让这些平台协同工作，Web 应用程序被开发了出来。

Web 应用程序是运行在 Web 上的简易应用程序。它们围绕 Web 浏览器标准被进行构建，几乎可被任何平台之上的任何浏览器来使用。

Web services 把 Web 应用程序提升到了另外一个层面

通过使用 Web services，您的应用程序可向全世界发布功能或消息。

Web services 使用 XML 来编解码数据，并使用 SOAP 借由开放的协议来传输数据。

通过 Web services，您的会计部门的 Win 2k 服务器可与 IT 供应商的 UNIX 服务器进行连接。

Web services 有两种类型的应用：

1.可重复使用的应用程序组件

有一些功能是不同的应用程序常常会用到的。那么为什么要周而复始地开发它们呢？

Web services 可以把应用程序组件作为服务来提供，比如汇率转换、天气预报或者甚至是语言翻译等等。

比较理想的情况是，每种应用程序组件只有一个最优秀的版本，这样任何人都可以在其应用程序中使用它。

2.连接现有的软件

通过为不同的应用程序提供一种链接其数据的途径，Web services有助于解决协同工作的问题。

通过使用 Web services，您可以在不同的应用程序与平台之间来交换数据。

本文webservice应用测试用例使用Myeclipse8.5进行开发、Tomcat6进行部署

一、让你的webservice工程SayHello

1、JAX-WS介绍

 JAX-WS规范是一组XML web services的JAVA API。

2、开发步骤

 基于JAX-WS的WebService开发步骤如下：

 2.1新建一个Web Service Project工程。选择File->New->WebService Project，取名为WebServicePro（JAX-WS支持只在javaEE5或更高版本中可行），如下图：

2.2创建服务类。服务类就是一个普通java类，负责提供我们想要发布的执行方法。在这里我们写一个简单的SayHello类，如下：

package com.mywebservice.ws;
public class SayHello
{
public String sayHello(String name)
{
return "Hello " name;
}
}

 2.3  创建一个Web Service。选择File->New->others->Myeclipse->WebService->webService，点击之后，在Strategy中选择Bottom-up scenario，如下图：

在最后一个屏幕，需要选择提供WebService方法的javaBean，在这里就是已经建立好的SayHello类，如下图：

填好之后，选择GenerateWSDL in project并点击完成。Myeclipse会自动生成SayHelloDelegate代理类。

到此web service已经建立好了，生成的工程结构图为：

二、配置文件解析

1、主要的配置文件为*.wsdl，即webservice的描述文件。在本文应用中的SayHelloService.wsdl为：

<?xml version="1.0" encoding="UTF-8"?>
<!-- Generated by JAX-WS RI at http://jax-ws.dev.java.net. RI's version is JAX-WS RI 2.1.3-hudson-390-. -->
<definitions xmlns="http://schemas.xmlsoap.org/wsdl/" xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/" xmlns:tns="http://ws.mywebservice.com/" xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd" xmlns:xsd="http://www.w3.org/2001/XMLSchema" name="SayHelloService" targetNamespace="http://ws.mywebservice.com/">
 <!-- 
 * types元素，描述web service使用的数据类型。
 * 为了实现最大的互操作性（interoperability）和平台中立性（neutrality），WSDL选用XML Schema DataTypes来定义数据类型。
 * 简称XSD作为标准类型系统，并将它作为固有类型系统（本例中为：SayHelloService_schema1.xsd）。
 -->
  <types>
    <xsd:schema>
      <xsd:import namespace="http://ws.mywebservice.com/" schemaLocation="SayHelloService_schema1.xsd"/>
    </xsd:schema>
  </types>
  <!-- 
 * message元素，描述web service使用的消息。
 * 该元素定义一个操作的数据元素。每个消息均由一个或多个部件组成。可以把这些部件比作传统编程语言中一个函数调用的参数。
 * 该部分是信息格式的抽象定义：定义了两个消息sayHelloResponse和sayHelloRequest：
 * sayHelloRequest：sayHello操作的请求消息格式，由一个消息片断组成，名字为parameters,
 * 元素是我们前面定义的 types中的元素；
 * sayHelloResponse：sayHello操作的响应消息格式，由一个消息片断组成，名字为parameters,
 * 元素是我们前面定义 *的types中的元素；
 * 如果采用RPC样式的消息传递，只需要将文档中的element元素应以修改为type即可。
  -->
  <message name="sayHello">
    <part element="tns:sayHello" name="parameters"/>
  </message>
  <message name="sayHelloResponse">
    <part element="tns:sayHelloResponse" name="parameters"/>
  </message>
   <!-- 
 * portType元素，描述web service执行的操作。
 * 这是最重要的 WSDL 元素。它可描述一个 web service可被执行的操作，以及相关的消息。
 * 可以把 <portType> 元素比作传统编程语言中的一个函数库（或一个模块、或一个类）。
 * 每个操作关联一个输入消息和一个输出消息。
 * portType定义了服务的调用模式的类型，这里包含一个操作sayHello方法，同时包含input和output表明
 * 该操作是一个 请求／响应模式，请求消息是前面定义的sayHelloRequest，
 * 响应消息是前面定义的 sayHelloResponse。input表示传递到Web服务的有效负载，
 * output消息表示传递给客户的有效负载。
  -->
  <portType name="SayHelloDelegate">
    <operation name="sayHello">
      <input message="tns:sayHello"/>
      <output message="tns:sayHelloResponse"/>
    </operation>
  </portType>
  <!--
 * binding元素，描述web service使用的通信协议。 
 * 该元素为每个端口定义消息格式和协议细节。
 * 针对操作和portType中使用的消息指定实际的协议和数据格式规范。
 * binding 元素有两个属性：name属性和type属性
 * name属性定义binding 的名称，而type属性指向用于 binding 的端口，在这个例子中是 "SayHelloDelegate" 端口。
 * soap:binding 元素有两个属性：style属性和transport属性
 * style属性可取值"rpc"或"document"。在这个例子中我们使用 document。transport 属性定义了要使用的 SOAP 协议。在这个例子中我们使用 HTTP。
 * operation元素定义了每个端口提供的操作符。
 * 对于每个操作，相应的 SOAP 行为都需要被定义。同时您必须如何对输入和输出进行编码。在这个例子中我们使用了"literal"。 -->
  <binding name="SayHelloPortBinding" type="tns:SayHelloDelegate">
    <soap:binding style="document" transport="http://schemas.xmlsoap.org/soap/http"/>
    <operation name="sayHello">
      <soap:operation soapAction=""/>
      <input>
        <soap:body use="literal"/>
      </input>
      <output>
        <soap:body use="literal"/>
      </output>
    </operation>
  </binding>
   <!--
 * service元素包含一组port元素。
 * port指定一个绑定的地址，这样定义一个通信的终端，将端点与来自服务接口定义的binding 元素关联起来。
  -->
  <service name="SayHelloService">
    <port binding="tns:SayHelloPortBinding" name="SayHelloPort">
      <soap:address location="http://localhost:8080/jax_ws_test/SayHelloPort"/>
    </port>
  </service>
</definitions>

2、交换信息的数据格式配置在*.xsd文件中，对应本文应用中的SayHelloService_schema1.xsd为：

<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:tns="http://ws.mywebservice.com/" targetNamespace="http://ws.mywebservice.com/" version="1.0">
 <!-- 
 * 下面是数据定义部分，该部分定义了两个元素，一个是sayHello，一个是sayHelloResponse：
 * sayHello：定义了一个复杂类型，仅仅包含一个简单的字符串，将来用来描述操作的参入传入部分；
 * sayHelloResponse：定义了一个复杂类型，仅仅包含一个简单的字符串，将来用来描述操作的返回值；
 *-->
  <xs:element name="sayHello" type="tns:sayHello"/>

  <xs:element name="sayHelloResponse" type="tns:sayHelloResponse"/>

  <xs:complexType name="sayHello">
    <xs:sequence>
      <xs:element minOccurs="0" name="arg0" type="xs:string"/>
    </xs:sequence>
  </xs:complexType>

  <xs:complexType name="sayHelloResponse">
    <xs:sequence>
      <xs:element minOccurs="0" name="return" type="xs:string"/>
    </xs:sequence>
  </xs:complexType>
</xs:schema>

三、 在Tomcat6中部署webservice应用
在部署该测试应用时，需要导入JAX-WS的jar包。在项目名称上右击->properties->AddLibrary->MyeclipseLibraries->后面的两个，如下图：

在MyEclipse中配置好Tomcat，使用Tomcat部署应用

四、部署完后，可以开发客户端对该WEBSERVICE进行访问了

创建Webservice Client 
已经部署好Webservice。那我们新建一个Webservice client，来调用Webservic

新建一个java project，名为ClientofWebServicePro。

创建一个Web Service Client。在项目名称上右击New->others->Myeclipse->WebServices->WebServiceClient，在WSDL URL中填写路径，如图：

点击直到完成。可以看到在新建的java project中，src下产生了许多的文件。

 建立一个客户端测试类MyClient.java，在main函数中加入以下代码：

SayHelloService service = newSayHelloService(); 
SayHelloDelegate delegate =service.getSayHelloPort();
System.out.println(delegate.sayHello("haoliyan"));

最终客户端工程结构如下图所示：

运行该工程，可以得到输出：Hello haoliyan