Webservice相关的知识

• 一、利用jdk web服务api实现，这里使用基于 SOAP message 的 Web 服务
•      1.首先建立一个Web services EndPoint：
• package Hello;   
• import javax.jws.WebService;   
• import javax.jws.WebMethod;   
• import javax.xml.ws.Endpoint;   
•   
• @WebService  
• public class Hello {  
•  
• @WebMethod  
• public String hello(String name) {   
• return "Hello, " + name + " ";   
• }   
•     
•  public static void main(String[] args) {   
•    // create and publish an endpoint   
•        Hello hello = new Hello();   
•        Endpoint endpoint = Endpoint.publish("http://localhost:8080/hello", hello);    
•         }   
• } 
•     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.客户端程序：
•       
• 1class HelloClient{   
• 2public 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}
• 9
•  
•      以上方法还稍显繁琐，还有更加简单的方法
•  
• 二、使用xfire，我这里使用的是myeclipse集成的xfire进行测试的
•     利用xfire开发WebService，可以有三种方法：
•       1一种是从javabean 中生成；
•       2 一种是从wsdl文件中生成；
•       3 还有一种是自己建立webservice
•     步骤如下：
•     用myeclipse建立webservice工程，目录结构如下：
•   
•     首先建立webservice接口，
•      代码如下：
•      
• 1package com.myeclipse.wsExample;
• 2//Generated by MyEclipse
• 3
• 4public interface IHelloWorldService {
• 5    
• 6    public String example(String message);
• 7    
• 8}
•       接着实现这个借口：
•  1package com.myeclipse.wsExample;
•  2//Generated by MyEclipse
•  3
•  4public class HelloWorldServiceImpl implements IHelloWorldService {
•  5    
•  6    public String example(String message) {
•  7        return message;
•  8    }
•  9    
• 10}
•    修改service.xml 文件，加入以下代码：
•  
•  1<service>
•  2        <name>HelloWorldService</name>
•  3        <serviceClass>
•  4            com.myeclipse.wsExample.IHelloWorldService
•  5        </serviceClass>
•  6        <implementationClass>
•  7            com.myeclipse.wsExample.HelloWorldServiceImpl
•  8        </implementationClass>
•  9        <style>wrapped</style>
• 10        <use>literal</use>
• 11        <scope>application</scope>
• 12    </service>
•  把整个项目部署到tomcat服务器中 ，打开浏览器，输入http://localhost:8989/HelloWorld/services/HelloWorldService?wsdl,可以看到如下： 
•      
•  然后再展开HelloWorldService后面的wsdl可以看到：
•  
• 客户端实现如下：
•  1package com.myeclipse.wsExample.client;
•  2
•  3import java.net.MalformedURLException;
•  4import java.net.URL;
•  5
•  6import org.codehaus.xfire.XFireFactory;
•  7import org.codehaus.xfire.client.Client;
•  8import org.codehaus.xfire.client.XFireProxyFactory;
•  9import org.codehaus.xfire.service.Service;
• 10import org.codehaus.xfire.service.binding.ObjectServiceFactory;
• 11
• 12import com.myeclipse.wsExample.IHelloWorldService;
• 13
• 14public class HelloWorldClient {
• 15public static void main(String[] args) throws MalformedURLException, Exception {
• 16// TODO Auto-generated method stub
• 17Service s=new ObjectServiceFactory().create(IHelloWorldService.class);
• 18XFireProxyFactory xf=new XFireProxyFactory(XFireFactory.newInstance().getXFire());
• 19String url="http://localhost:8989/HelloWorld/services/HelloWorldService";
• 20
• 21        try
• 22        {            
• 23            
• 24            IHelloWorldService hs=(IHelloWorldService) xf.create(s,url);
• 25            String st=hs.example("zhangjin");
• 26            System.out.print(st);
• 27        }
• 28        catch(Exception e)
• 29        {
• 30            e.printStackTrace();
• 31        }
• 32    }
• 33
• 34}
• 35
•        这里再说点题外话，有时候我们知道一个wsdl地址，比如想用java客户端引用.net 做得webservice，使用myeclipse引用，但是却出现无法通过验证的错误，这时我们可以直接在类中引用，步骤如下：
•         
•  1public 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        
•  7//远程调用.net开发的webservice
•  8Client c=new Client(new URL("http://www.webxml.com.cn/webservices/qqOnlineWebService.asmx?wsdl"));
•  9        Object[] o=c.invoke("qqCheckOnline", new String[]{"531086641","591284436"});
• 10        
• 11//调用.net本机开发的webservice
• 12Client c1=new Client(new URL("http://localhost/zj/Service.asmx?wsdl"));
• 13Object[] o1=c1.invoke("HelloWorld",new String[]{});
• 14        
• 15}
•  
• 三、使用axis1.4调用webservice方法
•    前提条件：下载axis1.4包和tomcat服务器   ，并将axis文件夹复制到tomcat服务器的webapp文件夹中
•    这里我就说一下最简单的方法：
•          首先建立一个任意的java类（例如：HelloWorld.java），复制到axis文件夹下,将其扩展名改为jws，然后重新启动tomcat，在浏览器中输入http://localhost:8989/axis/HelloWorld.jws?wsdl，就会得到一个wsdl文件，其客户端调用方法如下：
•   
•  1import javax.xml.rpc.Service;
•  2import javax.xml.rpc.ServiceException;
•  3import javax.xml.rpc.ServiceFactory;
•  4
•  5import java.net.MalformedURLException;
•  6import java.net.URL;
•  7import java.rmi.RemoteException;
•  8
•  9import javax.xml.namespace.QName;
• 10
• 11public class TestHelloWorld {
• 12
• 13
• 14    public static void main(String[] args) throws MalformedURLException, ServiceException, RemoteException {
• 15        // TODO Auto-generated method stub
• 16        
• 17        String wsdlUrl ="http://localhost:8989/axis/HelloWorld.jws?wsdl";
• 18        String nameSpaceUri ="http://localhost:8989/axis/HelloWorld.jws";
• 19        String serviceName = "HelloWorldService";
• 20        String portName = "HelloWorld";
• 21        
• 22        ServiceFactory serviceFactory = ServiceFactory.newInstance();
• 23        Service afService =serviceFactory.createService(new URL(wsdlUrl),new QName(nameSpaceUri, serviceName));
• 24        HelloWorldInterface proxy = (HelloWorldInterface)afService.getPort(new QName(nameSpaceUri, portName),HelloWorldInterface.class);
• 25        System.out.println("return value is "+proxy.getName("john") ) ;
• 26        
• 27    }
• 28
• 29}
• 30
• 四、使用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类：
•  
•  1public 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}
• 11
•    由于这两个方法都是public类型，所以都会发布成webservice。编译HelloWorld类后，将HelloWorld.class文件放到%tomcat%webappsaxis2WEB-INFpojo目录中（如果没有pojo目录，则建立该目录），然后打开浏览器进行测试：
• 输入一下url： 
• http://localhost:8080/axis2/services/listServices
• 会列出所有webservice
•   
• 这是其中的两个webservice列表，接着，在客户端进行测试：
• 首先可以写一个封装类，减少编码，代码如下：
•   
•   
•  1package MZ.GetWebService;
•  2import javax.xml.namespace.QName;
•  3
•  4import org.apache.axis2.AxisFault;
•  5import org.apache.axis2.addressing.EndpointReference;
•  6import org.apache.axis2.client.Options;
•  7import org.apache.axis2.rpc.client.RPCServiceClient;
•  8
•  9
• 10public 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}
• 61
• 客户端调用方法：
•  
• MZ.GetWebService.GetWSByAxis2 ws=new MZ.GetWebService.GetWSByAxis2();
• ws.WSUrl="http://localhost:8989/axis2/services/HelloWorld";
• HelloWorld hello= (HelloWorld)ws.getObject("getName", HelloWorld.class);
•             
•            
•  System.out.println(hello.getName("zhangjin"));
•      2.使用service.xml发布webservice，这种方式和直接放在pojo目录中的POJO类不同。要想将MyService类发布成Web Service，需要一个services.xml文件，这个文件需要放在META-INF目录中，该文件的内容如下：
•     <description>
•         HelloWorld webservice
•     </description>
•     <parameter name="ServiceClass">
•         service.HelloWorld  
•     </parameter>
•     <messageReceivers>
•         <messageReceiver mep="http://www.w3.org/2004/08/wsdl/in-out"
•             class="org.apache.axis2.rpc.receivers.RPCMessageReceiver" />
•         <messageReceiver mep="http://www.w3.org/2004/08/wsdl/in-only"
•             class="org.apache.axis2.rpc.receivers.RPCInOnlyMessageReceiver" />
•     </messageReceivers>
• </service>
• 其中<service>元素用于发布Web Service，一个<service>元素只能发布一个WebService类，name属性表示WebService名，如下面的URL可以获得这个WebService的WSDL内容：
• http://localhost:8080/axis2/services/myService?wsdl
•   除此之外，还有直接可以在其中制定webservice操作方法：可以这样些service.xml文件
•  2    <description>
•  3       HelloWorld service
•  4    </description>
•  5    <parameter name="ServiceClass">
•  6        service.HelloWorld  
•  7    </parameter>
•  8    <operation name="getName">
•  9        <messageReceiver class="org.apache.axis2.rpc.receivers.RPCMessageReceiver" />
• 10    </operation>
• 11    <operation name="add">
• 12        <messageReceiver
• 13            class="org.apache.axis2.rpc.receivers.RPCMessageReceiver" />
• 14    </operation>
• 15</service>
• 16
• 如果要发布多个webservice，可以在文件两段加上<serviceGroup><service></service>...<service></service></serviceGroup>发布