Axis的基础测试

Axis的基础测试

一．如何搭建Axis2的开发环境

1.下载和安装Java （JDK1.4以上）。设置JAVA_HOME环境变量。
2.下载Axis2并解压到目标文件夹。
3.拷贝axis2.war文件到你的Servlet引擎的webapps目录。
4.设置AXIS2_HOME环境变量到步骤3的axis2.war所在文件夹。
大部分情况下还需要为我们的服务建立一个WSDL文件，Axis2的Java2WSDL可以用来生成一个WSDL。如果要从一个Java类来生成一个WSDL，可按照以下步骤：
a.建立和编译你的Java类
(Windows)
%AXIS2_HOME%\bin\java2wsdl -cp . -cnsamples.quickstart.service.pojo.StockQuoteService -of StockQuoteService.wsdl
(Linux)
$AXIS2_HOME/bin/java2wsdl -cp . -cn samples.quickstart.service.pojo.StockQuoteService-of StockQuoteService.wsdl
b.使用命令行来生成WSDL:
生成命令行以后，你就可以按照你的需要进行修改，例如你可能需要添加一个定制的错误处理，或者改动生成的元素的名字。

二．Axis2是什么？

A． Axis2是一个web服务/SOAP/WSDL引擎，它继承Apache Axis广泛使用的SOAP堆栈，它有两个实现版本-----java和C。它是主流的webservice开发框架之一，实现方便，安全的，可靠的。它支持热部署，以及异步webservice的调用等。

B．要求java版本，jdk至少是1.5及以上版本。

C．传输协议：HTTP,SMTP,JMS,TCP

D．支持规范：

① SOAP 1.1 和 1.2。

 ② 消息传输优化机制（MTOM），优化的XML包装（XOP）和SOAP带附件。

③ WSDL 1.1中，包括SOAP和HTTP绑定,（本身支持WSDL1.1和2.0）。

④ WS-Addressing。一种将消息寻址信息综合到Web services消息中的标准。

⑤ WS-Policy。Web 服务策略框架。

⑥ SAAJ 1.1 。(SOAP with Attachments API for JAVA SAAJ)是在松散耦合软件系统中利用SOAP协议实现的基于XML消息传递的API规范。顾名思义，SAAJ支持带附件的SOAP消息。

 

  

三．复杂对象在webservice之间的传输：

在实际的应用中，不仅需要使用WebService来传递简单类型的数据，有时也需要传递更复杂的数据，这些数据可以被称为复合类型的数据。数组与类（接口）是比较常用的复合类型。在Axis2中可以直接使用将WebService方法的参数或返回值类型声明成数组或类（接口）。但要注意，在定义数组类型时只能使用一维数组，如果想传递多维数组，可以使用分隔符进行分隔，如下面的代码所示：

String[] strArray = new String[]{ "自行车,飞机,火箭","中国,美国,德国", "超人,蜘蛛侠,钢铁侠" } ;

上面的代码可以看作是一个3*3的二维数组。

在传递类的对象实例时，除了直接将数组类型声明成相应的类或接口，也可以将对象实例进行序列化，也就是说，将一个对象实例转换成字节数组进行传递，然后接l收方再进行反序列化，还原这个对象实例。

 

四．调用webservice接口的方法：

参考《java_调用Webservice接口.doc》

 

五．Axis2发布有二种方法 ：

一）在项目里发布；（特点：灵活，可调试）

二）打包成aar文件发布；（特点：不方便调试）

 

六．同步调用WebService和异步调用WebService的区别:

一：同步调用

　　　　一个同步操作会阻塞整个当前的进程，直到这个操作完成才能执行下一段代码

　二：异步调用

　　　　不会阻塞启动操作的调用线程，调用程序必须通过轮流检测，或者等待完成信号来发现调用的完成

八．WebService中的方法是否允许重载？

WebService中不支持使用方法的重载.

九．为什么WebService中不支持方法的重载？

WebService中不支持方法的重载，这还得从WebService的工作机制中说起，当客户端调用一个WebService的方法时，首先要将方法名称和需要传递的参数包装成XML，也就是SOAP包，通过HTTP协议传递到服务器端，然后服务器端解析这段XML，得到被调用的方法名称和传递过来的参数，进而调用WebService相应的方法，方法执行完毕后，将返回结果再次包装为XML，也就是SOAP响应，发送到客户端，最后客户端解析这段XML，最终得到返回结果，关键在于服务器端解析XML时无法识别重载的方法，WebService只认方法的名称，而且两个方法的名称相同，服务器端不知道该调用哪个相应的方法

十．如何解决WebService中方法的重载？

可以通过MessageName属性消除由于多个相同的名称造成的Web服务无法识别的问题，因为MessageName属性使得Web服务能够确定唯一别名的重载方法，默认时候是方法本身的名称，当指定MessageName属性后，SOAP将反映MessageName的值，而不是方法名称本身，所以这就解决了WebService中不支持方法的重载

十一.java发布webService要注意的地方

如果发布在公网上的话，要注意添加用户名和密码的验证。

1. POJO类不能使用package关键字声明包。

       2. 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即可。

       3. 在浏览器中测试WebService时，如果WebService方法有参数，需要使用URL的请求参数来指定该WebService方法参数的值，请求参数名与方法参数名要一致，例如，要测试getGreeting方法，请求参数名应为name，如上面的URL所示。

       4. 发布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会重名）

十二.java调用webService要注意的地方

1. 客户端代码需要引用很多Axis2的jar包，如果读者不太清楚要引用哪个jar包，可以在Eclipse的工程中引用Axis2发行包的lib目录中的所有jar包。

       2. 在本例中使用了RPCServiceClient类的invokeBlocking方法调用了WebService中的方法。invokeBlocking方法有三个参数，其中第一个参数的类型是QName对象，表示要调用的方法名；第二个参数表示要调用的WebService方法的参数值，参数类型为Object[]；第三个参数表示WebService方法的返回值类型的Class对象，参数类型为Class[]。当方法没有参数时，invokeBlocking方法的第二个参数值不能是null，而要使用new Object[]{}。

       3. 如果被调用的WebService方法没有返回值，应使用RPCServiceClient类的invokeRobust方法，该方法只有两个参数，它们的含义与invokeBlocking方法的前两个参数的含义相同。

       4. 在创建QName对象时，QName类的构造方法的第一个参数表示WSDL文件的命名空间名，也就是<wsdl:definitions>元素的targetNamespace属性值，下面是SimpleService类生成的WSDL文件的代码片段：

       <?xml version="1.0" encoding="UTF-8"?>
       <wsdl:definitions xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/" xmlns:ns1="http:/  /org.apache.axis2/xsd" 
       xmlns:ns="http://ws.apache.org/axis2" xmlns:wsaw="http://www.w3.org/2006/05/a   ddressing/wsdl" 
       xmlns:http="http://schemas.xmlsoap.org/wsdl/http/" xmlns:xs="http://www.w3.org/   2001/XMLSchema" 
       xmlns:mime="http://schemas.xmlsoap.org/wsdl/mime/" xmlns:soap="http://schema   s.xmlsoap.org/wsdl/soap/" 
       xmlns:soap12="http://schemas.xmlsoap.org/wsdl/soap12/" 
       targetNamespace="http://ws.apache.org/axis2">
              <wsdl:types>
                      
              </wsdl:types>
                      
       </wsdl:definitions>

十三.会话（Session）管理

1. 使用MessageContext和ServiceContext获得与设置key-value对。

2. 为要进行Session管理的WebService类所对应的<service>元素添加一个scope属性，并将该属性值设为transportsession。

3. 在客户端使用setManageSession(true)打开Session管理功能。

十四.将Spring中的装配JavaBean发布成WebService需要注意以下几点：

       1. 由JavaBean编译生成的.class文件需要放在WEB-INF\classes目录中，或打成.jar包后放在WEB-INF\lib目录中，而WEB-INF\services目录中的.aar包中不需要包含.class文件，而只需要包含一个META-INF目录，并在该目录中包含一个services.xml文件即可。

       2. services.xml的配置方法与前几篇文章的配置方法类似，只是并不需要使用ServiceClass参数指定要发布成WebService的Java类，而是要指定在applicationContext.xml文件中的装配JavaBean的名称（SpringBeanName参数）。

       3. 在services.xml文件中需要通过ServiceObjectSupplier参数指定SpringServletContextObjectSupplier类来获得Spring的ApplicationContext对象。