Axis2创建WebService实例
WebService
Tomcat
Apache
Web
XML?
??一、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文件放到<Tomcat安装目录>webapps目录中，
???? 并启动Tomcat,在浏览器地址栏中输入如下的URL：
?????http://localhost:8080/axis2/，如看到axis2的主页面则安装成功。
?
??二、编写和发布WebService
???(1)用POJO形式发布（无需配置）
????在Axis2中不需要进行任何的配置，就可以直接将一个简单的POJO发布成WebService。
?? ?其中POJO中所有的public方法将被发布成WebService方法。
????示例代码如下：
????
- public?class?HelloService?{???
- ????public?String?sayHello(){??
- ????????return?"hello";??
- ????}?????
- public?String?sayHelloToPerson(String?name){??????????
- if(name==null){??
- ????????????name?=?"nobody";??
- ????????}??
- return?"hello,"+name;??
- ????}??
- }??
???编译HelloService类后，将HelloService.class文件放到<Tomcat安装目录>webappsaxis2WEB-INFpojo目录中
??（如果没有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
??页面显示如下结果：
parameter?name="hotdeployment">trueparameter>??
?
? 将true改为false即可。要注意的是，Axis2在默认情况下虽然是热发布，但并不是热更新.
??也就是说，一旦成功发布了WebService，再想更新该WebService，就必须重启Tomcat。
??这对于开发人员调试WebService非常不方便，因此，在开发WebService时，可以将Axis2设为热更新。
??在axis2.xml文件中找到
deployer?extension=".class"?directory="my"?class="org.apache.axis2.deployment.POJODeployer"/>??
?
??上面的配置允许在<Tomcat安装目录>webappsaxis2WEB-INFmy目录中发布WebService。
? ?例如，将本例中的HelloService.class复制到my目录中也可以成功发布
?? （但要删除pojo目录中的SimpleService.class，否则WebService会重名）。
?
(2)使用services.xml配置文件发布
??用Axis2实现Web Service，虽然可以将POJO类放在axis2WEB-INFpojo目录中直接发布成Web Service，
??这样做不需要进行任何配置，但这些POJO类不能在任何包中。这似乎有些不方便.
??为此，Axis2也允许将带包的POJO类发布成Web Service。先实现一个POJO类，代码如下：
<?xml?version="1.0"?encoding="UTF-8"?>??
service?name="HelloServiceNew"description ????????Web?Service例子??
parameter?name="ServiceClass" ????????com.sinosoft.webservice.HelloServiceNew??
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"?service>??
?
?其中<service>元素用于发布Web Service，一个<service>元素只能发布一个WebService类，
??name属性表示WebService名，如下面的URL可以获得这个WebService的WSDL内容：
??http://localhost:8080/axis2/services/HelloServiceNew?wsdl
??其中name属性名就是上面URL中"?"和"/"之间的部分。
??<description>元素表示当前Web Service的描述，<parameter>元素用于设置WebService的参数，
??在这里用于设置WebService对应的类名。
??在这里最值得注意的是<messageReceivers>元素，该元素用于设置处理WebService方法的处理器。
??例如，sayHelloNew方法有一个返回值，因此，需要使用可处理输入输出的RPCMessageReceiver类，
??而updateData方法没有返回值，因此，需要使用只能处理输入的RPCInOnlyMessageReceiver类。
??
??使用这种方式发布WebService，必须打包成.aar文件，.aar文件实际上就是改变了扩展名的.jar文件。
??现在建立了两个文件：HelloServiceNew.Java和services.xml。
??将HelloServiceNew.java编译，生成HelloServiceNew.class。
??services.xml和HelloServiceNew.class文件的位置如下：
??D:ws comsinosoftwebserviceHelloServiceNew.class
??D:wsMETA-INFservices.xml
??在windows控制台中进入ws目录，并输入如下的命令生成.aar文件.
?
??? jar cvf ws.aar .
??实际上，.jar文件也可以发布webservice，但axis2官方文档中建议使用.aar文件发布webservice.
??最后将ws.aar文件复制到<Tomcat安装目录>webappsaxis2WEB-INFservices目录中，
??启动Tomcat后，就可以调用这个WebService了。
?
? 另外services.xml文件中也可以直接指定WebService类的方法，如可以用下面的配置代码来发布WebService
serviceGroupservice?name="myService1" ????...??
service?name="myService2">??
?
中间省略的代码同上面services.xml文件的配置。
?
三、 用Java实现调用WebService的客户端程序
???? WebService是为程序服务的，只在浏览器中访问WebService是没有意义的。调用WebService的客户端代码如下：
package?client;??
class?StupTest?{???????????
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类的对象实例。?
