Chinaunix首页 | 论坛 | 博客
  • 博客访问: 5436604
  • 博文数量: 895
  • 博客积分: 17977
  • 博客等级: 上将
  • 技术积分: 8691
  • 用 户 组: 普通用户
  • 注册时间: 2005-08-26 09:59
个人简介

一个好老好老的老程序员了。

文章分类

全部博文(895)

文章存档

2021年(2)

2020年(10)

2019年(40)

2018年(88)

2017年(130)

2015年(5)

2014年(12)

2013年(41)

2012年(36)

2011年(272)

2010年(1)

2009年(53)

2008年(65)

2007年(47)

2006年(81)

2005年(12)

分类: 系统运维

2011-05-12 23:33:54

Axis框架构建webservice
1.axis概述。
A. Axis2是一个web服务//WSDL引擎,它继承Apache Axis广泛使用的SOAP堆栈,它有两个实现版本-----和C。它是主流的webservice开发框架之一,实现方便,安全的,可靠的。它支持热部署,以及异步webservice的调用等。
B.要求java版本,jdk至少是1.5及以上版本。
C.传输:HTTP,SMTP,JMS,TCP
D.支持规范:① SOAP 1.1 和 1.2。
             ② 消息传输优化机制(MTOM),优化的XML包装(XOP)和SOAP带附件。
             ③ WSDL 1.1中,包括SOAP和HTTP绑定,(本身支持WSDL1.1和2.0)。
             ④ WS-Addressing。一种将消息寻址信息综合到 services消息中的标准。
             ⑤ WS-Policy。Web 服务策略框架。
             ⑥ SAAJ 1.1 。(SOAP with Attachments API for JAVA SAAJ)是在松散耦合软件系统中利用SOAP协议实现的基于XML消息传递的API规范。顾名思义,SAAJ支持带附件的SOAP消息。

2.获取axis包。
在Apache官方网站下载框架组件包,的版本是axis2-1.5.1,如下包:
2010年5月7日 - 黑夜中的星星 - 黑夜中的星星 clip_image002.jpg
下载 (13.39 KB)
2010-4-22 14:43

A.Axis2-1.5.1-docs.zip解压后有xdoc和javadoc两个文档,xdoc讲的就是就是一些关于axis的概述,javadoc就是axis的java类的帮助文档。
B.Axis2-1.5.1-src.zip解压后就是axis的源码。
C.Axis2-1.5.1-war.zip解压后除了license.txt,readme.txt外就是一个axis2.war,这个文件是部署axis2到web容器的文件,其实就是一个发布好的应用。
D.Axis2-1.5.1-bin.zip这个文件是最重要的了,里面包含了我们使用的所有java开发所需要的jar文件,还包括提供的一些工具。有bin,conf,lib,repository,samples,webapp文件夹,bin里面有axis2提供的一些工具。如下:
2010年5月7日 - 黑夜中的星星 - 黑夜中的星星 clip_image003.jpg
下载 (19.58 KB)
工具
2010-4-22 14:43

Bat的文件用于windows环境下,sh用于Unix环境下。
Conf文件夹里是axis配置文件axis2.,可修改默认。
Lib文件夹里就是所有的jar文件。
Samples是一些例子。
Repository里是启用应用所依赖的文件。

3.发布一个基于pojo的webservice。
A.先解压我们下载好的Axis2-1.5.1-war.zip文件,获得axis.war文件,把它放到我们安装好的应用服务器发布目录。这里我们把它放到tomcat安装目录的webapps目录下。启动tomcat,打开浏览器,输入如果出现以下页面,说明我们安装成功。
2010年5月7日 - 黑夜中的星星 - 黑夜中的星星 clip_image001.jpg
下载 (100.28 KB)
2010-4-22 14:43


B.编写如下:
public class HelloService
{
        public String sayHello(String name)
        {
                System.out.println("Hello " + name +"!");
                return "Hello " + name +"!";
        }
}
把上面代码编译后的class文件放入webappsaxis2WEB-INFpojo目录下,如果没有pojo文件夹则自己创建,注意不要加包。
输入 出现以下页面
2010年5月7日 - 黑夜中的星星 - 黑夜中的星星 1111.jpg
(87.12 KB)
2010-4-22 14:43

可以看到所有已发布的可见的webservice,这里有三个,HelloService是我们刚刚发布的,version是版本信息,SimpleService是我昨天发布的。

就可以在页面访问我们的了。
C.下面我们编写java程序的客户端来调用我们写的webservice。编写代码如下:
package client;
import javax.xml.namespace.QName;
import org.apache.axis2.addressing.EndpointReference;
import org.apache.axis2.client.Options;
import org.apache.axis2.rpc.client.RPCServiceClient;
public class HelloServiceClient {
            public static void main(String[] args) throws Exception{
                //  使用RPC方式调用WebService        
             RPCServiceClient serviceClient = new RPCServiceClient();
                Options options = serviceClient.getOptions();
                //  指定调用WebService的URL
                EndpointReference targetEPR = new EndpointReference(
                        "");
                options.setTo(targetEPR);
                //  指定getGreeting方法的参数值
                Object[] opAddEntryArgs = new Object[] {"alaric"};
                //  指定getGreeting方法返回值的数据类型的Class对象
                Class[] classes = new Class[] {String.class};
                //  指定要调用的getGreeting方法及WSDL文件的命名空间
           QName opAddEntry = new QName("", "sayHello");
                //  调用getGreeting方法并输出该方法的返回值
                System.out.println(serviceClient.invokeBlocking(opAddEntry, opAddEntryArgs, classes)[0]);
                   
        }

}
运行(为了保证调用成功,运行时保证你的web服务已经启动)结果如下:
2010年5月7日 - 黑夜中的星星 - 黑夜中的星星 RAUBK%P4C1HR~SOENVHE7.jpg
(27.61 KB)
2010-4-22 14:43

关于更多axis2的java类及其继承关系和方法的使用请查看我们下的包Axis2-1.5.1-docs.zip里的javadoc。
D.也许你已经看出以上这种方法编写客户端程序太麻烦,所有的调用都得我们自己写。现在我们用用axis提供的工具wsdl2java来生成客户端stub,这样我们调用远程webservice就像调用本地一样方便。先来看看我们的wsdl,在地址栏里输入以下地址:?wsdl
可以看到wsdl。现在我们在环境变量里加入
AXIS2_HOME=D:Program Filesaxis2-1.4(注意这里是你的axsi2的工具解压目录)。在path里加入%AXIS2_HOME%\bin。输入wsdl2java -uri ?wsdl -p client -s -o d:\stub其中-url参数指定了wsdl文件的,可以是本地路径,也可以是网络路径。-p参数指定了生成的Java类的包名,-o参数指定了生成的一系列文件保存的根目录。就可以得到stub,然后我们可以像如下程序来调用服务:
package client;
public class HelloStubClient {
         public static void main(String[] args) throws Exception  
            {
                HelloServiceStub stub = new HelloServiceStub();
HelloServiceStub.SayHello hello= new HelloServiceStub.SayHello();
                hello.setArgs0("zhangjinping");
                System.out.println( stub.sayHello(hello).get_return());
          
            }
}
编译运行以上代码,运行结果如下:
2010年5月7日 - 黑夜中的星星 - 黑夜中的星星 I}[)71C9M1062IDL3TIRE.jpg
(11.21 KB)
2010-4-22 14:43

到这里我们的简单的pojo发布webservice已经结束了。也许你已经看出,pojo发布一个webservice的缺陷,它不能带包名。实际应用中不可能这么做。那么我们用services.xml来发布,须看下节。
4.利用services.xml来发布webservice。
A.编写带有包名的pojo类如下:
    package service;

import java..Date;

public class MyService {
     public String sayHello(String name){
             return "你好, "+name;
     }
     public void dataUpdate(String data){
            System.out.println(data+" 已经更新!");
     }
}
编译上面文件,获得MyService.class文件。
然后准备个services.xml文件。如下:

   
        Web Service
   

   
        service.MyService  
   

   
                    class="org.apache.axis2.rpc.receivers.RPCMessageReceiver" />
                 class="org.apache.axis2.rpc.receivers.RPCInOnlyMessageReceiver" />
   



其中元素用于发布Web Service,一个元素只能发布一WebService类,name属性表示WebService名,如下面的URL可以获得这个WebService的WSDL内容: 其中name属性名就是上面URL中"?"和"/"之间的部分。元素表示当前Web Service的描述,元素用于设置WebService的参数,在这里用于设置WebService对应的类名。在这里最值得注意的是元素,该元素用于设置处理WebService方法的处理器。例如,getGreeting方法有一个返回值,因此,需要使用可处理输入输出的RPCMessageReceiver类,而update方法没有返回值,因此,需要使用只能处理输入的RPCInOnlyMessageReceiver类。
                建立如下目录:
                    D:wsserviceMyService.class
                              D:wsMETA-INFservice.xml
                在命令符下进入d:ws,然后把这两个文件夹带放好的文件一块打成ws.aar文件(实际上,.jar文件也可以发布webservice,但axis2官方文档中建议使      用.aar文件发布webservice)
          命令: jar -cvf ws.aar . (不明白的可以输入jar –help获得帮助来看它的用法)
                 
(20.15 KB)
2010-4-22 14:54

                Ok,ws.aar文件已经生成我们把它放到Tomcat 6.0webappsaxis2WEB-INFservices
                这个目录下,重启我们的tomcat服务。
               输入看到我们的webservice多了一个。
           
(25.4 KB)
2010-4-22 14:55
      
               
B.编写客户端程序和pojo里面的一样这里不再说了。
   另外services.xml文件中也可以直接指定WebService类的方法,如可以用下面的配置代码来发布WebService:

   
   
        Web Service例子
   

   
        service.MyService  
   

   
        
   

   
                    class="org.apache.axis2.rpc.receivers.RPCInOnlyMessageReceiver" />
   




上面的配置代码前面的部分和以前的services.xml文件的内容相同,但后面使用了元素来指定每一个WebService方法,并单独指定了处理每一个方法的处理器。对于客户端来说,调用使用这两个services.xml文件发布的WebService并没有太大我区别,只是使用第二个services.xml文件发布WebServices后,在使用wsdl2java命令或使用C#、delphi等生成客户端的stub时,update方法的String类型被封装在了update类中,在传递update方法的参数时需要建立update类的对象实例。而使用第一个services.xml文件发布的WebService在生成stub时直接可以为update方法传递String类型的参数。从这一点可以看出,这两种方法生成的WSDL有一定的区别。但实际上,如果客户端程序使用第一个services.xml文件发布的WebService生成stub类时(这时update方法的参数是String),在服务端又改为第二个services.xml文件来发布WebService,这时客户端并不需要再重新生成stub类,而可以直接调用update方法。也就是说,服务端使用什么样的方式发布WebService,对客户端并没有影响。
如果想发布多个WebService,可以使用元素,如再建立一个MyService1类,代码如下:
package service
public class MyService1
{
    public String getName()  
    {
        return "bill";
    }
}
在services.xml文件中可以使用如下的配置代码来配置MyService和MyService1类:

   
        
            Web Service例子
        

        
            service.MyService  
        

        
                            class="org.apache.axis2.rpc.receivers.RPCMessageReceiver" />
                                  class="org.apache.axis2.rpc.receivers.RPCInOnlyMessageReceiver" />
        

   

   
        
            Web Service例子
      

        
            service.MyService1  
        

         
                           class="org.apache.axis2.rpc.receivers.RPCMessageReceiver" />
                                    class="org.apache.axis2.rpc.receivers.RPCInOnlyMessageReceiver" />
        

   


到这里我webservice的发布可以任你所想去发布了。
还得注意一点:怎么处理复杂对象在网络之间的传输。
C.        复杂对象在webservice之间的传输:
    在实际的应用中,不仅需要使用WebService来传递简单类型的数据,有时也需要传递更复杂的数据,这些数据可以被称为复合类型的数据。数组与类(接口)是比较常用的复合类型。在Axis2中可以直接使用将WebService方法的参数或返回值类型声明成数组或类(接口)。但要注意,在定义数组类型时只能使用一维数组,如果想传递多维数组,可以使用分隔符进行分隔,如下面的代码所示:
String[] strArray = new String[]{ "自行车,飞机,火箭","中国,美国,德国", "超人,蜘蛛侠,钢铁侠" } ;
    上面的代码可以看作是一个3*3的二维数组。
    在传递类的对象实例时,除了直接将数组类型声明成相应的类或接口,也可以将对象实例进行序列化,也就是说,将一个对象实例转换成字节数组进行传递,然后接收方再进行反序列化,还原这个对象实例。
阅读(448) | 评论(0) | 转发(0) |
0

上一篇:Apache Axis2

下一篇:Axis2

给主人留下些什么吧!~~