Java调用webservice接口方法(SOAP message、xfire、axis)

 

 

webservice的 发布一般都是使用WSDL(web service descriptive language)文件的样式来发布的,在WSDL文件里面,包含这个webservice暴露在外面可供使用的接口。今天搜索到了非常好的 webservice provider列表

http://www.webservicex.net/WCF/default.aspx

这上面列出了70多个包括很多方面的free webservice provider,utilities->global weather就可以获取全球的天气预报。

下面我们来看Java如何通过WSDL文件来调用这些web service:

注意,以下的代码并没有经过真正的测试,只是说明这些情况,不同版本的Axis相差很大,大家最好以apache网站上的例子为准,这里仅仅用于说明其基本用法。 

一、利用jdk web服务api实现,这里使用基于 SOAP message 的 Web 服务 
1.首先建立一个Web services EndPoint: 

Java代码 
  1. package Hello;      
  2. import javax.jws.WebService;      
  3. import javax.jws.WebMethod;      
  4. import javax.xml.ws.Endpoint;      
  5.      
  6. @WebService     
  7. public class Hello {     
  8.     
  9. @WebMethod     
  10. public String hello(String name) {      
  11. return "Hello, " + name + "\n";      
  12. }      
  13.        
  14.  public static void main(String[] args) {      
  15.    // create and publish an endpoint      
  16.        Hello hello = new Hello();      
  17.        Endpoint endpoint = Endpoint.publish("http://localhost:8080/hello", hello);       
  18.         }      
  19. }   
Java代码 
  1. package Hello;     
  2. import javax.jws.WebService;     
  3. import javax.jws.WebMethod;     
  4. import javax.xml.ws.Endpoint;     
  5.     
  6. @WebService    
  7. public class Hello {    
  8.    
  9. @WebMethod    
  10. public String hello(String name) {     
  11. return "Hello, " + name + "\n";     
  12. }     
  13.       
  14.  public static void main(String[] args) {     
  15.    // create and publish an endpoint     
  16.        Hello hello = new Hello();     
  17.        Endpoint endpoint = Endpoint.publish("http://localhost:8080/hello", hello);      
  18.         }     
  19. }   


2.使用 apt 编译 Hello.java(例:apt -d [存放编译后的文件目录] Hello.java ) ,会生成 jaws目录 
3.使用java Hello.Hello运行,然后将浏览器指向http://localhost:8080/hello?wsdl就会出现下列显示 
4.使用wsimport 生成客户端 
使用如下:wsimport -p . -keep http://localhost:8080/hello?wsdl 
5.客户端程序: 

Java代码 
  1. class HelloClient{      
  2. public static void main(String args[]) {      
  3.   HelloService service = new HelloService();      
  4.   Hello helloProxy = service.getHelloPort();      
  5.   String hello = helloProxy.hello("你好");             
  6.   System.out.println(hello);      
  7.   }      
  8. }  
Java代码 
  1. class HelloClient{     
  2. public static void main(String args[]) {     
  3.   HelloService service = new HelloService();     
  4.   Hello helloProxy = service.getHelloPort();     
  5.   String hello = helloProxy.hello("你好");            
  6.   System.out.println(hello);     
  7.   }     
  8. }  




二、使用xfire,我这里使用的是myeclipse集成的xfire进行测试的 
利用xfire开发WebService,可以有三种方法: 
      1一种是从javabean 中生成; 
      2 一种是从wsdl文件中生成; 
      3 还有一种是自己建立webservice 
步骤如下: 
    用myeclipse建立webservice工程,目录结构如下: 
  
    首先建立webservice接口, 
     代码如下: 

Java代码 
  1. package com.myeclipse.wsExample;   
  2. //Generated by MyEclipse   
  3.   
  4. public interface IHelloWorldService {   
  5.        
  6.     public String example(String message);   
  7.        
  8. }  
Java代码 
  1. package com.myeclipse.wsExample;  
  2. //Generated by MyEclipse  
  3.   
  4. public interface IHelloWorldService {  
  5.       
  6.     public String example(String message);  
  7.       
  8. }  


Java代码 
  1. package com.myeclipse.wsExample;   
  2.  //Generated by MyEclipse   
  3.     
  4.  public class HelloWorldServiceImpl implements IHelloWorldService {   
  5.         
  6.      public String example(String message) {   
  7.          return message;   
  8.      }   
  9.         
  10. }  
Java代码 
  1. package com.myeclipse.wsExample;  
  2.  //Generated by MyEclipse  
  3.    
  4.  public class HelloWorldServiceImpl implements IHelloWorldService {  
  5.        
  6.      public String example(String message) {  
  7.          return message;  
  8.      }  
  9.        
  10. }  



修改service.xml 文件,加入以下代码: 

Xml代码 
  1.   
  2. <service>  
  3.         <name>HelloWorldServicename>  
  4.         <serviceClass>  
  5.              com.myeclipse.wsExample.IHelloWorldService   
  6.          serviceClass>  
  7.          <implementationClass>  
  8.             com.myeclipse.wsExample.HelloWorldServiceImpl   
  9.          implementationClass>  
  10.          <style>wrappedstyle>  
  11.          <use>literaluse>  
  12.          <scope>applicationscope>  
  13. service>  
Xml代码 
  1. <service>  
  2.         <name>HelloWorldServicename>  
  3.         <serviceClass>  
  4.              com.myeclipse.wsExample.IHelloWorldService  
  5.          serviceClass>  
  6.          <implementationClass>  
  7.             com.myeclipse.wsExample.HelloWorldServiceImpl  
  8.          implementationClass>  
  9.          <style>wrappedstyle>  
  10.          <use>literaluse>  
  11.          <scope>applicationscope>  
  12. service>  



把整个项目部署到tomcat服务器中 ,打开浏览器,输入http://localhost:8989/HelloWorld/services/HelloWorldService?wsdl 

客户端实现如下: 

Java代码 
  1. package com.myeclipse.wsExample.client;   
  2. import java.net.MalformedURLException;   
  3. import java.net.URL;   
  4.   
  5. import org.codehaus.xfire.XFireFactory;   
  6. import org.codehaus.xfire.client.Client;   
  7. import org.codehaus.xfire.client.XFireProxyFactory;   
  8. import org.codehaus.xfire.service.Service;   
  9. import org.codehaus.xfire.service.binding.ObjectServiceFactory;   
  10.   
  11. import com.myeclipse.wsExample.IHelloWorldService;   
  12.   
  13. public class HelloWorldClient {   
  14. public static void main(String[] args) throws MalformedURLException, Exception {   
  15. // TODO Auto-generated method stub   
  16. Service s=new ObjectServiceFactory().create(IHelloWorldService.class);   
  17. XFireProxyFactory xf=new XFireProxyFactory(XFireFactory.newInstance().getXFire());   
  18. String url="http://localhost:8989/HelloWorld/services/HelloWorldService";   
  19.   
  20.         try  
  21.         {               
  22.                
  23.             IHelloWorldService hs=(IHelloWorldService) xf.create(s,url);   
  24.             String st=hs.example("zhangjin");   
  25.             System.out.print(st);   
  26.         }   
  27.         catch(Exception e)   
  28.         {   
  29.             e.printStackTrace();   
  30.         }   
  31.    }   
  32.   
  33. }  
Java代码 
  1. package com.myeclipse.wsExample.client;  
  2. import java.net.MalformedURLException;  
  3. import java.net.URL;  
  4.   
  5. import org.codehaus.xfire.XFireFactory;  
  6. import org.codehaus.xfire.client.Client;  
  7. import org.codehaus.xfire.client.XFireProxyFactory;  
  8. import org.codehaus.xfire.service.Service;  
  9. import org.codehaus.xfire.service.binding.ObjectServiceFactory;  
  10.   
  11. import com.myeclipse.wsExample.IHelloWorldService;  
  12.   
  13. public class HelloWorldClient {  
  14. public static void main(String[] args) throws MalformedURLException, Exception {  
  15. // TODO Auto-generated method stub  
  16. Service s=new ObjectServiceFactory().create(IHelloWorldService.class);  
  17. XFireProxyFactory xf=new XFireProxyFactory(XFireFactory.newInstance().getXFire());  
  18. String url="http://localhost:8989/HelloWorld/services/HelloWorldService";  
  19.   
  20.         try  
  21.         {              
  22.               
  23.             IHelloWorldService hs=(IHelloWorldService) xf.create(s,url);  
  24.             String st=hs.example("zhangjin");  
  25.             System.out.print(st);  
  26.         }  
  27.         catch(Exception e)  
  28.         {  
  29.             e.printStackTrace();  
  30.         }  
  31.    }  
  32.   
  33. }  


这里再说点题外话,有时候我们知道一个wsdl地址,比如想用java客户端引用.net 做得webservice,使用myeclipse引用,但是却出现无法通过验证的错误,这时我们可以直接在类中引用,步骤如下: 

Java代码 
  1. public static void main(String[] args) throws MalformedURLException, Exception {   
  2.         // TODO Auto-generated method stub   
  3.         Service s=new ObjectServiceFactory().create(IHelloWorldService.class);   
  4.         XFireProxyFactory xf=new XFireProxyFactory(XFireFactory.newInstance().getXFire());   
  5.                
  6. //远程调用.net开发的webservice   
  7. Client c=new Client(new URL("http://www.webxml.com.cn/webservices/qqOnlineWebService.asmx?wsdl"));   
  8.         Object[] o=c.invoke("qqCheckOnline"new String[]{"531086641","591284436"});   
  9.            
  10. //调用.net本机开发的webservice   
  11. Client c1=new Client(new URL("http://localhost/zj/Service.asmx?wsdl"));   
  12. Object[] o1=c1.invoke("HelloWorld",new String[]{});   
  13.            
  14. }  
Java代码 
  1. public static void main(String[] args) throws MalformedURLException, Exception {  
  2.         // TODO Auto-generated method stub  
  3.         Service s=new ObjectServiceFactory().create(IHelloWorldService.class);  
  4.         XFireProxyFactory xf=new XFireProxyFactory(XFireFactory.newInstance().getXFire());  
  5.               
  6. //远程调用.net开发的webservice  
  7. Client c=new Client(new URL("http://www.webxml.com.cn/webservices/qqOnlineWebService.asmx?wsdl"));  
  8.         Object[] o=c.invoke("qqCheckOnline"new String[]{"531086641","591284436"});  
  9.           
  10. //调用.net本机开发的webservice  
  11. Client c1=new Client(new URL("http://localhost/zj/Service.asmx?wsdl"));  
  12. Object[] o1=c1.invoke("HelloWorld",new String[]{});  
  13.           
  14. }  


三、使用axis1.4调用webservice方法 
   前提条件:下载axis1.4包和tomcat服务器   ,并将axis文件夹复制到tomcat服务器的webapp文件夹中 
   这里我就说一下最简单的方法: 
         首先建立一个任意的java类(例如:HelloWorld.java),复制到axis文件夹下,将其扩展名改为jws,然后重新启动tomcat,在浏览器中输入http://localhost:8989/axis/HelloWorld.jws?wsdl,就会得到一个wsdl文件,其客户端调用方法如下: 

Java代码 
  1. import javax.xml.rpc.Service;   
  2. import javax.xml.rpc.ServiceException;   
  3. import javax.xml.rpc.ServiceFactory;   
  4. import java.net.MalformedURLException;   
  5. import java.net.URL;   
  6. import java.rmi.RemoteException;   
  7. import javax.xml.namespace.QName;   
  8.   
  9. public class TestHelloWorld {   
  10.   
  11.   
  12.     public static void main(String[] args) throws MalformedURLException, ServiceException, RemoteException {   
  13.         // TODO Auto-generated method stub   
  14.            
  15.         String wsdlUrl ="http://localhost:8989/axis/HelloWorld.jws?wsdl";   
  16.         String nameSpaceUri ="http://localhost:8989/axis/HelloWorld.jws";   
  17.         String serviceName = "HelloWorldService";   
  18.         String portName = "HelloWorld";   
  19.            
  20.         ServiceFactory serviceFactory = ServiceFactory.newInstance();   
  21.         Service afService =serviceFactory.createService(new URL(wsdlUrl),new QName(nameSpaceUri, serviceName));   
  22.         HelloWorldInterface proxy = (HelloWorldInterface)afService.getPort(new QName(nameSpaceUri, portName),HelloWorldInterface.class);   
  23.         System.out.println("return value is "+proxy.getName("john") ) ;   
  24.            
  25.     }   
  26.   
  27. }  
Java代码 
  1. import javax.xml.rpc.Service;  
  2. import javax.xml.rpc.ServiceException;  
  3. import javax.xml.rpc.ServiceFactory;  
  4. import java.net.MalformedURLException;  
  5. import java.net.URL;  
  6. import java.rmi.RemoteException;  
  7. import javax.xml.namespace.QName;  
  8.   
  9. public class TestHelloWorld {  
  10.   
  11.   
  12.     public static void main(String[] args) throws MalformedURLException, ServiceException, RemoteException {  
  13.         // TODO Auto-generated method stub  
  14.           
  15.         String wsdlUrl ="http://localhost:8989/axis/HelloWorld.jws?wsdl";  
  16.         String nameSpaceUri ="http://localhost:8989/axis/HelloWorld.jws";  
  17.         String serviceName = "HelloWorldService";  
  18.         String portName = "HelloWorld";  
  19.           
  20.         ServiceFactory serviceFactory = ServiceFactory.newInstance();  
  21.         Service afService =serviceFactory.createService(new URL(wsdlUrl),new QName(nameSpaceUri, serviceName));  
  22.         HelloWorldInterface proxy = (HelloWorldInterface)afService.getPort(new QName(nameSpaceUri, portName),HelloWorldInterface.class);  
  23.         System.out.println("return value is "+proxy.getName("john") ) ;  
  24.           
  25.     }  
  26.   
  27. }  


四、使用axis2开发webservice(这里首先感谢李宁老师)    
  使用axis2 需要先下载  

   axis2-1.4.1-bin.zip 

   axis2-1.4.1-war.zip 
  http://ws.apache.org/axis2/   
  同理,也需要将axis2复制到webapp目录中 
在axis2中部署webservice有两种方法, 
    第一种是pojo方式,这种方式比较简单,但是有一些限制,例如部署的类不能加上包名 
    第二种方式是利用xml发布webservice,这种方法比较灵活,不需要限制类的声明 
    下面分别说明使用方法: 
    1.pojo方式:在Axis2中不需要进行任何的配置,就可以直接将一个简单的POJO发布成WebService。其中POJO中所有的public方法将被发布成WebService方法。先实现一个pojo类: 

Java代码 
  1. public class HelloWorld{   
  2.     public String getName(String name)   
  3.     {   
  4.         return "你好 " + name;   
  5.     }       
  6.     public int add(int a,int b)   
  7.     {   
  8.         return a+b;   
  9.     }       
  10. }  
Java代码 
  1. public class HelloWorld{  
  2.     public String getName(String name)  
  3.     {  
  4.         return "你好 " + name;  
  5.     }      
  6.     public int add(int a,int b)  
  7.     {  
  8.         return a+b;  
  9.     }      
  10. }  


由于这两个方法都是public类型,所以都会发布成webservice。编译HelloWorld类后,将HelloWorld.class文件放到%tomcat%\webapps\axis2\WEB-INF\pojo目录中(如果没有pojo目录,则建立该目录),然后打开浏览器进行测试: 
输入一下url:  

http://localhost:8080/axis2/services/listServices 
会列出所有webservice 
  
这是其中的两个webservice列表,接着,在客户端进行测试: 
首先可以写一个封装类,减少编码,代码如下: 
 

Java代码 
  1. package MZ.GetWebService;   
  2. import javax.xml.namespace.QName;   
  3.   
  4. import org.apache.axis2.AxisFault;   
  5. import org.apache.axis2.addressing.EndpointReference;   
  6. import org.apache.axis2.client.Options;   
  7. import org.apache.axis2.rpc.client.RPCServiceClient;   
  8.   
  9.   
  10. public class GetWSByAxis2 {   
  11.       private static String EndPointUrl;   
  12.       private static String QUrl="http://ws.apache.org/axis2";   
  13.       private QName opAddEntry;    
  14.       public String WSUrl;   
  15.       public RPCServiceClient setOption() throws AxisFault   
  16.       {   
  17.           RPCServiceClient serviceClient = new RPCServiceClient();   
  18.           Options options = serviceClient.getOptions();   
  19.           EndpointReference targetEPR = new EndpointReference(WSUrl);   
  20.           options.setTo(targetEPR);   
  21.           return serviceClient;   
  22.       }   
  23.          
  24.       public QName getQname(String Option){   
  25.              
  26.           return new QName (QUrl,Option);   
  27.       }   
  28.  //返回String   
  29.       public String getStr(String Option) throws AxisFault   
  30.       {   
  31.           RPCServiceClient serviceClient =this.setOption();    
  32.         
  33.           opAddEntry =this.getQname(Option);   
  34.          
  35.          String str = (String) serviceClient.invokeBlocking(opAddEntry,    
  36.                           new Object[]{}, new Class[]{String.class })[0];   
  37.          return str;   
  38.      }   
  39. // 返回一维String数组   
  40.       public String[] getArray(String Option) throws AxisFault   
  41.       {   
  42.           RPCServiceClient serviceClient =this.setOption();    
  43.         
  44.           opAddEntry =this.getQname(Option);   
  45.          
  46.          String[] strArray = (String[]) serviceClient.invokeBlocking(opAddEntry,    
  47.                           new Object[]{}, new Class[]{String[].class })[0];   
  48.          return strArray;   
  49.      }   
  50.       //从WebService中返回一个对象的实例   
  51.      public Object getObject(String Option,Object o) throws AxisFault   
  52.      {    
  53.         RPCServiceClient serviceClient =this.setOption();    
  54.          QName qname=this.getQname(Option);   
  55.          Object object = serviceClient.invokeBlocking(qname, new Object[]{},new Class[]{o.getClass()})[0];   
  56.          return object;   
  57.      }   
  58.         
  59. /////////////////////////////////////////       读者可以自己封装数据类型,如int,byte,float等数据类型   
  60. }  
Java代码 
  1. package MZ.GetWebService;  
  2. import javax.xml.namespace.QName;  
  3.   
  4. import org.apache.axis2.AxisFault;  
  5. import org.apache.axis2.addressing.EndpointReference;  
  6. import org.apache.axis2.client.Options;  
  7. import org.apache.axis2.rpc.client.RPCServiceClient;  
  8.   
  9.   
  10. public class GetWSByAxis2 {  
  11.       private static String EndPointUrl;  
  12.       private static String QUrl="http://ws.apache.org/axis2";  
  13.       private QName opAddEntry;   
  14.       public String WSUrl;  
  15.       public RPCServiceClient setOption() throws AxisFault  
  16.       {  
  17.           RPCServiceClient serviceClient = new RPCServiceClient();  
  18.           Options options = serviceClient.getOptions();  
  19.           EndpointReference targetEPR = new EndpointReference(WSUrl);  
  20.           options.setTo(targetEPR);  
  21.           return serviceClient;  
  22.       }  
  23.         
  24.       public QName getQname(String Option){  
  25.             
  26.           return new QName (QUrl,Option);  
  27.       }  
  28.  //返回String  
  29.       public String getStr(String Option) throws AxisFault  
  30.       {  
  31.           RPCServiceClient serviceClient =this.setOption();   
  32.        
  33.           opAddEntry =this.getQname(Option);  
  34.         
  35.          String str = (String) serviceClient.invokeBlocking(opAddEntry,   
  36.                           new Object[]{}, new Class[]{String.class })[0];  
  37.          return str;  
  38.      }  
  39. // 返回一维String数组  
  40.       public String[] getArray(String Option) throws AxisFault  
  41.       {  
  42.           RPCServiceClient serviceClient =this.setOption();   
  43.        
  44.           opAddEntry =this.getQname(Option);  
  45.         
  46.          String[] strArray = (String[]) serviceClient.invokeBlocking(opAddEntry,   
  47.                           new Object[]{}, new Class[]{String[].class })[0];  
  48.          return strArray;  
  49.      }  
  50.       //从WebService中返回一个对象的实例  
  51.      public Object getObject(String Option,Object o) throws AxisFault  
  52.      {   
  53.         RPCServiceClient serviceClient =this.setOption();   
  54.          QName qname=this.getQname(Option);  
  55.          Object object = serviceClient.invokeBlocking(qname, new Object[]{},new Class[]{o.getClass()})[0];  
  56.          return object;  
  57.      }  
  58.        
  59. /////////////////////////////////////////       读者可以自己封装数据类型,如int,byte,float等数据类型  
  60. }  


客户端调用方法: 

Java代码 
  1. MZ.GetWebService.GetWSByAxis2 ws=new MZ.GetWebService.GetWSByAxis2();   
  2. ws.WSUrl="http://localhost:8989/axis2/services/HelloWorld";   
  3. HelloWorld hello= (HelloWorld)ws.getObject("getName", HelloWorld.class);   
  4.                
  5.               
  6.  System.out.println(hello.getName("zhangjin"));  
Java代码 
  1. MZ.GetWebService.GetWSByAxis2 ws=new MZ.GetWebService.GetWSByAxis2();  
  2. ws.WSUrl="http://localhost:8989/axis2/services/HelloWorld";  
  3. HelloWorld hello= (HelloWorld)ws.getObject("getName", HelloWorld.class);  
  4.               
  5.              
  6.  System.out.println(hello.getName("zhangjin"));  


2.使用service.xml发布webservice,这种方式和直接放在pojo目录中的POJO类不同。要想将MyService类发布成Web Service,需要一个services.xml文件,这个文件需要放在META-INF目录中,该文件的内容如下: 

Xml代码 
  1. <service name="HelloWorld">  
  2.     <description>  
  3.         HelloWorld webservice   
  4.     description>  
  5.     <parameter name="ServiceClass">  
  6.         service.HelloWorld     
  7.     parameter>  
  8.     <messageReceivers>  
  9.         <messageReceiver mep="http://www.w3.org/2004/08/wsdl/in-out"  
  10.             class="org.apache.axis2.rpc.receivers.RPCMessageReceiver" />  
  11.         <messageReceiver mep="http://www.w3.org/2004/08/wsdl/in-only"  
  12.             class="org.apache.axis2.rpc.receivers.RPCInOnlyMessageReceiver" />  
  13.     messageReceivers>  
  14. service>  
Xml代码 
  1. <service name="HelloWorld">  
  2.     <description>  
  3.         HelloWorld webservice  
  4.     description>  
  5.     <parameter name="ServiceClass">  
  6.         service.HelloWorld    
  7.     parameter>  
  8.     <messageReceivers>  
  9.         <messageReceiver mep="http://www.w3.org/2004/08/wsdl/in-out"  
  10.             class="org.apache.axis2.rpc.receivers.RPCMessageReceiver" />  
  11.         <messageReceiver mep="http://www.w3.org/2004/08/wsdl/in-only"  
  12.             class="org.apache.axis2.rpc.receivers.RPCInOnlyMessageReceiver" />  
  13.     messageReceivers>  
  14. service>  


其中元素用于发布Web Service,一个元素只能发布一个WebService类,name属性表示WebService名,如下面的URL可以获得这个WebService的WSDL内容: 
http://localhost:8080/axis2/services/myService?wsdl 
  除此之外,还有直接可以在其中制定webservice操作方法:可以这样些service.xml文件 

Java代码 
  1. "HelloWorld">   
  2.        
  3.        HelloWorld service   
  4.        
  5.     "ServiceClass">   
  6.         service.HelloWorld     
  7.        
  8.     "getName">   
  9.         class="org.apache.axis2.rpc.receivers.RPCMessageReceiver" />   
  10.        
  11.     "add">   
  12.         
  13.             class="org.apache.axis2.rpc.receivers.RPCMessageReceiver" />   
  14.        
  15.   
Java代码
  1. "HelloWorld">  
  2.       
  3.        HelloWorld service  
  4.       
  5.     "ServiceClass">  
  6.         service.HelloWorld    
  7.       
  8.     "getName">  
  9.         class="org.apache.axis2.rpc.receivers.RPCMessageReceiver" />  
  10.       
  11.     "add">  
  12.         
  13.             class="org.apache.axis2.rpc.receivers.RPCMessageReceiver" />  
  14.       
  15.   


如果要发布多个webservice,可以在文件两段加上...发布

 

你可能感兴趣的:(Java调用webservice接口方法(SOAP message、xfire、axis))