Axis2 WebService的发布和调用说明

准备工作

1、下载：axis2-1.5.4-bin.zip,axis2-1.5.4-war.zip 下载地址：http://axis.apache.org/axis2/java/core/
2、环境变量设置
AXIS2_HOME E:\research\axis2-1.5.4-bin\axis2-1.5.4
JAVA_HOME C:\Program Files\Java\jdk1.6.0_21
3、axis2-1.5.4-war.zip解压，将压缩包内的axis2.war部署到%TOMCAT-HOME%/webapps下，启动tomcat，访问http://localhost:8085/axis2/看是否正常。

点击Service会进入Service列表页面，当前只有一个Version服务。http://localhost:8085/axis2/services/Version?wsdl
4、下载Eclipse的Axis2插件： axis2-eclipse-codegen-plugin-1.5.4.zip,axis2-eclipse-service-plugin-1.5.4.zip 解压后将plugins 复制到%ECLIPSE_HOME%\plugins。
http://www.apache.org/dyn/mirrors/mirrors.cgi/axis/axis2/java/core/1.5.4/axis2-eclipse-codegen-plugin-1.5.4.zip
http://www.apache.org/dyn/mirrors/mirrors.cgi/axis/axis2/java/core/1.5.4/axis2-eclipse-service-plugin-1.5.4.zip

安装完插件后，IDE中选择new->other中看到“Axis2 Wizards”，说明插件已经安装成功了。

 

AXIS2发布Web Services 
一、工程文件

1、新建名称为Axis2Service1 的java工程。
2、新建 \Axis2Service1\src\ws\TestWs.java

[java] view plaincopy

1. package ws;  
2. public class TestWs {  
3.  public String showName(String name) {return name; }  
4.  public String getName() {return "Axis2Service Sample"; }    
5. }  

 

二、arr部署方式
1、手动打包
新建\Axis2Service1\deploy文件夹，将\Axis2Service1\bin下的class文件复制过来。
新建\Axis2Service1\deploy\META-INF\services.xml文件

[html] view plaincopy

1. <service name="AxisService">  
2.  <description>AxisService</description>  
3.  <parameter name="ServiceClass">ws.TestWs</parameter>  
4.  <operation name="showName">  
5.   <messageReceiver  
6.    class="org.apache.axis2.rpc.receivers.RPCMessageReceiver" />  
7.  </operation>  
8.  <operation name="getName">  
9.   <messageReceiver  
10.    class="org.apache.axis2.rpc.receivers.RPCInOnlyMessageReceiver" />  
11.  </operation>  
12. </service>  

 

生成aar包 \Axis2Service1\deploy>jar cvf AxisService.aar . (注意带.号)

2、插件打包
IDE中选择New->other->Axis2 Service Archiver,点击Next;
Class File Location:选择Axis2Service1\bin目录,点击Next;
勾选Skip WSDL,点击Next;
Service Archiver 选择jar位置，如果没有jar包就直接点击Next;
勾选Generate the service xml automatically 自动生成service.xml file文件,点击Next
service name,输入:AxisService,然后在class name 中填写要发布的类(全路径，如：ws.TestWs),点击load。勾选Search declared methods only。点击next

output File location,输入:D:\ ; output File Name,输入artiver文件的名称 AxisService。点击finish。
提示 Service Archvie generated successfully! 注册表明,生成成功。

3、发布AxisService
AxisService.aar复制到%TOMCAT-HOME%/webapps/axis2/WEB-INF/services下。（不打aar包，\Axis2Service1\deploy下面复制过去也是可以）

打开http://localhost:8085/axis2/services/listServices 就可以看到刚才发布的AxisService服务了，下面有两个函数：showName,getName。

 

三、独立部署

1、新建java web project工程。
2、文件复制
%TOMCAT-HOME%\webapps\axis2\WEB-INF\lib 复制到 \Axis2Service2\WebRoot\WEB-INF\lib 下，并加入工程引用。
%TOMCAT-HOME%\webapps\axis2\WEB-INF\conf 复制到 \Axis2Service2\WebRoot\WEB-INF\conf 
%TOMCAT-HOME%\webapps\axis2\WEB-INF\modules 复制到 \Axis2Service2\WebRoot\WEB-INF\modules

3、web.xml 代码如下

[html] view plaincopy

1. <?xml version="1.0" encoding="UTF-8"?>  
2. <web-app id="wmf" version="2.4" xmlns="http://java.sun.com/xml/ns/j2ee"  
3.  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"  
4.  xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee http://java.sun.com/xml/ns/j2ee/web-app_2_4.xsd">  
5.  <servlet>  
6.   <servlet-name>AxisServlet</servlet-name>  
7.   <servlet-class>org.apache.axis2.transport.http.AxisServlet</servlet-class>  
8.   <load-on-startup>1</load-on-startup>  
9.  </servlet>  
10.  <servlet-mapping>  
11.   <servlet-name>AxisServlet</servlet-name>  
12.   <url-pattern>/services/*</url-pattern>  
13.  </servlet-mapping>  
14. </web-app>  

 

2、新建 \Axis2Service2\src\ws\TestWs.java

[java] view plaincopy

1. package ws;  
2. public class TestWs {  
3.  public String showName(String name) {return name; }  
4.  public String getName() {return "Axis2Service Sample"; }    
5. }  

3、新建\Axis2Service2\WebRoot\WEB-INF\services目录。
4、新建一个AxisService服务
AxisService\META-INF\services.xml

[html] view plaincopy

1. <service name="AxisService">  
2.  <description>AxisService</description>  
3.  <parameter name="ServiceClass">ws.TestWs</parameter>  
4.  <operation name="showName">  
5.   <messageReceiver  
6.    class="org.apache.axis2.rpc.receivers.RPCMessageReceiver" />  
7.  </operation>  
8.  <operation name="getName">  
9.   <messageReceiver  
10.    class="org.apache.axis2.rpc.receivers.RPCInOnlyMessageReceiver" />  
11.  </operation>  
12. </service>  

 

启动tomcat后，访问http://localhost:8085/Axis2Service2/services/AxisService?wsdl看是否正常。

 AXIS2调用Web Services

一、客户端stub文件生成
1、脚本生成方式
去AXIS2的解压目录下bin(%AXIS2_HOME%\bin\)下执行下面语句
wsdl2java -uri http://localhost:8085/Axis2Service2/services/AxisService?wsdl -p ws -s -o stub
-p参数指定了生成的Java类的包名
-o参数指定了生成的一系列文件保存的根目录
在stub\src\ws自动生成AxisServiceStub.java

2、插件生成方式
IDE中选择New->other->Axis2 Code Generator,点击Next;
勾选Generate Java source code from a WSDL file,点击Next;
WSDL file location,输入:http://localhost:8085/Axis2Service2/services/AxisService?wsdl,点击Next;
如果路径不对会提示：Specified WSDL is invalid!, Please select a validated *.wsdl/*.xml file on previous page.
正确的话，点击next;

指定输入路径,点击Next

提示：All operations completed successfully! 生成成功。在D:\src\ws 自动生成了stub一系列文件,其中ws是包名。

上面2种方式生成的stub类有点不一样，脚本生成方式是单一文件，插件生成方式生成的一系列文件。

二、客户端调用
脚本生成方式为例子，插件生成的类似。

1、新建 java工程 Axis2Client
新建\Axis2Client\lib文件夹
将%AXIS2_HOME%\lib\ 下的所有jar包复制到\Axis2Client\lib，并加入工程引用中
将通过脚本生成的单一AxisServiceStub.java文件加入到src\ws下

2、新建test.TestWs.java 主要代码如下

 

[java] view plaincopy

1. //初始化Sub类  
2. AxisServiceStub stub = new AxisServiceStub();  
3. //传递AxisServiceStub.ShowName对象，相关参数在这边赋值。  
4. AxisServiceStub.ShowName command = new AxisServiceStub.ShowName();  
5. command.setName("Hello!");  
6. //取得返回值  
7. String name = stub.showName(command).get_return();  
8. System.out.println(name);  

 

 

调用成功后控制台输出：Hello!

 

 AXIS2调用REST Web Services

使用http://localhost:8086/Axis2Rest/services/AxisService/showName?name=rest的方式访问刚才发布成功的WebService。从上面可以看出这个就是rest风格。Axis1.0是无法通过showName?name=rest来获取信息的。

2、使用axis客户端调用

[java] view plaincopy

1. public class TestRest {  
2.    
3.     private static String toEpr = "http://localhost:8086/Axis2Rest/services/AxisService";  
4.      
5.     public static void main(String[] args) throws AxisFault {  
6.         Options options = new Options();  
7.         options.setTo(new EndpointReference(toEpr));  
8.          
9.         //客户端REST方式调用服务跟普通服务的区别，REST调用必须加上下面这个代码。  
10.         options.setProperty(Constants.Configuration.ENABLE_REST, Constants.VALUE_TRUE);  
11.         ServiceClient sender = new ServiceClient();  
12.         //axis2-1.5.4不需要下面这句代码，否则会报错  
13.         //sender.engageModule(new QName(Constants.MODULE_ADDRESSING));  
14.         sender.setOptions(options);  
15.         OMElement result = sender.sendReceive(getPayload());  
16.         try {  
17.             XMLStreamWriter writer = XMLOutputFactory.newInstance()  
18.                     .createXMLStreamWriter(System.out);  
19.             result.serialize(writer);  
20.             writer.flush();  
21.         } catch (XMLStreamException e) {  
22.             e.printStackTrace();  
23.         } catch (FactoryConfigurationError e) {  
24.             e.printStackTrace();  
25.         }  
26.     }  
27.     private static OMElement getPayload() {  
28.         OMFactory fac = OMAbstractFactory.getOMFactory();  
29.         OMNamespace omNs = fac.createOMNamespace(  
30.                 "http://ws", "example1");  
31.         OMElement method = fac.createOMElement("showName", omNs);  
32.         OMElement value = fac.createOMElement("name", omNs);  
33.         value.addChild(fac.createOMText(value, "Rest"));  
34.         method.addChild(value);  
35.         return method;  
36.     }  

 

说明：
1、sender.engageModule(new QName(Constants.MODULE_ADDRESSING)); axis2-1.5.4不需要下面这句代码，否则会报错

2、客户端REST方式调用服务跟普通服务的区别，就是Rest有下面这个代码；
options.setProperty(Constants.Configuration.ENABLE_REST, Constants.VALUE_TRUE);
两者返回的数据都是

[html] view plaincopy

1. <ns:showNameResponse xmlns:ns="Resthttp://ws"><ns:return>Rest</ns:return></ns:showNameResponse>  

 

3、getPayload方法

OMNamespace omNs = fac.createOMNamespace("http://ws", "example1"); 指定命名空间，如果没对的话会报如下错误<faultstring>namespace mismatch require http://ws found http://ws1</faultstring>

OMElement method = fac.createOMElement("showName", omNs); 要传递的方法名为 "showName"

OMElement value = fac.createOMElement("name", omNs); 传递的参数为name

value.addChild(fac.createOMText(value, "Rest"));  传递参数name的值为Rest。

注：转载http://feiyeguohai.iteye.com/blog/1575700