webservices系列（四）——Axis2入门框架

柔光的暖阳◎ 2022-07-03 23:54 233阅读 0赞

一．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这个服务的详细信息

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

![Center 1][]  
在浏览器中输入：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，找到如下的配置代码：

将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>元素中添加如下的子元素：

上面的配置允许在<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函数，结果如下

![Center 2][]

[Center]: /images/20220618/75008b5246284c41b512eb764e724727.png
[Center 1]: /images/20220618/fe5d73c372834e42a979959a5a145bda.png
[Center 2]: /images/20220618/27d7c2dfba2d48a2ab10bc749424a23b.png