微信公众号搜"智元新知"关注
微信扫一扫可直接关注哦!

WebService学习笔记4——AXIS1基础

 

1.AXIS简介:

Axis是Apache组织推出的SOAP引擎,Axis项目是Apache组织著名的SOAP项目的后继项目,目前最新版本是采用Java开发的1.1版本,C++的版本正在开发之中。
但是Axis不仅仅是一个SOAP引擎,它还包括

(1). 一个独立运行的SOAP服务器。
(2).一个servlet引擎的插件,这个servlet引擎可以是Tomcat。
(3).对WSDL的扩展支持

(4).一个将WSDL的描述生成java类的工具。
(5).一些示例代码
(6).还有一个监控TCP/IP包的工具。

2.Axis安装配置:

(1)、环境 J2SE SDK,Servlet 容器,如Tomcat 6.0。

(2)、到 http://ws.apache.org/Axis/网站下载Axis安装包。
(3)、解压缩安装包,将Axis_UNZIP_PATH/Axis-version/webapps下的Axis包拷贝到TOMCAT_HOME/webapps目录下,以下约定Axis_HOME为该TOMCAT_HOME/webapps/Axis目录。

(4)、启动tomcat,访问http://localhost:8080/Axis 检查安装是否成功。

(5)、以上步骤执行成功,可以开发webservice例子了。

3.AXIS的发布方式:

AXIS提供了两种Webservice的发布方式:

及时发布(Instant Deployment)。

定制发布(Custom Deployment)。

4.AXIS的及时发布方式——java web service(jws):

(1).对即时发布的支持是Axis的特色之一,使用即时发布只需将提供服务的java类的源代码后缀改为”.jws”,然后将该jws文件放到”%Tomcat_HOME%/webapps/axis”目录下,即可将其迅速发布成Web服务。每当用户调用这类服务的时候,Axis会自动进行编译,即使服务器重启了也不必对其做任何处理,使用非常简单快捷。

(2).需要注意的是:JWS的web服务发布是一个很简单的Web服务发布方式,在页面中你不能使用包,而且由于代码是在运行期被编译的,所以在部署之后,你也很难找到错误所在。

5.AXIS定制发布方式——wsdd方式:

(1).即时发布是一项令人激动的技术,它使Web服务的开发变得如此简单;然而即时发布并不总是最好的选择,比如有些应用系统是第三方提供的,我们没有购买源代码,只有.class文件,但我们又希望将这个应用系统的一些功能对外发布成Web服务,使其能够在更大范围内产生作用,这个时候即时发布技术就无能为力了。此外,即时发布技术并不灵活,无法进行更多的服务配置,这使得它并不能满足一些特定系统的需求。

(2).将java源代码编译成.class文件,放置到“%Tomcat_HOME%/webapps/axis/”目录下,即可着手进行发布。定制发布不需要构建.jws文件,但必须在” %Tomcat_HOME%/webapps/axis/WEB-INF/”目录下创建服务发布描述文件deploy.wsdd(Web Service Deployment Descriptor的缩写),这个文件负责描述服务的名称、入口等信息,其内容如下:

[xhtml]  view plain copy
  1. <deployment xmlns="http://xml.apache.org/axis/wsdd/" xmlns:java="http://xml.apache.org/axis/wsdd/providers/java">  
  2. <!--provider=””java:RPC”是服务类型,除了RPC方式以外,还有Document、Wrapped和Message方式-->  
  3.        service name="服务名" provider="java:RPC"<!--告诉服务应该调用的类-->  
  4.  parameter name="className" value="服务实现类全路径"/>  
  5. <!--告诉服务可以调用这个类中的任何的Public方法,也可以指定方法名-->  
  6.  parameter name="allowedMethods" value="*"/>  
  7. parameter name=”scope” value=”request”/>  
  8.        </service>  
  9.   deployment>  
 

(3).部署定制服务:

使用Axis提供的一个客户端管理工具——AdminClient来完成服务的定制发布。
   在“%Tomcat_HOME%/webapps/axis/”目录下,运行:

   java -cp %AXISCLAsspATH% org.apache.axis.client.AdminClient deploy.wsdd

java -cp %AXISCLAsspATH% org.apache.axis.client.AdminClient -l http://localhost:8081/WebServiceTest/services/WebServiceServer.WSServer deploy.wsdd

如果运行时说没有找到类,那么可能是类路径没有配置好,建议将所有的与axis相关的jar都写到classpath中去。这样只要运行:

   java org.apache.axis.client.AdminClient deploy.wsdd
   可以看到以下运行结果:

 Processing file deploy.wsdd
 <Admin>Doneprocessing</Admin>

  这表明服务定制发布完成。
 
   你也可以调用
 java org.apache.axis.client.AdminClient undeploy.wsdd  来取消部署。

   你也可以调用
 java org.apache.axis.client.AdminClient list 来获得所有的已经部署的服务的列表。在这里你会看到services,handlers,transports等等,注意这个调用只是列出了WEB-INF/server-config.wsdd的文件内容

(4).注意:编译后的class文件要拷贝到WEB-INF/classes的目录中,如果该文件中有包存在的话,别忘了还要在classes目录下创建包的目录
   通过访问http://localhost:8080/axis/services/工程名称?wsdl可以看到这个服务的WSDL描述文件,这说明服务被成功发布了。

6.客户端调用AXIS发布的服务:

 

7. AXIS支持三种对象范围:
(1).request范围:这是认的情况,每一次Soap请求的时候都将创建新的对象。
(2).application范围:将会为所有的请求生成一个单独的共享的对象。
(3).session范围:为每一个session期的客户端请求创建一个对象。
  指定方法如下:

[xhtml]  service name="MyService"...>  
  • parameter name="scope" value="对象范围"/>  
  • ...  
  • >  

  •  8. AXIS的Handler和Handlers Chain:

     Webservice的Handler可以在Webservice每个方法调用之前或之后做一些特定事情,如权限验证,记录日志等等常用操作。

    (1).定义Handler:

    自定义的Handler必须要继承BasicHandler类,并实现其中的invoke(MessageContext context)方法,其中MessageContext参数是AXIS上下文。

    Handler通过getoperation(String string)方法获得配置文件属性值,通过<requestFlow>标签来讲Handler引入到某个Service中。

    (2).配置Handler:

    在wsdd文件中加入如下配置:

    [xhtml]  handler name=”handler名称” type=”java:handler全路径名”>  
  •        parameter name=”handler变量名” value=”……”/>  
  •        ……  
  • handler>  
  •  

    (3).为WebService引入Handler:

    在wsdd文件的<service>中加入如下配置:

     

    (4).Hanlder Chain:

    a.定义Handler Chain:

    Handler Chain是实现一连串多个Handler的链,Chain必须继承SimpleChain类,然后在构造方法中使用:this.addHandler(handler对象);将Handler加入到Chain中。

    b.配置Handler Chain:

    在wsdd文件中,Chain的配置和Handler有些不同,<chain>元素中的子元素只允许是<handler>或者<chain>,即允许<chain>嵌套,具体配置如下:

     

    9.WebService传递复杂对象:

    (1).创建Qname:

    [java] 
  • Qname表示XML规范中定义的限定名称,由名称空间URI、本地部分和前缀组成,如:  
  • //第一个参数是名称空间,第二个参数是本地部分  
  • Qname qn = new Qname(”urn:AddressManager”, ”Address”);  
  •  

    (2).注册对象类型映射:

    如:

     

    (4).设置传递的方法参数类型:

    如:

    [java] 
  • call.addParameter(“参数名”, XMLType.XSD_ANYTYPE, ParameterModel.IN);  
  •  

    (5).在wsdd文件加上类型映射:

    在<service>标签中加入如下配置:

    [xhtml]  beanMapping qname=”前缀:本地名”  
  • xmlns:前缀=”urn:名称空间”  
  • languageSpecificType=”java:自定义类型全路径”/>  
  •  

    10.WebService传递带有内部类的复杂对象:

    (1).内部类必须是可序列化的,内部类必须是静态的,否则不能被序列化。

    (2).内部类也要像自定义类一样进行映射和注册,如:

     

    (3).在wsdd文件中配置内部类的相关映射:

    如:

    [xhtml]  beanMapping qname=”本地名”  
  • xmlns:前缀=”urn:名称空间”  
  • languageSpecificType=”java:外部类全路径$内部类名”/>  
  •  

    11.Webservice的RMI调用方式:

    本地实现一个Remote接口,其中包含远程webservice的调用方法(同名、同返回类型、同参数类型),则通过service可以获得一个对远程webservice对象的引用,用该引用可以直接像调用本地方法一样调用远程方法

    (1).服务器端不用继承或者实现任何接口。

    (2).通过如下方法使本地的远程接口获取webservice引用:

     

    12.WebService传递异常对象:

    (1).自定义异常。

    (2).方法中抛出该异常对象。

    (3).在wsdd文件中加入如下配置:

    在<service>元素的<operation>标签中加入<fault>子标签如下:

    [xhtml]  operation name=”……”fault name=”……”  
  • qname=”……”  
  • type=”tns:ServerException”/>  
  • operation>  
  • typeMapping qname=”……”  
  • type=”java:自定义异常类全路径”  
  • serializer=”org.apache.axis.encoding.ser.BeanSerializerFactory”  
  • deserializer=“org.apache.axis.encoding.ser.BeanDeSerializerFactory”  
  • encodingStyle=http://schemas.xmlsoap.org/soap/encoding/”/>  
  •  

    13.WebService传递文件

    (1).服务器端方法

    [java] 
  • public String receive(DataHandler handler, String fileName){  
  •        File file = new File(fileName);  
  • if(handler == null || filename == null || fileName.equals(“”)){  
  •        return “failure”;  
  • }  
  • InputStream input = null;  
  • FileOutputStream fos = null;  
  • try{  
  •        input = handler.getInputStream();  
  •        fos = new FileOutputStream(file);  
  •        byte[] buffer = new byte[1024];  
  •        while(input.read(buffer) != -1){  
  •               fos.writer(buffer);  
  • }  
  • }catch(Exception e){  
  •        e.printstacktrace();  
  • }finally{  
  •        if(input != null){  
  •               try{  
  •        input.close();  
  • }catch(IOException e){  
  • }  
  • }  
  • if(fos != null){  
  •        try{  
  •        fos.close();  
  • }catch(Exception e){  
  • }  
  • }  
  • }  
  • return “success”;  
  • }  
  •  

    注意:DataHandler是一个专门的传送器,通过它可以把文件进行序列化。

    (2).wsdd文件进行如下配置:

    [xhtml]  service name=”FileReceiverServer” provider=”java:RPC”parameter name=”className” value=”服务器文件接收类全路径”/>  
  •        ……  
  •        operatiojn name=”receive”  
  • qname=”operNS:receive”  
  • xmlns:operNS=”receive”  
  • returnType=”rtns:String”  
  • xmlns:rtns=”http://www.w3.org/2001/xmlSchema”>  
  • parameter name=”handler” type=”myns:DataHandler”  
  • xmlns:myns=http://www.w3.org/XmlSchema”/>  
  •               parameter name=”fileName” type=”tns:String”  
  • xmlns:tns=http://www.w3.org/XmlSchema”>  
  •        typeMapping qname=”myns:DataHandler”  
  • xmlns:myns=”DataHandler”  
  • languageSpecific=”java:javax.activation.DataHandler”  
  • serializer=”org.apache.axis.encoding.ser.JAFDataHandlerSerializerFactory”  
  • deserializer=”org.apache.axis.encoding.ser.JAFDataHandlerDeSerializerFactory” encodingstyle=http://schemas.xmlsoap.org/soap/encoding/”>  
  •  

    (3).客户端传递DataHandler对象:

     

    文件路径名的获取一般写法如:

     

    版权声明:本文内容由互联网用户自发贡献,该文观点与技术仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容, 请发送邮件至 [email protected] 举报,一经查实,本站将立刻删除。

    相关推荐