利用Axis引擎成功发布一个Web Service的整个过程(包括环境的建立等等)(参照官方的user-guide.pdf)

本文链接：https://blog.csdn.net/liuxiIT/article/details/5802265

1.首先下载Axis.

访问网址:http://ws.apache.org/axis/java/releases.html

我下的是1.4的版本:如下

下载后的axis-bin-1_4.tar.gz解压到D:/Learn/WebService，文件名为:axis-1_4

axis-1_4文件夹下的目录结构如下:

在继续往下做之前要将classpath设置好:要把axis的lib包含进去:

设置环境变量classpath的值:

classpath=.;C:/Program Files/Java/jdk1.5.0_09/lib;

D:/Learn/WebService/axis-1_4/lib/axis.jar;

D:/Learn/WebService/axis-1_4/lib/activation-1.1.jar;

D:/Learn/WebService/axis-1_4/lib/jaxrpc.jar;

D:/Learn/WebService/axis-1_4/lib/saaj.jar;

D:/Learn/WebService/axis-1_4/lib/wsdl4j-1.5.1.jar;

D:/Learn/WebService/axis-1_4/lib/commons-logging-1.0.4.jar;

D:/Learn/WebService/axis-1_4/lib/log4j-1.2.8.jar;

D:/Learn/WebService/axis-1_4/lib/commons-discovery-0.2.jar

注意:下载的axis-1_4的lib下没有activation-1.1.jar包，这个jar包可以去:

http://ws.apache.org/axis2/download/1_5/download.cgi中下载Standard Binary Distribution 里面有这个jar包

接下来要把axis-1_4/webapps/axis文件夹拷贝到Tomcat的webapps目录下:

启动Tomcat，我把Tomcat的监听端口设置为8888。

一切准备工作全部OK了，准备发布一个Web Service到Tomcat中，然后我们通过在控制台用java命令来访问这个service。

在这里，就把axis-1_4/samples/userguide/example3下的MyService发布到Tomcat中去.

通过什么方法呢?

通过Axis Web Service 的部署描述文件(WSDD). 文件夹example3下的deploy.wsdd文件的内容如下:

在控制台输入如下命令，操作界面如下:

控制台输出Processing file deploy.wsdd

<Admin>Done processing</Admin>

说明部署成功!

接下来就可以访问这个Service了.

先看看这个Service具体做什么事吧:

package samples.userguide.example3; public class MyService { public String serviceMethod(String arg) { return arg; } }

业务逻辑相当简单

在控制台准备运行Client.class类,Client.java的内容如下：

package samples.userguide.example3; import org.apache.axis.client.Call; import org.apache.axis.client.Service; import org.apache.axis.encoding.XMLType; import org.apache.axis.utils.Options; import javax.xml.namespace.QName; import javax.xml.rpc.ParameterMode; public class Client { public static void main(String [] args) { try { Options options = new Options(args); String endpointURL = options.getURL(); String textToSend; args = options.getRemainingArgs(); if ((args == null) || (args.length < 1)) { textToSend = "<nothing>"; } else { textToSend = args[0]; } Service service = new Service(); Call call = (Call) service.createCall(); call.setTargetEndpointAddress( new java.net.URL(endpointURL) ); call.setOperationName( new QName("http://example3.userguide.samples", "serviceMethod") ); //调用MyService 的serviceMethod方法 call.addParameter( "arg1", XMLType.XSD_STRING, ParameterMode.IN); call.setReturnType( org.apache.axis.encoding.XMLType.XSD_STRING ); String ret = (String) call.invoke( new Object[] { textToSend } ); System.out.println("You typed : " + ret); } catch (Exception e) { System.err.println(e.toString()); } } }

控制台操作如下：

结果显示了:

You typed : 你正在测试用WSDD部署第一个Web Service 是否成功!

而这句话是在Client.java中的语句：System.out.println("You typed : " + ret);输出的

其中ret的值是MyService 的方法 serviceMethod返回的

到此，一个利用WSDD部署的Web Service就这样出来了。相当简单吧！

利用org.apache.axis.client.AdminClient还可以查看已经部署的service有哪些：运行如下命令即可：

C:/Documents and Settings/u121979>java org.apache.axis.client.AdminClient -p8888 list
log4j:WARN No appenders could be found for logger (org.apache.axis.i18n.ProjectResourceBundle).
log4j:WARN Please initialize the log4j system properly.
<ns1:deployment xmlns="http://xml.apache.org/axis/wsdd/" xmlns:java="http://xml.apache.org/axis/wsdd/provider
s/java" xmlns:ns1="http://xml.apache.org/axis/wsdd/">
<ns1:globalConfiguration>
<ns1:parameter name="sendMultiRefs" value="true"/>
<ns1:parameter name="disablePrettyXML" value="true"/>
<ns1:parameter name="adminPassword" value="admin"/>
<ns1:parameter name="attachments.Directory" value="D:/MyProject/jakarta-tomcat-5.0.28/webapps/axis/WEB-INF/
attachments"/>
<ns1:parameter name="dotNetSoapEncFix" value="true"/>
<ns1:parameter name="enableNamespacePrefixOptimization" value="false"/>
<ns1:parameter name="sendXMLDeclaration" value="true"/>
<ns1:parameter name="sendXsiTypes" value="true"/>
<ns1:parameter name="attachments.implementation" value="org.apache.axis.attachments.AttachmentsImpl"/>
<ns1:requestFlow>
   <ns1:handler type="java:org.apache.axis.handlers.JWSHandler">
    <ns1:parameter name="scope" value="session"/>
   </ns1:handler>
   <ns1:handler type="java:org.apache.axis.handlers.JWSHandler">
    <ns1:parameter name="scope" value="request"/>
    <ns1:parameter name="extension" value=".jwr"/>
   </ns1:handler>
</ns1:requestFlow>
</ns1:globalConfiguration>
<ns1:handler name="track" type="java:samples.userguide.example4.LogHandler">
<ns1:parameter name="filename" value="MyService.log"/>
</ns1:handler>
<ns1:handler name="LocalResponder" type="java:org.apache.axis.transport.local.LocalResponder"/>
<ns1:handler name="URLMapper" type="java:org.apache.axis.handlers.http.URLMapper"/>
<ns1:handler name="Authenticate" type="java:org.apache.axis.handlers.SimpleAuthenticationHandler"/>
<ns1:service name="AdminService" provider="java:MSG">
<ns1:parameter name="allowedMethods" value="AdminService"/>
<ns1:parameter name="enableRemoteAdmin" value="false"/>
<ns1:parameter name="className" value="org.apache.axis.utils.Admin"/>
<ns1:namespace>http://xml.apache.org/axis/wsdd/</ns1:namespace>
</ns1:service>
<ns1:service name="Version" provider="java:RPC">
<ns1:parameter name="allowedMethods" value="getVersion"/>
<ns1:parameter name="className" value="org.apache.axis.Version"/>
</ns1:service>
<ns1:service name="LogTestService" provider="java:RPC">
<ns1:requestFlow>
   <ns1:handler type="track"/>
</ns1:requestFlow>
<ns1:parameter name="allowedMethods" value="*"/>
<ns1:parameter name="accesses" value="1"/>
<ns1:parameter name="className" value="samples.userguide.example4.Service"/>
</ns1:service>
<ns1:service name="MyService" provider="java:RPC">
<ns1:parameter name="allowedMethods" value="*"/>
<ns1:parameter name="className" value="samples.userguide.example3.MyService"/>
</ns1:service>
<ns1:transport name="http">
<ns1:requestFlow>
   <ns1:handler type="URLMapper"/>
   <ns1:handler type="java:org.apache.axis.handlers.http.HTTPAuthHandler"/>
</ns1:requestFlow>
<ns1:parameter name="qs:list" value="org.apache.axis.transport.http.QSListHandler"/>
<ns1:parameter name="qs:wsdl" value="org.apache.axis.transport.http.QSWSDLHandler"/>
<ns1:parameter name="qs.list" value="org.apache.axis.transport.http.QSListHandler"/>
<ns1:parameter name="qs.method" value="org.apache.axis.transport.http.QSMethodHandler"/>
<ns1:parameter name="qs:method" value="org.apache.axis.transport.http.QSMethodHandler"/>
<ns1:parameter name="qs.wsdl" value="org.apache.axis.transport.http.QSWSDLHandler"/>
</ns1:transport>
<ns1:transport name="local">
<ns1:responseFlow>
   <ns1:handler type="LocalResponder"/>
</ns1:responseFlow>
</ns1:transport>
</ns1:deployment>

C:/Documents and Settings/u121979>

当我运行如下命令时，就可以将MyService移走:

D:/Learn/WebService/axis-1_4/samples/userguide/example3>java org.apache.axis.client.AdminClient -p8888 undep
loy.wsdd
log4j:WARN No appenders could be found for logger (org.apache.axis.i18n.ProjectResourceBundle).
log4j:WARN Please initialize the log4j system properly.
Processing file undeploy.wsdd
<Admin>Done processing</Admin>

在用AdminClient list查看：

D:/Learn/WebService/axis-1_4/samples/userguide/example3>java org.apache.axis.client.AdminClient -p8888 list
log4j:WARN No appenders could be found for logger (org.apache.axis.i18n.ProjectResourceBundle).
log4j:WARN Please initialize the log4j system properly.
<ns1:deployment xmlns="http://xml.apache.org/axis/wsdd/" xmlns:java="http://xml.apache.org/axis/wsdd/provider
s/java" xmlns:ns1="http://xml.apache.org/axis/wsdd/">
<ns1:globalConfiguration>
<ns1:parameter name="sendMultiRefs" value="true"/>
<ns1:parameter name="disablePrettyXML" value="true"/>
<ns1:parameter name="adminPassword" value="admin"/>
<ns1:parameter name="attachments.Directory" value="D:/MyProject/jakarta-tomcat-5.0.28/webapps/axis/WEB-INF/
attachments"/>
<ns1:parameter name="dotNetSoapEncFix" value="true"/>
<ns1:parameter name="enableNamespacePrefixOptimization" value="false"/>
<ns1:parameter name="sendXMLDeclaration" value="true"/>
<ns1:parameter name="sendXsiTypes" value="true"/>
<ns1:parameter name="attachments.implementation" value="org.apache.axis.attachments.AttachmentsImpl"/>
<ns1:requestFlow>
   <ns1:handler type="java:org.apache.axis.handlers.JWSHandler">
    <ns1:parameter name="scope" value="session"/>
   </ns1:handler>
   <ns1:handler type="java:org.apache.axis.handlers.JWSHandler">
    <ns1:parameter name="scope" value="request"/>
    <ns1:parameter name="extension" value=".jwr"/>
   </ns1:handler>
</ns1:requestFlow>
</ns1:globalConfiguration>
<ns1:handler name="track" type="java:samples.userguide.example4.LogHandler">
<ns1:parameter name="filename" value="MyService.log"/>
</ns1:handler>
<ns1:handler name="LocalResponder" type="java:org.apache.axis.transport.local.LocalResponder"/>
<ns1:handler name="URLMapper" type="java:org.apache.axis.handlers.http.URLMapper"/>
<ns1:handler name="Authenticate" type="java:org.apache.axis.handlers.SimpleAuthenticationHandler"/>
<ns1:service name="AdminService" provider="java:MSG">
<ns1:parameter name="allowedMethods" value="AdminService"/>
<ns1:parameter name="enableRemoteAdmin" value="false"/>
<ns1:parameter name="className" value="org.apache.axis.utils.Admin"/>
<ns1:namespace>http://xml.apache.org/axis/wsdd/</ns1:namespace>
</ns1:service>
<ns1:service name="Version" provider="java:RPC">
<ns1:parameter name="allowedMethods" value="getVersion"/>
<ns1:parameter name="className" value="org.apache.axis.Version"/>
</ns1:service>
<ns1:service name="LogTestService" provider="java:RPC">
<ns1:requestFlow>
   <ns1:handler type="track"/>
</ns1:requestFlow>
<ns1:parameter name="allowedMethods" value="*"/>
<ns1:parameter name="accesses" value="1"/>
<ns1:parameter name="className" value="samples.userguide.example4.Service"/>
</ns1:service>
<ns1:transport name="http">
<ns1:requestFlow>
   <ns1:handler type="URLMapper"/>
   <ns1:handler type="java:org.apache.axis.handlers.http.HTTPAuthHandler"/>
</ns1:requestFlow>
<ns1:parameter name="qs:list" value="org.apache.axis.transport.http.QSListHandler"/>
<ns1:parameter name="qs:wsdl" value="org.apache.axis.transport.http.QSWSDLHandler"/>
<ns1:parameter name="qs.list" value="org.apache.axis.transport.http.QSListHandler"/>
<ns1:parameter name="qs.method" value="org.apache.axis.transport.http.QSMethodHandler"/>
<ns1:parameter name="qs:method" value="org.apache.axis.transport.http.QSMethodHandler"/>
<ns1:parameter name="qs.wsdl" value="org.apache.axis.transport.http.QSWSDLHandler"/>
</ns1:transport>
<ns1:transport name="local">
<ns1:responseFlow>
   <ns1:handler type="LocalResponder"/>
</ns1:responseFlow>
</ns1:transport>
</ns1:deployment>