用MyEclipse创建jax-ws

用MyEclipse创建jax-ws
2012年05月23日 星期三 19:33


创建jax-ws service：



输入项目名称，framework选择JAX-WS,项目建好了之后你就会发现其实webservice项目就是一个普通的web项目。

新建业务处理类：



业务处理类要满足以下条件：
   1、这个类必须是public类
   2、这些类不能是final的或者abstract
 3、这个类必须有一个公共的默认构造函数
 4、这个类绝对不能有finalize()方法
   5、实现方法必须非static

新建webservice service
选中项目点击右键new->new webservice，如果找不到这个选项点击other查找下。



选 择对应的project，framework还是选择jax-ws，strategy选择下面的create web service from java bean。这个strategy指的是webservice的生成策略，有2中方式，基于java bean 和基于wsdl文件的。对应着webservice的2种设计原则，一种是code first，另外一种是wsdl first。
点击next进入下一步。



选 择对应的业务处理类，soap style/use 选择默认的，MTOM Support 是实现webservice 之间的文件传输。如果要生成wsdl文件就勾选 generate wsdl in project。下面的三个选项可以设置webservice 的命名空间，服务名以及服务端口
点击finish
系统会自动生成webservice 代理类和相应的wsdl文件。为了最大程度的平台中立性，WSDL 使用 XML Schema 语法来定义数据类型。这些数据类型用来定义web service方法的参数和返回指。也就是对应的xsd文件。然后需要添加对应library然后整个系统的结构为：




然后将程序放到tomcat服务器，即可运行，例如：http://127.0.0.1:8088/jaxwsService/HelloWordPort?wsdl 如果能访问到对应wsdl文件就表示这个webservice发布成功。

可以看下wsdl文档内容：

Java代码
  1. <?xml version="1.0" encoding="UTF-8"?>   
  2. <!-- Generated by JAX-WS RI at http://jax-ws.dev.java.net. RI's version is JAX-WS RI 2.1.3-hudson-390-. -->   
  3. <definitions xmlns="http://schemas.xmlsoap.org/wsdl/" xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/" xmlns:tns="http://ws.test.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="HelloWordService" targetNamespace="http://ws.test.com/">   
  4.   <types>   
  5.     <xsd:schema>   
  6.       <xsd:import namespace="http://ws.test.com/" schemaLocation="HelloWordService_schema1.xsd"/>   
  7.     </xsd:schema>   
  8.   </types>   
  9.   <message name="add">   
  10.     <part element="tns:add" name="parameters"/>   
  11.   </message>   
  12.   <message name="addResponse">   
  13.     <part element="tns:addResponse" name="parameters"/>   
  14.   </message>   
  15.   <message name="hello">   
  16.     <part element="tns:hello" name="parameters"/>   
  17.   </message>   
  18.   <message name="helloResponse">   
  19.     <part element="tns:helloResponse" name="parameters"/>   
  20.   </message>   
  21.   <portType name="HelloWordDelegate">   
  22.     <operation name="add">   
  23.       <input message="tns:add"/>   
  24.       <output message="tns:addResponse"/>   
  25.     </operation>   
  26.     <operation name="hello">   
  27.       <input message="tns:hello"/>   
  28.       <output message="tns:helloResponse"/>   
  29.     </operation>   
  30.   </portType>   
  31.   <binding name="HelloWordPortBinding" type="tns:HelloWordDelegate">   
  32.     <soap:binding style="document" transport="http://schemas.xmlsoap.org/soap/http"/>   
  33.     <operation name="add">   
  34.       <soap:operation soapAction=""/>   
  35.       <input>   
  36.         <soap:body use="literal"/>   
  37.       </input>   
  38.       <output>   
  39.         <soap:body use="literal"/>   
  40.       </output>   
  41.     </operation>   
  42.     <operation name="hello">   
  43.       <soap:operation soapAction=""/>   
  44.       <input>   
  45.         <soap:body use="literal"/>   
  46.       </input>   
  47.       <output>   
  48.         <soap:body use="literal"/>   
  49.       </output>   
  50.     </operation>   
  51.   </binding>   
  52.   <service name="HelloWordService">   
  53.     <port binding="tns:HelloWordPortBinding" name="HelloWordPort">   
  54.       <soap:address location="http://localhost:8080/jaxwsService/HelloWordService"/>   
  55.     </port>   
  56.   </service>   
  57. </definitions>  
<?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.test.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="HelloWordService" targetNamespace="http://ws.test.com/">  <types>    <xsd:schema>      <xsd:import namespace="http://ws.test.com/" schemaLocation="HelloWordService_schema1.xsd"/>    </xsd:schema>  </types>  <message name="add">    <part element="tns:add" name="parameters"/>  </message>  <message name="addResponse">    <part element="tns:addResponse" name="parameters"/>  </message>  <message name="hello">    <part element="tns:hello" name="parameters"/>  </message>  <message name="helloResponse">    <part element="tns:helloResponse" name="parameters"/>  </message>  <portType name="HelloWordDelegate">    <operation name="add">      <input message="tns:add"/>      <output message="tns:addResponse"/>    </operation>    <operation name="hello">      <input message="tns:hello"/>      <output message="tns:helloResponse"/>    </operation>  </portType>  <binding name="HelloWordPortBinding" type="tns:HelloWordDelegate">    <soap:binding style="document" transport="http://schemas.xmlsoap.org/soap/http"/>    <operation name="add">      <soap:operation soapAction=""/>      <input>        <soap:body use="literal"/>      </input>      <output>        <soap:body use="literal"/>      </output>    </operation>    <operation name="hello">      <soap:operation soapAction=""/>      <input>        <soap:body use="literal"/>      </input>      <output>        <soap:body use="literal"/>      </output>    </operation>  </binding>  <service name="HelloWordService">    <port binding="tns:HelloWordPortBinding" name="HelloWordPort">      <soap:address location="http://localhost:8080/jaxwsService/HelloWordService"/>    </port>  </service></definitions>



对照着简介一章所介绍wsdl文档结构看下。
第一部分是 <types>元素，主要定义webservice的数据类型，它实际是引用了另外一个xsd文件，xsd文件内容如下：

Java代码
  1. <?xml version="1.0" encoding="UTF-8"?>   
  2. <xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:tns="http://ws.test.com/" targetNamespace="http://ws.test.com/" version="1.0">   
  3.   
  4.   <xs:element name="add" type="tns:add"/>   
  5.   
  6.   <xs:element name="addResponse" type="tns:addResponse"/>   
  7.   
  8.   <xs:element name="hello" type="tns:hello"/>   
  9.   
  10.   <xs:element name="helloResponse" type="tns:helloResponse"/>   
  11.   
  12.   <xs:complexType name="hello">   
  13.     <xs:sequence>   
  14.       <xs:element minOccurs="0" name="arg0" type="xs:string"/>   
  15.     </xs:sequence>   
  16.   </xs:complexType>   
  17.   
  18.   <xs:complexType name="helloResponse">   
  19.     <xs:sequence>   
  20.       <xs:element minOccurs="0" name="return" type="xs:string"/>   
  21.     </xs:sequence>   
  22.   </xs:complexType>   
  23.   
  24.   <xs:complexType name="add">   
  25.     <xs:sequence>   
  26.       <xs:element name="arg0" type="xs:int"/>   
  27.       <xs:element name="arg1" type="xs:int"/>   
  28.     </xs:sequence>   
  29.   </xs:complexType>   
  30.   
  31.   <xs:complexType name="addResponse">   
  32.     <xs:sequence>   
  33.       <xs:element name="return" type="xs:int"/>   
  34.     </xs:sequence>   
  35.   </xs:complexType>   
  36. </xs:schema>  
<?xml version="1.0" encoding="UTF-8"?><xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:tns="http://ws.test.com/" targetNamespace="http://ws.test.com/" version="1.0">  <xs:element name="add" type="tns:add"/>  <xs:element name="addResponse" type="tns:addResponse"/>  <xs:element name="hello" type="tns:hello"/>  <xs:element name="helloResponse" type="tns:helloResponse"/>  <xs:complexType name="hello">    <xs:sequence>      <xs:element minOccurs="0" name="arg0" type="xs:string"/>    </xs:sequence>  </xs:complexType>  <xs:complexType name="helloResponse">    <xs:sequence>      <xs:element minOccurs="0" name="return" type="xs:string"/>    </xs:sequence>  </xs:complexType>  <xs:complexType name="add">    <xs:sequence>      <xs:element name="arg0" type="xs:int"/>      <xs:element name="arg1" type="xs:int"/>    </xs:sequence>  </xs:complexType>  <xs:complexType name="addResponse">    <xs:sequence>      <xs:element name="return" type="xs:int"/>    </xs:sequence>  </xs:complexType></xs:schema>


如 果细心的朋友大家就会发现在new webservice那一步时，有个soap style/use 选项你可以看到myeclipse 6.5中默认的就是上面所说的 document/wrapped样式，而xsd里面也主要是使用xs:complexType节点来描述数据类型。
然后在接着看wsdl中的<message> 元素你可以看到message元素定义之后主要是使用在<portType> 元素中。
而<portType> 元素则可以告诉大家这个webservice有几个方法。方法名叫什么有没有返回值等等。<binding> 元素则是为每个端口定义消息格式和协议细节。你可以找到style="document"以及对应use="literal"等字样。这就规定了该 webservice使用哪种编码样式来进行SOAP的编码。

下面来建一个webservice 客户端来模拟调用下。也是用myeclipse 6.5来进行开发。

新建jax-ws  client
新建个普通的java project，并建好对应包。点击右键选择 new web service client,选择对应项目，选择jax-ws然后点击next.



选择wsdl URL,然后将wsdl地址复制上去，选择生成client类放入哪个包.点击next


下个界面是进行wsdl的验证。如果没有报错直接点击next。添加对应所需要的library，点击finish。client 项目至此新建完成，项目结构为：




新建client 调用类：



至此大功告成，整个示例就完成了。但是咱们也别歇着，回头看看jax-ws的实现原理。
1）webservice 服务器端发布一个webservice项目，这时候会为这个webservice项目分配一个servlet，大家可以看下webservice服务器端 项目下web.xml，然后根据不同的webservice分配不同的<url-pattern>，大家可以看下<url- pattern>里面的值其实就是webservice 对应的port.
2)然后webservice clinet会生成代理类，然后利用代理类发送SOAP消息去请求webservice 服务器端的servlet，而servlet会根据不同的port去请求不同的webservice。

流程图如下：



可 能有些同学还会问下这个问题。就是说你服务器端和客户端都用的是jax-ws，所以根据wsdl在myeclipse中就能自动生成客户端代码，但是如果 服务器端用的是其他框架就不能自动生成客户端代码怎么办？别着急。既然有自动生成就有手动生成的。而手动生成是不管服务器端是使用框架的。

wsgen
wsgen 是在JDK的bin目录下的一个exe文件（Windows版），该命令的主要功能是用来生成合适的JAX-WS。它读取Web Service的终端类文件，同时生成所有用于发布Web Service所依赖的源代码文件和经过编译过的二进制类文件。这里要特别说明的是，通常在Web Service Bean中用到的异常类会另外生成一个描述Bean，如果Web Service Bean中的方法有申明抛出异常，这一步是必需的，否则服务器无法绑定该对像。此外，wsgen还能辅助生成WSDL和相关的xsd文件。wsgen从资 源文件生成一个完整的操作列表并验证web service是否合法，可以完整发布。
命令参数说明：
 -cp 定义classpath
 -r 生成 bean的wsdl文件的存放目录
 -s 生成发布Web Service的源代码文件的存放目录（如果方法有抛出异常，则会生成该异常的描述类源文件）
 -d 生成发布Web Service的编译过的二进制类文件的存放目录（该异常的描述类的class文件）

命令范例：wsgen -cp ./bin -r ./wsdl -s ./src -d ./bin -wsdl org.jsoso.jws.server.Example

wsimport
wsimport 也是在JDK的bin目录下的一个exe文件（Windows版），主要功能是根据服务端发布的wsdl文件生成客户端存根及框架，负责与Web Service 服务器通信，并在将其封装成实例，客户端可以直接使用，就像使用本地实例一样。对Java而言，wsimport帮助程序员生存调用web service所需要的客户端类文件.java和.class。要提醒指出的是，wsimport可以用于非Java的服务器端，如：服务器端也许是C# 编写的web service，通过wsimport则生成Java的客户端实现。
命令参数说明：
 -d 生成客户端执行类的class文件的存放目录
 -s 生成客户端执行类的源文件的存放目录
 -p 定义生成类的包名

命令范例：wsimport -d ./bin -s ./src -p org.jsoso.jws.client.ref http://localhost:8080/hello?wsdl

posted @ 2012-05-24 09:19  狼里格朗  阅读(1402)  评论(1)  编辑  收藏  举报