axis2_1.6.2之构建web端和客户端

 参考资料：

    http://blog.csdn.net/apei830/article/details/5448897

axis2的官网

  http://axis.apache.org/axis2/java/core/docs/pojoguide.html

  1、先来构建web端，搭建服务平台

     a、从这 http://axis.apache.org/axis2/java/core/download.cgi 下载  axis2-1.6.2-war.zip  

             然后将里面的 axis2-web文件夹复制到你新建的java web的WerRoot下面  

                 将axis2\WEB-INF\lib包里面的jar复制到你的lib下  

   b、然后配置你的web.xml文件 加上AxisServlet配置 并且修改你项目的首页

   

[html]  view plain copy

1. <?xml version="1.0" encoding="UTF-8"?>  
2. <web-app version="2.5"   
3.     xmlns="http://java.sun.com/xml/ns/javaee"   
4.     xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"   
5.     xsi:schemaLocation="http://java.sun.com/xml/ns/javaee   
6.     http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd">  
7.   <welcome-file-list>  
8.     <welcome-file>/axis2-web/index.jsp</welcome-file>  
9.   </welcome-file-list>  
10.     
11.   <servlet>  
12.     <servlet-name>AxisServlet</servlet-name>  
13.     <servlet-class>org.apache.axis2.transport.http.AxisServlet</servlet-class>  
14.   </servlet>  
15.     
16.   <servlet-mapping>  
17.     <servlet-name>AxisServlet</servlet-name>  
18.     <url-pattern>/services/*</url-pattern>  
19.   </servlet-mapping>  
20.     
21. </web-app>  

  c、构建你对外发布的服务 这里测试用的 如下  包含对外两个方法  

    一个输入文本 返回文本

 一个上传二进制文件 返回布尔值 

[java]  view plain copy

1. package com.undergrowth.ws.test;  
2.   
3. import java.io.File;  
4. import java.io.FileInputStream;  
5. import java.io.FileOutputStream;  
6. import java.io.IOException;  
7. import java.io.InputStream;  
8.   
9. import javax.activation.DataHandler;  
10.   
11. public class WSTest {  
12.       
13.     public String sayHello(String name){  
14.         return name+"\tHello World\t"+"WebServices Axis2";  
15.     }  
16.       
17.     public  boolean uploadWithDataHandle(DataHandler dHandler,String fileName){  
18.           
19.         FileOutputStream fos=null;  
20.         try {  
21.             File file=new File("d:/upload_res/");  
22.             if(!file.exists()) file.mkdir();  
23.             fos=new FileOutputStream(new File(file,fileName));  
24.             writeFileToOutput(fos,dHandler.getInputStream());  
25.             System.out.println("上传成功!");  
26.             fos.close();  
27.         } catch (Exception e) {  
28.             // TODO: handle exception  
29.             e.printStackTrace();  
30.             return false;  
31.         }finally{  
32.             if(fos!=null){  
33.                 try {  
34.                     fos.close();  
35.                 } catch (IOException e) {  
36.                     // TODO Auto-generated catch block  
37.                     e.printStackTrace();  
38.                 }  
39.             }  
40.         }  
41.           
42.         return true;  
43.     }  
44.   
45.     private void writeFileToOutput(FileOutputStream fos, InputStream inputStream) throws IOException {  
46.         // TODO Auto-generated method stub  
47.         int n=0;  
48.         byte[] data=new byte[1024*8];  
49.         while((n=inputStream.read(data))!=-1){  
50.             fos.write(data,0,n);  
51.         }  
52.     }  
53.       
54. }  

d、向AXIS2的框架描述你要提供的服务  即services.xml文件

[html]  view plain copy

1. <?xml version="1.0" encoding="UTF-8"?>  
2. <serviceGroup>  
3.        <service name=""sayHello"">  
4.               <description>Web Service例子</description>  
5.               <parameter name="ServiceClass">com.SayHello</parameter>  
6.               <messageReceivers>  
7.                      <messageReceiver mep="http://www.w3.org/2004/08/wsdl/in-out" class="org.apache.axis2.rpc.receivers.RPCMessageReceiver" />  
8.               </messageReceivers>  
9.        </service>  
10. </serviceGroup>  

<service name=""sayHello""> 即是服务地址中  http://localhost:7001/Axis2Test/services/sayHello?wsdl  的名字

<parameter name="ServiceClass">com.SayHello</parameter>  即是SayHello类在src下的路径

对于services.xml文件的位置 只用放在你项目的web-inf下面即可  当然还有很多种放置方式  

对于services.xml的文件位置 我查看了AsixServlet源码  有如下这么一段 关于services.xml的放置位置的

当然中间经过很多转换 最终是在  WarBasedAxisConfigurator类下有这么一个方法  

[java]  view plain copy

1. public void loadServices() {  
2.         String repository = config.getInitParameter("axis2.repository.path");  
3.         if (repository != null) {  
4.             super.loadServices();  
5.             log.debug((new StringBuilder()).append(  
6.                     "loaded services from path: ").append(repository)  
7.                     .toString());  
8.             return;  
9.         }  
10.         String repository = config.getInitParameter("axis2.repository.url");  
11.         if (repository != null) {  
12.             loadServicesFromUrl(new URL(repository));  
13.             log.debug((new StringBuilder())  
14.                     .append("loaded services from URL: ").append(repository)  
15.                     .toString());  
16.             return;  
17.         }  
18.         loadServicesFromWebInf();  
19.         if (config.getServletContext().getRealPath("") != null  
20.                 || config.getServletContext().getRealPath("/") != null) {  
21.             super.loadServices();  
22.             log.debug("loaded services from webapp");  
23.             return;  
24.         }  
25.         try {  
26.             URL url = config.getServletContext().getResource("/WEB-INF/");  
27.             if (url != null) {  
28.                 loadServicesFromUrl(url);  
29.                 log.debug("loaded services from /WEB-INF/ folder (URL)");  
30.             }  
31.         } catch (MalformedURLException e) {  
32.             log.info(e.getMessage());  
33.         }  
34.         return;  
35.     }  

接下来有一个方法

[java]  view plain copy

1. private void loadServicesFromWebInf() {  
2.         try {  
3.             InputStream servicexml = config.getServletContext()  
4.                     .getResourceAsStream("/WEB-INF/services.xml");  
5.             if (servicexml != null) {  
6.                 HashMap wsdlServices = new HashMap();  
7.                 ArchiveReader archiveReader = new ArchiveReader();  
8.                 String path = config.getServletContext()  
9.                         .getRealPath("/WEB-INF");  
10.                 if (path != null)  
11.                     archiveReader.processFilesInFolder(new File(path),  
12.                             wsdlServices);  
13.                 org.apache.axis2.description.AxisServiceGroup serviceGroup = DeploymentEngine  
14.                         .buildServiceGroup(servicexml, Thread.currentThread()  
15.                                 .getContextClassLoader(), "annonServiceGroup",  
16.                                 configContext, archiveReader, wsdlServices);  
17.                 axisConfig.addServiceGroup(serviceGroup);  
18.             }  
19.         } catch (AxisFault axisFault) {  
20.             log.info(axisFault);  
21.         } catch (FileNotFoundException e) {  
22.             log.info(e);  
23.         } catch (XMLStreamException e) {  
24.             log.info(e);  
25.         }  
26.     }  

看上面那个方法  就是从web-inf下面获取services.xml文件啊  然后调用

[html]  view plain copy

1. axisConfig.addServiceGroup(serviceGroup);  

添加axisConfig.addServiceGroup  添加ajaxService

附  目录结构如下：

e、经过上面几步  发布项目  测试 

 http://localhost:7001/Axis2Test/

http://localhost:7001/Axis2Test/services/sayHello?wsdl

2、构建客户端 客户端也有很多中方式 这里采用 RPCServiceClient 进行调用

调用HelloWorld

[java]  view plain copy

1. package com.undergrowth.webservices;  
2.   
3. import javax.xml.namespace.QName;  
4.   
5. import org.apache.axis2.AxisFault;  
6. import org.apache.axis2.addressing.EndpointReference;  
7. import org.apache.axis2.rpc.client.RPCServiceClient;  
8.   
9. public class RPCClientHelloWorld {  
10.   
11.     /** 
12.      * @param args 
13.      */  
14.     public static void main(String[] args) {  
15.         // TODO Auto-generated method stub  
16.           
17.         try {  
18.             //1.创建webServices客户端  
19.             RPCServiceClient rpClient=new RPCServiceClient();  
20.             rpClient.getOptions().setTo(new EndpointReference("http://localhost:8888/Axis2Web/services/WSTest"));  
21.             //2.设置调用参数  
22.             QName opEntryQNama=new QName("http://test.ws.undergrowth.com","sayHello");  
23.             //输入参数  
24.             Object[] opEntryArgs=new Object[]{"google"};  
25.             //返回参数  
26.             Class[] returnClassArgs=new Class[]{String.class};  
27.             //3,进行调用  
28.             System.out.println(rpClient.invokeBlocking(opEntryQNama, opEntryArgs, returnClassArgs)[0]);  
29.         } catch (AxisFault e) {  
30.             // TODO Auto-generated catch block  
31.             e.printStackTrace();  
32.         }  
33.     }  
34.   
35. }  

调用文件上传

[java]  view plain copy

1. package com.undergrowth.webservices;  
2.   
3. import javax.activation.DataHandler;  
4. import javax.activation.FileDataSource;  
5. import javax.xml.namespace.QName;  
6.   
7. import org.apache.axis2.AxisFault;  
8. import org.apache.axis2.addressing.EndpointReference;  
9. import org.apache.axis2.rpc.client.RPCServiceClient;  
10.   
11. public class RPCClientUploadFile {  
12.   
13.     /** 
14.      * @param args 
15.      */  
16.     public static void main(String[] args) {  
17.         // TODO Auto-generated method stub  
18.           
19.         try {  
20.             //1.创建webServices客户端  
21.             RPCServiceClient rpClient=new RPCServiceClient();  
22.             rpClient.getOptions().setTo(new EndpointReference("http://localhost:8888/Axis2Web/services/WSTest"));  
23.             //2.设置调用参数  
24.             QName opEntryQNama=new QName("http://test.ws.undergrowth.com","uploadWithDataHandle");  
25.             //输入参数  
26.             Object[] opEntryArgs=new Object[]{new DataHandler(new FileDataSource("/csg.jpg")),"csg.jpg"};  
27.             //返回参数  
28.             Class[] returnClassArgs=new Class[]{Boolean.class};  
29.             //3,进行调用  
30.             System.out.println("上传结果为:"+rpClient.invokeBlocking(opEntryQNama, opEntryArgs, returnClassArgs)[0]);  
31.         } catch (AxisFault e) {  
32.             // TODO Auto-generated catch block  
33.             e.printStackTrace();  
34.         }  
35.     }  
36.   
37. }  

我是部署在weblogic下的，服务能访问，但调用的使用出现了这个问题：

java.lang.IllegalArgumentException: Unable to access unsupported property javax.xml.stream.supportDTD

我在网上搜索了一下，在WEB-INF下加上weblogic.xml

在里面加上如下代码：

<weblogic-web-app> 
    <container-descriptor> 
           <prefer-web-inf-classes>true</prefer-web-inf-classes> 
      </container-descriptor> 
</weblogic-web-app>

可能是JAR包冲突的问题

完整的weblogic.xml内容为：

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE weblogic-web-app PUBLIC "-//BEA Systems, Inc.//DTD Web Application 8.1//EN" "http://www.bea.com/servers/wls810/dtd/weblogic810-web-jar.dtd">
<weblogic-web-app>
   <jsp-descriptor>
    <jsp-param>
      <param-name>compileFlags</param-name>
      <param-value>-g</param-value>
    </jsp-param>
    <jsp-param>
      <param-name>keepgenerated</param-name>
      <param-value>true</param-value>
    </jsp-param>
    <jsp-param>
      <param-name>pageCheckSeconds</param-name>
      <param-value>1</param-value>
    </jsp-param>
   </jsp-descriptor>
	 <container-descriptor>
	   <prefer-web-inf-classes>true</prefer-web-inf-classes>
	 </container-descriptor>
  <context-root>Axis2Test</context-root>
</weblogic-web-app>