使用Myeclipse 8.5开发基于JAX-WS的Web service实例

使用Myeclipse 8.5开发基于JAX-WS的Web service实例

本文为Web service 开发入门篇，主要介绍在Myeclipse 8.5环境下开发Web service的服务程序和客户端程序的基本流程。
在Weblogic 10.3.4 中部署Web service服务。

开发环境如下：
JAVA IDE：       Myeclipse 8.5
Web server：     Weblogic 10.3.4

开发Web service服务程序，需要了解以下相关内容， WSDL,  SOAP, XML。这些是组成Web service 的基础。

在Myeclipse8.5下开发Web service程序，目前系统支持的开发框架有3个，JAX-WS,REST(JAX-RS),XFire。其中系统建议不要使用XFire 的框架，可能是要被淘汰了（deprecated）。我们选择的是JAX-WS框架。这个需要Java EE 5.0的支持。所以后面选择Web server容器的时候，是要能支持Java EE 5.0的才可以部署成功。

（一） Web service服务端开发
1. 新建一个Web service project, 菜单File -> New -> Web Service Project，

在上面的框中输入项目名myWebSvc,框架选择 JAX-WS, J2EE只能选择Java EE 5.0。
Finish完成项目新建。

2. 新建一个 Java Bean, 就是一个普通的Class, File –> New -> Class,

包名输入 com.myweb.ws, 类名输入 SayHello, Finish 结束新建类。

在类中加入一个方法sayHaha如下，

package com.myweb.ws;

public class SayHello
{
    public String sayHaha(String request)
    {
return "Haha, " + request + ", O.K. !";
}
}

3. 新建一个Web service， 菜单File –> New -> Other -> MyEclipse -> Web Services -> Web Service,

Next 进入下一步，


选择 Create web  service from java class(Bottom-up scenario),Next进入下一步,

Java class 输入 com.myweb.ws.SayHello, 选中 Generate WSDL in project 选项，
Finish 结束新建。

生成新的服务代理类， com.myweb.ws.SayHelloDelegation
生成WSDL定义文件，WebRoot\WEB-INF\wsdl\SayHelloService.wsdl
WebRoot\WEB-INF\wsdl\SayHelloService_Schema1.xsd,

（二） 部署Web service 服务
1. Window -> Show View -> Servers, 这里前提是已经安装完成Weblogic10.3.4,
在 Weblogic 10.x上点右键， 选择Add Deployment 部署myWebSvc，


Finish结束部署。

2. 重启Weblogic 服务，在浏览器输入 http://localhost:7001/myWebSvc/SayHelloPort，如果显示正确，则服务发布成功。

3. 在创建Web service 项目的过程中，如果加入了 JAX-WS 2.1 Runtime / API 库，在部署Web service时，会报错误，

2011-10-13 17:28:22 [com.sun.xml.ws.policy.jaxws.BuilderHandler]  getPolicySubjects
严重: [failed to localize] WSP_1014_POLICY_REFERENCE_DOES_NOT_EXIST(zip:D:/bea/weblogic1034/webdomain/servers/AdminServer/tmp/_WL_user/_appsdir_WebServicePro_dir/achpn5/war/WEB-INF/lib/webservices-rt.jar!/WEB-INF/wsdl/wsat.wsdl#Addressing_policy)
2011-10-13 17:28:22 [com.sun.xml.ws.policy.jaxws.PolicyWSDLParserExtension]  finished
严重: [failed to localize] WSP_1014_POLICY_REFERENCE_DOES_NOT_EXIST(zip:D:/bea/weblogic1034/webdomain/servers/AdminServer/tmp/_WL_user/_appsdir_WebServicePro_dir/achpn5/war/WEB-INF/lib/webservices-rt.jar!/WEB-INF/wsdl/wsat.wsdl#Addressing_policy)
2011-10-13 17:28:22 [com.sun.xml.ws.policy.jaxws.PolicyWSDLParserExtension]  finished
严重: [failed to localize] WSP_1018_POLICY_EXCEPTION_WHILE_FINISHING_PARSING_WSDL()
com.sun.xml.ws.policy.PolicyException: [failed to localize] WSP_1014_POLICY_REFERENCE_DOES_NOT_EXIST(zip:D:/bea/weblogic1034/webdomain/servers/AdminServer/tmp/_WL_user/_appsdir_WebServicePro_dir/achpn5/war/WEB-INF/lib/webservices-rt.jar!/WEB-INF/wsdl/wsat.wsdl#Addressing_policy)
at com.sun.xml.ws.policy.jaxws.BuilderHandler.getPolicies(BuilderHandler.java:93)

只要删去JAX-WS这两个包 ，再重新部署就可以了。

 

4. 如果在Tomcat 6.0上部署，则需要加上JAX-WS API /  Runtime 两个库，否则会报错，

    严重: Error configuring application listener of class com.sun.xml.ws.transport.http.servlet.WSServletContextListener

java.lang.ClassNotFoundException: com.sun.xml.ws.transport.http.servlet.WSServletContextListener

    at org.apache.catalina.loader.WebappClassLoader.loadClass(WebappClassLoader.java:1645)

    at org.apache.catalina.loader.WebappClassLoader.loadClass(WebappClassLoader.java:1491)

    at org.apache.catalina.core.StandardContext.listenerStart(StandardContext.java:4078)

（三） Web service 客户端开发
1. 新建 Java project, File -> New -> Java Project,

输入项目名 UseWS, Finish 结束新建。

2. 新建Web service client程序， File –> New -> Other -> MyEclipse -> Web Services -> Web Service Client,

 

Next 进入下一步，

 

WSDL File 为Web Service 的WSDL文件
E:\workspace\myWebSvc\WebRoot\WEB-INF\wsdl\SayHelloService.wsdl

Next进入下一步，

Finish 结束新建。

3. 新建一个Test类，用来调用 SayHelloService,  File -> New -> Class,

Finish 结束类的新建。

修改类如下：
import com.myweb.ws.SayHelloDelegate;
import com.myweb.ws.SayHelloService;

public class Test
{

    public static void main(String[] args)
    {
String request = "World";
String response = null;

SayHelloService sayHelloSvc = new SayHelloService();
SayHelloDelegate sayHelloDgt = sayHelloSvc.getSayHelloPort();

response = sayHelloDgt.sayHaha(request);
System.out.println(response);
    }
}

4. 运行项目，发现一个错误，
Exception in thread "main" com.sun.xml.ws.client.ClientTransportException: HTTP transport error: java.net.ConnectException: Connection refused: connect
at com.sun.xml.ws.transport.http.client.HttpClientTransport.getOutput(HttpClientTransport.java:134)
at com.sun.xml.ws.transport.http.client.HttpTransportPipe.process(HttpTransportPipe.java:140)
at com.sun.xml.xwss.XWSSClientPipe.process(XWSSClientPipe.java:118)
at com.sun.xml.ws.api.pipe.helper.PipeAdapter.processRequest(PipeAdapter.java:115)
at com.sun.xml.ws.api.pipe.Fiber.__doRun(Fiber.java:595)
at com.sun.xml.ws.api.pipe.Fiber._doRun(Fiber.java:554)
at com.sun.xml.ws.api.pipe.Fiber.doRun(Fiber.java:539)
at com.sun.xml.ws.api.pipe.Fiber.runSync(Fiber.java:436)
at com.sun.xml.ws.client.Stub.process(Stub.java:248)
at com.sun.xml.ws.client.sei.SEIStub.doProcess(SEIStub.java:135)
at com.sun.xml.ws.client.sei.SyncMethodHandler.invoke(SyncMethodHandler.java:109)
at com.sun.xml.ws.client.sei.SyncMethodHandler.invoke(SyncMethodHandler.java:89)
at com.sun.xml.ws.client.sei.SEIStub.invoke(SEIStub.java:118)
at $Proxy34.sayHaha(Unknown Source)
at Test.main(Test.java:15)
Caused by: java.net.ConnectException: Connection refused: connect
at java.net.PlainSocketImpl.socketConnect(Native Method)
at java.net.PlainSocketImpl.doConnect(PlainSocketImpl.java:333)
at java.net.PlainSocketImpl.connectToAddress(PlainSocketImpl.java:195)
at java.net.PlainSocketImpl.connect(PlainSocketImpl.java:182)
at java.net.Socket.connect(Socket.java:507)
at java.net.Socket.connect(Socket.java:457)
at sun.net.NetworkClient.doConnect(NetworkClient.java:157)
at sun.net.www.http.HttpClient.openServer(HttpClient.java:365)
at sun.net.www.http.HttpClient.openServer(HttpClient.java:477)
at sun.net.www.http.HttpClient.<init>(HttpClient.java:214)
at sun.net.www.http.HttpClient.New(HttpClient.java:287)
at sun.net.www.http.HttpClient.New(HttpClient.java:299)
at sun.net.www.protocol.http.HttpURLConnection.getNewHttpClient(HttpURLConnection.java:792)
at sun.net.www.protocol.http.HttpURLConnection.plainConnect(HttpURLConnection.java:771)
at sun.net.www.protocol.http.HttpURLConnection.connect(HttpURLConnection.java:669)
at sun.net.www.protocol.http.HttpURLConnection.getOutputStream(HttpURLConnection.java:836)
at com.sun.xml.ws.transport.http.client.HttpClientTransport.getOutput(HttpClientTransport.java:122)
... 14 more

错误显示是Connection refused， 查看了SayHelloService.wsdl文件，发现这里的配置文件中， 标签service 的soap:address location 的端口是8080， 而Weblogic中我们用的默认端口是7001，于是修改端口号为7001，

<service name="SayHelloService">
    <port binding="tns:SayHelloPortBinding" name="SayHelloPort">
      <soap:address location="http://localhost:8080/myWebSvc/SayHelloPort"/>
    </port>
  </service>

修改为

<service name="SayHelloService">
    <port binding="tns:SayHelloPortBinding" name="SayHelloPort">
      <soap:address location="http://localhost:7001/myWebSvc/SayHelloPort"/>
    </port>
  </service>

另外，如果不在同一台机器上测试， 这里的localhost应该改为相应的IP地址。

修改后测试，显示成功。

Haha, World, O.K. !

（全文完）