AXIS2之WSDL2JAVA

WSDL2Java操作指南

1. 安装JDK1.5, 配置系统环境变量:
   下载安装JDK后, 设置环境变量：
   JAVA_HOME=C:/Program Files/Java/jdk1.5.0_02
   Path=%Path%;%JAVA_HOME%/bin(这里的%Path%指你系统已经有的一系列配置)
   CLASSPATH=%JAVA_HOME%/lib

2. 下载axis, 配置系统环境变量:
   下载axis后，配置如下：
   AXIS_LIB=F:/Java/axis/axis-1_4/lib
   然后在CLASSPATH里添加axis的8个jar:
   CLASSPATH=%JAVA_HOME%/lib;
 %AXIS_LIB%/axis.jar;
 %AXIS_LIB%/axis-ant.jar;
 %AXIS_LIB%/commons-discovery-0.2.jar;
 %AXIS_LIB%/commons-logging-1.0.4.jar;
 %AXIS_LIB%/jaxrpc.jar;
 %AXIS_LIB%/log4j-1.2.8.jar;
 %AXIS_LIB%/saaj.jar;
 %AXIS_LIB%/wsdl4j-1.5.1.jar;
   
3. 添加附加的3个jar:
   自己去获取activation.jar, mail.jar, xerces.jar, 放到AXIS_LIB所指的目录下，
然后在CLASSPATH里添加：
   CLASSPATH=%JAVA_HOME%/lib;
 %AXIS_LIB%/axis.jar;
 %AXIS_LIB%/axis-ant.jar;
 %AXIS_LIB%/commons-discovery-0.2.jar;
 %AXIS_LIB%/commons-logging-1.0.4.jar;
 %AXIS_LIB%/jaxrpc.jar;
 %AXIS_LIB%/log4j-1.2.8.jar;
 %AXIS_LIB%/saaj.jar;
 %AXIS_LIB%/wsdl4j-1.5.1.jar;
 %AXIS_LIB%/activation.jar;
 %AXIS_LIB%/mail.jar;
 %AXIS_LIB%/xerces.jar

4. 获取或者自己编写wsdl文件

5. 生成webservice服务器端的代码：
   5.1 先看命令的帮助, 在cmd.exe的提示符执行：java org.apache.axis.wsdl.WSDL2Java -h
       我可以看到很多选项，其中就有-s和-S
   5.2 执行WSDL2Java, 生成skeleton类:
       java org.apache.axis.wsdl.WSDL2Java -s -S true BluePower.wsdl
       将生成：  A skeleton class
                  An implementation template class
                  One deploy.wsdd file
                  One undeploy.wsdd file
   5.3 执行WSDL2Java, 不生成skeleton类:
       java org.apache.axis.wsdl.WSDL2Java -s BluePower.wsdl
       将生成：  
                  An implementation template class
                  One deploy.wsdd file
                  One undeploy.wsdd file
       (我们发现少了一个A skeleton class)
   5.4 名字解释：
   Skeleton class: 
      它是Axis engine 和 the actual service implementation 类之间的一个代理类。
       The skeleton contains an implementation of the AddressBook service. 
       This implementation is either passed into the skeleton on construction, 
       or an instance of the generated implementation is created.
       When the Axis engine calls the skeleton's addEntry method, 
       it simply delegates the invocation to the real implementation's addEntry method.
   Implementation Template class:
       它就是我们的实际服务器端的实现代码，我们要在不同的方法里写具体的实现处理。
       
6. 根据deploy.wsdd生成server-config.wsdd:
  这里比较模糊，我暂时的方法是：
  先部署一个web服务器，如用resin，然后把第5步生成的类文件放到classes下(eclipse可以指定编译路径)，
  把deploy.wsdd放到classes上一目录，也就是WEB-INF下，运行命令：
  java -cp %AXIS_CLASSPATH% org.apache.axis.client.AdminClient -lhttp://localhost:8080/test/services/MyServer deploy.wsdd
  若出现：<Admin>Done processing</Admin>则成功，若出现失败，则具体情况具体分析。
  成功后，当前目录就会生成server-config.wsdd文件。
  注意：为什么这里用%AXIS_CLASSPATH%, 因为直接把这些jar配置在CLASSPATH里，调用log4j时有冲突。最好不要放到CLASSPATH
  
7. server-config.wsdd文件里的未解决的数组类型问题：
  若接口参数或返回值有数组，则会生成ArrayMapping的配置，而在resin下配置axis的servlet去装载，就是不行。
  暂时的解决方法是，把这些数组类型就声明为一般类型，就能装载了；客户端用数组类型访问，服务器也能正常
  解析出来，返回给客户端的数组类型，客户端也能正常解析

AXIS2之WSDL2JAVA

　　Axis2是常用的一种SOAP engine，但是它提供的wsdl2Java的命令行工具的说明比较简单，没有具体的例子。下面举出几个例子：

从最简单的开始 ,-uri 指定wsdl文件
> WSDL2Java -uri currencyConvert.wsdl

-d 使用不同的data binding方法
> WSDL2Java -uri currencyConvert.wsdl -d XML beans

-a 生成异步的方法
> WSDL2Java -uri currencyConvert.wsdl -a

-t 生成测试case
> WSDL2Java -uri currencyConvert.wsdl -t ...

稍微复杂一些的，-p可以指定生成的package，-o指定生成的路径，-ss生成服务端代码
wsdl2java -uri ../wsdl/currencyConvert.wsdl -o ../gen_src  -ss -sd -g -p foo.bat

再复杂一些，－ns2p 将namespace进行替换,多个中间用逗号隔开
wsdl2java -uri ../wsdl /currencyConvert.wsdl -o ../wsdl /gen_src  -ss -sd -g -p com.foo.bar -ns2p "http://www.xxx.yyy.com/zzz /v1.0"=com.foo.bar,"http://www.xxx.yyy.com/ddd/v1.1"=com.foo.bar.goo进入讨论组讨论。

 

C:/ws/classes> java org.apache.axis.wsdl.WSDL2Java -o . -d Session -s -S true  -Nurn:MobileBoss com.yy.ws mb.wsdl

参数说明： -o 输出文件所在目录（ .-代表当前目录 ）

                   -s生成server端绑定代码

                   -d发布范围

                  -S是否产生发布和撤销webservice的deploy.wsdd和undeploy.wsdd文件。ture代表生成发布文件。

                  -Nurn:命名空间 包名

                 mb.wsdl - wsdl文件名。

 

 

 Axis2是常用的一种SOAP engine，但是它提供的wsdl2java的命令行工具的说明比较简单，没有具体的例子。下面举出几个例子：

从最简单的开始 ,-uri 指定wsdl文件
> WSDL2Java -uri currencyConvert.wsdl

-d 使用不同的data binding方法
> WSDL2Java -uri currencyConvert.wsdl -d xmlbeans

-a 生成异步的方法
> WSDL2Java -uri currencyConvert.wsdl -a

-t 生成测试case
> WSDL2Java -uri currencyConvert.wsdl -t ...

稍微复杂一些的，-p可以指定生成的package，-o指定生成的路径，-ss生成服务端代码
wsdl2java -uri ../wsdl/currencyConvert.wsdl -o ../gen_src  -ss -sd -g -p foo.bat

再复杂一些，－ns2p 将namespace进行替换,多个中间用逗号隔开
wsdl2java -uri ../wsdl/currencyConvert.wsdl -o ../wsdl/gen_src  -ss -sd -g -p com.foo.bar -ns2p "http://www.xxx.yyy.com/zzz/v1.0"=com.foo.bar,"http://www.xxx.yyy.com/ddd/v1.1"=com.foo.bar.goo

 

 

稍微复杂一些的，-p可以指定生成的package，-o指定生成的路径，-ss生成服务端代码
wsdl2java　-uri　../wsdl/currencyConvert.wsdl　-o　../gen_src　　-ss　-sd　-g　-p　foo.bat

再复杂一些，－ns2p　将namespace进行替换,多个中间用逗号隔开
wsdl2java　-uri　../wsdl/currencyConvert.wsdl　-o　../wsdl/gen_src　　-ss　-sd　-g　-p　com.foo.bar　-ns2p　"http://www.xxx.yyy.com/zzz/v1.0"=com.foo.bar,"http://www.xxx.yyy.com/ddd/v1.1"=com.foo.bar.goo