http://blog.youkuaiyun.com/zhangzhaokun/archive/2009/09/24/4582977.aspx
验证没通过!
___________________________________________________________________________
最近在工作过程中总是需要向其它项目组提供Webservice的接口,由于开始需求不是很明确,接口的定义经常需要变更,每一次下来都需要将Java到 wsdl,从wsdl到Java,再根据wsdd文件在tomcat上deploy服务这个过程重复一遍.在这个过程中经常出现一些问题,尤其是长期不用 axis之后再突然这么用上一用的时候,总是有或多或少的问题存在,遂经上述过程的一些详细操作步骤整理了一些,供参考.
使用Axis在Tomcat下发布Webservice有如下几个步骤:
(1)用JavaBean写好要发布的服务的定义
(2)使用Java2WSDL命令,根据JavaBean生成WSDL文件
(3)使用Wsdl2Java命令,根据WSDL文件生成服务端源代码,以及deploy.wsdd文件
(4)根据deploy.wsdd文件在tomcat下发布Webservice服务
(1)用JavaBean写好要发布的服务的定义
以用户注册为例,需要提供如下样式的用户注册服务,输入参数为 com.huawei.mtv.commons.services.schemas.UserRegisterEvt,输出参数为 com.huawei.mtv.commons.services.schemas.UserRegisterResp.
UserManage接口文件定义:
- package com.huawei.mtv.commons.services;
- import com.huawei.mtv.commons.services.schemas.UserRegisterEvt;
- import com.huawei.mtv.commons.services.schemas.UserRegisterResp;
- public class UserManage
- {
- public UserRegisterResp register(UserRegisterEvt evt)
- {
- return null ;
- }
- }
输入参数UserRegisterEvt源代码:
- package com.huawei.mtv.commons.services.schemas;
- public class UserRegisterEvt implements java.io.Serializable {
- private int accessCode;
- private java.lang.String level;
- private java.lang.String userId;
- public UserRegisterEvt(){
- }
- public int getAccessCode(){
- return accessCode;
- }
- public void setAccessCode( int accessCode){
- this .accessCode = accessCode;
- }
- public java.lang.String getLevel(){
- return level;
- }
- public void setLevel(java.lang.String level){
- this .level = level;
- }
- public java.lang.String getUserId(){
- return userId;
- }
- public void setUserId(java.lang.String userId){
- this .userId = userId;
- }
- }
输出参数UserRegisterResp源代码:
- package com.huawei.mtv.commons.services.schemas;
- public class UserRegisterResp implements java.io.Serializable {
- private java.lang.String description;
- private java.lang.String returnCode;
- public java.lang.String getDescription(){
- return description;
- }
- public void setDescription(java.lang.String description){
- this .description = description;
- }
- public java.lang.String getReturnCode() {
- return returnCode;
- }
- public void setReturnCode(java.lang.String returnCode){
- this .returnCode = returnCode;
- }
- }
在Eclipse环境下将上述定义文件导出为mtv-common.jar包.至此第一步算是完成了.
(2)使用Java2WSDL命令,根据JavaBean生成WSDL文件
这里我使用的是axis-1_4版本,具体使用到的jar包(只使用了axis-1_4中lib目录中自带的jar包)和命令参见如下代码。
java2wsdl.bat批处理文件 :
- set axis_home=D:/software/axis2/axis-1_4/lib
- set axis_path=%axis_home%/axis-ant.jar
- set axis_path=%axis_path%;%axis_home%/axis.jar
- set axis_path=%axis_path%;%axis_home%/commons-discovery-0.2.jar
- set axis_path=%axis_path%;%axis_home%/commons-logging-1.0.4.jar
- set axis_path=%axis_path%;%axis_home%/jaxrpc.jar;
- set axis_path=%axis_path%;%axis_home%/log4j-1.2.8.jar
- set axis_path=%axis_path%;%axis_home%/mtv-common.jar
- set axis_path=%axis_path%;%axis_home%/saaj.jar
- set axis_path=%axis_path%;%axis_home%/wsdl4j-1.5.1.jar
- set CLASSPATH=%CLASSPAHT%;%axis_path%
- java org.apache.axis.wsdl.Java2WSDL -n "urn:UserManage" -p "com.huawei.mtv.commons.services" "urn:UserManage" -o "UserManage.wsdl" -l "http://localhost:8080/axis/services/UserManage" com.huawei.mtv.commons.services.UserManage
执行上述批处理文件之后就生成了UserManage.wsdl文件了.
Java2WSDL命令的个参数含义如下:
- -o:指定输出的WSDL文件的文件名。
- -l:指定服务的位置。
- -n:WSDL文件的目标名字空间。
- -p:指定从package到名字空间的映射,这里可以有多个映射。
要注意如下几点:
-o -l -n -p这些选项最好与后面选项对应的值之间没有空格,尤其是-p参数,有空格的话在生成WSDL文件的时候会报错.
(3)使用Wsdl2Java命令,根据WSDL文件生成服务端源代码,以及deploy.wsdd文件
使用如下wsdl2java.bat批处理文件来生成Webservice服务端和客户端源代码.
- set axis_home=D:/software/axis2/axis-1_4/lib
- set axis_path=%axis_home%/axis-ant.jar
- set axis_path=%axis_path%;%axis_home%/axis.jar
- set axis_path=%axis_path%;%axis_home%/commons-discovery-0.2.jar
- set axis_path=%axis_path%;%axis_home%/commons-logging-1.0.4.jar
- set axis_path=%axis_path%;%axis_home%/jaxrpc.jar;
- set axis_path=%axis_path%;%axis_home%/log4j-1.2.8.jar
- set axis_path=%axis_path%;%axis_home%/mtv-common.jar
- set axis_path=%axis_path%;%axis_home%/saaj.jar
- set axis_path=%axis_path%;%axis_home%/wsdl4j-1.5.1.jar
- java org.apache.axis.wsdl.WSDL2Java --server-side --skeletonDeploy true UserManage.wsdl
执行上述批处理文件之后会生成源代码的目录与结构如下:
UserManage_pkg包下生成文件如下:
- deploy.wsdd
- undeploy.wsdd
- UserManage.java
- UserManageService.java
- UserManageServiceLocator.java
- UserManageSoapBindingImpl.java
- UserManageSoapBindingSkeleton.java
- UserManageSoapBindingStub.java
另外也生成了com包,该包下的java文件与我们最初在第一步定义的文件基本相同.
利用Eclipse将上述生成的Java代码进行编译,导出为mtv-service.jar
(4)根据deploy.wsdd文件在tomcat下发布Webservice服务
将axis-1_4/webapps目录下的axis直接拷贝到tomcat/webapps目录下,再将mtv-service.jar包放到 tomcat/webapps/axis/WEB-INFO/lib目录下,将tomcat启动,执行如下deploy.bat批处理命令即可发布 UserManage服务了.
deploy.bat批处理文件如下:
- set axis_home=D:/software/axis2/axis-1_4/lib
- set axis_path=%axis_home%/axis-ant.jar
- set axis_path=%axis_path%;%axis_home%/axis.jar
- set axis_path=%axis_path%;%axis_home%/commons-discovery-0.2.jar
- set axis_path=%axis_path%;%axis_home%/commons-logging-1.0.4.jar
- set axis_path=%axis_path%;%axis_home%/jaxrpc.jar;
- set axis_path=%axis_path%;%axis_home%/log4j-1.2.8.jar
- set axis_path=%axis_path%;%axis_home%/saaj.jar
- set axis_path=%axis_path%;%axis_home%/wsdl4j-1.5.1.jar
- java org.apache.axis.client.AdminClient -l"http://localhost:9000/axis/services/UserManage" deploy.wsdd
经过上述4大步骤,我们的UserManage服务就顺利发布了.
通过http://localhost:9000/axis/servlet/AxisServlet 即可查看到刚才发布UserManage服务了.