Webservice Axis1.4

在开发之前，先了解一下AXIS，axis目前出现的2版本以其灵活性，快速开发工具的集成高于xfire而使用者居其上。用Eclipse开发，一开始就会想到xfire，它是集成与Eclipse的。所以开发起来非常方便，现在我们来看看axis的开发是怎么样的? 看完本文后，你可以相互比较一下xfire与它的差别。

首先，创建axis环境 ．(注:我事先说明。这是对此版本的基本功能与简单实例的描术)

本人的开发环境eclipse3.7，tomcat5.5.31，jdk1.5 axis_1.4.6目前最新版
这里主要讲一下webservice的一个开发过程，
1. 下载axis1.4最新版本http://apache.mirror.phpchina.com/ws/axis/1_4/
2. 将解压后的axis-1_4文件下的webapps目录下的axis目录拷到%TOMCAT_HOME%Webapps/目录下
3. 启动tomcat的。输入路径http://localhost:8080/axis - 打开axis主界面
4. 点击页面上的Validation ->查看一下你的axis 是否添加了完整的jar文件，注意，这里要仔细看一下，自已少了什么 样的 jar文件，有时缺少了文件axis将无法正常工作。补充一下：这里的xmlsec.jar文件如果缺少的话。可以到这里下载 http://xml.apache.org/security/dist/java-library/ c++的与java两个目录。
5. 下载后把xmlsec-1。4。6。jar考到axis的lib目录下。
上面的步骤如果进行正常将会在Validation页面中就看不到有Error与Warning的信息。好了，接下来我们开始编写代码

Axis支持三种web service的部署和开发，分别为：
1、 Dynamic Invocation Interface (DII)
2、 Stubs方式
3、 Dynamic Proxy方式
这里主要讲一下我的开发过程，通过这样过程，你也将初步的掌握axis 开发Webservice的整体过程．
我再这里只讲第2种方式的

第二种:Stubs　开发方式(stubs 故名思意，存根的方式)
Stubs 方式相对要复杂一点．不过如果学会了这种方式，嘿嘿，那你开发的时候就会明显比第一种方式快了，接下来，跟我一起学吧。
步骤1:
创建环境变量，设置AXIS的环境变量。
这种方式的编码，先要设置一下命令行的环境。右键我的电脑 ? 属性 ? 选择高级选项卡 ? 新建用户变量 ? 输入用户变量如下:

变量名:AXIS_HOME
变量值: D:\tomcat-5.5.31\webapps\axis\WEB-INF

变量名: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%\wsdl4j-1.5.1.jar;%AXIS_LIB%\activation.jar;%AXIS_LIB%\xmlsec-1.4.6.jar;%AXIS_LIB%\axis-ant.jar;%AXIS_LIB%\mail.jar;

CLASSPATH:

追加：%AXISCLASSPATH%

新建好上述的三个变量后．确定退出．
步骤2:
编码开始！这里要稍讲得详细并复杂一点了，我们上面看到了，只设置了一个普通 的参数，这里我就写一下自定义数据类型参数的传递．网上很多文章只讲到了普通数据类型做参数传递。
服务器端的编写，代码与注释如下：
首先定义自定义参数类（第一个类）
package com.web.test;

publicclass UserBean {//自定义数据类型.
//很简单，只有一个String 与int 型
private String name="";
private int age;

publicint getAge() {
return age;
}

publicvoid setAge(int age) {
this.age = age;
}

public String getName() {
return name;
}

publicvoid setName(String name) {
this.name = name;
}
}

其次编写第二个类Webservice服务器端类
package com.web.test;

publicclass Server {//服务器端
//服务端，传递的是一个自定义的数据类型.UserBean
public String getBeanStr(UserBean bean){
return "You Name:"+bean.getName()
+ "，You Age:" + bean.getAge();
}
}

最后编写一个deploy.wsdd文件如下:
<deployment
xmlns="http://xml.apache.org/axis/wsdd/"
xmlns:java="http://xml.apache.org/axis/wsdd/providers/java">
<!-- 这里的stubs为wsdd描述符中的ServiceNamespace -->
<service name="stubs" provider="java:RPC">
<!-- 这里的ClassName就是我的服务类了，这个服务主要功能就是传递
一个自定义的对象 -->
<parameter name="className" value="com.web.test.Server"/>
<!-- 这里描术的意思是，此服务类中的方法全部享出来.value值为*号
如果你只想让你的客户端只能调用其中一个方法时，value值改为方
法名就可以了。-->
<parameter name="allowedMethods" value="*"/>
<!-- 这个typeMapping 是类型映射，使传递的参数序列化用反序列化，
一个自定义类型在要网络上传递，那就一定得让他序列化． -->

<!-- 下面是反序列化类配置-->
<typeMapping
deserializer="org.apache.axis.encoding.ser.BeanDeserializerFactory"
encodingStyle=http://schemas.xmlsoap.org/soap/encoding/
<!-- 这是Qname名称的定义 -->
qname="ns1:user"
<!-- 序列化类配置 -->
serializer="org.apache.axis.encoding.ser.BeanSerializerFactory"
<!-- 我的数据参数类型类路径-->
type="java:com.web.test.UserBean"
<!-- Qname对映的key -->
xmlns:ns1="urn:BeanService"/>
</service>
</deployment>

到这一步，我们的服务端配置完成，整理一下思路，stubs方式调用需要
(这里主要是为了讲述自定义类的对像传递)
1. 一个自定义类。
2. 一个服务端类。
3．一个wsdd文件服务描术符。
OK接着看。
将上面写好的两个类的class文件复制到/axis/web-inf/class目录下，只要把整个包复制过来就行了，然后在把deploy.wsdd文件复制到/axis/web-inf/目录下。
打开控制台进入你的axis目录:
>cd D:\tomcat-5.5.31\webapps\axis\WEB-INF (我的目录)

>java org.apache.axis.client.AdminClient -l

http://localhost:8080/axis/services/AdminService deploy.wsdd

（说明: stubs就是刚才我们在deploy。wsdd文件里配置的<service name="stubs"）
这里是关键．这个命令就是发布这个服务。你只需这样理解它。发布成功后，你在看下你的Axis/web-inf/目录下，多了一个server-config.wsdd文件，你可打开它看下里成的描述符是不是跟我们写的deploy。wsdd相类似呢？
如果发布失败，那么在控制台下你将会看到一些错误信息，并仔细的解决它．
（注:一般错误的原因有这么几点，
我个人在开发学习时，可能是类路径没有写对，也可能是你的<service name="stubs" 这个名称有点错误，你要么改成别的名称试试。
也有可能是你的wsdd文件里面写得不规范。
最后可能就是你的命令无效，ClassNotFoundException错误，这个错误是因为你没有配置好axis的环境造成的。）
发布成功后在控制台下会有提示:
Processing file deploy.wsdd
<Admin>Done processing</Admin>
OK当您发布成功后．可以开始往下写了．
步骤3:
嘿。完成了上面两个步骤，接下来的工作就是很轻松的了，我们来生成一个客户端
>cd D:\tomcat-5.5.31\webapps\axis\WEB-INF (我的目录)
打开生成的wsdl地址http://localhost:8080/axis/services/stubs?wsdl将打开的xml文档保存为stubs.wsdl文件，放在上面的目录下。
控制台命令
>java -cp %AXISCLASSPATH% org.apache.axis.wsdl.WSDL2Java stubs.wsdl
打开axis/web-inf/目录下可以看到生成了localhost目录和BeanService目录，OK，复制这2个目录，到你的项目中。

localhost目录生成了:
Server.java
ServerService.java
ServerServiceLocator.java
StubsSoapBindingStub.java
User.java
java文件;

接下来的工作就是编写一个调用类测试。代码与注释如下

package myclient;

import java.net.URL;
import javax.xml.namespace.QName;
import org.apache.axis.client.Call;
import org.apache.axis.client.Service;
import org.apache.axis.encoding.ser.BeanDeserializerFactory;
import org.apache.axis.encoding.ser.BeanSerializerFactory;

public class Test {
public static void main(String []args) throws Exception {
QName qname = new QName("urn:BeanService","user");
Service s = new Service();
Call call = (Call) s.createCall();
//注册这个bean为可序列化的.传递参数
call.registerTypeMapping(User.class,qname,
new BeanSerializerFactory(User.class,qname),
new BeanDeserializerFactory(User.class,qname));
//设置一下调用方法名.不设置肯定会报错的哦
call.setOperationName("getBeanStr");
//设置一下这个服务的绝对路径.
call.setTargetEndpointAddress(
new URL("http://localhost:8080/axis/services/stubs?wsdl"));
//实例化一个User,这个User是生成出来的User哦，不是原先那个。
User u = new User();
u.setAge(23);
u.setName("do WebService！");
//通知方法,并返回结果
String str = (String)call.invoke(new Object[]{u});
System.out.println(str);
//out.print ==> You Name:do WebService！,You Age:23
}
}
好了，这下完成了stubs的方式．

我也是刚学习的，有疑问可以留言大家互相交流学习