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

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文件的内容如下:

<deployment xmlns="http://xml.apache.org/axis/wsdd/"
            xmlns:java="http://xml.apache.org/axis/wsdd/providers/java">

 <service name="MyService" provider="java:RPC">
  <parameter name="className" value="samples.userguide.example3.MyService"/>
  <parameter name="allowedMethods" value="*"/>
 </service>

</deployment>

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

控制台输出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>

D:/Learn/WebService/axis-1_4/samples/userguide/example3>

发现MyService不见了. OK !