eclipse开发webservice-axis2/spring+maven

最新推荐文章于 2021-09-02 11:47:03 发布

hxpjava1

最新推荐文章于 2021-09-02 11:47:03 发布

阅读量638

点赞数

分类专栏： web service

web service 专栏收录该内容

10 篇文章

订阅专栏

前言

本文将讲述使用eclipse发布axis2服务的环境准备到发布过程。

1、基础准备

eclipse需要两个插件（eclipse_axis2-插件-直接解压到dropins）

http://download.csdn.net/detail/bestcxx/9721775

然后是axis2的war包和bin包，前者我们可以直接看到axis2服务启动的样子，并且把我们的webservice服务直接添加到这个axis2项目中，后面的bin包则直接为eclipse开发

axis2提供了环境支持。

axis2的war和bin下载（当然你也可以从apache的官网下载较新版本）

下载地址

http://download.csdn.net/detail/bestcxx/9721766

你本地需要有可以启动的服务器，我这里是tomcat

2、解压axis2-1.7.4-war.zip和axis2-1.7.4-bin.zip

得到axis2.war和axis2-1.7.4

对于axis2.war的处理

放到tomcat服务器webapps下启动

访问 http://localhost:8080/axis2/

点击Administration ,右面有个username和password，这是axis2提供的demo的管理员登陆页，默认是 admin/axis2

如果是生产环境一定记得修改，位置为axis2\WEB-INF\conf\axis2.xml

点击Services，就可以看到axis2自带的webservice服务了

对于axis2-1.7.4的处理

把axis2-1.7.4复制到某一个位置，比如你的D盘然后需要在3中设置了

3、在eclipse中配置axis2的开发环境

点击preferences

然后如上图设置axis2的bin路径，里面的一些jar包等会为eclipse提供支持

eclipse中axis2的插件

eclipse的两个axis2的插件解压到eclipse/dropins，然后重启eclipse

这样，你的eclipse中就可以看到这两个东西了，一个用于将java方法生成为服务端，一个则用于生成客户端

4、下面将写个简单的例子

这个例子包含两个部分，一是服务的发布，二是服务的访问

服务的发布包含简单方法的发布和复杂方法的发布

服务的访问包含axis2客户端访问和axis2的RPC访问

4.1 方法1-接口和接口的实现

接口类

 
   [java]  
   view plain 
    copy 
    
  
 package stu.demo.service;  
   
 public interface Axis2TestImpl {  
     public String WriteStr(String str);  
 }  

实现类，也是具体服务的发布类

 
   [java]  
   view plain 
    copy 
    
  
 package stu.demo.service;  
   
 public class AxisTestService implements Axis2TestImpl {  
       
     public String WriteStr(String str){  
         System.out.println("您输入的是："+str);  
         return str;  
     }  
   
 }  

4.2 使用axis2的插件AxisTestService输出为webservice服务

注意红色方框圈中的区域，new来自于eclipse左上角的File

选择服务所在项目的classes文件夹

一路点下去

继续点

还点

再点一下，得到

Service name就是webservice的名字，Class name是方法所在类的路径，然后按下Load，下面会显示Method name，点next

那个location是文件输出路径，你自定义的，下面File name是输出文件的名字(我这个文是后面写的，所以名字和下面的配图不一样)

然后在你设置的位置得到下面的文件(axis2test_service.aar)

4.3 把服务发布到axis2.war中

还记得tomcat中的那个项目吗

先停止tomcat服务器

把axis2test_service.aar复制到axis2这个项目的axis2\WEB-INF\services\下

（记得把axis2.war删除）

然后重启tomcat

这样你就已经把你刚写的服务发布到这个axis2中去了

访问http://localhost:8080/axis2/services/listServices

4.4 编写并发布另外两个服务

刚才发布的是一个以接口实现类形式展现的类，返回的是String类型，下面将发布不实现任何接口的类，以及返回为实体类型的方法

发布的方法不再赘述

不实现接口的类发布为webservice服务

 
   [java]  
   view plain 
    copy 
    
  
 package stu.demo.noimpl;  
   
 public class Axis2NoImpl {  
       
     public String  WriteYourName(String name){  
         System.out.println("你输入的名字为:"+name);  
         return name;  
     }  
   
 }  

eclipse产生的对应的aar文件为 axis2noImpl.aar

返回类型为实体类的发布为webservice服务

需要实体类

 
   [java]  
   view plain 
    copy 
    
  
 package stu.demo.fz;  
   
 public class ModelUser {  
       
     private String userName;  
     private String userPwd;  
     public String getUserName() {  
         return userName;  
     }  
     public void setUserName(String userName) {  
         this.userName = userName;  
     }  
     public String getUserPwd() {  
         return userPwd;  
     }  
     public void setUserPwd(String userPwd) {  
         this.userPwd = userPwd;  
     }  
       
       
   
 }  

然后是包含发布方法的类

 
   [java]  
   view plain 
    copy 
    
  
 package stu.demo.fz;  
   
 public class Axis2Fz {  
     public ModelUser WriteModelUser(ModelUser modelUser){  
         System.out.println("你输入的用户名为："+modelUser.getUserName());  
         System.out.println("你输入的密码为："+modelUser.getUserPwd());  
         return modelUser;  
     }  
 }  

eclipse产生的对应的aar文件为 axis2Fz.aar

4.5 axis2插件生成客户端访问webservice

这里涉及到要为哪一个webservice设置客户端

所以先获取webservice的wsdl地址

方法如下

如下

然后接着说eclipse的下一步

选择输出到向项目，然后直接选择一个项目的路径（到项目名字即可）

然后Finesh

得到客户端

当然，如果你为复杂的返回类型那个生成客户端，则会有一个实体类文件生成

4.5 axis2的客户端调用和RPC调用

这里不赘述了了，直接把客户端的调用方法和PRC的调用方法贴出来

需要注意的是，如果只是PRC调用的话，对于返回参数为某个实体类的话，需手动创建实体类文件

需要强调的是，对于客户端调用，其方法名字是和你调用的服务的类的名字息息相关的，但是大体思路是

实例化Stub stub

实例化入参类型入参

实例化返回类型返回

返回=stub.方法（入参）

返回.getreturn()就是返回值

 
   [java]  
   view plain 
    copy 
    
  
 package stu.demo.test;  
   
 import java.rmi.RemoteException;  
   
 import javax.xml.namespace.QName;  
   
 import junit.framework.TestCase;  
   
 import org.apache.axis2.AxisFault;  
 import org.apache.axis2.addressing.EndpointReference;  
 import org.apache.axis2.client.Options;  
 import org.apache.axis2.rpc.client.RPCServiceClient;  
 import org.junit.Test;  
   
 import stu.demo.fz.xsd.ModelUser;  
 import stu.demo.noimpl.Axis2NoImplStub;  
 import stu.demo.noimpl.WriteYourName;  
 import stu.demo.noimpl.WriteYourNameResponse;  
   
 public class Axis2ClientNoImpl {  
     /** 
      * 使用axis2客户端调用 
      */  
     @Test  
     public void testAxis2NoImpl(){  
         try {  
             String name="Jecket";  
 //          Axis2NoImplStub Axis2NoImpl =new  Axis2NoImplStub();//这个方法访问地址被封装到了客户端代码  
             Axis2NoImplStub Axis2NoImpl =new  Axis2NoImplStub("http://localhost:8080/axis2/services/Axis2NoImpl.Axis2NoImplHttpSoap12Endpoint/");//如果生产地址和测试不一致，则需要指定，灵活运用  
               
             WriteYourName writeYourName=new WriteYourName ();  
             writeYourName.setName(name);  
               
             WriteYourNameResponse writeYourNameResponse=new WriteYourNameResponse();  
               
             writeYourNameResponse=Axis2NoImpl.writeYourName(writeYourName);  
               
             TestCase.assertFalse("方法返回的名字和你输入的名字不一致", writeYourNameResponse.get_return()==name);  
         } catch (AxisFault e) {  
             // TODO Auto-generated catch block  
             e.printStackTrace();  
         } catch (RemoteException e) {  
             // TODO Auto-generated catch block  
             e.printStackTrace();  
         }  
     }  
       
     /** 
      * 使用axis2的RPC调用 
      */  
     @Test  
     public void testAxis2NoImpl2(){  
           String result = "";  
           try {  
   
            String serviceUrl = "http://localhost:8080/axis2/services/Axis2NoImpl?wsdl";  
            //使用RPC方式调用WebService  
            RPCServiceClient serviceClient = new RPCServiceClient();  
            Options options = serviceClient.getOptions();  
            //设置2秒超时  
            options.setTimeOutInMilliSeconds(2000L);  
            //指定调用WebService的URL  
            EndpointReference targetEPR = new EndpointReference(serviceUrl);  
            options.setTo(targetEPR);  
              
            //指定接口方法的参数值  
            Object[] opAddEntryArgs = new Object[] {"Jecket"};  
            //指定方法返回值的数据类型的Class对象  
            Class[] classes = new Class[] { String.class };  
            //指定调用的方法及WSDL文件的命名空间  QName("targetNamespace","method Name");  
            QName qName = new QName("http://noimpl.demo.stu","WriteYourName");  
            //调用getVersioin方法并输出该方法的返回值,  
            //返回对象是一个Object的数组,拿数组的第一个值，转换强转即可  
            result = serviceClient.invokeBlocking(qName,opAddEntryArgs, classes)[0].toString();  
           } catch (Exception e) {  
            e.printStackTrace();  
            result = e.getMessage();  
              
             
           }  
           System.out.println("返回值result="+result);  
     }  
       
     /** 
      * 使用axis2的RPC调用 
      * 入参和反参都是复杂类型 
      */  
     @Test  
     public void testAxis2Fz(){  
           String result = "";  
           try {  
   
            String serviceUrl = "http://localhost:8080/axis2/services/Axis2Fz?wsdl";  
            //使用RPC方式调用WebService  
            RPCServiceClient serviceClient = new RPCServiceClient();  
            Options options = serviceClient.getOptions();  
            //设置2秒超时  
            options.setTimeOutInMilliSeconds(2000L);  
            //指定调用WebService的URL  
            EndpointReference targetEPR = new EndpointReference(serviceUrl);  
            options.setTo(targetEPR);  
              
            //指定接口方法的参数值  
            ModelUser modelUser=new ModelUser();  
            modelUser.setUserName("Jecket");  
            modelUser.setUserPwd("123456");  
            Object[] opAddEntryArgs = new Object[] {modelUser};  
            //指定方法返回值的数据类型的Class对象  
            Class[] classes = new Class[] { ModelUser.class };  
            //指定调用的方法及WSDL文件的命名空间  QName("targetNamespace","method Name");  
            QName qName = new QName("http://fz.demo.stu","WriteModelUser");  
            //调用getVersioin方法并输出该方法的返回值,  
            //返回对象是一个Object的数组,拿数组的第一个值，转换强转即可  
            modelUser = (ModelUser) serviceClient.invokeBlocking(qName,opAddEntryArgs, classes)[0];  
            
            System.out.println("name:"+modelUser.getUserName());  
            System.out.println("password:"+modelUser.getUserPwd());  
           } catch (Exception e) {  
            e.printStackTrace();  
            result = e.getMessage();  
              
             
           }  
            
     }  
       
       
   
 }  

4.6 axis2的webservice服务添加到自己的项目中发布结合spring+maven

首先建议阅读官方文档http://axis.apache.org/axis2/java/core/docs/spring.html

然后就是实践了

1、maven的pom.xml中关于axis2的配置

 
   [html]  
   view plain 
    copy 
    
  
 <dependency>  
             <groupId>org.apache.axis2</groupId>  
             <artifactId>axis2-transport-http</artifactId>  
             <version>1.7.2</version>  
         </dependency>  
         <dependency>  
             <groupId>org.apache.axis2</groupId>  
             <artifactId>axis2-spring</artifactId>  
             <version>1.7.2</version>  
         </dependency>  
         <dependency>  
             <groupId>org.apache.axis2</groupId>  
             <artifactId>axis2</artifactId>  
             <version>1.6.2</version>  
         </dependency>  
         <dependency>  
             <groupId>org.apache.axis2</groupId>  
             <artifactId>axis2-transport-local</artifactId>  
             <version>1.7.2</version>  
         </dependency>  
         <dependency>  
             <groupId>org.apache.axis2</groupId>  
             <artifactId>axis2-kernel</artifactId>  
             <version>1.6.2</version>  
         </dependency>  

2、编写axis2的对外提供服务的类以及方法（我这里不写接口了，熟悉spring的应该知道最好使用接口以及接口的实现）

我的项目名称是 mavenssh，包路径为com.bestcxx.mavenstu.mavenssh.axis2，类名为Axis2Webservice，方法只有一个叫getStrA

 
   [java]  
   view plain 
    copy 
    
  
 package com.bestcxx.mavenstu.mavenssh.axis2;  
   
 public class Axis2Webservice {  
       
     public String getStrA(){  
         String str="123";  
         System.out.println("你输入的是："+str);  
         return str;  
     }  
   
 }  

3、spring的applicationContext.xml中将Axis2Webservice注册为bean

 
   [html]  
   view plain 
    copy 
    
  
 <!--如果没有ServletContext配置 则需要增加下面这句 -->  
     <!--<bean id="applicationContext"   
     class="org.apache.axis2.extensions.spring.receivers.ApplicationContextHolder" /> -->  
   
     <bean id="springAwareService" class="com.bestcxx.mavenstu.mavenssh.axis2.Axis2Webservice" scope="prototype"/>  

4、web.xml编写

 
   [html]  
   view plain 
    copy 
    
  
 <listener>  
         <description>Spring ApplicationContext 载入</description>  
         <listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>  
     </listener>  
 <!-- Spring ApplicationContext配置文件的路径,可使用通配符,多个路径用,号分隔 此参数用于后面的Spring Context   
         Loader -->  
     <context-param>  
         <param-name>contextConfigLocation</param-name>  
         <param-value>classpath:spring/applicationContext.xml</param-value>  
     </context-param>  
   
 <!-- axis2设置 -->  
      <servlet>    
         <servlet-name>AxisServlet</servlet-name>      
         <servlet-class>org.apache.axis2.transport.http.AxisServlet</servlet-class>    
     </servlet>   
   
     <servlet-mapping>  
         <servlet-name>AxisServlet</servlet-name>  
         <url-pattern>/services/*</url-pattern>  
     </servlet-mapping>  

5、最后是services.xml的编写，这里需要注意路径

比如这里我的项目名称为mavenssh

就需要把services.xml放置到项目的如下路径中

-webapp

-WEB-INF

-services

-mavenssh

-META-INF

-services.xml

services.xml的内容为

 
   [html]  
   view plain 
    copy 
    
  
 <service name="SpringAwareService"><!-- 访问的时候，这个是wsdl服务的名字 -->  
     <description>  
         simple spring example  
     </description>  
     <parameter name="ServiceObjectSupplier">org.apache.axis2.extensions.spring.receivers.SpringServletContextObjectSupplier</parameter>  
     <parameter name="SpringBeanName">springAwareService</parameter><!-- 这个是spring中配置的bean名字 -->  
     <parameter name="getStrA"><!-- 这个是对外提供的服务的具体方法名 -->  
    <span style="white-space:pre">   </span> <messageReceiver class="org.apache.axis2.receivers.RawXMLINOutMessageReceiver"/>  
     </parameter>  
 </service>   