WebService学习笔记4——AXIS1基础

发布时间：2020-12-16 23:05:13 所属栏目：安全来源：网络整理

导读：? 1.AXIS简介： Axis是Apache组织推出的SOAP引擎，Axis项目是Apache组织著名的SOAP项目的后继项目，目前最新版本是采用Java开发的1.1版本，C++的版本正在开发之中。但是Axis不仅仅是一个SOAP引擎，它还包括： (1).?一个独立运行的SOAP服务器。 (2).一个serv

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

<deployment?xmlns="http://xml.apache.org/axis/wsdd/"?xmlns:java="http://xml.apache.org/axis/wsdd/providers/java">??
??
???????service?name="服务名"?provider="java:RPC"??
?parameter?name="className"?value="服务实现类全路径"/>??
??
?parameter?name="allowedMethods"?value="*"/>??
parameter?name=”scope”?value=”request”/>??
???????</service>??
??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发布的服务：

[java]?

String?url?=”AXIS服务的发布地址路径”;??

Service?serv?=?new?Service();??

Call?call?=?(Call)serv.createCall();??

call.setTargetEndpointAddress(url);??

call.setOperationName(new?QName(url,?“调用服务的方法名”));??

call.invoke(new?Object[]{参数对象});??

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>中加入如下配置：

[xhtml]? requestFlow>或者responseFlowhandler?type=”handler名”/>??

>??

(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>嵌套，具体配置如下：

[xhtml]? chain?name=”chain名”handler?type=”java:chain的全路径”/>??

???????......??

chain>??

9.WebService传递复杂对象：

(1).创建Qname：

[java]?

Qname表示XML规范中定义的限定名称，由名称空间URI、本地部分和前缀组成，如：??

//第一个参数是名称空间，第二个参数是本地部分??

Qname?qn?=?new?Qname(”urn:AddressManager”,?”Address”);??

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

如：

[java]?

call.registerTypeMapping(对象.class,?QName,??

new?org.apache.axis.encoding.ser.BeanSerializerFactory(对象. new?org.apache.axis.encoding.ser.BeanDeSerializerFactory(对象. [java]?

call.setReturnClass(ArrayList.class);??

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

如：

[java]?

call.addParameter(“参数名”,?XMLType.XSD_ANYTYPE,?ParameterModel.IN);??

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

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

[xhtml]? beanMapping?qname=”前缀:本地名”??

xmlns:前缀=”urn:名称空间”??

languageSpecificType=”java:自定义类型全路径”/>??

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

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

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

[java]?

call.registerTypeMapping(外部类.内部类.BeanSerializerFactory.class);??

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

如：

[xhtml]? beanMapping?qname=”本地名”??

xmlns:前缀=”urn:名称空间”??

languageSpecificType=”java:外部类全路径$内部类名”/>??

11.Webservice的RMI调用方式：

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

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

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

[java]?

接口类型?对象?=??(接口类型)Service对象.getPort(endpoint/QName,?ProxyInterface.class);??

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对象：

[java]?

DataHandler?dh?=?new?DataHandler(new?FileDataSource(文件路径名));??

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

[java]?

FileSenderClient.class.getResource(文件名).getPath();??

（编辑：李大同）

【声明】本站内容均来自网络，其相关言论仅代表作者个人观点，不代表本站立场。若无意侵犯到您的权利，请及时与联系站长删除相关内容!