BlogJava-菠萝三国-文章分类-AXIS

Web Service深度编程——Axis序列化/反序列化器开发指南

菠萝 — Thu, 30 Aug 2007 04:42:00 GMT

JAVA——咖啡馆Velocity 的应用示例- -| 回首页 | 2005年索引 | - -Web Service 的开发层次
Web Service深度编程——Axis序列化/反序列化器- -
Tag： Web Service Axis

Web Service深度编程——Axis序列化/反序列化器开发指南

作者：薛谷雨

作者简介

薛谷雨是NORDSAN(北京)信息科技开发有限公司高级JAVA研发工程师，正致力于企业级异构数据交换的服务器产品的研发，在J2EE和WEB SERVICE方面有较为丰富的开发经验，你可以通过 rainight@126.com 与他取得联系。

前言

Axis是Apache组织推出的SOAP引擎，Axis项目是Apache组织著名的SOAP项目的后继项目。Axis为开发者提供了大量的序列化/反序列化器，能够基本满足大部分应用。但在某些情况下，对特定的对象，现有的序列化/反序列化器不能胜任，于是只有开发人员自己实现专用于此对象的序列化/反序列化器插入到Axis中来完成序列化工作。考虑到Web Service是一门新兴技术，中文资料大多是泛泛的讲解，关于序列化/反序列化器的开发鲜有较为深入的介绍，本文提供一份较为完整的开发指南，并提供了一个十分有用的实现，即序列化JDOM模型的Element,使其可以通过Web 服务在网络上传输，我想这一扩展是许多采用JDOM作为XML解析工具的开发人员都梦寐以求的功能。通过本文的介绍和实例，希望能起到抛砖引玉的作用，读者在阅读完本文之后可以轻松的实现针对于任何非符合BEAN规范的对象的序列化/反序列化器。

本文所面对的读者需要有一定的使用Axis做Web服务开发的开发经验，因此关于如何Axis的基础知识并不在本文的介绍范围，如果读者对此感兴趣，可以参考本文最后的参考资料部分，去相应的网站进行学习。

序列化/反序列化器简介

序列化/反序列化器在英文中的对应翻译是Serializer/Deserializer，一个序列化器的功能是遵循一定的映射规则和编码风格，将一种类型的JAVA对象通过某种特定的机制，转换成为XML描述的形式；反序列化器的功能是序列化器所做工作的逆操作，两者相辅相成，成对出现。Axis中的序列化/反序列化器采用设计范式中的工厂模式，每一个Serializer唯一对应一个SerializerFactory；每一个Deserializer唯一对应一个DeserializerFactory。一种类型的JAVA对象具体要采用哪个序列化/反序列化器需要在提供Web服务的服务器和调用Web服务的客户端分别配置，关于这一部分如何配置，我将在本文后面的内容中进行详细介绍。Axis已经为开发者提供了丰富的序列化/反序列化器,对于java的基本数据类型，绝大部分常用的容器类(比如数组类型，Vector类型等)都提供了实现，特别是提供了对W3C的DOM对象(比如Document, Element等)和符合Bean规范的JAVA对象提供了功能完善的序列化/反序列化器，因此我们在需要的时候只要在配置文件中配置一下就可以直接使用。如果对象中包含其它类型的对象，比如Vector中包含一组Bean对象，Axis会自动叠代的调用序列化器，最终拼装成唯一的XML表述。在还原成JAVA对象时，也遵循这样的叠代操作逆向进行。关于Axis到底内置了哪些序列化/反序列化器，您可以参照Axis的API文档中包org.apache.axis.encoding.ser下的类的名称"望文生义"的了解一下，在以后的开发中做到心中有数。但对于一些特殊类型的对象(其实我们自己开发的很大一部分类都是这种特殊类型的对象，很少有绝对符合Bean规范的)，需要通过Web服务进行传递，我们不得不开发自己的序列化/反序列化器。

开发篇

开发自己的序列化/反序列化器是一个激动人心的工作，但是却并不复杂,需要做的事情包括实现名成为org.apache.axis.encoding的包中的SerializerFactory，Serializer，DeserializerFactory和Deserializer这四个接口。下面我将结合一个实例来讲解序列化/反序列化器的开发方法，希望读者能够一边参看本文提供的源代码一边学习。

JDOM作为一款比较"另类"的XML解析工具(因为它不符合W3C的DOM模型，自己另立一套)默默地占领着java世界里的xml解析器的半壁江山，由于其简洁的设计和方便灵活的API调用，已经渐渐成为了许多开发人员在进行XML开发的首选。但是Axis是建立在W3C的DOM模型的基础之上，师出名们正派，自然不屑与JDOM为伍。因此当开发人员想将自己已经写好的基于JDOM的应用模块采用Web服务的方式发布的时候，不可避免的会遇到如何将JDOM模型下的对象如Document, Element等序列化的问题。在软件工程师不会自己扩展Axis的序列化/反序列化器的时候，我们只能有两个办法达到这个目的，第一个就是更改以前应用模块内的API设计,使暴露的入口参数和返回值参数都是W3C的对象类型，但这种做法并不现实，因为这一应用模块往往不是独立存在，牵一发将动全身，导致旧有系统架构的崩塌；另一种做法就是为这个模块做一个代理类，它做的工作就对外接收或返回DOM模型的对象，对内转换成JDOM模型的对象，然后转发给应用模块，繁琐且效率低下。当我们向Axis注入了针对于JDOM模型的序列化/反序列化器后，这一工作便可以由Axis代劳了。下面我们将逐个开发这四个类：

JDomElementSerializerFactory

JDomElementSerializerFactory是一个工厂类，需要通过某种机制注册到Axis引擎(具体方法见下面"服务器端应用篇")；Axis通过调用它，来实例化JDomElementSerializer。Axis 提供了BaseSerializerFactory,这个类是一个抽象类，并实现其中包含了一些可重用的代码。我们自己开发的工厂类只需简单继承这个类就可以。构造函数中需要调用父类的构造函数将序列器类下面是它的源代码：

package org.apache.axis.encoding.ser;

public class JDomElementSerializerFactory
extends BaseSerializerFactory {

public JDomElementSerializerFactory() {
super(JDomElementSerializer.class);
}
}

JDomElementSerializer

JDomElementSerializer实现org.apache.axis.encoding.Serializer接口，其核心API是serialize()，我们需要在这个方法的内部完成对JDOM模型的Element的序列化工作,序列化的结果要保存在入口参数传入的序列化上下文对象（SerializationContext）中：

public void serialize(QName name, Attributes attributes, Object value,
SerializationContext context) throws java.io.IOException {

if (!(value instanceof Element))
throw new IOException(
Messages.getMessage("cant Serialize Object"));

//获取符合JDOM的Element对象
Element root=(Element)value;

//输出到StringWriter
XMLOutputter outputter=new XMLOutputter();//创建一个JDOM的XML输出器
StringWriter sw=new StringWriter();
outputter.output(root,sw);

//用支持W3C的DOM模型的Xerces解析器解析文本流
DOMParser parser=new DOMParser();//创建一个DOM的XML解析器
try {
parser.parse(new org.xml.sax.InputSource(
new java.io.StringReader(sw.toString())));
}catch (Exception ex) {
throw new java.io.IOException("序列化时产生错误");
}

//获取符合DOM模型的Element对象
org.w3c.dom.Element w3c_root =
parser.getDocument().getDocumentElement();

//放入序列化上下文对象中
context.startElement(name, attributes);
context.writeDOMElement(w3c_root);
context.endElement();
}

JDomElementDeserializerFactory

反序列化器的工厂类同序列化器的工厂类一样的设计，在此不在赘述。代码：

package org.apache.axis.encoding.ser;

public class JDomElementDeserializerFactory
extends BaseDeserializerFactory {

public JDomElementDeserializerFactory() {
super(JDomElementDeserializer.class);
}

}

JDomElementDeserializer

用过SAX解析XML的读者，对反序列化的实现比较容易理解，反序列化也采用了消息触发的机制，我们只需继承org.apache.axis.encoding.DeserializerImpl类，并覆盖其中的onEndElement方法：

/**
* 在元素结束触发反序列化的方法
* @param namespace String 命名空间
* @param localName String 本地名称
* @param context DeserializationContext 反序列化上下文
* @throws SAXException
*/
public void onEndElement(String namespace, String localName,
DeserializationContext context) throws SAXException {

try {
//从反序列化上下文对象中获取原始的消息元素
MessageElement msgElem = context.getCurElement();
if (msgElem != null) {
MessageContext messageContext = context.getMessageContext();
Boolean currentElement = (Boolean) messageContext.getProperty(
DESERIALIZE_CURRENT_ELEMENT);

//如果当前的消息元素本身需要反序列化
if (currentElement != null && currentElement.booleanValue()) {
org.w3c.dom.Element element = msgElem.getAsDOM();
org.jdom.input.DOMBuilder db=new org.jdom.input.DOMBuilder();
value=db.build(element);
messageContext.setProperty(DESERIALIZE_CURRENT_ELEMENT,
Boolean.FALSE);
return;
}

//反序列化消息元素中的消息体
java.util.ArrayList children = msgElem.getChildren();
if (children != null) {

//取得消息体
msgElem = (MessageElement) children.get(0);
if (msgElem != null) {
org.w3c.dom.Element ret = msgElem.getAsDOM();
org.jdom.input.DOMBuilder db=new org.jdom.input.DOMBuilder();

//用DOMBuilder将DOM模型的Element,转换成JDOM模型的Element
value=db.build(ret);
}
}

}
}
catch (Exception ex) {
//错误，则记日志,并抛SAXException
log.error(Messages.getMessage("exception00"), ex);
throw new SAXException(ex);
}
}

完成这四个类的编码，序列化/反序列化器的开发工作基本完成，下面将详细讲解使用及部署方法。

服务器端应用篇

为了简单起见，我们将一个很简单的类通过Web服务发布,类中只有一个名称为hello函数，函数的返回值为JDOM模型的Element。代码如下：

package test;

import org.jdom.*;
import java.rmi.RemoteException;

public class Sample1 implements java.rmi.Remote{
public Sample1() {
}

public Element hello(String name){
Element root=new Element("root");
Element hello=new Element("hello");
hello.setText("hello,"+name+"!");
root.addContent(hello);
return root;
}

}

关于如何将一个类发布成Web服务，在此并不进行介绍，相信读者可以自己完成，我们只关注如何将序列化/反序列化器加入到我们的Web服务中。打开web服务的配置文件server-config.xml,编辑关于Sample1的服务的配置部分：

注意上面代码中的粗体字部分，是我们现在要添加的，它表述了如何将序列化反序列化器部署到Web服务中。

部署到Web Server

解压缩本文后面附带的源代码，根目录下有build.xml文件，读者需要正确安装配置好Apache Ant，然后运行

Ant make

编译后可生成压缩文件sample.war。将生成的war包部署到Tomcat4.1下，启动Tomcat,本文默认的Tomcat监听的http端口为8080。后面的客户端测试程序也将通过连接这一端口访问此Web服务。如果读者的Tomcat不在8080端口上工作，那么客户端程序也要进行相应的修改。最后启动Tomcat,这部分操作完成。

客户端应用篇

下面我们将编写客户端程序访问刚才部署的Web服务，讲解如何把我们编写的序列化/反序列化器加载到客户端应用程序中，下面是客户端调用的代码,注意斜体字部分，是关于序列化/反序列化器的注册过程(如果你的Web服务器不是工作在8080端口，或采用了其他Web服务名，请自行更改下面程序中的url变量中的值)，我们在test包下创建了一个名称为 Client的类，代码如下：

package test;

import org.apache.axis.client.Service;
import org.apache.axis.client.Call;
import org.apache.axis.utils.Options;
import javax.xml.namespace.QName;

public class Client {
public Client() {
}

public static void main(String[] args) throws Exception{
if(args.length<1){
System.out.println("错误：缺少参数");
System.exit(0);
}
//Web服务的URL
String url="http://localhost:8080/sample/services/Sample1";
Service service=new Service();
Call call = (Call)service.createCall();
call.setTargetEndpointAddress(url);

//注册序列化/反序列化器
call.registerTypeMapping(org.jdom.Element.class,
new QName("http://jdom.org","Element"),
new org.apache.axis.encoding.ser.JDomElementSerializerFactory(),
new org.apache.axis.encoding.ser.JDomElementDeserializerFactory());

//设置调用方法
call.setOperationName(
new javax.xml.namespace.QName("http://test", "hello"));

//Web服务调用
java.lang.Object _resp = call.invoke(new java.lang.Object[] {args[0]});

//输出到屏幕
org.jdom.output.XMLOutputter out=new org.jdom.output.XMLOutputter();
out.output( (org.jdom.Element) _resp, System.out);

}

}

编译后运行该程序，在控制台窗口工程的根目录下输入

run world ( 其中"world"为调用例程中API的入口参数)

经过一次web通讯，一两秒后屏幕将显示运行结果：

hello,world!

至此我们完成了一次Web服务的访问过程。如果在程序执行过程中，我们用TCP Moniter之类的工具监视这一次访问中的在网络中流入流出的数据，可以看到客户端发起调用的xml数据流如下：

POST /sample/services/Sample1 HTTP/1.0
Content-Type: text/xml; charset=utf-8
Accept: application/soap+xml,
application/dime, multipart/related, text/*
User-Agent: Axis/1.1
Host: 127.0.0.1
Cache-Control: no-cache
Pragma: no-cache
SOAPAction: ""
Content-Length: 430

world

服务器端返回的结果的XML输出流如下：

HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Date: Wed, 31 Mar 2004 06:42:18 GMT
Server: Apache Coyote/1.0
Connection: close

hello,world!

结语

以上详细讲解了Axis的序列化/反序列化器的开发过程，相信读者已经从中学到了不少知识，并能够应用于自己的项目开发中去。通过掌握这一技术，我们将更为深刻的理解Axis的内部结构和Web服务的工作机理，这些经验是市面上那些泛泛的讲解JAVA Web服务的参考书上所学不到的。后续的文章还将向您展示一些在Java Web服务深度开发中的高级技术，让您真正驾驭Axis。

参考资料

附件中提供了本文中的全部源码，它是一个完整的工程,可以参考学习。
在apache的网站您可以获得最新的Axis库及其开发文档：http://ws.apache.org/axis/ 本文中提到的Tomcat Web服务器可以在这里免费获得：http://jakarta.apache.org/tomcat/index.html
《IBM DEVELOPWORK》中一个关于web服务的教程《从JAVA类创建web服务》，是您快速掌握Web服务开发的很好教材，初学者可以进行学习。
JDOM类库可以去www.jdom.org下载，CSDN上有一篇不错的文章可以让您快速掌握JDOM的使用方法。http://www.csdn.net/develop/Read_Article.asp?Id=13806

菠萝 2007-08-30 12:42 发表评论

Axis开发Webservice传Bean对象返回String串的实例

菠萝 — Thu, 30 Aug 2007 04:32:00 GMT

Axis开发Webservice传Bean对象返回String串的实例

这几天也一直在为了设计与实现一个业务平台,想用Webservice 来作为核心技术来实现,也一直想精溢求精地把这个东东搞好, 突然觉得好久没来这里写日志了.呵,时间如白驹过隙啊!

对于webService 以前也接触过.但只是皮毛,这次可是来真格的.来就来吧,年轻人这就是机会.一定得把握好,干它一票! 呵,就在网上到处找找啊,在本地机器上左试试,右试试啊, 什么法子都用一遍。就不信搞不定它，小样！

网上的例子也比较散，比较简易的，达不我想要的业务水平，只能慢慢搜索与摸索吧。。。。。。就这样天天想着这事，也没什么心情来这里写写。

近些天，也快回深圳了，定在下周四动身吧。这边的工作也得告一节了。把我前一些日子，搞一个完整的Samples 放到这里来，与大家共享。希望对有心人有些启发，也希望高人指点与点评。。。。。。。、

   ****************************************************
   *Axis开发Webservice传Bean对象返回String串的实例.rtf*
   ****************************************************

在ECLIPSE 里新建一工程，其次建包，再次建类，
基本包：samples.userguide.example5
基本类： Order.java

内容：
* Order.java *
*《********************************

package samples.userguide.example5;

/**
* This is a JavaBean which represents an order for some products.
* Copyright: Copyright (c) 2007-1
* @author Black skin (blackskin@126.com)
* @version 1.0
*/
public class Order {
/** Who's ordering */
private String customerName;

/** Where do they live */
private String shippingAddress;

/** Which items do we want */
private String itemCodes[];

/** And how many */
private int quantities[];

// Bean accessors

public String getCustomerName() {
return customerName;
}

public void setCustomerName(String name) {
customerName = name;
}

public String getShippingAddress() {
return shippingAddress;
}

public void setShippingAddress(String address) {
shippingAddress = address;
}

public String[] getItemCodes() {
return itemCodes;
}

public void setItemCodes(String[] items) {
itemCodes = items;
}

public int[] getQuantities() {
return quantities;
}

public void setQuantities(int[] quants) {
quantities = quants;
}
}

********************************》*

主服务包: samples.userguide.example5
主服务类: BeanService.java

如下：
* BeanService.java *
**《*******************************
package samples.userguide.example5;

/**
* This is a JavaBean which represents an order for some products.
* Copyright: Copyright (c) 2007-1
* @author Black skin (blackskin@126.com)
* @version 1.0
*/

public class BeanService {
public String processOrder(Order order) {
String sep = System.getProperty("line.separator");

String response = "Hi, " + order.getCustomerName() + "!" + sep;

response += sep + "You seem to have ordered the following:" + sep;

String[] items = order.getItemCodes();
int[] quantities = order.getQuantities();

for (int i = 0; i < items.length; i++) {
response += sep + quantities[i] + " of item : " + items[i];
}

response += sep + sep + "If this had been a real order processing system, "
+ sep + "we'd probably have charged you about now.";

return response;
}

public static void main(String[] args) throws Exception{
/** Who's ordering */
String customerName = "Black Skin";
/** Where do they live */
String shippingAddress = "001 xingan Street, bayuquan, YK";
/** Which items do we want */
String[] items = new String[] { "apple", "160ml-Milk" };
/** And how many */
int[] quantities = new int[] { 2, 4 };
/** request class init() */
Order order = new Order();
order.setCustomerName(customerName);
order.setShippingAddress(shippingAddress);
order.setItemCodes(items);
order.setQuantities(quantities);
/** server class init() */
BeanService beanservice = new BeanService();
String result = beanservice.processOrder(order);
/** OutPut the result */
System.out.println(" " + result);
}

}

********************************》*

BeanService.java里有个本地测试方法(samples.userguide.example5.BeanService.main())，来测试此应用的可运行性；

到此，服务端类写完了，接着来把此类的方法发布成 WebService 接口

手写一个deploy.wsdd 文件，可以参考下面的例子：
*deploy.wsdd例子*
*《********************************

http://xml.apache.org/axis/wsdd/" xmlns:java="http://xml.apache.org/axis/wsdd/providers/java">

********************************》*

显然，简单，造一个deploy.wsdd 信手捏来,如下：
      *deploy.wsdd*
*《********************************
http://xml.apache.org/axis/wsdd/" xmlns:java="http://xml.apache.org/axis/wsdd/providers/java">






********************************》*

有了deploy.wsdd文件了，接着通过它来生成 server-config.wsdd.
OK! 用命令直接生成就行；在deploy.wsdd 的文件夹下新建一个 makeWsdd.bat.
其中的写法有下面的例子来参考：

* makeWsdd.bat 例子*
*《********************************
set AXISCLASSPATH= “应用发布的路径”
set AXIS_LIB= “AXIS框架的内部JAR包LIB路径”
SET CLASSPATH=.;%CLASSPATH%;%AXIS_LIB%\wsdl4j-1.5.1.jar;%AXIS_LIB%\axis.jar;%AXIS_LIB%\jaxrpc.jar;
%AXIS_LIB%\saaj.jar;%AXIS_LIB%\commons-discovery-0.2.jar;%AXIS_LIB%\commons-logging-1.0.4.jar

java -Djava.ext.dirs=%AXISCLASSPATH% org.apache.axis.client.AdminClient
-S服务名\services\AdminService -p端口号（如果你的端口号不是默认的8080需要指定。
例如：8899）deploy.wsdd
********************************》*

如此，我写了一“makeWsdd.bat”文件。如下：

* makeWsdd.bat*
*《********************************
set AXISCLASSPATH=C:\Axis_webservice\Tomcat_4.1\webapps\axis
set AXIS_LIB=C:\axis-1_4\lib
SET CLASSPATH=.;%CLASSPATH%;%AXIS_LIB%\wsdl4j-1.5.1.jar;%AXIS_LIB%\axis.jar;%AXIS_LIB%\jaxrpc.jar;
%AXIS_LIB%\saaj.jar;%AXIS_LIB%\commons-discovery-0.2.jar;%AXIS_LIB%\commons-logging-1.0.4.jar

java -Djava.ext.dirs=%AXISCLASSPATH% org.apache.axis.client.AdminClient
-SBeanServer\services\AdminService -p 8080 deploy.wsdd
********************************》*

保存好，接下来架设Webservice.

架设AXIS：
首先，将deploy.wsdd文件Copy到 %AXISCLASSPATH%/WEB-INF 目录下；
其次，将之前的类编译后，连路径一起Copy到 %AXISCLASSPATH%/WEB-INF/classes目录下，
最后，将tomcat的 catalina 服务启动.
（即：C:\Axis_webservice\Tomcat_4.1\bin,

   [特别注意的是：]
       Ａ。tomcat务必启动。
       Ｂ。在写如上的命令行时，务必注意参数的写法。“-D”　与 “-S”与其值间不能有空格。切记！
       C。各XX的路径里，最好是不要有空格，因为JAVA里对大小写与路径空格有校验。
，）

测试：
命令行启动方法；运行"cmd",在命令行里写："cd C:\Axis_webservice\Tomcat_4.1\bin",回车，再写：" catalina run ",回车，OK！
后台会报错：
"
- Unable to find config file. Creating new servlet engine config file: /WEB-INF/server-config.wsdd
2007-1-20 10:07:48 org.apache.coyote.http11.Http11Protocol start
信息: Starting Coyote HTTP/1.1 on port 8080
"
说明，在../WEB-INF/下没有"server-config.wsdd",暂时忽略。
在IE地址栏写：http://localhost:8080/axis
可见，axis 欢迎首页，点击 "list" 便可看到默认情况下发布了两个服务下各有一个方法。一切准备工作已经OK！

再回到，刚才我们写的那个批处理文件：" makeWsdd.bat"，
直接双击，便可执行，有一个警告，可以忽略的。执行完成后，在相应的
%AXISCLASSPATH%/WEB-INF下便有一“server-config.wsdd”文件，如下：

*server-config.wsdd*
*《********************************

http://xml.apache.org/axis/wsdd/" xmlns:java="http://xml.apache.org/axis/wsdd/providers/java">









http://xml.apache.org/axis/wsdd/

********************************》*

再去打开："http://localhost:8080/axis/servlet/AxisServlet",或者，再刷新。
便可以看到，我们新发布的一个webservice接口服务，其名为："OrderProcessor "
此服务下的个方法：其名为："processOrder "。

点击服务对应的"（WSDL）"可见服务WSDL描述内容。在其中也可以得服务的访问地址：
"http://localhost:8080/axis/services/OrderProcessor?wsdl"
服务器端的开发，搞定了！

-:) -:) -:)

接下来，准备开发，客户端的开发。

* Client.java *
*《********************************
package samples.userguide.example5;

/**
* This is a JavaBean which represents an order for some products.
* Copyright: Copyright (c) 2007-1
* @author Black skin (blackskin@126.com)
* @version 1.0
*/

import java.net.URL;

import org.apache.axis.AxisFault;
import org.apache.axis.client.Call;
import org.apache.axis.client.Service;
import org.apache.axis.utils.Options;

import javax.xml.namespace.QName;
import javax.xml.rpc.ParameterMode;

public class Client {
public static void main(String[] args) throws Exception {
//Options options = new Options(args);
String urlWsdl = "http://localhost:8080/axis/services/OrderProcessor?wsdl";

Order order = new Order();
order.setCustomerName("Black Skin");
order.setShippingAddress("275 Grove Street, Newton, MA");

String[] items = new String[] { "apple", "160ml-Milk" };
int[] quantities = new int[] { 8, 4 };

order.setItemCodes(items);
order.setQuantities(quantities);

Service service = new Service();
Call call = (Call) service.createCall();
QName qn = new QName("urn:BeanService", "Order");

call.registerTypeMapping(Order.class, qn,
    new org.apache.axis.encoding.ser.BeanSerializerFactory(
      Order.class, qn),
    new org.apache.axis.encoding.ser.BeanDeserializerFactory(
      Order.class, qn));
String result;
try {
   //call.setTargetEndpointAddress(new java.net.URL(options.getURL()));
   call.setTargetEndpointAddress(new java.net.URL(urlWsdl));
   call.setOperationName(new QName("OrderProcessor", "processOrder"));
   call.addParameter("arg1", qn, ParameterMode.IN);
   call.setReturnType(org.apache.axis.encoding.XMLType.XSD_STRING);

result = (String) call.invoke(new Object[] { order });
} catch (AxisFault fault) {
result = "Error : " + fault.toString();
}

System.out.println(result);
}
}

********************************》*

oK! 到此，一个完整的Webservice例子就搞定了。

另外，Axis 还提供了一些工具，如:" wsdl2java "、" java2wsdl "

处理的方式与方法：
java2wsdl:
   1. 以上为例，在以上工程的class输出目录新建一BAT文件：名为：“java2wsdl.bat”
   2. 其内容为：
         * java2wsdl.bat *
*《********************************
set AXIS_LIB=C:\axis-1_4\lib
SET CLASSPATH=.;%CLASSPATH%;%AXIS_LIB%\wsdl4j-1.5.1.jar;%AXIS_LIB%\axis.jar;%AXIS_LIB%\jaxrpc.jar;%AXIS_LIB%\saaj.jar;%AXIS_LIB%\commons-discovery-0.2.jar;%AXIS_LIB%\commons-logging-1.0.4.jar

java org.apache.axis.wsdl.Java2WSDL -o Order.wsdl -l"http://localhost:8080/axis/services/OrderProcessor" -n "urn:BeanService" -p"samples.userguide.example5.Order" "urn:Order" samples.userguide.example5.BeanService
********************************》*

把AXIS_LIB设为正确的本地包路径，再运行“java2wsdl.bat”，
便可以在目录下看到一个文件：“Order.wsdl”，通过这个WSDL文件，可以生成Webservice接口服务的框架，
既可以是服务器端，也可以是客户端框架。其细节，可以参考下一节。

处理的方式与方法：
wsdl2java :
   1. 以上为例，把Order.wsdl拷贝过来，在其目录下新建一BAT文件：名为：“wsdl2java.bat”
   2. 其内容为：
       * wsdl2java.bat *
*《********************************
set AXIS_LIB=C:\axis-1_4\lib
SET CLASSPATH=.;%CLASSPATH%;%AXIS_LIB%\wsdl4j-1.5.1.jar;%AXIS_LIB%\axis.jar;%AXIS_LIB%\jaxrpc.jar;%AXIS_LIB%\saaj.jar;%AXIS_LIB%\commons-discovery-0.2.jar;%AXIS_LIB%\commons-logging-1.0.4.jar

java org.apache.axis.wsdl.WSDL2Java Order.wsdl
********************************》*

或者有另外的作法：把服务端的应用启动，直接写成：
“
java org.apache.axis.wsdl.WSDL2Java http://localhost:8080/axis/services/OrderProcessor?wsdl
”
保存好后，运行这个BAT文件，
便会自动生成:
BeanService_pkg\
BeanService.java
BeanServiceService.java
BeanServiceServiceLocator.java
OrderProcessorSoapBindingStub.java
Order.java

ok.

菠萝 2007-08-30 12:32 发表评论

使用Apache Axis部署 Web服务时的常见问题及其解决方法

菠萝 — Thu, 16 Aug 2007 09:04:00 GMT

本文详细介绍了在Linux环境下以Apache Axis+ Resin作为Web服务平台部署Web服务时的常见问题及解决方法。衷心希望本文对Web服务的开发人员或对Web服务感兴趣的读者能起到一定的帮助作用。

1 引言

随着Web服务技术的发展和成熟，其方便性和易用性已逐渐被人们所接受，越来越多的合作伙伴之间开始利用Web服务来实现合作方之间的数据接口。使用Apache Axis和Linux平台是一种低成本的Web服务解决方案，但Apache Axis文档的FAQ对开发者来说内容还不够丰富，本文作者将自己使用Axis时遇到的问题和解决方法整理成文，奉献给Web服务的开发人员和对此感兴趣的读者朋友，旨在帮助大家节约一些宝贵的时间。有关Web服务的基础知识，读者可以阅读参考文献中推荐的文档。作者未在文中介绍Apache和Resin的安装方法，读者可以参考相关网站的说明文档。

作者使用的软件环境如下。

操作系统：Red Hat Linux 7.2

Web服务器: Apache 1.3.27

应用服务器：Resin 2.1.8 ( http://www.caucho.com/ )

SOAP服务器：Apache Axis 1.1

XML解析器：Xerces 2.5.0，Xalan 2.5.1

JDK版本：JDK 1.4.1

2 使用Axis时的常见问题及其解决方法

2.1 Axis运行需要哪些jar文件

对Axis解包后，将axis-1_1/webapps/axis/WEB-INF/lib/目录下的jar文件复制到/usr/local/apache/htdocs/WEB-INF/lib目录下(Web应用程序的目录)。应包括以下jar文件。

axis-ant.jar
            axis.jar
            commons-discovery.jar
            commons-logging.jar
            jaxrpc.jar
            log4j-1.2.8.jar
            name.txt
            saaj.jar
            wsdl4j.jar

如果需要使用axis提供的测试页面，还要将axis-1_1/webapps/axis/目录下的文件复制到/usr/local/apache/htdocs/axis/目录下。应包括以下募?

EchoHeaders.jws
            fingerprint.jsp
            happyaxis.jsp
            index.html

2.2 应该使用哪一种XML解析器

XML解析器选用不当，经常会导致使用Apache Axis时出现一些莫名其妙的问题。

由于Apache Axis 并未对Resin内置的xml解析器进行过测试，因此推荐读者使用已通过测试的Xerces xml解析器。可以从 http://xml.apache.org/xalan-j/index.html 处下载Xalan的Java版XSLT处理器，其中包含了Xerces的Java版XML解析器，不需要再单独下载xml解析器。

Xalan 2.5.1解包后，将bin/目录下的xercesImpl.jar、xml-apis.jar和xalan.jar复制到resin安装目录的lib/目录下，例如/usr/local/resin/lib。

编辑/etc/目录下的profile文件，找到设置CLASSPATH环境变量的位置，在其后加入下面的内容(B shell)。

XMLPARSER=$RESIN_HOME/lib/xalan.jar:$RESIN_HOME/lib/xercesImpl.jar:$RESIN_HOME/lib/xml-apis.jar
            export CLASSPATH=$XMLPARSER:$CLASSPATH

2.2.1 注意事项
如果CLASSPATH中包含其它的XML解析器设置，应将其从CLASSPATH环境变量的设置中去掉，以免发生冲突。

2.3 如何在Resin中使用Xerces的XML解析器

通过修改resin.conf将resin的XmlParser置换为Xerces的XmlParser。在resin.conf对应的Web应用程序配置中加入以下设置。

配置完成后重新启动Resin。

2.4 如何排除XML解析器出现的异常

2.4.1 问题描述

使用http://test.com/axis查看已部署的服务时出现Axis内部错，显示有关WSDD配置的异常信息。如果把WEB-INF目录下的server-config.wsdd删除，再查看就正常了，但只能看到AdminService和Version两个系统缺省的服务，后来部署的服务都看不到了。

2.4.2 原因分析

Axis会在WEB应用程序的WEB-INF/目录下自动生成一个名字为server-config.wsdd的xml文件，其中记录了已部署的WEB服务。每部署一个新的WEB服务时，Axis都会将新服务的描述信息加入到server-config.wsdd中。

故障站点使用的XmlParser是resin内置的XmlParser，Axis并未对其对进行过兼容性测试，查看WEB服务信息时需要从server-config.wsdd(这是一个xml文件)取得已部署的WEB服务描述信息，当server-config.wsdd的内容较复杂时，resin内置的XmlParser因某种原因出现异常，导致Axis内部错误。Server-config.wsdd中记录的Web服务描述信息较少时不会出现异常。

2.4.3 解决方法

修改resin.conf，将resin的XmlParser置换为Xerces的XmlParser。置换方法参见2.3节。

2.4.4 小结

如果Axis报告的错误中有关于xml解析器的错误，建议读者参照本小节描述的方法更换应用服务器的xml解析器，将会有助于问题的解决。

2.5 如何将Axis集成到Resin或其它应用服务器

Axis是以Servlet的方式运行的，而Resin的作用相当于Servlets容器(Container)，因此只要配置得当，就可以使Axis在Resin环境中运行，这一点也适用于Resin以外的其它应用服务器。在Resin中配置Axis的方法如下。

将axis-1_1/webapps/axis/WEB-INF/web.xml中的Servlet配置项复制到resin.conf中对应的Web应用程序配置中。通常应包括以下内容。

 
            
            AxisServlet
            Apache-Axis Servlet
            
            org.apache.axis.transport.http.AxisServlet
            
            
            
            AdminServlet
            Axis Admin Servlet
            
            org.apache.axis.transport.http.AdminServlet
            
            100
            
            
            SOAPMonitorService
            SOAPMonitorService
            
            org.apache.axis.monitor.SOAPMonitorService
            
            
            SOAPMonitorPort
            5001
            
            100
            
            
            AxisServlet
            /axis/servlet/AxisServlet
            
            
            AxisServlet
            *.jws
            
            
            AxisServlet
            /services/*
            
            
            SOAPMonitorService
            /SOAPMonitor
            
            
            
            
            
            wsdl
            text/xml
            
            
            xsd
            text/xml

2.6 Axis提供了哪些开发工具

Apache Axis提供了WSDL2Java和Java2WSDL两个开发工具。

WSDL2Java利用已知的WSDL文件生成服务端和客户端代码。该WSDL文件可以是由合作伙伴提供的，也可以是利用Java2WSDL生成的。Java2WSDL根据已有的Java类文件生成WSDL文件，Java类文件可以是接口类文件，并不需要实现细节。

此外Axis还提供了SoapMonitorApplet和TCPMon工具，可用于监测Web服务。

2.7 如何生成Web服务的服务端和客户端代码

2.7.1 生成或取得WSDL文件

Java2WSDL是Axis提供的利用Java类文件得到WSDL文件的工具。类文件可以使用接口文件编译生成，例如下面的接口文件SoftwarePrice.java。

package samples.userguide.example6;
            /**
            * Interface describing a web service to set and get software prices.
            **/
            public interface SoftwarePrice {
            public void setWidgetPrice(String softWareName, String price);
            public String getWidgetPrice(String softWareName);

编译SoftwarePrice.java。

javac SoftwarePrice.java

将SoftwarePrice.class复制到正确的package路径下。

执行下面的命令:

java org.apache.axis.wsdl.Java2WSDL -o sp.wsdl  -l"http://test.com:80/services/SoftwarePrice" -n "urn:SoftwarePrice"
            -p"samples.userguide.example6" "urn:Example6" samples.userguide.example6.SoftwarePrice

各参数的含义如下。

-o：指定输出的WSDL文件的文件名。
            

            -l：指定服务的位置。
            

            -n：WSDL文件的目标名字空间。
            

            -p：指定从package到名字空间的映射，这里可以有多个映射。

最后面的类文件包含了Web服务的接口。

该命令执行后，将生成sp.wsdl文件。

如果按CLASSPATH的设置找不到指定的类文件，Axis将报告异常，如下所示。

java.lang.ClassNotFoundException: samples.userguide.example6.SoftwarePrice
            at java.net.URLClassLoader$1.run(URLClassLoader.java:198)
            at java.security.AccessController.doPrivileged(Native Method)
            ……

如果出现上面的问题，请检查是否已将有关类文件复制到正确的位置或CLASSPATH设置是否正确。

生成WSDL文件以后，就可以利用Axis提供的WSDL2Java工具生成Web服务的服务端代码和客户端代码了。

2.7.1.1 注意事项

WSDL文件也可以由合作伙伴提供。这种情况下合作伙伴往往是Web服务的提供者或标准接口的制定者，开发者只要按照既定的WSDL文件生成客户端或服务端代码就可以了。

2.7.2 生成客户端或服务端代码

WSDL2Java工具用于从WSDL文件生成客户端存根（stub）代码，服务端框架（skeleton）代码以及WSDL中的数据类型文件(生成与之对应的Java代码)。开发人员只需向框架代码中补充相关的业务逻辑代码即可得到完整的Web服务代码，因此该工具极大地减轻了开发人员的编码负担。WSDL2Java的使用举例如下。

java org.apache.axis.wsdl.WSDL2Java --server-side --skeletonDeploy true MyService.wsdl

执行上述命令后将生成下列文件。

No.	文件	用途
1.	deploy.wsdd	MyService服务的部署描述文件
2.	MyService.java	MyService服务的接口文件
3.	MyServiceService.java	获得MyService服务的接口文件
4.	MyServiceServiceLocator.java	实现MyServiceService接口
5.	MyServiceSoapBindingImpl.java	实现MyService接口，应向其中补充业务逻辑
6.	MyServiceSoapBindingSkeleton.java	MyService服务的服务端框架代码,实现MyService, org.apache.axis.wsdl.Skeleton接口
7.	MyServiceSoapBindingStub.java	MyService服务的客户端存根代码,实现MyService接口
8.	undeploy.wsdd	注销MyService服务的部署描述文件

2.7.3 编写Web服务客户端代码

Web服务的客户端程序完成对Web服务的调用，其程序结构如下。

import com.chinavnet.zx.service.v1_0.*;// WSDL2Java生成的package的名字空间;
            public class TestClient {
            public static void main (String[] args) throws Exception
            {
            com.chinavnet.zx.service.v1_0.SPInterfaceForVNetLocator locator = new  SPInterfaceForVNetLocator();//获得一个locator对象
            locator.setMaintainSession(true);
            com.chinavnet.zx.service.v1_0.SPInterfaceForVNetSoap service = locator.getSPInterfaceForVNetSoap();//获得服务对象
            com.chinavnet.zx.service.v1_0.DetailLedgerFeedbackResult feedbackRes = null;
            //初始化Web服务中定义的数据类型
            try {
            feedbackRes =  service.generalLedgerFeedback();//调用Web服务的方法并取得返回值
            System.out.println("FeedbackResult :");
            if(feedbackRes != null)
            {
            System.out.println("SPID: " +feedbackRes.getSPID());
            System.out.println("errorDesc: " +feedbackRes.getErrorDescription());
            System.out.println("result: " +feedbackRes.getResult());
            }else
            {
            System.out.println("feedbackRes is null!");
            }
            } catch (java.rmi.RemoteException re) {
            //           throw new junit.framework.AssertionFailedError("Remote Exception caught: " + re );
            re.printStackTrace();
            }
            }//End of main()
            }//End of TestClient class

测试客户端程序是非常简单的，将客户端程序编译后，执行"java TestClient"即可。

2.8 如何编写服务端代码

向MyServiceSoapBindingImpl.java添加相关的业务逻辑代码后，将WSDL2Java生成的源程序编译，打包成jar文件，复制到/usr/local/apache/htdocs/WEB-INF/lib/目录下。

2.9 如何发布Web服务

有了deploy.wsdd文件并准备好类文件后，就可以发布MyService服务了。Axis在安装后自动发布了AdminService，利用它可以发布新的Web服务。方法如下。

java org.apache.axis.client.AdminClient -lhttp://localhost:80/services/AdminService deploy.wsdd
            上面的命令执行后，有如下提示。
            Processing file deploy.wsdd
            Done processing

2.10 执行WSDL2Java时报告" 类型被引用但未定义"

2.10.1 问题描述

执行WSDL2Java时报告下面的异常：

java.io.IOException: Type {http://schemas.xmlsoap.org/wsdl/} ArrayOfFailedRecord is referenced but not defined.

2.10.2 原因分析

出现上述情况可能的原因有：

类型未定义就被引用。

使用了错误的名字空间。

WSDL文件中存在输入错误。

2.10.3 解决方法

经过仔细检查发现wsdl文件中的

的type=" s0:ArrayOfFailedRecord"中的s0:前面有一个空格，将空格删除后问题解决了。

2.10.4 小结

WSDL文件中出现的编辑错误有可能导致执行WSDL2Java时出现"类型被引用但未定义"错误。

2.11 server-config.wsdd的作用是什么

server-config.wsdd记录了axis已发布的Web服务的描述信息。

2.12 发布Web服务时报告"Exception:: (404)Not Found"

2.12.1 问题描述

执行java org.apache.axis.client.AdminClient -lhttp://localhost:80/services/AdminService deploy.wsdd命令发布WEB服务时报告如下内容。
            Processing file deploy.wsdd
            Exception:: (404)Not Found

Apache的access_log显示如下。

127.0.0.1 - - [17/Sep/2003:15:56:33 +0800] "POST /services/AdminService HTTP/1.0" 404 293

2.12.2 原因分析

出现这个问题的比较简单的原因可能是端口不对，或URL路径不对(例如路径中多写了目录)，Axis的SoapMonitor服务按指定的端口或URL找不到AdminService，需要检查正确的端口号和URL路径。

比较深层次的原因就复杂得多了。

本文作者遇到的是下面的情况。

AdminService是一个已发布的WEB服务。

AdminClient使用soap协议同AdminService通信，需要按指定的端口和URL定位AdminService，而原来使用的resin.conf中，有两个web-app配置项，配置A的摘要如下所示。


            /usr/local/apache/htdocs/

配置B的摘要如下所示。


            /usr/local/apache/htdocs/esales/

Axis的有关配置在配置B中。

Httpd.conf中的DocumentRoot是/usr/local/apache/htdocs/。

使用java org.apache.axis.client.AdminClient -lhttp://localhost:80/services/AdminService deploy.wsdd发布WEB服务时，需要按http协议解析url: //localhost:80/services/AdminService。由于htdocs/目录下并没有services/目录(services是Axis在resin.conf中的servlet-mapping)，因此应用服务器按resin.conf中的配置去定位AdminService ，因为url的主机名为localhost，因此resin不会到(配置B)中去定位url，而是到配置A中去定位，在配置A中并没有Axis的配置，找不到与AdminService相关的url，因此报告了前面描述的异常情况。

2.12.3 解决方法

知道了原因后，按如下方法就可以解决了。

将配置B中全部关于Axis的配置移到配置A中，注意相应地要改变/etc/profile中的CLASSPATH变量的值。

保存resin.conf后，重新登录服务器(使新的CLASSPATH生效)，重新启动resin。再次发布WEB服务。

java org.apache.axis.client.AdminClient -lhttp://localhost:80/services/AdminService deploy.wsdd

屏幕显示如下。

Processing file deploy.wsdd
            Done processing

WEB服务终于发布成功了。

在发布成功的情况下apache的access_log中会看到如下的log：

tail -f access_log|grep vice
            127.0.0.1 - - [17/Sep/2003:16:05:00 +0800] "POST /services/AdminService HTTP/1.0" 200 296 "-" "Axis/1.1"

2.12.4 小结

本小节描述的问题可能是读者遇到的出现最多的异常，但原因并不是唯一的。遇到该问题时，建议读者冷静分析出现问题的可能原因，多实验几种解决方法，最终一定可以成功！

2.13 如何监测SOAP请求和响应流

2.13.1 引言

发布了Web服务以后，如何观察请求和响应数据呢？记录运行日志是一种传统且有效的方法，但对于调试程序来讲还不够方便和直观。值得欣慰的是，Axis为我们提供了在客户端观察SOAP请求和响应流数据的工具SoapMonitor，经过适当配置后，可以实时地观察到Web服务的SOAP请求和响应数据。SoapMonitor是一个Java Applet程序，通过浏览器下载到客户端运行。下面就介绍SoapMonitor的配置和使用方法。

2.13.2 准备SOAPMonitor 小应用程序

在Axis 1.1中，没有为我们编译SOAPMonitor.java程序，但我们可以在axis-1_1/webapps/axis/目录下找到名字为SOAPMonitorApplet.java的源程序文件，自己进行编译。该程序编译后，会生成如下的类文件：

SOAPMonitorApplet.class
            SOAPMonitorApplet$ServiceFilterPanel.class
            SOAPMonitorApplet$SOAPMonitorData.class
            SOAPMonitorApplet$SOAPMonitorFilter.class
            SOAPMonitorApplet$SOAPMonitorPage.class
            SOAPMonitorApplet$SOAPMonitorTableModel.class
            SOAPMonitorApplet$SOAPMonitorTextArea.class

读者需要把上述类文件复制到自己的Web应用程序目录下，本例中是/usr/local/apache/htdocs/目录。

在浏览器地址样中输入SOAPMonitor的地址，例如 http://test.com/SOAPMonitor ，浏览器会提示用户正在下载Applet程序，下载完毕后，读者可以在浏览器窗口中看到如图4-1所示的用户界面。如果上述类文件的位置不正确，浏览器会报告"找不到类"的错误。此时应检查是否已将上述类文件复制到正确的目录下。

图 2-1 SOAPMonitor的界面

2.13.3 发布SOAPMonitor服务

图2-1所示的SOAPMonitor界面出现后，并不意味着就可以观察到Web服务的SOAP请求流与响应流了，首先需要发布SOAPMonitorService。该Web服务是由Axis提供的，但需要由用户自己进行发布，方法如下。

获得SOAPMonitor服务的WSDD文件deploy.wsdd，内容如下(也可到 http://www.sosnoski.com/presents/java-xml/axis/axis-monitor.html 复制该文件)：

发布SOAPMonitor服务：

java org.apache.axis.client.AdminClient -lhttp://localhost:80/services/AdminService deploy.wsdd

2.13.4 修改deploy.wsdd

发布SOAPMonitor服务后，还要对被监测的Web服务进行配置。方法是先注销该Web服务，然后修改该服务对应的WSDD文件，在其中增加请求流和响应流的配置，否则是观测不到SOAP请求和响应流的。

注销Web服务的方法如下。

进入该Web服务的undeploy.wsdd文件所在的目录，执行

Java org.apache.axis.client.AdminClient -lhttp://localhost:80/services/AdminService undeploy.wsdd

修改WSDD文件的方法如下。

以Axis提供的MyService为例，对MyService的WSDD文件做如下修改。

修改前:

修改后: (有下划线的行是新加入的内容)

修改WSDD文件后，重新发布MyService服务：

java org.apache.axis.client.AdminClient -lhttp://localhost:80/services/AdminService deploy.wsdd

2.13.5 启动SOAPMonitor小应用程序

按2.13.2节介绍的方法启动SOAPMonitor小应用程序。

使用客户端程序测试MyService服务：

#  java samples.userguide.example3.Client -lhttp://vnet.sohu.com/services/MyService "test"
            结果为：You typed : test

注意，一定要先启动SOAPMonitor小应用程序，后调用Web服务才能观察到SOAP请求和响应流。

2.13.6 观察SOAP请求和响应流

这时在SoapMonitorApplet的窗口中可以观察到SOAP和请求和响应消息，如图2-2所示。

图2-2 MyService的Soap请求和响应流

2.14 使用客户端程序测试Web服务时报告"Exception:: (404)Not Found"

2.14.1 问题描述

WEB服务接口编写完成并发布后，客户端测试程序收不到WEB服务的返回结果，Apache或Resin的log中也看不到访问记录。但测试程序返回结果为0(成功)，在没有部署该WEB服务的情况下，也是这个结果，因此怀疑调用的是WSDL文件的提供者自己测试用的WEB服务接口，可能与另一方提供的WSDL文件有关。

2.14.2 原因分析

合作伙伴调用WEB服务就能够成功，从WEB服务主机自己的客户端调用就接收不到数据，估计与合作伙伴提供的WSDL文件有关，该WSDL文件影响了WSDL2Java生成的客户端stub代码。检查stub代码，发现其soapAction都指向了合作伙伴的测试地址。

2.14.3 解决方法

修改stub代码中的soapAction，改为sp(Service Provider)自己的WEB服务URL。重新编译程序并发布Web服务，问题解决。

_call.setSOAPActionURI("sp自己的Web服务地址");

2.14.4 小结

本小节描述的问题出现于Web服务提供方按合作伙伴统一提供的WSDL文件生成客户端代码的情况。遇到这类问题，读者可直接检查WSDL2Java自动生成的代码的有关部分。

在WSDL文件中可以看到与下列内容相似的设置。

其中 http://test.com/services/SPInterfaceSoap即为已发布的WEB服务的URL，供客户端调用。

2.15 如何列出已发布的Web服务

使用下面的命令：

java org.apache.axis.client.AdminClient -lhttp://localhost:80/services/  list

实际上该命令的输出就是server-config.wsdd文件的内容。

2.16 发布Web服务时报告"调用目标异常"

2.16.1 问题描述

在部署WEB服务时报告：java.lang.reflect.InvocationTargetException异常。

2.16.2 原因分析

在WSDL文件中自定义的名字空间与Axis的services名字空间冲突。

2.16.3 解决方法

修改WSDL文件，将services改为别的名字。

2.17 WSDL文件中的targetNamespace的作用是什么

TargetNamespace指明目标名字空间，用于验证xml文档。

在WSDL文件中，中的targetNamespace与中的targetNamespace应保持一致。

2.18 Web服务部署成功但检测不到

2.19 客户端程序找不到可用的Web服务

2.19.1 问题描述

执行
            java org.apache.axis.client.AdminClient -lhttp://localhost:80/services/AdminService deploy.wsdd

时显示Done processing，却检查不到新的服务，在WEB-INF/目录下的server-config.wsdd文件中也看不到相应的配置项。

2.19.2 原因分析

新的WEB服务的类文件没有重新编译并复制到正确的位置。

2.19.3 解决方法

WEB服务的类文件可以打包为jar文件。在CLASSPATH环境变量中正确设置jar文件的路径。例如：

jar cvf  SPInterfaceSoap.jar com/zx/service/v1_0/*.class

将SPInterfaceSoap.jar复制到WEB-INF/lib/目录下，重新发布WEB服务。

2.20 如何排除原因不明的错误

有时，在对WEB服务执行客户端测试时会出现慕名其妙的错误。为保证环境是正确的，可以按下面的步骤排除原因不明的错误。

1. Undeploy被测试的服务

java org.apache.axis.client.AdminClient -lhttp://localhost:80/services/AdminService undeploy.wsdd

2. 重新启动resin: /usr/local/resin/bin/httpd.sh restart(如果是其它的应用服务器，请按相应的方法重新启动)

3. 重新发布WEB服务

4. 进行测试

3 小结

目前有很多可以使用的应用服务器和Web服务平台软件，本文仅以Apache Axis和Resin为例介绍了在部署Web服务的过程中可能遇到的问题及其解决方法，其中并未讨论Web服务的安全性问题。对于如何高效地开发和部署Web服务以及如何确保Web服务的安全性，还希望对此感兴趣的读者共同参与讨论，对于文中存在的错误和不足之处也希望读者朋友们能够不吝批评指正。

菠萝 2007-08-16 17:04 发表评论

生成客户端client stub文件

菠萝 — Thu, 16 Aug 2007 07:40:00 GMT

今天是感恩节，差点又要在公司加班了。好在Web Service程序并不是特别难搞，下午终于在eclipse下调通过了，正确产生了服务器端和客户端的Java代码，apache的东西的确很不错。

　　说道Web Service的程序开发，八个月前我加班调试公司和中国电信的商务领航系统的接口的时候，用的就是Web Service，Web Service有很多优点，使用Web Service可以在不同编程语言间实现数据交换，而我那时对Web Service也不熟，就由同事帮我生成了一大堆Web Service的框架代码，我则只单独开发业务代码。

　　这次的另外一个项目也要用Web Service了，不过人手也少了，没有人帮做Web Service了，只好自己动手。

　　好在开发前，有个同事先给我们不熟悉Web Service的程序员进行了一些培训，我才知道原来以前的Web Service都是可以自动生成代码的，而且也不难，试了一个下午客户端和服务器端的Web Service代码就都调试通过了，真不错。

　　为了更多喜爱开发的程序员也能迅速了解Web Service的开发，我这里整理了一些通过Axis开发Web Service的一些要点，希望能让不熟悉Web Service的开发人员能够迅速掌握Web Service。

　　一、Axis环境的安装

　　1、安装环境 J2SE SDK 1.4，Tomcat 5.0，eclipse 3.2。

　　2、到 http://xml.apache.org 网站下载Axis安装包。

　　3、将Axis相关包文件放在WEB-INF\lib目录下。

　　4、Axis可选的包：activation.jar； mail.jar； xmlsec-1.4.Beta1.jar拷贝到WEB-INF目录下，生成客户端时候需要使用。

　　Axis支持三种web service的部署和开发，分别为：

　　1、Dynamic Invocation Interface （DII）

　　2、Dynamic Proxy方式

　　3、Stubs方式

　　前两种方式我就不介绍了，同事告诉我他们自己都不使用前两种方式，他们建议我们使用Stubs方式，因此我就主要就介绍一下第三种方式。注意，我自己的Java源代码是放在D：\workspace\test\目录下，Axis相关包文件放在D：\workspace\test\WEB-INF目录下。

　　二、编写wsdd发布web服务，编写stub client访问web服务

　　1、编写服务端程序server，SayHello.java，编译server.SayHello.java

package server;
public class SayHello
{
    public String getName(String name)
    {
        return "hello "+name;
    }
}

　　2、编写wsdd文件

　　deploy.wsdd文件内容如下：

　　3、发布服务：

　　编辑一个deploy.bat，Axis_Lib为axis.jar路径。内容如下：

set Axis_Lib=D:\workspace\test\WEB-INF\lib
set Java_Cmd=java -Djava.ext.dirs=%Axis_Lib%
set Axis_Servlet=http://localhost:8080/test/servlet/AxisServlet
%Java_Cmd% org.apache.axis.client.AdminClient -l%Axis_Servlet% deploy.wsdd

　　执行这个批处理文件，这时候，如果提示成功的话，访问http://localhost:8080/test/services 就会显示服务列表。

　　4、生成客户端client stub文件

　　在浏览器上访问服务器端的服务，可以下载到WSDL文件，通过Axis的相关工具，可以自动从WSDL文件中生成Web Service的客户端代码。

　　编写一个WSDL2Java.bat文件，其内容如下：

set Axis_Lib=D:\workspace\test\WEB-INF\lib
set Java_Cmd=java -Djava.ext.dirs=%Axis_Lib%
set Output_Path=D:\workspace\test\src
set Package=server.SayHello
%Java_Cmd% org.apache.axis.wsdl.WSDL2Java -o%Output_Path% -p%Package% SayHello.wsdl

　　执行这个批处理文件就可以生成client stub.

　　生成的stub client文件列表为：SayHello.java，SayHelloService.java，SayHelloServiceLocator.java，SayHelloSoapBindingStub.java .

　　5、编写客户端程序，编译并执行

　　下面是一段junit测试客户端代码。

import java.net.URL;
import junit.framework.Test;
import junit.framework.TestCase;
import junit.framework.TestSuite;

public class TestWSClient extends TestCase {

    public TestWSClient(String string) {
        super(string);
    }

public void SayHelloClient() throws Exception {

        SayHelloService service = new SayHelloServiceLocator();
        SayHello_PortType client = service.getSayHello() ;
        String retValue = client.getName("clientname");
        System.out.println(retValue);

}

    public static Test suite() {
        TestSuite suite = new TestSuite();
        suite.addTest(new TestWSClient("SayHelloClient"));
        return suite;
    }
}

　　至此，整个服务器端和客户端的Web Service框架代码就完成了，剩下的就是在里面加入你的业务代码了，怎么样，Web Service并不难开发吧。

菠萝 2007-08-16 15:40 发表评论

AXIS学习笔记（一）

菠萝 — Thu, 16 Aug 2007 05:24:00 GMT

一、软件环境

1、axis-1_2 (从apache网站下载最新axis-bin-1_2.zip解压即可）

2、Tomcat5.0

3、JDK5.0

二、相关配置

1、在你的%TOMCAT_HOME%\common\lib下需要加入三个包 activation.jar、mail.jar、tools.jar

2、环境变量设置

AXIS_HOME 即axis-bin-1_2.zip解压的目录（我的是在F:\soap\axis-1_2）

AXIS_LIB 即 %AXIS_HOME%\lib

AXISCLASSPATH 即 %AXIS_LIB%\axis.jar;%AXIS_LIB%\commons-discovery-0.2.jar;%AXIS_LIB%\commons-logging-1.0.4.jar;%AXIS_LIB%\jaxrpc.jar;%AXIS_LIB%\saaj.jar;%AXIS_LIB%\log4j-1.2.8.jar;也就是把%AXIS_LIB%下所用JAR文件都导入

三、实验一下

在%AXIS_HOME%\webapps下找到axis文件夹，将其整个拷贝到%TOMCAT_HOME%\webapps下，启动

Tomcat,打开浏览器访问http://localhost:8080/axis/，出现以下页面说明你配置成功了。很简单吧：）

四、发布我们的第一个程序

第一个程序简单的返回HELLO WORLD！

HelloWorld.java

public class HelloWorld {
public String sayHello()
{
return "HELLO WORLD!";
}
}

我们的第一种发布方式：

将HelloWorld.java拷贝到%TOMCAT_HOME%\webapps\axis下，然后将其改名为HelloWorld.jws,这样AXIS就自然将其发布了。现在写个客户端程序访问一下：

TestClient.java

import org.apache.axis.client.Call;
import org.apache.axis.client.Service;

import javax.xml.rpc.ParameterMode;

public class TestClient
{
   public static void main(String [] args) throws Exception {

       String endpoint = "http://localhost/:" +"8080"+ "/axis/HelloWorld.jws";//指明服务所在位置

Service service = new Service(); //创建一个Service实例，注意是必须的！
Call call = (Call) service.createCall();//创建Call实例，也是必须的！

call.setTargetEndpointAddress( new java.net.URL(endpoint) );//为Call设置服务的位置

call.setOperationName( "sayHello" );//注意方法名与HelloWorld.java中一样！！

String res = (String) call.invoke( new Object[] {} );//返回String，没有传入参数

System.out.println( res );
}
}

我的测试是在jbuilder2005中，注意项目中要导入其自带的AXIS包（当然应该把其中JAR文件替换一下），可以看到程序返回了 "HELLO WORLD!"

可以看到在AXIS里发布服务其实是一件很容易的事，这是因为这个服务很简单的原因：）下面我们介绍第二种发布方式，这是常用的。

我们的第二种发布方式：

1、将HelloWorld.java编译成HelloWorld.class,放到%TOMCAT_HOME%\webapps\axis\WEB-INF\classes

下

2、在%TOMCAT_HOME%\webapps\axis\WEB-INF下新建deploy.wsdd文件，即SOAP服务发布描述文件

deploy.wsdd

http://xml.apache.org/axis/wsdd/" xmlns:java="http://xml.apache.org/axis/wsdd/providers/java">

在DOS下转换目录到%TOMCAT_HOME%\webapps\axis\WEB-INF，命令：

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

你会发现目录下多了一个server-config.wsdd文件，这就是AXIS的配置文件，以后所有的服务发布描述都会在里面找到。（当然，你可以直接修改它，不用再写deploy.wsdd）然后打开浏览器http://localhost:8080/axis/servlet/AxisServlet，你就会看到你的服务已发布

同样用客户端程序访问一下：（注意和上边的差别！！）

HelloClient.java

import org.apache.axis.client.Call;
import org.apache.axis.client.Service;

public class HelloClient
{
public static void main(String [] args) throws Exception {

String endpoint = "http://localhost/:" +"8080"+ "/axis/services/HelloWorld";//注意！差别仅仅在这里！！

       Service service = new Service();
       Call     call    = (Call) service.createCall();
       call.setTargetEndpointAddress( new java.net.URL(endpoint) );
        call.setOperationName("sayHello" );

String res = (String) call.invoke( new Object[] {} );

System.out.println( res );
}
}

菠萝 2007-08-16 13:24 发表评论

AXIS-是用AdminClient部属时要注意的

菠萝 — Thu, 16 Aug 2007 05:23:00 GMT

如果使用java -cp %AXISCLASSPATH% org.apache.axis.client.AdminClient deploy.wsdd

将自动部署到axis web应用的server-config.wsdd

要想部署到自己的web 应用下，比如boyoi，要使用以下的方式

java -cp %AXISCLASSPATH% org.apache.axis.client.AdminClient
-lhttp://localhost:8080/boyoi/services/AdminService deploy.wsdd

菠萝 2007-08-16 13:23 发表评论

AXIS全攻略（一）

菠萝 — Thu, 16 Aug 2007 05:20:00 GMT

一、Axis简介

1. 什么是SOAP

SOAP是一个基于XML的用于应用程序之间通信数据编码的传输协议。最初由微软和Userland Software提出，随着不断地完善和改进，SOAP很快被业界广泛应用，目前完全发布版本是1.1。在其发展过程中，W3C XML标准工作小组积极促成SOAP成为一个真正的开放标准。在写作此文档之时，SOAP1.2草案已经发布，1.2对1.1中相对混乱的部分做了改进。
SOAP被广泛作为新一代跨平台、跨语言分布计算Web Services的重要部分。

2. 什么是Axis

Axis是Apache组织推出的SOAP引擎，Axis项目是Apache组织著名的SOAP项目的后继项目，目前最新版本是采用Java开发的1.1版本，C++的版本正在开发之中。Axis v1.1软件包可以从http://ws.apache.org/axis/dist/1_1/下载得到。
但是Axis不仅仅是一个SOAP引擎，它还包括：
    一个独立运行的SOAP服务器
    一个servlet引擎的插件，这个servlet引擎可以是Tomcat
    对WSDL的扩展支持
    一个将WSDL的描述生成JAVA类的工具
    一些示例代码
    还有一个监控TCP/IP包的工具

二、Axis的安装

应用Axis开发Web Services，你需要安装如下软件：
1.JDK1.4.2
2.一个支持Servlet的服务器引擎，比如广为人知的Tomcat。

当安装好Tomcat之后，只需将下载的Axis软件包解压缩，将其中的“webapps”目录下的“axis”目录整个拷贝到Tomcat安装目录下的“webapps”目录下即可。

三、Axis的配置

Axis基于Java开发，可以部署于多种操作系统，使用前需要配置一系列的系统变量，在此假定你已经在本机上装好了Tomcat 4.0以上的版本，需要配置的系统变量如下表所示：

CATALINA_HOME
C:\Tomcat_4_1

（此处应为Tomcat的安装位置，注意路径名中不要有空格）

AXIS_HOME
%CATALINA_HOME%\webapps\axis

AXIS_LIB
%AXIS_HOME%\lib

AXISCLASSPATH
%AXIS_LIB%\axis.jar;%AXIS_LIB%\commons-discovery.jar; %AXIS_LIB%\commons-logging.jar;%AXIS_LIB%\jaxrpc.jar; %AXIS_LIB%\saaj.jar;%AXIS_LIB%\log4j-1.2.8.jar; %AXIS_LIB%\xml-apis.jar;%AXIS_LIB%\xercesImpl.jar

CLASSPATH 中加入：
%AXIS_LIB%\axis.jar;%AXIS_LIB%\commons-discovery.jar; %AXIS_LIB%\commons-logging.jar;%AXIS_LIB%\jaxrpc.jar; %AXIS_LIB%\saaj.jar;%AXIS_LIB%\log4j-1.2.8.jar; %AXIS_LIB%\xml-apis.jar;%AXIS_LIB%\xercesImpl.jar

四、Axis的测试

安装配置完毕后，应测试一下是否Axis可以正确运行了。

　　启动Tomcat服务器，在浏览器中访问http://localhost:8080/axis/happyaxis.jsp，如果页面显示有错误，则需要回头检查一下相关配置是否正确，如果浏览页面能正确显示出系统组件、属性等参数配置信息，则表示安装成功。现在可以开始开发你的Web Services应用了。

五、服务的发布
Axis提供了两种服务发布方式，一种是即时发布（Instant Deployment），一种是定制发布（Custom Deployment）。

1. 使用即时发布 Java Web Service(JWS)

　　对即时发布的支持是Axis的特色之一，使用即时发布使用户只需有提供服务的Java类的源代码，即可将其迅速发布成Web服务。每当用户调用这类服务的时候，Axis会自动进行编译，即使服务器重启了也不必对其做任何处理，使用非常简单快捷。

　　使用即时发布首先需要一个实现服务功能的Java源文件，将其扩展名改为.jws（Java Web Service的缩写），然后将该文件放到“……\webapps\axis”目录下即可。
在此给出一个从英里到公里的长度单位转换的服务，其源码如下：

文件Distance.jws

public class Distance
{
    public double convertMile2Kilometre( double mile )
    {
return mile * 1.609;  //实现英里到公里的距离转换
    }
}

将其放到“……\webapps\axis”目录，通过访问http://localhost:8080/axis/Distance.jws?wsdl可以看到这个服务的WSDL描述文件，这说明Distance服务被成功发布了。描述的WDSL代码如下：

- http://192.168.0.26:8080/axis/Distance.jws" xmlns="http://schemas.xmlsoap.org/wsdl/"
xmlns:apachesoap="http://xml.apache.org/xml-soap" xmlns:impl="http://192.168.0.26:8080/axis/Distance.jws" xmlns:intf="http://192.168.0.26:8080/axis/Distance.jws" xmlns:soapenc="http://schemas.xmlsoap.org/soap/encoding/" xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/" xmlns:wsdlsoap="http://schemas.xmlsoap.org/wsdl/soap/" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
-

-

-
-

-
http://schemas.xmlsoap.org/soap/http" />
-

-
http://schemas.xmlsoap.org/soap/encoding/" namespace="http://defaultnamespace/" use="encoded" />

-
http://schemas.xmlsoap.org/soap/encoding/" namespace="http://192.168.0.26:8080/axis/Distance.jws" use="encoded" />

-
-
http://192.168.0.26:8080/axis/Distance.jws" />

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

2. 使用定制发布 Web Service Deployment Descriptor(WSDD)

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

　　因此，Axis提供了另一种服务发布方式，这就是定制发布。

　　在此给出一个从加仑到升的容积单位转换的服务，其源码如下：

　　文件Capacity.java
    package samples.capacity;
    public class Capacity
    {
        public double convertGallon2Litre( double gallon )
{
     return gallon * 4.546;//实现加仑到升的容积转换
}//convertGallon2Litre()

    }/* Capacity */

    将其编译成.class文件，放置到“……\webapps\axis\samples\capacity”目录下，即可着手进行发布。
    定制发布不需要构建.jws文件，但必须创建服务发布描述文件deploy.wsdd（Web Service Deployment Descriptor的缩写），这个文件负责描述服务的名称、入口等信息，其内容如下：
    文件deploy.wsdd

http://xml.apache.org/axis/wsdd/" xmlns:java="http://xml.apache.org/axis/wsdd/providers/java">

在这里服务的提供者是“java:RPC”，它被内建在Axis中，而且指明了一个JAVA RPC服务，做这个处理的类是org.apache.axis.providers.java.RPCProvider。
我们是通过一个标签告诉RPC服务应该调用的类，而另外一个标签则告诉引擎，它可以调用这个类中的任何的Public方法。你也可以指定通过使用名字空间或者一些可以调用的方法列表，来指明那些方法可以被调用。

　　将该文件也放到“……\webapps\axis\samples\capacity”目录下，然后可以采用Axis提供的一个客户端管理工具——AdminClient来完成服务的定制发布。
在“……\webapps\axis\samples\capacity”目录下，运行：

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

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

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

Processing file deploy.wsdd
Doneprocessing

　　这表明Capacity服务定制发布完成。

你也可以调用：
java org.apache.axis.client.AdminClient undeploy.wsdd 来取消部署。

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

   一定要注意：编译后的class文件要拷贝到web-inf/classes的目录中，如果该文件中有包存在的话，别忘了还要在classes目录下创建包的目录
   通过访问http://localhost:8080/axis/services/Capacity?wsdl可以看到这个服务的WSDL描述文件，这说明Capacity服务被成功发布了。
   你也可以通过访问http://localhost:8080/axis/servlet/AxisServlet查看所有定制发布的服务。
   WDSL如下：

- http://localhost:8080/axis/services/Capacity" xmlns="http://schemas.xmlsoap.org/wsdl/"
    xmlns:apachesoap="http://xml.apache.org/xml-soap" xmlns:impl="http://localhost:8080/axis/services/Capacity" xmlns:intf="http://localhost:8080/axis/services/Capacity" xmlns:soapenc="http://schemas.xmlsoap.org/soap/encoding/" xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/" xmlns:wsdlsoap="http://schemas.xmlsoap.org/wsdl/soap/" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
-

-

-
-

-
http://schemas.xmlsoap.org/soap/http" />
-

-
http://schemas.xmlsoap.org/soap/encoding/" namespace="http://capacity.samples/" use="encoded" />

-
http://schemas.xmlsoap.org/soap/encoding/" namespace="http://localhost:8080/axis/services/Capacity" use="encoded" />

-
-
http://localhost:8080/axis/services/Capacity" />

WSDD 的高级功能：
(1) AXIS支持三种对象范围：
     "request"范围：这是默认的情况，每一次Soap请求的时候都将创建新的对象。
     "application"范围：将会为所有的请求生成一个单独的共享的对象。
     "session"范围：为每一个session期的客户端请求创建一个对象。
指定方法如下：

...

(2) 更多部署内容：Handlers and Chains
让我们来深入挖掘一下Axis引擎的更强大的特性。如果我们想跟踪我们的服务被调用了多少次，那么我们只需要包含一个简单的handler，它存放在samples/log目录下。要使用这个handler，你就首先应该部署这个handler，然后使用在部署服务时给它指定的名字。下面是一个wsdd文件的例子：
http://xml.apache.org/axis/wsdd/" xmlns:java="http://xml.apache.org/axis/wsdd/providers/java">

第一段指明了一个名为track的handler，它是samples.userguide.example4.LogHandler类的实例。另外还指定了一个参数filename，用于指定日志文件名称。
下面的那段指明了一个RPC服务，和我们在上面的例子中看到的一样，所不同的是在service标签中的标签，它指定了一些在调用服务前应该被调用的handler集。也就是由于我们在部署中插入了这个"track"的引用，所以我们确定每次调用服务的时候都将被记录到日志文件中去。

(3)远程管理：

WARNING: enabling remote administration may give unauthorized parties access to your machine. If you do this, please make sure to add security to your configuration!
所以远程管理涉及到安全问题，不建议采用。

菠萝 2007-08-16 13:20 发表评论

结合Axis和Ant开发Web服务

菠萝 — Sun, 12 Aug 2007 09:04:00 GMT

本文结合一个简单示例讲解了怎样把Axis和Ant结合起来进行Web服务的开发。帮助读者从简单的java源代码或者从一个服务描述文件（wsdl）开始，用Ant工具进行构建，设置，并把服务部署到Axis。

首先假定您熟悉 AXIS 处理系统和Ant工具。文中示例所需要的软件如下：

l Apache Axis 1.1

l Apache Ant 1.5.3

l Jarkat Tomcat 4.1.24

在开始前，假定上述软件已经安装和配置好了。

Axis和Ant简介

Axis 框架是来自 Apache Group 的、基于 java 的、最新的 SOAP 规范（SOAP 1.2）和 SOAP with Attachments 规范（来自 Apache Group ）的开放源代码实现。其本质上是一个SOAP引擎－－一个构建诸如客户端、服务器、网关等SOAP处理器的框架。是Apache SOAP的后继项目。但是，Axis使用SAX（基于事件）解析器获得了比Apache SOAP早期版本(使用DOM解析)非常明显的速度优势。另外，它还具有很强的灵活性和稳定性，支持Web服务描述语言1.1版。

Apache Ant是Apache软件基金会jakarta项目中的一个子项目，是一个基于Java的构建工具，类似于make，但它没有make那么复杂繁琐。Ant由一些内置任务（task）和可选择的任务组成，还可以配置第三方提供的任务。它的构建配置文件基于XML的，所以容易书写和维护，而且结构清晰。Ant还可以集成到一些开发环境中（例如visual age,jbuilder,Elipse)。

Axis对Ant的支持

Axis为支持Ant构建，提供了一个axis-ant.jar文件。该文件包含三个可选任务(task)的定义和实现：axis-wsdl2java，axis-java2wsdl和axis-admin。任务axis-wsdl2java与Axis提供的工具WSDL2Java具有同样的功能，根据web服务描述文件生成对应的Java源程序，它的属性设置与WSDL2Java的命令参数设置类似。而任务axis-java2wsdl则相反，它与Java2WSDL工具一样，是根据已有的类文件来生成Web服务描述文件。最后一个任务axis-admin是用于web服务的部署和取消部署的，对应于Axis的AminClient工具。

为了使Ant能够正确使用上述三个任务（task），还需要做一些配置。注意：Apache Ant的版本必须是1.5.1或更高版本。

1．设置系统的环境变量CLASSPATH包含Axis提供的axis-ant.jar文件，或者在Ant的配置文件（通常是build.xml）中设置路径包含它。例如，

2．然后使用声明导入axis-ant.jar文件中的属性文件所定义的任务（task）列表。

classpathref="axis.classpath" />

3．设置在构建过程中可能要需要的java包，例如， Axis所有的jar包，wsdl4j.jar，junit.jar等等。

实例开发

下面就用一个实例来讲解怎样把Ant和Axis结合来开发Web服务。为了注重本文的目的，我们开发一个比较简单的Web服务，它接受客户端传入的字符串数组，如果传入的参数为null，则抛出一个自定义的异常，否则把每个字符串连接起来返回给客户端。

首先定义一个Web服务接口Hello，如下所示：

package com.bidlink.hello;

public interface Hello{

public String echo(String[] content ) throws

java.rmi.RemoteException,com.bidlink.hello.MyException;

}

自定义异常MyException包含一个时间值，以记录异常出现的时间，如下：

package com.bidlink.hello;

public class MyException extends org.apache.axis.AxisFault implements java.io.Serializable{

private java.util.Calendar occurTime;

public MyException() {

}

public MyException(

java.util.Calendar occurTime) {

super();

this.occurTime = occurTime;

}

public java.util.Calendar getOccurTime() {

return occurTime;

}

public void setOccurTime(java.util.Calendar occurTime) {

this.occurTime = occurTime;

}

1．axis-java2wsdl：从类文件生成服务描述文件

编译上面定义的两个文件Hell.java和MyException.java。接着编写Ant的配置文件build.xml（文件详细信息请查看示例源代码），使用axis-java2wsdl任务根据类Hello来生成Web服务描述文件hello.wsdl。任务具体配置如下：

location="http://localhost:8080/axis/services/Hello"

namespace="http://hello.bidlink.com"

output="hello.wsdl"

style="RPC"

extraclasses="com.bidlink.hello.MyException">

其中，指出Hello.class和MyException.class文件的位置。

运行命令ant java2wsdl，构建出Web服务描述文件hello.wsdl。

2．axis-wsdkl2java：从服务描述文件生成服务源程序

下面讲解怎样根据刚刚得到的hello.wsdl文件生成服务所需要的java源程序。在这里需要用到任务axis-wsdl2java。任务属性设置如下：

url="hello.wsdl"

deployscope="Request"

output="${gensrc}"

serverside="true"

skeletondeploy="false"

testcase="true"

noimports="false"

typemappingversion="1.2">

运行ant wsdl2java，根据axis-wsdl2java任务的属性配置生成相应的java源程序，本例所生成的文件包括：服务端服务接口文件Hello.java及其实现HelloSoapBindingImpl.java，以及客户端的HelloService.java，HelloServiceLocator.java，HelloServiceLocator.java和客户端存根文件HelloSoapBindingStub.java。又因为属性testcase="true"，所以还生成了测试文件HelloServiceTestCase.java。当然，自定义异常MyException也是重新生成的。

3．axis-admin：向Axis部署Hello服务

服务源程序生成后，需要根据服务的功能修改HelloSoapBindingImpl.java文件，以真正实现该Web服务。修改如下：

/**

* HelloSoapBindingImpl.java

* This file was auto-generated from WSDL

* by the Apache Axis WSDL2Java emitter.

package com.bidlink.hello;

public class HelloSoapBindingImpl implements com.bidlink.hello.Hello{

public java.lang.String echo(java.lang.String[] in0) throws java.rmi.RemoteException, com.bidlink.hello.MyException {

if(in0 == null)

throw new MyException(java.util.Calendar.getInstance());

String retStr = "";

for(int i=0; i< in0.length; i++)

retStr += in0[i];

return retStr;

}

编译所有的生成的源程序，最后使用axis-admin任务向Axis部署Hello Web服务。

port="${target.port}"

hostname="${target.server}"

failonerror="true"

servletpath="${target.appname}/services/AdminService"

debug="true"

xmlfile="deploy.wsdd"/>

运行ant deploy，部署Hello服务。

测试

现在可以测试所部署的Web服务hello。可以通过浏览器，也可以利用刚才生成的测试文件HelloServiceTestCase.java来进行该项工作。如果利用测试文件HelloServiceTestCase.java，那么还需要对它进行稍作修改。具体来说，就是添加一个main函数，然后修改所生成的测试方法。

菠萝 2007-08-12 17:04 发表评论

用Axis开发基于Java的Web服务

菠萝 — Mon, 06 Aug 2007 14:47:00 GMT

概述

　　本文介绍了一个比较简单实用的基于Java的SOAP引擎——Apache组织推出的Axis——的安装、配置和应用开发方法，希望对有兴趣做基于Java的Web Services应用开发的朋友有所帮助。

　　Axis简介

　　Axis是Apache组织推出的SOAP引擎，Axis项目是Apache组织著名的SOAP项目的后继项目，目前最新版本是采用Java开发的1.1版本，C 的版本正在开发之中。Axis v1.1软件包可以从http://ws.apache.org/axis/dist/1_1/下载得到。

　　Axis的安装

　　应用Axis开发Web Services，你需要有一个支持Servlet的服务器引擎，比如广为人知的Tomcat（Tomcat也是由Apache组织所提供的，目前的最新版本为4.1.24，下载地址为http://jakarta.apache.org/builds/jakarta-tomcat-4.0/release/v4.1.24/）。在此之前当然你机器必须已经装好了JDK1.3以上的版本，当安装好Tomcat之后，只需将下载的Axis软件包解压缩，将其中的“webapps”目录下的“axis”目录整个拷贝到Tomcat安装目录下的“webapps”目录下即可。

　　Axis的配置

　　Axis基于Java开发，可以部署于多种操作系统，使用前需要配置一系列的系统变量，在此假定你已经在本机上装好了Tomcat 4.0以上的版本，需要配置的系统变量如下表所示：

CATALINA_HOME
C:\Tomcat_4_1

（此处应为Tomcat的安装位置，注意路径名中不要有空格）

AXIS_HOME
蔜ALINA_HOME%\webapps\axis

AXIS_LIB
%AXIS_HOME%\lib

AXISCLASSPATH
%AXIS_LIB%\axis.jar;%AXIS_LIB%\commons-discovery.jar; %AXIS_LIB%\commons-logging.jar;%AXIS_LIB%\jaxrpc.jar; %AXIS_LIB%\saaj.jar;%AXIS_LIB%\log4j-1.2.8.jar; %AXIS_LIB%\xml-apis.jar;%AXIS_LIB%\xercesImpl.jar

　　如果你不愿做这么繁琐的类路径设置，可以直接将axis软件包中“lib”目录下的所有.jar文件加入到系统环境变量CLASSPATH中即可。

　　Axis的测试

　　安装配置完毕后，应测试一下是否Axis可以正确运行了。

　　启动Tomcat服务器，在浏览器中访问http://localhost:8080/axis/happyaxis.jsp，如果页面显示有错误，则需要回头检查一下相关配置是否正确，如果浏览页面能正确显示出系统组件、属性等参数配置信息，则表示安装成功，如下图所示：

　　现在可以开始开发你的Web Services应用了。

CATALINA_HOME
C:\Tomcat_4_1

　　如果你不愿做这么繁琐的类路径设置，可以直接将axis软件包中“lib”目录下的所有.jar文件加入到系统环境变量CLASSPATH中即可。

　　Axis的测试

　　安装配置完毕后，应测试一下是否Axis可以正确运行了。

　　现在可以开始开发你的Web Services应用了。

服务的发布

　　Axis提供了两种服务发布方式，一种是即时发布（Instant Deployment），一种是定制发布（Custom Deployment）。

　　使用即时发布

　　对即时发布的支持是Axis的特色之一，使用即时发布使用户只需有提供服务的Java类的源代码，即可将其迅速发布成Web服务。每当用户调用这类服务的时候，Axis会自动进行编译，即使服务器重启了也不必对其做任何处理，使用非常简单快捷。

使用即时发布首先需要一个实现服务功能的Java源文件，将其扩展名改为.jws（Java Web Service的缩写），然后将该文件放到“……\webapps\axis”目录下即可。

　　在此给出一个从英里到公里的长度单位转换的服务，其源码如下：

文件Distance.jws

/**

* @author 飞鹰

public class Distance

{

public double convertMile2Kilometre( double mile )

{

//实现英里到公里的距离转换

return mile * 1.609;

}//convertMile2Kilometre()

}/* Distance */

　　将其放到“……\webapps\axis”目录，通过访问http://localhost:8080/axis/Distance.jws?wsdl可以看到这个服务的WSDL描述文件，这说明Distance服务被成功发布了。如下图所示：

　　使用定制发布

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

　　因此，Axis提供了另一种服务发布方式，这就是定制发布。

　　在此给出一个从加仑到升的容积单位转换的服务，其源码如下：

　　文件Capacity.java

package samples.capacity;

/**

* @author 飞鹰

public class Capacity

{

public double convertGallon2Litre( double gallon )

{

//实现加仑到升的容积转换

return gallon * 4.546;

}//convertGallon2Litre()

}/* Capacity */

　　将其编译成.class文件，放置到“……\webapps\axis\samples\capacity”目录下，即可着手进行发布。

　　定制发布不需要构建.jws文件，但必须创建服务发布描述文件deploy.wsdd（Web Service Deployment Descriptor的缩写），这个文件负责描述服务的名称、入口等信息，其内容如下：

　　文件deploy.wsdd

xmlns:java="http://xml.apache.org/axis/wsdd/providers/java">

　　将该文件也放到“……\webapps\axis\samples\capacity”目录下，然后可以采用Axis提供的一个客户端管理工具——AdminClient来完成服务的定制发布。

　　在“……\webapps\axis\samples\capacity”目录下，运行：

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

　　可以看到以下运行结果：

Processing file deploy.wsdd

Doneprocessing

　　这表明Capacity服务定制发布完成。

　　通过访问http://localhost:8080/axis/services/Capacity?wsdl可以看到这个服务的WSDL描述文件，这说明Capacity服务被成功发布了。如下图所示：

服务的访问

　　GET方式的服务访问

　　一般的SOAP消息都是采用POST方式实现传递，但也可以通过GET方式来访问。比如以下给出的一个服务——“HelloWorld”，其源码如下：

文件HelloWorld.jws

/**

* @author 飞鹰

public class HelloWorld

{

public String helloWorld()

{

//在服务器端打印输出

System.out.println( "Hello World!" );

//返回相应字符串

return "Hello World!";

}//helloWorld()

}/* HelloWorld */

　　这个服务给出一个名位“helloWorld”的无入口参数的操作，返回一个内容为“Hello World！的字符串”，同时在服务器端打印“Hello World！”，将该文件放到“……\webapps\axis”目录下，即可通过GET方法直接访问该服务，访问的地址为http://localhost:8080/axis/HelloWorld.jws?method=helloWorld，可以看到返回的SOAP信封消息，同时服务器端给出了相应的显示信息“Hello World！”这表明HelloWorld服务被成功访问了。如下图所示：

　　客户端服务访问编程

　　Axis提供了一套API来实现SOAP，从http://localhost:8080/axis/docs/apiDocs/index.html可以看到Axis的API文档。

　　其中，org.apache.axis.client.Call和org.apache.axis.client.Service是两个比较常用的类，一般的客户端程序欲访问一个Web Service时，都要生成一个客户端的Service对象和Call对象，在访问服务之前，首先要对Call对象设置相应的参数，包括服务的位置、操作名、入口参数、返回值类型等，最后调用Call对象的invoke方法访问服务。

　　以下给出了一个客户端访问Web服务的例程——AXISTest.java：

　　文件AXISTest.java

package axisexercise;

import org.apache.axis.client.Call;

import org.apache.axis.client.Service;

import org.apache.axis.encoding.XMLType;

import javax.xml.rpc.ParameterMode;

/**

* @author 飞鹰

public class AXISTest

{

public static void main( String[] args ) throws Exception

{

Service service = new Service();

Call call = ( Call ) service.createCall();

//////////访问即时发布的Distance服务

//设置访问点

call.setTargetEndpointAddress( "http://localhost:8080/axis/Distance.jws" );

//设置操作名

call.setOperationName( "convertMile2Kilometre" );

//设置入口参数

call.addParameter( "op1", XMLType.XSD_DOUBLE, ParameterMode.IN );

call.setReturnType( XMLType.XSD_DOUBLE );

Double d1 = new Double( 190 );

//调用服务

System.out.println( d1 " 英里相当于 "

call.invoke( new Object[] {d1} ) " 公里！" );

//////////访问定制发布的Capacity服务

call = ( Call ) service.createCall();

//设置访问点

call.setTargetEndpointAddress( "http://localhost:8080/axis/services/Capacity" );

//设置操作名

call.setOperationName( "convertGallon2Litre" );

//设置入口参数

call.addParameter( "op1", XMLType.XSD_DOUBLE, ParameterMode.IN );

call.setReturnType( XMLType.XSD_DOUBLE );

d1 = new Double( 10.00 );

//调用服务

System.out.println( d1 " 加仑相当于 "

call.invoke( new Object[] {d1} ) " 升！" );

} //main()

}/* AXISTest */

　　编译运行后运行可以看到以下的结果：

　　190.0英里相当于305.71公里！

　　10.0加仑相当于45.46升！
　
　　注意程序在访问即时发布的Distance服务和定制发布的Capacity服务时的不同，前者的服务访问点地址为http://localhost:8080/axis/HelloWorld.jws，而后者的则为http://localhost:8080/axis/services/Capacity。

　　总结

　　Web Services是未来网络应用的发展方向，SOAP和WSDL是Web Services的核心协议，Axis给出了一个很好的SOAP实现，它使得开发Web Services应用变得轻松而有趣。

菠萝 2007-08-06 22:47 发表评论

用jws来创建web services

菠萝 — Mon, 06 Aug 2007 14:44:00 GMT

用jws来创建web services是一个最简单的方法，下面借助一个简单的例子说明一下具体过程
1.编写一个java文件，经javac编译后没有错误，把该文件另存为.jws文件。例如合HelloWorld.jws:
public class HelloWorld{
public String sayHello(String name){
         return "Hello"+name;
         }
      }
然后把它放到对应的webapps/axis下.
2。启动服务器，axis会自动把它变成一个服务，生成相关的wsdl文档，并把jws用java编译成class文件放到axis\WEB-INF\jwsClasses目录下。打开IE,输入：http://127.0.0.1:7001/axis/HelloWorld.jws，即可发现有一个wsdl和该服务。
3。编写一应用程序客户端来访问该web services.例如：
import javax.xml.rpc.ParameterMode;
import org.apache.axis.client.Call;
import org.apache.axis.client.Service;
import org.apache.axis.encoding.XMLType;
public class ServiceClient{
public static void main(String[] args) throws Exception{
  String endpoint="http://127.0.0.1:7001/axis/HelloWorld.jws";
  String name="gaolong1";
  Service service=new Service();
  Call call=(Call) service.createCall();
  call.setUsername("glong1");
  call.setPassword("131001");//这是服务所用的安全的认证
  call.setTargetEndpointAddress(new java.net.URL(endpoint));
  call.setOperationName("sayHello");
  call.addParameter("name",XMLType.XSD_STRING,ParameterMode.IN);
  call.setReturnType(XMLType.XSD_STRING);//XMLType.XSD_STRING);
  String ret=(String)call.invoke(new Object[] {name});
  System.out.println(ret);
}
}
运行后，会显示其调用信息。
在使用的过程中，要用到tcpmontor来监听截取soap消息：
用：java org.apache.axis.utils.tcpmon 7003 localhost 7001 (其中前者是截听得代理端口，中间是目标地址，后者是所用的目标端口）
通过tcpmontor来监听tcp:7001得到的soap消息如下：
请求消息：

http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">

http://schemas.xmlsoap.org/soap/encoding/">
      gaolong1

回应消息：

http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">

http://schemas.xmlsoap.org/soap/encoding/">
       Hellogaolong1

菠萝 2007-08-06 22:44 发表评论

用wsdd来开发web services

菠萝 — Mon, 06 Aug 2007 14:43:00 GMT

用wsdd(服务部署描述语言)，主要是编写java文件和编写wsdd文件。
1。编写java文件，最好是定义在某一个包下，否则便以后直接放到\WEB-INF\classes下，有时会出错，原因是在用deploy.wsdd部署时映射不对。然后直接包对应的包放到\WEB-INF\classes中。HelloWorldG.java文件：
    package test.gaolong;
public class HelloWorldG{
public String sayHelloG(String name){
         return "HelloG "+name;
         }
      }
2。编写wsdd文件，根据wsdd文件的规范编写相关文档。例如：(deploy.wsdd)
   http://xml.apache.org/axis/wsdd/" xmlns:java="http://xml.apache.org/axis/wsdd/providers/java"><--命名空间-->
<-服务名-->
    <--对应的主类--->
    <---注册相应的方法，如果只有一个方法，可以直接注册方法名--->
    <--定义用户认证--->
    <-用户认证的描述文件-->



3。部署wsdd文件：打开命令口，切换到deploy.wsdd目录下，运行java org.apache.axis.client.AdminClient即可完成部署。
      这儿可能出错，正确的显示：
D:\bea\user_projects\domains\mydomain\applications\axis\WEB-INF\classes>java org.apache.axis.client.AdminClient -p 7001 deploy.wsdd
Processing file deploy.wsdd
Done processing
      当在wsdl中使用deploy.wsdd来部署时，对于服务器是要打开的，而且当服务器的端口不是8080时，采用要求java org.apache.axis.client.AdminClient -p deploy.wsdd 来指定并进行服务部署。
4。打开server-config.wsdd会发现增加了语句描述：




其实直接到该文件中增加该内容，不必用org.apache.axis.client.AdminClient来部署描述。
打开IE，可以在http://127.0.0.1:7001/axis/servlet/AxisServlet看到该服务部署到服务列表上。
5。编写测试application客户端,其代码如下：
import javax.xml.rpc.ParameterMode;
import org.apache.axis.client.Call;
import org.apache.axis.client.Service;
import org.apache.axis.encoding.XMLType;
import javax.xml.namespace.QName;

public class ServiceClient{
public static void main(String[] args) throws Exception{
  String endpoint="http://127.0.0.1:7003/axis/services/HelloWorldG";
  String name="gaong1";
  Service service=new Service();
  Call call=(Call) service.createCall();//回调服务
  call.setUsername("gaolong1");
  call.setPassword("8001");//用户认证
  call.setTargetEndpointAddress(new java.net.URL(endpoint));
// call.setOperationName("sayHelloG");
  call.setOperationName(new QName("http://gaolong.test/", "sayHelloG"));//设置指定的命名空间，根据wsdl文件来决定
  call.addParameter("name",XMLType.XSD_STRING,ParameterMode.IN);
  call.setReturnType(XMLType.XSD_STRING);//XMLType.XSD_STRING);
  String ret=(String)call.invoke(new Object[] {name});
  System.out.println(ret);
}
}
运行之后有关的显示。
6。通过tcpmonitor来监听的soap消息如下：
请求soap:
http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">

      http://schemas.xmlsoap.org/soap/encoding/" xmlns:ns1="http://gaolong.test/">
              gaolong1


回应soap:
http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">

http://schemas.xmlsoap.org/soap/encoding/" xmlns:ns1="http://gaolong.test/">
      http://schemas.xmlsoap.org/soap/encoding/%22%3EHelloG gaolong1

菠萝 2007-08-06 22:43 发表评论

用DataHandler来实现一个带附件的soap请求的web services

菠萝 — Mon, 06 Aug 2007 14:40:00 GMT

1.为了使其对DataHandler的支持。除了配置好axis环境之外，还要在sun的网站上下载jaf 1-0-2.jar包，并把它注册到CLASS_PATH中。
2.编写服务程序（.java),既支持文本文件，也支持二进制文件。
package test.gaolong;

import java.io.*;
import javax.activation.*;

public class FileService{
public static String Repository="./files/";
public String putFile(DataHandler dh,String name){
   if(name==null)
       name="test.tmp";
       System.out.println("test");
   try{
    File dir=new File(Repository);
    if(!dir.exists()){
         dir.mkdir(); System.out.println("makedir"+"test");
      }
    InputStream input=dh.getInputStream();
    FileOutputStream fos=new FileOutputStream(new File(dir,name));
    System.out.println("test");
    byte[] buffer=new byte[1024*4];
    int n=0;
    while((n=input.read(buffer))!=-1){
     fos.write(buffer,0,n);
     System.out.println(buffer);
    }
    System.out.println("test");
    input.close();
    fos.close();
   }catch(IOException e){
    e.printStackTrace();
   }
return name+"send OK";
}
public DataHandler getFile(String name){
File dir=new File(Repository);
if(!dir.exists())
dir.mkdir();
File data=new File(dir,name);
if(data.exists())
         return new DataHandler(new FileDataSource(data));
else
         return null;
  }
}
3。写deploy.wsdd部署描述文件如下：
http://xml.apache.org/axis/wsdd/" xmlns:java="http://xml.apache.org/axis/wsdd/providers/java" xmlns:ns1="http://localhost:7001/axis/services/FileService" >




    http://www.w3.org/2001/XMlSchema">


     http://www.w3.org/2001/XMlSchema">



    http://schemas.xmlsoap.org/soap/encoding/%22/%3E//注意见下面的。

注：对于soap1.2而言，要使用上面的,而对于soap1.1而言，则有一点区别如下：
http://schemas.xmlsoap.org/soap/encoding/%22/>
4。启动服务器，用java org.apache.axis.client.AdminClient -p 7001 deploy.wsdd部署webservices即可访问。
5。编写客户端应用访问程序如下：
import javax.xml.rpc.ParameterMode;
import org.apache.axis.client.Call;
import org.apache.axis.client.Service;
import org.apache.axis.encoding.XMLType;
import javax.xml.namespace.QName;
import org.apache.axis.soap.SOAP11Constants;
import java.net.URL;
import javax.activation.DataHandler;
import javax.activation.FileDataSource;
import org.apache.axis.encoding.ser.*;
public class ServiceClient{
public static void main(String[] args) throws Exception{
  String filename="HelloWorld.java";
  DataHandler dh=new DataHandler(new FileDataSource(filename));
  String endpoint="http://127.0.0.1:7003/axis/services/FileService";
  String name="gaolong1";
  Service service=new Service();
  Call call=(Call) service.createCall();
     call.setTargetEndpointAddress(new java.net.URL(endpoint));
     call.setOperationName(new QName("http://127.0.0.1:7001/axis/services/FileService", "putFile"));//指定方法的命名空间
        QName qnameattachment=new QName("FileService","DataHandler");
        call.registerTypeMapping(dh.getClass(),qnameattachment,JAFDataHandlerSerializerFactory.class,JAFDataHandlerDeserializerFactory.class);
        call.addParameter("s1",qnameattachment,ParameterMode.IN);
        call.addParameter("s2",XMLType.XSD_STRING,ParameterMode.IN);
  call.setReturnType(XMLType.XSD_STRING);//XMLType.XSD_STRING);//用Class.forName("java.lang.String")来获取java类型
  String ret=(String)call.invoke(new Object[] {dh,"HelloWorld.java"});
  System.out.println(ret);
}
}
6。成功执行客户端应用程序，可以找到上传文件。
请求的soap消息:
POST /axis/services/FileService HTTP/1.0
Content-Type: multipart/related; type="text/xml"; start="<3165C8664597DC7EF29D5BFAC8972562>"; boundary="----=_Part_0_21866740.1141202759484"
Accept: application/soap+xml, application/dime, multipart/related, text/*
User-Agent: Axis/1.2.1
Host: localhost:7003
Cache-Control: no-cache
Pragma: no-cache
SOAPAction: ""
Content-Length: 1050

------=_Part_0_21866740.1141202759484
Content-Type: text/xml; charset=UTF-8
Content-Transfer-Encoding: binary
Content-Id: <3165C8664597DC7EF29D5BFAC8972562>

http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance%22%3E%3Csoapenv:Body%3E%3Cns1:putFile soapenv:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/" xmlns:ns1="http://127.0.0.1:7001/axis/services/FileService%22%3E%3Cs1 href="cid:03D9C1D3A9E0788D274934C3ABD52811" xsi:type="ns2:DataHandler" xmlns:ns2="FileService"/>HelloWorld.java
------=_Part_0_21866740.1141202759484
Content-Type: application/octet-stream
Content-Transfer-Encoding: binary
Content-Id: <03D9C1D3A9E0788D274934C3ABD52811>

public class HelloWorld{
public String sayHello(String name){
         return "Hello"+name;
         }
      }
------=_Part_0_21866740.1141202759484--
上传后的文件的位置：/*在该目录下创建文件夹：D:\bea\user_projects\domains\mydomain\files，并把相应的文件存入该目录下*/
7.另一种基于java mail的带附件的传输，是基于xmlDOM+servlet可以来实现，只是比较底层而已。

菠萝 2007-08-06 22:40 发表评论

为什么需要Web Service

菠萝 — Mon, 06 Aug 2007 14:35:00 GMT

从前，分布式的应用程序逻辑需要使用分布式的对象模型，诸如：微软的分布式组件对象模型(DCOM)、对象管理集团的公用对象请求代理程序体系结构(CORBA)或Sun的远程方法调用(RMI)。通过使用这种基本结构，开发人员仍可拥有使用本地模型所提供的丰富资源和精确性，并可将服务置于远程系统中。

当我已经有了我中意的中间件平台（RMI, Jini, CORBA, DCOM 等等)时，为什么还要为Web而烦恼呢？中间件确实提供了强大的服务实现手段，但是，这些系统有一个共同的缺陷，那就是它们无法扩展到互联网上：它们要求服务客户端与系统提供的服务本身之间必须进行紧密耦合，即要求一个同类基本结构。这样的系统往往十分脆弱：如果一端的执行机制发生变化，那么另一端便会崩溃。例如，如果服务器应用程序的接口发生更改，那么客户端便会崩溃。

要求提供紧密耦合的基本结构，无可厚非，许多应用程序均是基于这种系统构建而成的。但是，当各个公司需要相互合作、或信息技术提供商扩大业务范围时，便很难实现单一而统一的基本结构。您根本无法保证您希望与之进行远程通信的管道的另一端，具备所有您需要的基本结构：对于它使用的操作系统、对象模型或编程语言，您可能一无所知。

相反，Web服务彼此是松散偶合的。连接中的任何一方均可更改执行机制，却不影响应用程序的正常运行。从技术角度讲，人们已转向使用一种基于消息的异步技术来实现高可靠性的系统性能，通过使用诸如HTTP、简单邮件传输协议(SMTP)以及至为重要的XML来实现统一的连接。

Web作为信息发布者的力量就在于简单且无处不在，这对解决现在这样一个分裂中间件世界很重要。Web通过在传统中间件平台上更有效实现的Services，来提供一个统一且广泛适用的接口，这样就改善了这个平台。

从一个N层应用程序结构的角度来看，web service只是一个方便程序访问的包装，服务还是要靠中间件来实现。访问包括服务请求处理（监听者）和一个支持商业逻辑操作的接口，商业逻辑本身是由传统的中间件平台实现的。

从理论上讲，开发人员可通过调用Web应用编程接口(API)（就像调用本地服务一样），将Web服务集成到应用程序中，不同的是Web API调用可通过互联网发送给位于远程系统中的某一服务。例如，Microsoft Passport服务使得开发人员能够对某应用程序进行验证。通过Passport服务编程，开发人员可以充分利用Passport的基本结构，通过运行Passport来维护用户数据库，以确保它的正常运行、定期备份等等。

消息传递系统将通信的基本单元打包成自我描述型的数据包（又称作消息），并将其放到网络缆线中。消息传递系统与分布式对象系统之间的本质区别在于：要求发送方辨识接收方的基本结构的程度有所不同。在分布式系统中，发送方需对接收方的情况作出种种猜测：应用程序是如何激活或拆包的，调用的是什么样的界面，等等。

另一方面，消息传递系统会在缆线格式级上创建合同。发送方既不需考虑消息被接收后的情况，也不需考虑接发双方之间的通信情况，唯一需要考虑的是接收方是否能辩识发送的消息内容。

在缆线格式级上创建合同的优势不言而喻。例如，接收方可在任何时刻进行更改，而不会干扰发送方的消息发送，只要它仍可辩识原有消息的内容。另外，发送方无需任何特殊的软件即可与接收方通信：只要它发出正确格式的消息，接收方就可以响应。

菠萝 2007-08-06 22:35 发表评论

WebService之axis的复杂对象传输

菠萝 — Mon, 06 Aug 2007 14:32:00 GMT

先自定义发布:
写一个deploy.wsdd 文件:

encodingStyle="http://schemas.xmlsoap.org/soap/encoding/"
qname="ns1:book"
serializer="org.apache.axis.encoding.ser.BeanSerializerFactory"
type="java:tests.book"
xmlns:ns1="http://127.0.0.1:8080/axis/services/mShop"/>

服务发布后，以上的发布信息都会被添加到server-config.wsdd文件里~
若服务发布出了什么问题(比如View里面看不到任何服务等……==!)一个考虑的就是这个server-config.wsdd~
上面的高亮显示，这是关键，它在server端定义如何序列化和反序列化complexType
若没有这个，那么你在客户端registry.getDefaultTypeMapping()将什么都得不到~~

这里的定义了一个book对象,它是服务方法 public book[] getAllBooks() 的返回类型，类定义在tests.book，namespace是服务的namespace
具体的wsdd文件说明在axisUserguide里面，具体位置 : %axis_home%/docs/reference.html
以此类推，服务中所有的非原子类型返回都必须typeMapping一下~~~(= =!汗)

注册复杂类型的客户端代码：

org.apache.axis.client.Service service = new org.apache.axis.client.Service();
TypeMappingRegistry registry = service.getTypeMappingRegistry();
TypeMapping map = registry.getDefaultTypeMapping();
QName qType = new QName("http://localhost/tests","book");
Class qClass = Class.forName("tests.book");
map.register(qClass,qType,new BeanSerializerFactory(qClass, qType),
new BeanDeserializerFactory(qClass, qType));

要注意，Service是org.apache.axis.client.Service，而不是javax.xml.rpc.Service，如果用错了axis会发出一大堆http500来抱怨的~~~

菠萝 2007-08-06 22:32 发表评论

Servlet与Web服务

菠萝 — Mon, 06 Aug 2007 14:23:00 GMT

1.第一口就吃到馅，配置一个Web服务的最简方法
===============================================================================================

为了能让web服务先跑起来，先给出一个Web服务的原型，以便于后面的讨论。
我们从一个最简单的例子开始，只给出必须的东西。

所需软件：
1.Tomcat4.1.2
2.一个Java编译器，jdk或JBuilder等等，这是为了编译我们的Java源程序，于web服务无关。

所需文件：
1.sayHello.java
2.web.xml
3.server-config.xml
4.Java Packages: axis.jar,jaxrpc.jar,tt-bytecode.jar,wsdl4j.jar,xercesImpl.jar,xml-apis.jar

至于Tomcat怎么安装我就不说了，网上关于Tomcat安装的文章有很多。
这六个package，从ibm和apache的网站上都可以下得到。

只需要这些，我们就可以部署自己的Web服务了。。
下面是目录结构：
webapps/test/WEB-INF/web.xml
webapps/test/WEB-INF/server-config.wsdd
webapps/test/WEB-INF/classes/sayHello.class
webapps/test/WEB-INF/lib/xxx.jar ---所需得六个packages

web.xml
---------------------------------------------

Axis

org.apache.axis.transport.http.AxisServlet

Axis

/services/*

---------------------------------------------

server-config.wsdd
---------------------------------------------










---------------------------------------------

sayHello.java
---------------------------------------------
public class sayHello
{
  public String sayHelloTo(String aname)
  {
    return "How are you, " + aname;
  }
}
---------------------------------------------

假设ip地址192.168.0.1,端口号是80，我们输入下面的url得到服务列表（当然这里只有一个）:
http://192.168.0.1/test/services
如果你的端口号是8080，就应该输入http://192.168.0.1:8080/test/services,后面同理。

浏览器显示：
——————————————
|And now... Some Services |
| sayHelloService (wsdl)  |
|  .sayHelloTo            |
——————————————

sayHelloService是我们的服务名，右侧的 (wsdl)是一个链接指向sayHelloService的WSDL文档，
这个文档是由Axis自动生成的。
sayHelloTo当然就是我们的方法了。。。

点击(wsdl)链接或输入下面的url，得到WSDL:
http://192.168.0.1/test/services/sayHelloService?wsdl

浏览器显示sayHelloService的WSDL文档：































我们甚至不用客户端，就可以查看服务是否部署成功以及获得返回结果
用Get方法获得soap流，我们要用下面的url:
（真正调用Web服务，用的是Post方法，这个后面会讲）

http://192.168.0.1/test/services/sayHelloService?method=sayHelloTo&aname=everybody

浏览器显示的是乱码，我们点右键查看源文件，结果如下：

Got response message

   How are you, everybody


这就是我们想要的结果吗？这只是服务器端送回来的SOAP消息，不过我们想要的结果在里面。。。

为了真正调用我们的Web服务，下面给出一个Client：

import org.apache.axis.client.Call;
import org.apache.axis.client.Service;
import javax.xml.namespace.QName;

  public class test
  {
    public static void main(String [] args)
    {
      try {
             String endpoint = "http://192.168.0.1/test/services/sayHelloService";
             Service  service = new Service();
             Call     call    = (Call) service.createCall();
             call.setTargetEndpointAddress( new java.net.URL(endpoint) );
             call.setOperationName(new QName("http://sayHelloService", "sayHelloTo"));
             String ret = (String) call.invoke( new Object[] { args[0] } );
             System.out.println(ret);
         } catch (Exception e) {
             e.printStackTrace();
         }
    }
  }

  注意要配置好正确的classpath，确保编译器能找的到axis.jar和jaxrpc.jar，否则编译不会通过。
  用下面的命令行运行这个class:
  java test everybody
  我们会得到：How are you, everybody

  这才是我们真正想要的。。。

2.追根究底，我们的Web服务是怎样跑起来的
===============================================================================================

前面给出的两个配置文件web.xml和server-config.wsdd，或许不是能一下子就看懂的。

先让我们回顾一下servlet的映射模式。

我们知道，servlet是从javax.servlet.http.HttpServlet继承的，在服务器端被载入JVM执行，然后向客户端输出html流。
servlet的web.xml文件（位于 webapps/foo/WEB-INF目录）：

                         "http://java.sun.com/j2ee/dtds/web-app_2.2.dtd">

invoker

/servlet/*

invoker servlet 其实是：org.apache.catalina.servlets.InvokerServlet
按类名提供小服务程序。例如，如果您调用 foo/servlet/HelloServlet，
invoker servlet将装入该HelloServlet（如果它在其类路径中的话）并执行。

初看上面的web.xml，好像只给出了一个servlet映射，而没有定义invoker servlet。
其实，invoker servlet 是在tomcat的conf目录中的web.xml中定义的：：

invoker

org.apache.catalina.servlets.InvokerServlet

debug

所以，如果抛开Tomcat_HOME/conf/web.xml，我们这样定义一个web.xml，似乎更能清楚的说明问题：

"http://java.sun.com/j2ee/dtds/web-app_2.2.dtd">

MyInvoker

org.apache.catalina.servlets.InvokerServlet

debug

MyInvoker

/servlet/*

即所有/servlet/* 模式的url，都会交给org.apache.catalina.servlets.InvokerServlet来处理。
或者说，所有/servlet/* 模式的url，其实都是调用InvokerServlet这个类，而InvokerServlet本身也是
一个servlet，它也是从 HttpServlet 继承而来的。

这样，我们自己的servlet就能够通过特定的url执行，即 /servlet/OurServlet。
当然，如果你高兴，可以定义任何的 url pattern，而不一定是 /servlet/*，这一点，正如我们后面
看到的Axis处理Soap消息的方法。

再进一步，如果不想让 InvokerServlet 在中间“捣鬼”，我们当然可以直接定义自己的servlet:

"http://java.sun.com/j2ee/dtds/web-app_2.2.dtd">

MyInvoker2

com.foo.MyServlet

MyInvoker2

/AnyName/*

JSP也是一样的道理，有了上面的分析，
看看Tomcat_HOME/conf/web.xml中的如下语句就可以JSP的处理方法了，这里就不再废话了：
....

jsp

org.apache.jasper.servlet.JspServlet

logVerbosityLevel

WARNING

jsp

*.jsp

....

下面进入正题。

我们先来看部署Web Service的web.xml：

Axis

org.apache.axis.transport.http.AxisServlet

Axis

/services/*

所有 /services/* 模式的 url 都会交给org.apache.axis.transport.http.AxisServlet处理，
AxisServlet当然也是从HttpServlet继承而来的。这就是为什么我们部署的Web服务在调用时都要在
服务名称前加上 services/ 了。

可以说，AxisServlet是所有Web服务调用的入口。
那么AxisServlet在接手Web服务调用后都做了哪些工作呢？

客户端用call.invoke()调用web服务用的是POST，所以入口是AxisServlet.doPost...
而不是AxisServlet.doGet...

先来看看AxisServlet的doPost函数，这里只给出了关键语句及注释：

    /**
     * Process a POST to the servlet by handing it off to the Axis Engine.
     * Here is where SOAP messages are received
     * @param req posted request
     * @param res respose
     * @throws ServletException trouble
     * @throws IOException different trouble
     */
     public void doPost(HttpServletRequest req, HttpServletResponse res)
        throws ServletException, IOException
    {
msgContext = createMessageContext(engine, req, res);//获取客户请求信息

engine.invoke(msgContext); //调用客户端请求的服务

responseMsg = msgContext.getResponseMessage();//得到调用的返回结果

sendResponse(getProtocolVersion(req), contentType, res, responseMsg);//将结果送至客户端
     }

这样一来，Web服务调用的来龙去脉就大致清楚了。。。

为了高清楚前面我们的三个url
http://192.168.0.1/test/services
http://192.168.0.1/test/services/sayHelloService?wsdl
http://192.168.0.1/test/services/sayHelloService?method=sayHelloTo&aname=everybody
是怎样获得输出结果的，再来看看AxisServlet的doGet函数，这里只给出了流程框架及注释：

**
* Process GET requests. Because Axis does not support the GET-style
* pseudo execution of SOAP methods, this handler deals with queries
* of various kinds, not real SOAP actions.
*
* @todo for secure installations, dont stack trace on faults
* @param request request in
* @param response request out
* @throws ServletException
* @throws IOException
*/
public void doGet(HttpServletRequest req, HttpServletResponse res)
        throws ServletException, IOException
{

//如果路径为空，比如：http://localhost/wstk/services 或 http://localhost/wstk/services/*
if((pathInfo == null || pathInfo.equals("")) && !realpath.endsWith(".jws"))

{
//从server-config.wsdd文件中读取所有部署的服务信息，向向客户端列出所有部署的服务，
//包括每个服务可调用的方法。

}else
//如果路径不为空，比如：http://localhost/wstk/services/sayHelloService
if(realpath != null)
{
//如果请求wsdl，比如：http://localhost/wstk/services/sayHelloService?wsdl
if(wsdlRequested)
{
//创建sayHelloService的WSDL文件并传送至客户端
} else
//这里是利用url调用Web服务的入口，比如http://192.168.0.1/test/services/sayHelloService?method=sayHelloTo&aname=everybody
if(req.getParameterNames().hasMoreElements())
{
//如果客户端调用的方法正确，则Axis会调用相应的JavaBean，并把JavaBean的返回结果
//封装为Soap消息流返回给客户端。
}
}
}

而Axis怎样找到我们所请求的JavaBean呢？答案是server-config.wsdd文件。

server-config.wsdd








WSDD是web service deployment descriptor的缩写。

最外面的元素指示这是WSDD，并定义了java的名字空间。

接着的元素定义了service。一个service是一个目标链，包括请求request、内容提供者provider、响应response。
在这个例子中，我们指出service名字是sayHelloService ，provider是"java:RPC"，它是axis 的标记，指示这是一个java的RPC service，
而处理它的真正的class是org.apache.axis.providers.java.RPCProvider。

接着我们要在中告诉RPCProvider，它如何实例化并调用正确的class（如：com.foo.MyService）。
元素的className指示class名，allowedMethods告诉引擎那些共用的方法要通过soap来调用。
"*"表示所有的公共方法，我们也列出方法名字列表，可以空格或逗号分割它们。

菠萝 2007-08-06 22:23 发表评论