java wsdl 客户端 java实现webservice客户端

转载

mob6454cc67e023 2023-10-16 11:26:42

文章标签 java wsdl 客户端 apache xml java 文章分类 Java 后端开发

简介

WebService是一种服务的提供方式，通过WebService，不同应用间相互间调用变的很方便，网络上有很多常用的WebService服务，如：http://developer.51cto.com/art/200908/147125.htm，不同的语言平台对WebService都有实现，Java的WebService实现，比较流行的有Axis2、Jaxws，本文介绍的是Axis2。

Axis2下载和部署

Axis2是Apache开发的一个开源项目，再次感叹Apache的伟大！

下载地址：

http://mirror.bit.edu.cn/apache//axis/axis2/java/core/1.6.2/axis2-1.6.2-war.zip

将其内axis2.war解压到<Tomcat安装目录>/webapps下，启动Tomcat，war包会自动解压，

访问http://localhost:8080/axis2/，如果看到欢迎主页，则说明部署成功。

配置Axis2

<Tomcat安装目录>/webapps/axis2/WEB-INF/conf/axis2.xml，配置其内两个属性，以便调试。

[html] view plain copy print ?

1. <parameter name="hotdeployment">true</parameter><!-- 开启热部署，不需要重启即可部署服务 -->
2. <parameter name="hotupdate">true</parameter><!-- 开启热更新，不需要重启即可更新服务 -->

<parameter name="hotdeployment">true</parameter><!-- 开启热部署，不需要重启即可部署服务 -->
<parameter name="hotupdate">true</parameter><!-- 开启热更新，不需要重启即可更新服务 -->

编写服务

所谓服务就是编写一个类，写一些方法，方法返回数据，WebService客户端获取数据。

[java] view plain copy print ?

1. public class
2.   
3. public
4. return "hello";  
5.     }  
6.       
7. }

public class HelloService {

	public String sayHello() {
		return "hello";
	}
	
}

0配置POJO发布服务

服务类创建好后，我们需要发布到服务器上，将HelloService.class放到<Tomcat安装目录>/webapps/axis2/WEB-INF/pojo下，pojo没有需要创建。

至此，我们已经成功的创建了一个WebService服务了，so easy！

再次访问http://localhost:8080/axis2/，点击Services，可以发现可用services中多了一个HelloService，其内有一个可用操作sayHello，说明发布成功。

[java] view plain copy print ?

1. HelloService  
2.   
3. Service Description : No description available  for this
4.   
5. Service EPR : http://localhost:8080/axis2/services/HelloService
6.   
7. Service Status : Active  
8.   
9.   
10. Available Operations  
11. sayHello

HelloService

Service Description : No description available for this service

Service EPR : http://localhost:8080/axis2/services/HelloService

Service Status : Active


Available Operations
sayHello

访问

http://localhost:8080/axis2/services/HelloService，页面输出正是我们的返回值。

[html] view plain copy print ?

1. <ns:sayHelloResponse xmlns:ns="http://ws.apache.org/axis2">
2. <return>hello</return>
3. </ns:sayHelloResponse>

<ns:sayHelloResponse xmlns:ns="http://ws.apache.org/axis2">
<return>hello</return>
</ns:sayHelloResponse>

这里有两点需要注意：

- POJO发布的类不能放在包里，既不能使用package关键字；

- 默认的发布目录是pojo，可以在<Tomcat安装目录>/webapps/axis2/WEB-INF/conf/axis2.xml中增加目录，

[html] view plain copy print ?

1. <deployer extension=".class" directory="<要增加的目录名称>" class="org.apache.axis2.deployment.POJODeployer" />

<deployer extension=".class" directory="<要增加的目录名称>" class="org.apache.axis2.deployment.POJODeployer" />

要注意多个目录见WebService要唯一，否则会重名，重名后，先部署的会成功，后部署的会报错。

services.xml配置文件发布服务

虽然POJO的方式不需要配置文件，但是其服务类不能放在包内，显然是不符合我们日常开发的，Axis2也允许带包的类发布WebService，如果不允许，估计就没人用了。

首先写一个较复杂的服务类，多个方法，带参数，有返回值的。

[java] view plain copy print ?

package webservice.test;

/**
 * 计算器运算
 * 
 * @author gaoshuang
 */
public class CalculateService {

	// 加法
	public float plus(float x, float y) {
		return x + y;
	}

	// 减法
	public float minus(float x, float y) {
		return x - y;
	}

	// 乘法
	public float multiply(float x, float y) {
		return x * y;
	}

	// 除法
	public float divide(float x, float y) {
		if (y != 0)
			return x / y;
		else
			return -1;
	}
}

package webservice.test;

/**
 * 计算器运算
 * 
 * @author gaoshuang
 */
public class CalculateService {

	// 加法
	public float plus(float x, float y) {
		return x + y;
	}

	// 减法
	public float minus(float x, float y) {
		return x - y;
	}

	// 乘法
	public float multiply(float x, float y) {
		return x * y;
	}

	// 除法
	public float divide(float x, float y) {
		if (y != 0)
			return x / y;
		else
			return -1;
	}
}

1. package
2.   
3. /**
4. * 计算器运算
5. * 
6. * @author gaoshuang
7. */
8. public class
9.   
10. // 加法
11. public float plus(float x, float
12. return
13.     }  
14.   
15. // 减法
16. public float minus(float x, float
17. return
18.     }  
19.   
20. // 乘法
21. public float multiply(float x, float
22. return
23.     }  
24.   
25. // 除法
26. public float divide(float x, float
27. if (y !=  0)  
28. return
29. else
30. return -1;  
31.     }

然后编写services.xml，该文件需要放在META-INF文件夹下。

[html] view plain copy print ?

1. <?xml version="1.0" encoding="UTF-8"?>
2. <!-- 服务名称 -->
3. <service name="CalculateService">
4. <!-- 服务描述 -->
5. <description>
6.         加减乘除计算服务  
7. </description>
8. <!-- 设置服务类 -->
9. <parameter name="ServiceClass">
10.         com.runqianapp.webservice.test.CalculateService  
11. </parameter>
12. <!-- 方法 -->
13. <operation name="plus">
14.         <!-- 方法处理器，RPCMessageReceiver为带返回值的处理器，  
15. >
16. <messageReceiver mep="http://www.w3.org/2004/08/wsdl/in-out"
17. class="org.apache.axis2.rpc.receivers.RPCMessageReceiver" />
18. </operation>
19. <operation name="minus">
20. <messageReceiver mep="http://www.w3.org/2004/08/wsdl/in-out"
21. class="org.apache.axis2.rpc.receivers.RPCMessageReceiver" />
22. </operation>
23. <operation name="multiply">
24. <messageReceiver mep="http://www.w3.org/2004/08/wsdl/in-out"
25. class="org.apache.axis2.rpc.receivers.RPCMessageReceiver" />
26. </operation>
27. <operation name="divide">
28. <messageReceiver mep="http://www.w3.org/2004/08/wsdl/in-out"
29. class="org.apache.axis2.rpc.receivers.RPCMessageReceiver" />
30. </operation>
31. </service>

<?xml version="1.0" encoding="UTF-8"?>
<!-- 服务名称 -->
<service name="CalculateService">
	<!-- 服务描述 -->
    <description>
		加减乘除计算服务
    </description>
    <!-- 设置服务类 -->
    <parameter name="ServiceClass">
        com.runqianapp.webservice.test.CalculateService
    </parameter>
    <!-- 方法 -->
    <operation name="plus">
    	<!-- 方法处理器，RPCMessageReceiver为带返回值的处理器，
    	             RPCInOnlyMessageReceiver为不带返回值的处理器 -->
    	<messageReceiver mep="http://www.w3.org/2004/08/wsdl/in-out"
            class="org.apache.axis2.rpc.receivers.RPCMessageReceiver" />
    </operation>
    <operation name="minus">
    	<messageReceiver mep="http://www.w3.org/2004/08/wsdl/in-out"
            class="org.apache.axis2.rpc.receivers.RPCMessageReceiver" />
    </operation>
    <operation name="multiply">
    	<messageReceiver mep="http://www.w3.org/2004/08/wsdl/in-out"
            class="org.apache.axis2.rpc.receivers.RPCMessageReceiver" />
    </operation>
    <operation name="divide">
    	<messageReceiver mep="http://www.w3.org/2004/08/wsdl/in-out"
            class="org.apache.axis2.rpc.receivers.RPCMessageReceiver" />
    </operation>
</service>

最后将这两个文件打成jar包，不论用工具还是手动打，打的都是最外层的文件夹。

java wsdl 客户端 java实现webservice客户端_java wsdl 客户端

我打的名字是server.jar，更改后缀为aar，所以最后是server.aar，Axis2建议使用aar发布WebService，

将server.aar放到<Tomcat安装目录>/webapps/axis2/WEB-INF/services下，访问http://localhost:8080/axis2/services/listServices，

多出了一个CalculateService，说明发布成功。

[java] view plain copy print ?

1. CalculateService  
2.   
3. Service Description : CalculateService  
4.   
5. Service EPR : http://localhost:8080/axis2/services/CalculateService
6.   
7. Service Status : Active  
8.   
9.   
10. Available Operations  
11. divide  
12. plus  
13. minus  
14. multiply

CalculateService

Service Description : CalculateService

Service EPR : http://localhost:8080/axis2/services/CalculateService

Service Status : Active


Available Operations
divide
plus
minus
multiply

分别访问

http://localhost:8080/axis2/services/CalculateService/plus?x=1&y=2

http://localhost:8080/axis2/services/CalculateService/divide?x=1&y=2

http://localhost:8080/axis2/services/CalculateService/minus?x=1&y=2

http://localhost:8080/axis2/services/CalculateService/multiply?x=1&y=2 也可以发布多个WebService，可以使用serviceGroup标签。

[html] view plain copy print ?

1. <serviceGroup>
2. <service  name="myService1">
3.     ...  
4. </service>
5. <service name="myService2">
6.     ...  
7. </service>
8. </serviceGroup>

<serviceGroup>
<service name="myService1">
	...
</service>
<service name="myService2">
	...
</service>
</serviceGroup>

客户端实现

以上介绍的都是WebService服务创建及发布，那么有了一个WebService服务后，我们如何调用呢？只在浏览器上访问是没有意义的。

下载Axis2客户端压缩包：http://mirror.esocc.com/apache//axis/axis2/java/core/1.6.2/axis2-1.6.2-bin.zip，并解压。

新建工程WebServiceClientTest，将<Axis2客户端安装目录>/lib下所有jar包添加到工程中；

编写客户端代码；

[java] view plain copy print ?

1. package
2.   
3. import
4.   
5. import
6. import
7. import
8. import
9.   
10. public class
11.   
12. /**
13.      * @param args
14.      * @throws AxisFault
15.      */
16. public static void main(String[] args) throws
17. // 使用RPC方式调用WebService
18. new
19.         Options options = serviceClient.getOptions();   
20. // 指定调用WebService的URL
21.  new
22. "http://localhost:8080/axis2/services/CalculateService");  
23.         options.setTo(targetEPR);  
24. // 调用方法的参数值
25. new Object[] {1, 2};  
26. // 调用方法返回值的数据类型的Class对象
27. new Class[] { float.class
28. // 调用方法名及WSDL文件的命名空间
29. // 命名空间是http://localhost:8080/axis2/services/CalculateService?wsdl中wsdl:definitions标签targetNamespace属性
30. new QName("http://test.webservice", "plus");  
31. // 执行方法获取返回值
32. // 没有返回值的方法使用serviceClient.invokeRobust(opName, entryArgs)
33. 0];  
34.         System.out.println(result);  
35. // out: 3.0
36.     }  
37.   
38. }

package webservice.client.test;

import javax.xml.namespace.QName;

import org.apache.axis2.AxisFault;
import org.apache.axis2.addressing.EndpointReference;
import org.apache.axis2.client.Options;
import org.apache.axis2.rpc.client.RPCServiceClient;

public class Client1 {

	/**
	 * @param args
	 * @throws AxisFault
	 */
	public static void main(String[] args) throws AxisFault {
		// 使用RPC方式调用WebService
		RPCServiceClient serviceClient = new RPCServiceClient();
		Options options = serviceClient.getOptions();
		// 指定调用WebService的URL
		EndpointReference targetEPR = new EndpointReference(
				"http://localhost:8080/axis2/services/CalculateService");
		options.setTo(targetEPR);
		// 调用方法的参数值
		Object[] entryArgs = new Object[] {1, 2};
		// 调用方法返回值的数据类型的Class对象
		Class[] classes = new Class[] { float.class };
		// 调用方法名及WSDL文件的命名空间
		// 命名空间是http://localhost:8080/axis2/services/CalculateService?wsdl中wsdl:definitions标签targetNamespace属性
		QName opName = new QName("http://test.webservice", "plus");
		// 执行方法获取返回值
		// 没有返回值的方法使用serviceClient.invokeRobust(opName, entryArgs)
		Object result = serviceClient.invokeBlocking(opName, entryArgs, classes)[0];
		System.out.println(result);
		// out: 3.0
	}

}

以上是实现了一个简单的WebSerivce客户端，调用CalculateService中的plus方法，由代码可见，这种调用方式比较杂乱，代码不太友好。

wsdl2java简化客户端

<Axis2客户端安装目录>/bin目录，其内有两个bat，wsdl2java.bat和java2wsdl.bat，可以实现WSDL文件和Java之间的互相转换。

考虑到我们以后可能经常使用这些命令，设置环境变量，方便以后调用。在系统变量中加入AXIS2_HOME=<Axis2客户端安装目录>，path中追加;%AXIS2_HOME%\bin。

启动命令提示符，进入WebServiceTestClient所在目录，运行

[plain] view plain copy print ?

1. wsdl2java -uri http://localhost:8080/axis2/services/CalculateService?wsdl -p webservice.client.test -s

wsdl2java -uri http://localhost:8080/axis2/services/CalculateService?wsdl -p webservice.client.test -s

参数说明：uri - wsdl文件路径，网络路径或本地路径，p - 打包，这里和上一个客户端实现类打在了一个包里，wsdl2java有很多参数，详细可以运行该命令去查看。

执行后，如果没有报错，说明运行成功，刷新项目，该包下多出了一个CalculateServiceStub类，里面的代码极其复杂，还乱呼呼的，这我们不用管，调用该类。

[java] 
    view plain 
   copy 
   print 
   ? 
    
    
  
 
 
1. package
2.   
3. import
4.   
5. import
6.   
7. public class
8.   
9. /**
10.      * @param args
11.      * @throws RemoteException 
12.      */
13. public static void main(String[] args) throws
14. new
15. new
16. 1);  
17. 2);   
18. float result = stub.plus(plus).get_return();// 返回值自动转型，这也是强大之处
19.         System.out.println(result);  
20.     }  
21.   
22. }

package webservice.client.test;

import java.rmi.RemoteException;

import webservice.client.test.CalculateServiceStub.Plus;

public class Client2 {

	/**
	 * @param args
	 * @throws RemoteException 
	 */
	public static void main(String[] args) throws RemoteException {
		CalculateServiceStub stub = new CalculateServiceStub();
		Plus plus = new Plus();
		plus.setX(1);
		plus.setY(2);
		float result = stub.plus(plus).get_return();// 返回值自动转型，这也是强大之处
		System.out.println(result);
	}

}

如此做的好处就是调用时不需要在去查看WSDL，和正常使用一个类一样，对WebService的封装都由wsdl2java自动生成，代码更优雅、简洁。

利用wsdl2java轻松使用第三方WebService服务

有了wsdl2java，已知一个WSDL文件我们就可以轻松的生成WebService客户端供我们调用，给我们服务。文章开头给出的链接包含了一些第三方服务，有一个服务是生成随机个数中文，WSDL：http://www.webxml.com.cn/WebServices/RandomFontsWebService.asmx?wsdl，同样，启动命令提示符，进入项目路径，执行

[plain] view plain copy print ?

1. wsdl2java -uri http://www.webxml.com.cn/WebServices/RandomFontsWebService.asmx?wsdl -p webservice.client.test -s

wsdl2java -uri http://www.webxml.com.cn/WebServices/RandomFontsWebService.asmx?wsdl -p webservice.client.test -s

调用该类

[java] view plain copy print ?

1. package
2.   
3. import
4.   
5. import
6. import
7.   
8. public class
9.   
10. /**
11.      * @param args
12.      * @throws RemoteException 
13.      */
14. public static void main(String[] args) throws
15.  new
16. new
17. 10);// 免费使用有限制，最多8个
18.         ArrayOfString result = stub.getChineseFonts(getChineseFonts).getGetChineseFontsResult();  
19. for(String str : result.getString()) {  
20.             System.out.println(str);  
21.         }  
22.     }  
23.   
24. }

package webservice.client.test;

import java.rmi.RemoteException;

import webservice.client.test.RandomFontsWebServiceStub.ArrayOfString;
import webservice.client.test.RandomFontsWebServiceStub.GetChineseFonts;

public class ThirdClient {

	/**
	 * @param args
	 * @throws RemoteException 
	 */
	public static void main(String[] args) throws RemoteException {
		RandomFontsWebServiceStub stub = new RandomFontsWebServiceStub();
		GetChineseFonts getChineseFonts = new GetChineseFonts();
		getChineseFonts.setByFontsLength(10);// 免费使用有限制，最多8个
		ArrayOfString result = stub.getChineseFonts(getChineseFonts).getGetChineseFontsResult();
		for(String str : result.getString()) {
			System.out.println(str);
		}
	}

}

本文章为转载内容，我们尊重原作者对文章享有的著作权。如有内容错误或侵权问题，欢迎原作者联系我们进行内容更正或删除文章。