axis2开发实例（二）建立独自的新工程

axis2开发实例--建立独自的新工程

 

第一部分 环境搭建

1．  环境搭建

（1）    下载Axis2服务包：axis2-1.6.2-bin.zip，axis2-1.6.2-war.zip，分别解压到D:\webservice_axis2。

 

（2）下载myeclipse的axis2插件Axis2_Codegen_Wizard_1.3.0 和Axis2_Service_Archiver_1.3.0，一个是帮助我们生成aar文件的，另一个是帮我们用wsdl文件生成stub代码的。解压后将axis2插件包下的Axis2_Codegen_Wizard_1.3.0和Axis2_Service_Archiver_1.3.0文件夹拷贝至Myeclipse8.5\dropins 目录下，重启myeclipse生效

 

 

2．  编码  参考《http://blog.csdn.net/ge_zhiqiang/article/details/7656112》

（1）新建web工程newWebservice ，引入axis2的lib包

A、将Axis-War包解压后，把WEB-INF/下的conf，modules，services，lib拷贝到工程newWebservice 的WebRoot/WEB-INF/

B、修改web.xml，添加axis2的servlet

<servlet>        <servlet-name>AxisServlet</servlet-name>      <servlet-class>org.apache.axis2.transport.http.AxisServlet</servlet-class>        <load-on-startup>1</load-on-startup>     </servlet>     <servlet>        <servlet-name>AxisAdminServlet</servlet-name>     <servlet-class>org.apache.axis2.webapp.AxisAdminServlet</servlet-class>     </servlet>     <servlet-mapping>        <servlet-name>AxisServlet</servlet-name>        <url-pattern>/servlet/AxisServlet</url-pattern>     </servlet-mapping>     <servlet-mapping>        <servlet-name>AxisServlet</servlet-name>        <url-pattern>*.jws</url-pattern>     </servlet-mapping>     <servlet-mapping>        <servlet-name>AxisServlet</servlet-name>        <url-pattern>/services/*</url-pattern>     </servlet-mapping>     <servlet-mapping>        <servlet-name>AxisAdminServlet</servlet-name>        <url-pattern>/axis2-admin/*</url-pattern>     </servlet-mapping>

 

（2）创建service，用于发布

HelloWorldService.java

package com.service;   public class HelloWorldService {       public String sayHi(String helloName)     {        return "hi " + helloName;     } }

 

 

（3）.发布service

A、右键工程名newWebservice --NewàOther，选择Axis2 Service Archiver，

 

B、打包编译文件，指向编译好的service文件位置，一般都是XXX\WebRoot\WEB-INF\classes，选择E:\workspaces_8.5\ newWebservice \WebRoot\WEB-INF\classes目录，记得红色标记处的勾选取消掉

Ps:这里指定位置都是WEB-INF\classes目录，因为第D步填写的service包路径就是相对于此目录的

 

C、下一步略过wsdl文件选择，下一步选择依赖的的jar文件，没有可不用选择，下一步自动设置service.xml配置文件，

 

D、下一步，填写需要发布的webservice名称以及对外开放的服务类名称（自定义），服务类名称前面要带包名，（需要手动填写service路径，点击Load）

勾选Search declared method only，可以在下面的列表框中看见我们对外发布的方法名

 

E、下一步，将arr文件生成在newWebservice工程的WebRoot/WEB-INF/services ，E:\workspaces_8.5\newWebservice\WebRoot\WEB-INF\services；

 

F、启动tomcat，访问http://localhost:8080/newWebservice/services/HelloWordService?wsdl，得到wsdl文件。

至此发布完成。

 

第二部分  使用客户端测试webservice

（1）       根据wsdl生成客户端，有两种方式

方式一：使用myeclipse的axis2插件Axis2 Code Generator生成客户端

方式二：使用基本的命令行方式

Ps：本人使用方式一生成的代码不能够编译，提示有问题；因此采用方式二：

（3）方式二：制作《根据wsdl生成java代码.bat》

1.在D:\webservice_axis2中，已有axis2-1.6.2-bin，目标wsdl文件如Axis2Wsdl.wsdl

新建根据wsdl生成java代码.bat，内容如下：

set JAVA_HOME=D:\Program Files\Java\jdk1.6.0_10 set AXIS2_HOME=D:\webservice_axis2\axis2-1.6.2-bin\axis2-1.6.2   set Output_Path=Testclient   set Package=com.webservice.client   set Wsdl_File=D:\webservice_axis2\Axis2Wsdl.wsdl   %AXIS2_HOME%\bin\wsdl2java -uri %Wsdl_File% -p %Package% -s -o %Output_Path% ::一定要设置JAVA_HOME ::其中-url参数指定了wsdl文件的路径，可以是本地路径，也可以是网络路径。如 http://localhost:8080/axis2/services/SimpleService?wsdl ::-p参数指定了生成的Java类的包名 ::-o参数指定了生成的一系列文件保存的根目录 @echo  -------------OK-----------------   @echo ---The code has been created in the folder: Testclient---   @pause

绿色部分都是根据实际设置，执行批处理脚本生成的客户端代码会在Testclient中；

 

（2）       将Testclient中的src下的文件覆盖到项目Axis2Client的src下；新建测试代码

Test.java

package com.client.test;   import com.webservice.client.MyServiceStub; import com.webservice.client.MyServiceStub.AddStudent; import com.webservice.client.MyServiceStub.AddStudentResponse; import com.webservice.client.MyServiceStub.AddStudents; import com.webservice.client.MyServiceStub.AddStudentsResponse; import com.webservice.client.MyServiceStub.GetGreeting; import com.webservice.client.MyServiceStub.GetGreetingResponse; import com.webservice.client.MyServiceStub.QueryStudent; import com.webservice.client.MyServiceStub.QueryStudentResponse; import com.webservice.client.MyServiceStub.QueryStudents; import com.webservice.client.MyServiceStub.QueryStudentsResponse; import com.webservice.client.MyServiceStub.Student;   public class Test {          public static void main(String[] ss)          {                    // 设置远程服务调用地址        String target = "http://localhost:8080/newWebservice/services/HelloWordService";          try        {            // 根据地址构造用户存根            HelloWordServiceStub stub = new HelloWordServiceStub(target);              SayHi sayHi = new SayHi();            sayHi.setHelloName("servyou");            SayHiResponse ggr = stub.sayHi(sayHi);            // 接收方法返回值            String getResult = ggr.get_return();            System.out.println(getResult);                   } catch (Exception e)        {            e.printStackTrace();        }     }

 

第三部分 备注信息

备注：发布可以不生成arr文件，好处在于：经常改动代码或者添加安全控制模块如wss4j，因为经常改动 services.xml，所以这种情况最好不打包；否则最好打包发布

方法：

（1）    在/WEB-INF/services新建HelloWorldService（最好命名跟service命名一样，便于识别）；

（2）    在HelloWorldService新建META-INF目录，在META-INF中建立services.xml文件

<service name="HelloWordService">       <description>            Please Type your service description here       </description>       <messageReceivers>            <messageReceiver mep="http://www.w3.org/2004/08/wsdl/in-only" class="org.apache.axis2.rpc.receivers.RPCInOnlyMessageReceiver"/>            <messageReceiver  mep="http://www.w3.org/2004/08/wsdl/in-out"  class="org.apache.axis2.rpc.receivers.RPCMessageReceiver"/>       </messageReceivers>       <parameter name="ServiceClass">com.service.HelloWorldService</parameter> </service>

至此测试完毕

 

 

第四部分 补充

 

网上的实例基本都是将开发的service打包放到axis2中，但是在实际开发中，则不现实，不可能来回拷贝。而实际项目中存在两种可能性：A、新的web项目 B、已存在的web项目，如有需求：对外提供基于axis2的webservice，那么本实例就是演示这种情情况。

 ps：可以将《axis2开发实例（一）》例子合并开发复杂类型