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去装载，就是不行。
  暂时的解决方法是，把这些数组类型就声明为一般类型，就能装载了；客户端用数组类型访问，服务器也能正常
  解析出来，返回给客户端的数组类型，客户端也能正常解析。