eclipse开发webservice-axis2/spring+maven

水深无声 2022-07-13 05:21 196阅读 0赞

## 前言 ##

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

## 1、基础准备 ##

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

[http://download.csdn.net/detail/bestcxx/9721775][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][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/

![20161226215146332][]

点击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的开发环境 ##

![20161227091909954][]

点击preferences

![20161227092001142][]

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

eclipse中axis2的插件

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

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

![20161226220123164][]

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

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

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

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

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

接口类

package stu.demo.service;
    
    public interface Axis2TestImpl {
    	public String WriteStr(String str);
    }

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

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

![20161226223829479][]

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

![20161226224020292][]

一路点下去

![20161226224120013][]

继续点

![20161226224143652][]

还点

![20161226224217843][]

再点一下，得到

![20161226224343762][]

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

![20161226224629990][]

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

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

![20161226224742404][]

### 4.3 把服务发布到axis2.war中 ###

还记得tomcat中的那个项目吗

先停止tomcat服务器

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

（记得把axis2.war删除）

然后重启tomcat

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

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

![20161226225208140][]

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

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

发布的方法不再赘述

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

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

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

![20161226225743377][]

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

需要实体类

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;
    	}
    	
    	
    
    }

然后是包含发布方法的类

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

![20161226225940831][]

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

![20161226230207182][]

![20161226230246636][]

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

所以先获取webservice的wsdl地址

方法如下

![20161226230431388][]

如下

![20161226230524989][]

然后接着说eclipse的下一步

![20161226230638365][]

![20161226230712049][]

![20161226230750491][]

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

然后Finesh

得到客户端

![20161226230920867][]

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

![20161226231016647][]

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

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

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

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

实例化Stub  stub

实例化入参类型 入参

实例化返回类型 返回

返回=stub.方法（入参）

返回.getreturn()就是返回值

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][http_axis.apache.org_axis2_java_core_docs_spring.html]

然后就是实践了

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

<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

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

<bean id="springAwareService" class="com.bestcxx.mavenstu.mavenssh.axis2.Axis2Webservice" scope="prototype"/>

4、web.xml编写

<listener>
    		<description>Spring ApplicationContext 载入</description>
    		<listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
    	</listener>
    
    	<context-param>
    		<param-name>contextConfigLocation</param-name>
    		<param-value>classpath:spring/applicationContext.xml</param-value>
    	</context-param>
    
    
    	 <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

![20170215095705815][]

services.xml的内容为

<service name="SpringAwareService">
        <description>
            simple spring example
        </description>
        <parameter name="ServiceObjectSupplier">org.apache.axis2.extensions.spring.receivers.SpringServletContextObjectSupplier</parameter>
        <parameter name="SpringBeanName">springAwareService</parameter>
        <parameter name="getStrA">
        <messageReceiver class="org.apache.axis2.receivers.RawXMLINOutMessageReceiver"/>
        </parameter>
    </service>

6、这样之后，服务就已经可以正常启动和访问了

http://localhost:8085/mavenssh/services/SpringAwareService?wsdl

7、但是控制台提示

Please update your axis2.xml file!

只需把我们上面实验的axis2.war中的WEB\_INF/conf/下的axis2.xml复制到mavenssh(你的项目)下的WEB\_INF目录下即可  
  
里面有个用户名和密码，建议注释掉。

转载请声明出处：[http://blog.csdn.net/bestcxx/article/details/53889270][http_blog.csdn.net_bestcxx_article_details_53889270]

[http_download.csdn.net_detail_bestcxx_9721775]: http://download.csdn.net/detail/bestcxx/9721775
[http_download.csdn.net_detail_bestcxx_9721766]: http://download.csdn.net/detail/bestcxx/9721766
[20161226215146332]: /images/20220713/55c18070deae4322a6e58d6815373599.png
[20161227091909954]: /images/20220713/2d95856d5ab44ebcbbc66beed97f694b.png
[20161227092001142]: /images/20220713/45cdad103d9a4611bf457658a82ed4a0.png
[20161226220123164]: /images/20220713/0e60d23200c24c938ccb7eff8824e993.png
[20161226223829479]: /images/20220713/03e3dd7772fc4446999a7ff4a44d1a96.png
[20161226224020292]: /images/20220713/8d2a3b6f67cf4daa80b408f99148bbdc.png
[20161226224120013]: /images/20220713/582f2324161143dd83fccc8803743b16.png
[20161226224143652]: /images/20220713/36ae3b45e1d04194b4c5409fe960b509.png
[20161226224217843]: /images/20220713/db0b8895957244869def40782c958fd5.png
[20161226224343762]: /images/20220713/a08f952296044d1795750c38bd9ae462.png
[20161226224629990]: /images/20220713/2eaf962e56a343158235eb4e009c4df5.png
[20161226224742404]: /images/20220713/a5d8fc744ef3403490c1b83d27b71c7d.png
[20161226225208140]: /images/20220713/f79b07d79415484ca30e25d939f777e4.png
[20161226225743377]: /images/20220713/de879396336a4a4b983fc115f4a66464.png
[20161226225940831]: /images/20220713/c3c92cae35984f5e9fec89a56887f507.png
[20161226230207182]: /images/20220713/4c686a7f85ca4b3ab73d033d00f079a6.png
[20161226230246636]: /images/20220713/479ae9f560784fc4aef89e8903953279.png
[20161226230431388]: /images/20220713/a39d28df0e9a4491b79b1a05aaa71cee.png
[20161226230524989]: /images/20220713/ceac2a9d13844f8282216f0b4c0db7cb.png
[20161226230638365]: /images/20220713/1dc08117032f4b3c9f7262af50a717a7.png
[20161226230712049]: /images/20220713/da6f506a08424260bb4abb3f8f01496b.png
[20161226230750491]: /images/20220713/cec797118de9464dab38d7091ac0bb37.png
[20161226230920867]: /images/20220713/01158ac3074845c2995309e4a9090093.png
[20161226231016647]: /images/20220713/fd9cf4ea387e4a1daeeab5b1ee2fe450.png
[http_axis.apache.org_axis2_java_core_docs_spring.html]: http://axis.apache.org/axis2/java/core/docs/spring.html
[20170215095705815]: /images/20220713/4bcc78732d3e4072be453ae7e657cc70.png
[http_blog.csdn.net_bestcxx_article_details_53889270]: http://blog.csdn.net/bestcxx/article/details/53889270