AXIS实现Web应用

本文主要介绍使用service方式实现Web服务、复杂类型参数或者返回值以及面向消息/文档的服务类型，同时还会简单提及Web服务的会话管理以及安全问题等等。

前段时间我的一篇文章《应用AXIS开始Web服务之旅》介绍了如何通过AXIS 这个项目来实现Web服务的功能。

该文章主要介绍AXIS的结构、如何使用jws文件的方式开发一个简单的Web服务，并用了比较大的篇幅来介绍Web 服务的客户端编程，应该说是使用AXIS开发Web服务的入门篇，本文假设你已经看过《应用AXIS开始Web服务之旅》并对AXIS有一定的基础，在这个基础上我们将要介绍的内容有几个方面包括使用service方式实现Web服务、复杂类型参数或者返回值以及面向消息/文档的服务类型，同时还会简单提及Web服务的会话管理以及安全问题等等。

在开始我们的文章之前，我们还需要搭建一个环境，我们需要一个支持Web服务的web应用程序并假设名字为axis，如何建立请参照《应用AXIS开始Web 服务之旅》文章中的介绍。

使用定制发布编写Web服务使用jws文件的方式编写Web服务具有方便、快捷的优点，它可以很快的将你已有的类发布成Web服务。

但是更多的时候这并不是一个好的主意，因为这种做法引发的问题是我们必须要将已有类的源码发布出来，因为更多的时候我们并不想这样做；另外虽然你可以先用工具开发并调试完毕一个java文件后再改名为jws，但是这多少有些便扭，而且并不是类中的所有方法你都想发布成可通过Web服务来访问的，这时候你就必须将这些方法的修饰符改为不是public 的，这就跟你原有的类不同步，以后的修改将会更加的麻烦。

在这里我把定制发布方式称为service方式，就好像JSP的出现不会使Servlet 失宠的道理一样，有了jws，service 方式还是有它的用武之地，而且是大放异彩。

发布一个service方式的Web服务需要两部分内容：类文件以及Web服务发布描述文件。

下面我们使用一个简单的例子来讲述这个过程。

首先我们需要一个service类，这个类跟普通的类没有任何区别，下面是我们实现一个城市便民服务的类，我们需要将CityService类的两个方法getZip和getTel发布成Web服务，编译该文件并把class文件拷贝到<webapp>/WEB-INF/classes对应目录下。

Package lius.axis.demo;/*** 该类实现了城市服务，用于发布成Web服务* @author Liudong*/public class CityService {/*** 获取指定城市的邮编* @param city* @return*/public String getZip(String city) {return "510630";}/*** 获取指定城市的长途区号* @param city* @return*/public String getTel(String city) {return "020";}}程序已经完成，下面是发布这个Web服务。

打开<webapp>/WEB-INF/server-config.wsdd 如果这个文件不存在则创建一个新的文件，内容如下：<?xml version="1.0" encoding="UTF-8"?><deployment xmlns="/axis/wsdd/"xmlns:java="/axis/wsdd/providers/java"> <globalConfiguration><parameter name="adminPassword" value="admin"/><parameter name="attachments.implementation"value="org.apache.axis.attachments.AttachmentsImpl"/><parameter name="sendXsiTypes" value="true"/><parameter name="sendMultiRefs" value="true"/><parameter name="sendXMLDeclaration" value="true"/><parameter name="axis.sendMinimizedElements" value="true"/><requestFlow><handler type="java:org.apache.axis.handlers.JWSHandler"><parameter name="scope" value="session"/></handler><handler type="java:org.apache.axis.handlers.JWSHandler"><parameter name="scope" value="request"/><parameter name="extension" value=".jwr"/></handler></requestFlow></globalConfiguration><handler name="LocalResponder"type="java:org.apache.axis.transport.local.LocalResponder"/>< code sample is too wide > <handler name="URLMapper"type="java:org.apache.axis.handlers.http.URLMapper"/><handler name="Authenticate"type="java:org.apache.axis.handlers.SimpleAuthenticationHandler"/> < code sample is too wide > <service name="city" provider="java:RPC"> <!-- 服务类名 --><parameter name="className" value="lius.axis.demo.CityService"/><!-- 允许访问所有方法 --><parameter name="allowedMethods" value="*"/></service><transport name="http"><requestFlow><handler type="URLMapper"/><handlertype="java:org.apache.axis.handlers.http.HTTPAuthHandler"/></requestFlow></transport><transport name="local"><responseFlow><handler type="LocalResponder"/></responseFlow></transport></deployment>其中粗斜体的部分是我们服务的配置信息，启动Tomcat并打开浏览求访问地址：http://localhost:8080/axis/services/city?wsdl ，下面是浏览器显示我们Web服务的WDSL数据。

当然了，这个过程比起jws方式来说是稍微麻烦一点，你可以把它想象成你发布一个servlet一样，创建servlet类然后在web.xml中加入配置信息。

处理复杂类型参数和返回值之前我们做的演示程序都很简单，方法的参数和返回值都是简单类型的数据，但是在实际应用过程中往往没有这么简单。

在使用面向对象的编程语言时，我们会希望数据类型可以是某个对象，比如我们提供一个接口用来发送短信息，那么我们希望接口的参数是一个消息对象，这个消息对象封装了一条信息的所有内容包括发送者、接收者、发送时间、优先级、信息内容等等，如果我们把每个内容都做成一个参数，那这个接口的参数可能会非常的多。

因此封装成对象是很有必要的。

在使用Axis来编写Web服务时对复杂类型数据的处理同样也是非常简单。

Axis 要求复杂类型对象的编写必须符合JavaBean的规范，简单的说就是对象的属性是通过getter/setter方法来访问的。

来看看下面这个简单的例子所输出的WSDL信息有何特殊的地方。

为了简便，我们还是使用jws来编写，需要编写三个文件：sms.jws,Message.java,Response.java。

//文件名：sms.jwsimport lius.axis.demo.*;public class sms{/*** 短信息发送Web服务接口*/public Response send(Message msg) throws Exception{ System.out.println("CONTENT:"+msg.getContent());Response res = new Response();res.setMessage(msg);res.setCode(0);res.setErrorText("");return res;}}//Message.javapackage lius.axis.demo;/*** 欲发送的信息* @author Liudong*/public class Message {private String from;private String to;private String content;private int priority;public String getContent() {return content;}public void setContent(String content) {this.content = content;}public String getFrom() {return from;}public void setFrom(String from) {this.from = from;}public int getPriority() {return priority;}public void setPriority(int priority) {this.priority = priority;}public String getTo() {return to;}public void setTo(String to) {this.to = to;}}//Response.javapackage lius.axis.demo;/*** 信息发送回应，在这里我们做了一个对Message 类的引用 * @author Liudong*/public class Response {private int code;//发送结果代码private String errorText;private Message message;//发送的原始信息public int getCode() {return code;}public void setCode(int code) {this.code = code;}public String getErrorText() {return errorText;}public void setErrorText(String errorText) {this.errorText = errorText;}public Message getMessage() {return message;}public void setMessage(Message message) {this.message = message;}}编译Message.java和Response.java并将编译后的类文件拷贝到axis/WEB-INF/classes对应包的目录下，sms.jws拷贝到axis目录，访问http://localhost:8080/axis/sms.jws?wsdl即可看到WSDL信息，这些信息与之前不同的在于下面列出的内容(注意粗斜体部分内容)：<wsdl:types><schema targetNamespace="http://demo.axis.lius"xmlns="/2001/XMLSchema"><import namespace="/soap/encoding/" /> <complexType name="Message"><sequence><element name="content" nillable="true" type="xsd:string" /> <element name="from" nillable="true" type="xsd:string" /><element name="priority" type="xsd:int" /><element name="to" nillable="true" type="xsd:string" /></sequence></complexType><complexType name="Response"><sequence><element name="code" type="xsd:int" /><element name="errorText" nillable="true" type="xsd:string" /> <element name="message" nillable="true" type="tns1:Message" /> </sequence></complexType></schema></wsdl:types>这里定义了两个类型Message和Response，就是我们接口的参数类型以及返回值的类型。