利用JAX-WS开发Web服务

(转帖:)http://blog.chinaunix.net/u2/88379/showart_2128563.html

本文提供了一个使用Java如何开发基于SOAP的Web Services，其客户端可以是Perl、Ruby、Python或Java等。

Java SE 6封装了JAX-WS(Java API for XML-Web Services)，而JAX-WS同时支持基于SOAP的Web服务和REST风格的Web服务。JAX-WS通常可简写为JWS，当前，JWS的版本为2.x。

基于SOAP的Web服务可用单个Java类的实现，但是最好是用“接口+实现”的方式来实现最佳。


Web服务的接口称为SEI，即Service Endpoint Interface；
而Web服务的实现称为SIB，即Service Implementation Bean。

SIB可以是一个POJO，也可以是无状态的会话EJB。本文的SIB是普通Java类，通过JDK 6的类库即可实现Web服务的发布。

代码1：服务接口类SEI
view plaincopy to clipboardprint?

   1. package myweb.service; 
   2. import javax.jws.WebService; 
   3. import javax.jws.WebMethod; 
   4. import javax.jws.soap.SOAPBinding; 
   5. import javax.jws.soap.SOAPBinding.Style; 
   6. @WebService 
   7. @SOAPBinding(style=Style.RPC) 
   8. public interface TimeServer { 
   9.     @WebMethod 
  10.     String getTimeAsString(); 
  11.     @WebMethod 
  12.     long getTimeAsElapsed(); 
  13. } 

package myweb.service; import javax.jws.WebService; import javax.jws.WebMethod; import javax.jws.soap.SOAPBinding; import javax.jws.soap.SOAPBinding.Style; @WebService @SOAPBinding(style=Style.RPC) public interface TimeServer { @WebMethod String getTimeAsString(); @WebMethod long getTimeAsElapsed(); }

代码2：服务实现类SIB
view plaincopy to clipboardprint?

   1. package myweb.service; 
   2. import java.text.DateFormat; 
   3. import java.util.Date; 
   4. import javax.jws.WebService; 
   5.  
   6. @WebService(endpointInterface = "myweb.service.TimeServer") 
   7. public class TimeServerImpl implements TimeServer { 
   8.  
   9.     /**
  10.      * 返回从1970年1月1日0点0时0分起的毫秒数
  11.      */ 
  12.     public long getTimeAsElapsed() { 
  13.         return new Date().getTime(); 
  14.     } 
  15.  
  16.     /**
  17.      * 返回如“2009-12-21”格式的日期
  18.      */ 
  19.     public String getTimeAsString() { 
  20.         Date date = new Date(); 
  21.         DateFormat df = DateFormat.getDateInstance(); 
  22.         return df.format(date); 
  23.     } 
  24. } 

package myweb.service; import java.text.DateFormat; import java.util.Date; import javax.jws.WebService; @WebService(endpointInterface = "myweb.service.TimeServer") public class TimeServerImpl implements TimeServer { /** * 返回从1970年1月1日0点0时0分起的毫秒数 */ public long getTimeAsElapsed() { return new Date().getTime(); } /** * 返回如“2009-12-21”格式的日期 */ public String getTimeAsString() { Date date = new Date(); DateFormat df = DateFormat.getDateInstance(); return df.format(date); } }

代码3：服务发布类Publisher
view plaincopy to clipboardprint?

   1. package myweb.service; 
   2. import javax.xml.ws.Endpoint; 
   3.  
   4. public class TimeServerPublisher { 
   5.     public static void main(String[] args){ 
   6.         // 第一个参数是发布的URL 
   7.         // 第二个参数是SIB实现 
   8.         Endpoint.publish("http://127.0.0.1:10100/myweb", new TimeServerImpl()); 
   9.     } 
  10. } 

package myweb.service; import javax.xml.ws.Endpoint; public class TimeServerPublisher { public static void main(String[] args){ // 第一个参数是发布的URL // 第二个参数是SIB实现 Endpoint.publish("http://127.0.0.1:10100/myweb", new TimeServerImpl()); } }

编译以上代码：

javac myweb/service/*.java

运行服务：

java myweb/service/TimeServerPublisher

在浏览器地址栏输入：

http://localhost:10100/myweb?wsdl

也可编写客户端代码测试服务。

Java客户端：
view plaincopy to clipboardprint?

   1. package myweb.client; 
   2. import javax.xml.namespace.QName; 
   3. import javax.xml.ws.Service; 
   4. import java.net.URL; 
   5. import myweb.service.*; 
   6. public class TimeClient { 
   7.     public static void main(String[] args) throws Exception{ 
   8.         URL url = new URL("http://localhost:10100/myweb?wsdl"); 
   9.         // 第一个参数是服务的URI 
  10.         // 第二个参数是在WSDL发布的服务名 
  11.         QName qname = new QName("http://service.myweb/","TimeServerImplService"); 
  12.         // 创建服务 
  13.         Service service = Service.create(url, qname); 
  14.         // 提取端点接口，服务“端口”。 
  15.         TimeServer eif = service.getPort(TimeServer.class); 
  16.         System.out.println(eif.getTimeAsString()); 
  17.         System.out.println(eif.getTimeAsElapsed()); 
  18.     } 
  19. } 

package myweb.client; import javax.xml.namespace.QName; import javax.xml.ws.Service; import java.net.URL; import myweb.service.*; public class TimeClient { public static void main(String[] args) throws Exception{ URL url = new URL("http://localhost:10100/myweb?wsdl"); // 第一个参数是服务的URI // 第二个参数是在WSDL发布的服务名 QName qname = new QName("http://service.myweb/","TimeServerImplService"); // 创建服务 Service service = Service.create(url, qname); // 提取端点接口，服务“端口”。 TimeServer eif = service.getPort(TimeServer.class); System.out.println(eif.getTimeAsString()); System.out.println(eif.getTimeAsElapsed()); } }

运行客户端，显示结果如下：

2009-12-21
1261402511859

也可用Ruby编写客户端，如下：
view plaincopy to clipboardprint?

   1. #!/usr/bin/ruby 
   2.  
   3. # one Ruby package for SOAP-based services 
   4. require 'soap/wsdlDriver'  
   5.  
   6. wsdl_url = 'http://127.0.0.1:10100/myweb?wsdl' 
   7.  
   8.  
   9. service = SOAP::WSDLDriverFactory.new(wsdl_url).create_rpc_driver 
  10.  
  11. # Save request/response messages in files named '...soapmsgs...' 
  12. service.wiredump_file_base = 'soapmsgs' 
  13.  
  14. # Invoke service operations. 
  15. result1 = service.getTimeAsString 
  16. result2 = service.getTimeAsElapsed 
  17.  
  18. # Output results. 
  19. puts "Current time is: #{result1}" 
  20. puts "Elapsed milliseconds from the epoch: #{result2}" 

#!/usr/bin/ruby # one Ruby package for SOAP-based services require 'soap/wsdlDriver' wsdl_url = 'http://127.0.0.1:10100/myweb?wsdl' service = SOAP::WSDLDriverFactory.new(wsdl_url).create_rpc_driver # Save request/response messages in files named '...soapmsgs...' service.wiredump_file_base = 'soapmsgs' # Invoke service operations. result1 = service.getTimeAsString result2 = service.getTimeAsElapsed # Output results. puts "Current time is: #{result1}" puts "Elapsed milliseconds from the epoch: #{result2}"

运行结果相同！