开发人员应该知道的webservice知识

为什么说说webservice呢？

如今soa炒得火热，各大公司招聘都在要求懂soa技术，虽然大的概念是面向架构服务，说白了就是服务整合，把以前的老应用跟新应用通信，实现应用集成。具体实现技术为webservice。

webservice是什么？

webservice 提供的接口传递数据格式借助xml数据包传递的，基于soap对象访问协议，并且请求都遵行http协议,由于每中语言,对xml 数据包都遵行这一规则,这就提供了,不同开发平台下、不同系统的接口调用与访问。

规则与协议：

       1.XML:描述数据的标准方法.

　　2. SOAP :简单对象访问协议.

　　3.WSDL:Web服务描述语言.

　　4.UDDI(Universal Description, Discovery and Integration):通用描述、发现与集成，它是一种独立于平台的，基于XML语言的用于在互联网上描述商务的协议。

webservice实现方式（转自：http://blog.163.com/yexuan_1/blog/static/13436609920121833513679/）： 

一、利用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 + "\n";   
}   
    
 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.客户端程序：
      

1 class  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接口，
     代码如下：

     

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

      接着实现这个借口：

 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 文件，加入以下代码：
 

 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可以看到：
   
客户端实现如下：

 1 package  com.myeclipse.wsExample.client;
 2
 3 import  java.net.MalformedURLException;
 4 import  java.net.URL;
 5
 6 import  org.codehaus.xfire.XFireFactory;
 7 import  org.codehaus.xfire.client.Client;
 8 import  org.codehaus.xfire.client.XFireProxyFactory;
 9 import  org.codehaus.xfire.service.Service;
10 import  org.codehaus.xfire.service.binding.ObjectServiceFactory;
11
12 import  com.myeclipse.wsExample.IHelloWorldService;
13
14 public   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引用，但是却出现无法通过验证的错误，这时我们可以直接在类中引用，步骤如下：
        

 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        
 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文件，其客户端调用方法如下：
  

 1 import  javax.xml.rpc.Service;
 2 import  javax.xml.rpc.ServiceException;
 3 import  javax.xml.rpc.ServiceFactory;
 4
 5 import  java.net.MalformedURLException;
 6 import  java.net.URL;
 7 import  java.rmi.RemoteException;
 8
 9 import  javax.xml.namespace.QName;
10
11 public   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类：
 

 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}
11

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

http://localhost:8080/axis2/services/listServices

会列出所有webservice
  
这是其中的两个webservice列表，接着，在客户端进行测试：
首先可以写一个封装类，减少编码，代码如下：
  
  

 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}
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目录中，该文件的内容如下：

< service name = " HelloWorld " >
     < 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文件

 1 < service name = " HelloWorld " >
 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>发布

以上纯属个人理解，如有疑义，欢迎大家拍砖啊！