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

刺骨的言语ヽ痛彻心扉 2022-08-26 13:23 102阅读 0赞

文为Web service 开发入门篇，主要介绍在Myeclipse10环境下开发Web service的服务程序和客户端程序的基本流程。  
在Weblogic 11和tomcat6中部署Web service服务。  
  
开发环境如下：  
JAVA IDE： Myeclipse10

Web server： Weblogic 11

需要导入jax-ws包，到网上搜索很多的。

开发Web service服务程序，需要了解以下相关内容， WSDL, SOAP, XML。这些是组成Web service 的基础。  
  
在Myeclipse10下开发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，

![点击查看原始大小图片][b256437e-44cb-379c-94d5-d3cfeb513732.jpg]

在上面的框中输入项目名myWebSvc,框架选择 JAX-WS, J2EE只能选择Java EE 5.0。  
Finish完成项目新建。  
  
2. 新建一个 Java Bean, 就是一个普通的Class, File –> New -> Class,

![点击查看原始大小图片][0ac02b73-74ee-3f89-b2e2-045574de3eaa.jpg]  
包名输入 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,

![点击查看原始大小图片][bb77211c-bdb2-3e49-9b4a-cf1f97b68a08.jpg]  
  
Next 进入下一步，  
![点击查看原始大小图片][0ad9dc59-e001-3ac3-be09-f9a0d85482bd.jpg]  
  
选择 Create web service from java class(Bottom-up scenario),Next进入下一步,

![点击查看原始大小图片][274a9c02-f621-389a-86d3-033d5ac7ea3f.jpg]  
  
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. 将项目添加到WebLogic。  
  
2. 重启Weblogic 服务，在浏览器输入 [ http://localhost:7001/myWebSvc/SayHelloPort][http_localhost_7001_myWebSvc_SayHelloPort]，如果显示正确，则服务发布成功【Weblogic默认端口是7001，根据您的端口号来运行】。  
  
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,  
![点击查看原始大小图片][f43d97b1-e988-3b29-b51e-f55f11637dab.jpg]  
输入项目名 UseWS, Finish 结束新建。  
  
2. 新建Web service client程序， File –> New -> Other -> MyEclipse -> Web Services -> Web Service Client,

![点击查看原始大小图片][50aeee12-9d43-3eae-9eb1-cd2267ff91ed.jpg]  
  
Next 进入下一步，

![点击查看原始大小图片][03e75015-96b2-3112-85b1-689ee438228a.jpg]  
  
WSDL File 为Web Service 的WSDL文件  
E:\\workspace\\myWebSvc\\WebRoot\\WEB-INF\\wsdl\\SayHelloService.wsdl  
  
Next进入下一步，

![点击查看原始大小图片][7de35139-23ac-347d-8877-ff7e5a8c818a.jpg]  
  
Finish 结束新建。  
  
3. 新建一个Test类，用来调用 SayHelloService, File -> New -> Class,

![点击查看原始大小图片][a4f179ec-7962-3bba-b267-77b15fba82b3.jpg]  
  
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. !

[b256437e-44cb-379c-94d5-d3cfeb513732.jpg]: /images/20220824/b954b58a6242425b980631da22995a0e.png
[0ac02b73-74ee-3f89-b2e2-045574de3eaa.jpg]: /images/20220824/7d71bcdbad1a4c3fa299043d2c82353e.png
[bb77211c-bdb2-3e49-9b4a-cf1f97b68a08.jpg]: /images/20220824/62747e27e7a54b868562c9eff8dade67.png
[0ad9dc59-e001-3ac3-be09-f9a0d85482bd.jpg]: /images/20220824/2e183ad59da342a59849f1f26dc09840.png
[274a9c02-f621-389a-86d3-033d5ac7ea3f.jpg]: /images/20220824/a0c454b98915428390e4ed6f4c9ba74b.png
[http_localhost_7001_myWebSvc_SayHelloPort]: http://localhost:7001/myWebSvc/SayHelloPort
[f43d97b1-e988-3b29-b51e-f55f11637dab.jpg]: /images/20220824/eb4ae1e2d43a4733b3261fc1a3d53858.png
[50aeee12-9d43-3eae-9eb1-cd2267ff91ed.jpg]: /images/20220824/b5e5fe2f7fbc481689ffb2e4cbd470f8.png
[03e75015-96b2-3112-85b1-689ee438228a.jpg]: /images/20220824/622de655491840e08dd21895edb29fc5.png
[7de35139-23ac-347d-8877-ff7e5a8c818a.jpg]: /images/20220824/0697ede89ae34d5c8b6123e9f66807ee.png
[a4f179ec-7962-3bba-b267-77b15fba82b3.jpg]: /images/20220824/2991e0633cbc4b13a1d4d68b89502afc.png