一、axis2的下载和安装 1.可从http://ws.apache.org/axis2/下载axis2的最新版本： 可以下载如下两个zip包： axis2-1.5.4-bin.zip axis2-1.5.4-war.zip 其中 axis2-1.5.4-bin.zip文件中包含了axis2中所有的jar文件, axis2-1.5.4-war.zip文件用于将webservice
一、axis2的下载和安装
1.可从http://ws.apache.org/axis2/ 下载axis2的最新版本：
可以下载如下两个zip包：
axis2-1.5.4-bin.zip
axis2-1.5.4-war.zip
其中 axis2-1.5.4-bin.zip文件中包含了axis2中所有的jar文件,
axis2-1.5.4-war.zip文件用于将webservice发布到web容器中。
2.将axis2-1.5.4-war.zip文件解压到相应的目录，将目录中的axis2.war文件放到\webapps目录中，
并启动tomcat,在浏览器地址栏中输入如下的url：
http://localhost:8080/axis2/，如看到axis2的主页面则安装成功。
二、编写和发布webservice
(1)用pojo形式发布（无需配置）
在axis2中不需要进行任何的配置，就可以直接将一个简单的pojo发布成webservice。
其中pojo中所有的public方法将被发布成webservice方法。
示例代码如下：
java代码
public class helloservice { public string sayhello(){ return hello; } public string sayhellotoperson(string name){ if(name==null){ name = nobody; } return hello,+name; } } 编译helloservice类后，将helloservice.class文件放到\webapps\axis2\web-inf\pojo目录中
（如果没有pojo目录，则建立该目录）。现在我们已经成功将helloservice类发布成了webservice。
在浏览器地址栏中输入如下的url：
http://localhost:8080/axis2/services/listservices
在浏览器地址栏中输入如下的两个url来分别测试sayhellotoperson和sayhello方法：
1.http://localhost:8080/axis2/services/helloservice/sayhello
2.http://localhost:8080/axis2/services/helloservice/sayhellotoperson?name=bill
页面显示如下结果：
xml代码
ns:sayhellotopersonresponse xmlns:ns=http://ws.apache.org/axis2> return>hello,billreturn> ns:sayhellotopersonresponse>
在编写、发布和测试webservice时应注意如下几点：
1. pojo类不能使用package关键字声明包。
2. axis2在默认情况下可以热发布webservice，也就是说，将webservice的.class文件复制到pojo目录中时，
tomcat不需要重新启动就可以自动发布webservice。
如果想取消axis2的热发布功能，可以打开\webapps\axis2\web-inf\conf\axis2.xml，
找到如下的配置代码：
xml代码
parameter name=hotdeployment>trueparameter>
将true改为false即可。要注意的是，axis2在默认情况下虽然是热发布，但并不是热更新.
也就是说，一旦成功发布了webservice，再想更新该webservice，就必须重启tomcat。
这对于开发人员调试webservice非常不方便，因此，在开发webservice时，可以将axis2设为热更新。
在axis2.xml文件中找到
xml代码
parameter name=hotupdate>falseparameter>
将false改为true即可。
3. 在浏览器中测试webservice时，如果webservice方法有参数，需要使用url的请求参数来指定该webservice方法
参数的值，请求参数名与方法参数名要一致，例如，要测试sayhellotoperson方法，请求参数名应为name，如上面的url所示。
4. 发布webservice的pojo目录只是默认的，如果读者想在其他的目录发布webservice，
可以打开axis2.xml文件，并在元素中添加如下的子元素：
xml代码
deployer extension=.class directory=my class=org.apache.axis2.deployment.pojodeployer/>
上面的配置允许在\webapps\axis2\web-inf\my目录中发布webservice。
例如，将本例中的helloservice.class复制到my目录中也可以成功发布
（但要删除pojo目录中的simpleservice.class，否则webservice会重名）。
(2)使用services.xml配置文件发布
用axis2实现web service，虽然可以将pojo类放在axis2\web-inf\pojo目录中直接发布成web service，
这样做不需要进行任何配置，但这些pojo类不能在任何包中。这似乎有些不方便.
为此，axis2也允许将带包的pojo类发布成web service。先实现一个pojo类，代码如下：
java代码
package com.sinosoft.webservice; public class helloservicenew { public string sayhellonew(){ return hello; } public string sayhellotopersonnew(string name){ if(name==null){ name = nobody; } return hello,+name; } public void updatedata(string data){ system.out.println(data+ 已更新。); } }
要想将helloservicenew类发布成web service，需要一个services.xml文件，
这个文件需要放在meta-inf目录中，该文件的内容如下：
xml代码
xml version=1.0 encoding=utf-8?> service name=helloservicenew> description> web service例子 description> parameter name=serviceclass> com.sinosoft.webservice.helloservicenew parameter> messagereceivers> messagereceiver mep=http://www.w3.org/2004/08/wsdl/in-out class=org.apache.axis2.rpc.receivers.rpcmessagereceiver /> messagereceiver mep=http://www.w3.org/2004/08/wsdl/in-only class=org.apache.axis2.rpc.receivers.rpcinonlymessagereceiver /> messagereceivers> service>
其中元素用于发布web service，一个元素只能发布一个webservice类，
name属性表示webservice名，如下面的url可以获得这个webservice的wsdl内容：
http://localhost:8080/axis2/services/helloservicenew?wsdl
其中name属性名就是上面url中?和/之间的部分。
元素表示当前web service的描述，元素用于设置webservice的参数，
在这里用于设置webservice对应的类名。
在这里最值得注意的是元素，该元素用于设置处理webservice方法的处理器。
例如，sayhellonew方法有一个返回值，因此，需要使用可处理输入输出的rpcmessagereceiver类，
而updatedata方法没有返回值，因此，需要使用只能处理输入的rpcinonlymessagereceiver类。
使用这种方式发布webservice，必须打包成.aar文件，.aar文件实际上就是改变了扩展名的.jar文件。
现在建立了两个文件：helloservicenew.java和services.xml。
将helloservicenew.java编译，生成helloservicenew.class。
services.xml和helloservicenew.class文件的位置如下：
d:\ws\ com\sinosoft\webservice\helloservicenew.class
d:\ws\meta-inf\services.xml
在windows控制台中进入ws目录，并输入如下的命令生成.aar文件.
jar cvf ws.aar .
实际上，.jar文件也可以发布webservice，但axis2官方文档中建议使用.aar文件发布webservice.
最后将ws.aar文件复制到\webapps\axis2\web-inf\services目录中，
启动tomcat后，就可以调用这个webservice了。
另外services.xml文件中也可以直接指定webservice类的方法，如可以用下面的配置代码来发布webservice
xml代码
service name= helloservicenew > description> web service例子 description> parameter name=serviceclass> com.sinosoft.webservice.helloservicenew parameter> operation name=sayhello> messagereceiver class=org.apache.axis2.rpc.receivers.rpcmessagereceiver/> operation> operation name=updatedata> messagereceiver class=org.apache.axis2.rpc.receivers.rpcinonlymessagereceiver/> operation> service>
如果想发布多个webservice，可以使用元素
xml代码
servicegroup> service name=myservice1> ... service> service name=myservice2> ... service> servicegroup>
中间省略的代码同上面services.xml文件的配置。
三、 用java实现调用webservice的客户端程序
webservice是为程序服务的，只在浏览器中访问webservice是没有意义的。调用webservice的客户端代码如下：
java代码
import javax.xml.namespace.qname; import org.apache.axis2.axisfault; import org.apache.axis2.addressing.endpointreference; import org.apache.axis2.client.options; import org.apache.axis2.rpc.client.rpcserviceclient; public class testmain { public static void main(string args[]) throws axisfault{ // 使用rpc方式调用webservice rpcserviceclient serviceclient = new rpcserviceclient(); options options = serviceclient.getoptions(); // 指定调用webservice的url endpointreference targetepr = new endpointreference( http://localhost:8080/axis2/services/helloservice); options.setto(targetepr); // 指定sayhellotoperson方法的参数值 object[] opaddentryargs = new object[] {美女}; // 指定sayhellotoperson方法返回值的数据类型的class对象 class[] classes = new class[] {string.class}; // 指定要调用的sayhellotoperson方法及wsdl文件的命名空间 qname opaddentry = new qname(http://ws.apache.org/axis2, sayhellotoperson); // 调用sayhellotoperson方法并输出该方法的返回值 system.out.println(serviceclient.invokeblocking(opaddentry, opaddentryargs, classes)[0]); } } 输出结果为：
hello,美女
在编写客户端代码时应注意如下几点：
1. 客户端代码需要引用很多axis2的jar包，如果读者不太清楚要引用哪个jar包，
可以在eclipse的工程中引用axis2发行包的lib目录中的所有jar包。
2. 在本例中使用了rpcserviceclient类的invokeblocking方法调用了webservice中的方法。
invokeblocking方法有三个参数，其中第一个参数的类型是qname对象，表示要调用的方法名；
第二个参数表示要调用的webservice方法的参数值，参数类型为object[]；
第三个参数表示webservice方法的返回值类型的class对象，参数类型为class[]。
当方法没有参数时，invokeblocking方法的第二个参数值不能是null，而要使用new object[]{}。
3. 如果被调用的webservice方法没有返回值，应使用rpcserviceclient类的invokerobust方法，
该方法只有两个参数，它们的含义与invokeblocking方法的前两个参数的含义相同。
4. 在创建qname对象时，qname类的构造方法的第一个参数表示wsdl文件的命名空间名，
也就是元素的targetnamespace属性值。
四、用wsdl2java简化客户端的编写
axis2提供了一个wsdl2java.bat命令可以根据wsdl文件自动产生调用webservice的代码。
wsdl2java.bat命令可以在/bin目录中找到。
在使用wsdl2java.bat命令之前需要设置axis2_home环境变量，该变量值是。
在windows控制台输出如下的命令行来生成调用webservice的代码：
%axis2_home%\bin\wsdl2java -uri http://localhost:8080/axis2/services/helloservice?wsdl
-p client -s -o stub
其中-url参数指定了wsdl文件的路径，可以是本地路径，也可以是网络路径。
-p参数指定了生成的java类的包名，-o参数指定了生成的一系列文件保存的根目录。
在执行完上面的命令后，就会发现在当前目录下多了个stub目录，
在stub/src/client目录可以找到一个helloservicestub.java文件，
该文件复杂调用webservice，可以在程序中直接使用这个类，代码如下：
java代码
package client; public class stuptest { public static void main(string[] args) throws exception { helloservicestub stub = new helloservicestub(); helloservicestub.sayhellotoperson gg = new helloservicestub.sayhellotoperson(); gg.setname(美女); system.out.println( stub.sayhello().get_return()); system.out.println(stub.sayhellotoperson(gg).get_return()); } } 输出结果如下：
hello
hello,美女
上面的代码大大简化了调用webservice的步骤，并使代码更加简洁。
但要注意的是，wsdl2java.bat命令生成的stub类将webservice方法的参数都封装在了相应的类中，
类名为方法名，例如，sayhellotoperson方法的参数都封装在了sayhellotoperson类中，
要想调用sayhellotoperson方法，必须先创建sayhellotoperson类的对象实例。