webservices系列(四)——Axis2入门框架

一.Axis2下载

1.从http://axis.apache.org/axis2/java/core/download.html下载Axis2最新版本:

可以下载如下两个zip包:
axis2-1.7.4-bin.zip

axis2-1.7.4-war.zip

其中axis2-1.7.4-bin.zip是所有的jar包文件

axis2-1.7.4-war.zip文件用于将webservice发布到web容器中

将axis2-1.7.4-war.zip解压得到相应的目录,在目录中的axis2.war放在tomcat的webapps目录下。

启动tomcat,在浏览器地址栏中输入:http://localhost:8080/axis2/,如看到axis2的主页面则安装成功。


二、编写web service
(1).用POJO形式发布(无需配置)
在Axis2中无需配置,就可以将一个pojo发布到webservice上
pojo中所有public方法都被发布成webservice方法
示例代码如下:

public class HelloService
{
	public String queryName(String name) {
		System.out.println("webservice--> queryName:" + name);
		return "hello " + name;
	}
	
	public String queryName(String name, String title) {
		System.out.println("webservice--> queryTile:" + name);
		return "hello " + name + ",title is " + title;
	}
}

类中不可含有包名
编译此HelloService类后,将HelloService.class放到tomcat的webapps\axis2\WEB-INF\pojo目录下,没有pojo目录就创建pojo目录。现在我们已经成功将HelloService类发布成webservice。
在浏览器中输入:http://localhost:8080/axis2/services/listServices可以看到发布的HelloService。
HelloService下可以看到queryName、queryName两个方法。
在浏览器中输入:http://localhost:8080/axis2/services/HelloService?wsdl。可以看到HelloService这个服务的详细信息
webservices系列(四)——Axis2入门框架

可以看到,queryTitle的参数是args0、args1,queryName的参数是args0,这里有一点要注意的,在代码中我们设置的参数是name、title,而现在我们要传入的参数是args0、args1,为什么会出现这种情况,我也说不清楚。

webservices系列(四)——Axis2入门框架

在浏览器中输入:http://localhost:8080/axis2/services/HelloService/queryName?args0=bill验证,
页面显示如下结果:

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

在编写、发布和测试WebService应注意以下几点:
1.POJO类不能使用package关键字声明包。
2.传入参数注意看wsdl中的参数,而不是代码写得参数名。
3.Axis2在默认情况下可以热发布WebService,也就是说,将WebService的.class文件复制到pojo目录中时,Tomcat不需要重新启动就可以自动发布WebService。如果想取消Axis2的热发布功能,可以打开<Tomcat安装目录>\webapps\axis2\WEB-INF\conf\axis2.xml,找到如下的配置代码:

<parameter name="hotdeployment">true</parameter>

将true改为false即可。要注意的是,Axis2在默认情况下虽然是热发布,但并不是热更新,也就是说,一旦成功发布了WebService,再想更新该WebService,就必须重启Tomcat。这对于开发人员调试WebService非常不方便,因此,在开发WebService时,可以将Axis2设为热更新。在axis2.xml文件中找到

<parameter name="hotupdate">false</parameter>

,将false改为true即可。

    4. 在浏览器中测试WebService时,如果WebService方法有参数,需要使用URL的请求参数来指定该WebService方法参数的值,请求参数名与方法参数名要一致,例如,要测试getGreeting方法,请求参数名应为name,如上面的URL所示。
    5. 发布WebService的pojo目录只是默认的,如果读者想在其他的目录发布WebService,可以打开axis2.xml文件,并在<axisconfig>元素中添加如下的子元素:

<deployer extension=".class" directory="my" class="org.apache.axis2.deployment.POJODeployer"/>

上面的配置允许在<Tomcat安装目录>\webapps\axis2\WEB-INF\my目录中发布WebService。例如,将本例中的SimpleService.class复制到my目录中也可以成功发布(但要删除pojo目录中的SimpleService.class,否则WebService会重名)
(2)使用service.xml配置文件发布


(3)用wsimport编写client端代码
在cmd中使用
wsimport -p com.lc.client -keep http://localhost:8080/axis2/services/HelloService?wsdl
生成代码,将生成的代码拷到eclipse对应的包下。新建一个测试客户端类Client1。
代码如下:

/**
 * @author luocheng
 * 用wsimport工具生成代码的方式写Client客户端
 */
public class Client1 {
 
	public static void main(String[] args) {
		HelloServicePortType helloServicePortType = new HelloService().getHelloServiceHttpSoap11Endpoint();
		String s = helloServicePortType.queryName("张三");
		System.out.println("调用queryName:" + s);
	}
}

运行main函数,结果如下

webservices系列(四)——Axis2入门框架

上一篇:axis2客户端调用webservice服务--通过wsdl生成客户端程序并本地调用


下一篇:Axis2 WebService服务端客户端Demo搭建