Apache Axis用户指南(1) （2）

也可以使用AdminClient来列出所有发布到服务器上的组件：

D:\axis-1_4>java org.apache.axis.client.AdminClient list

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

apache.org/axis/wsdd/providers/java" xmlns:ns1="http://xml.apache.org/axis/wsdd/

">

 <ns1:globalConfiguration>

 <ns1:parameter name="sendMultiRefs" value="true"/>

 ......

<ns1:parameter name="attachments.implementation" value="org.apache.axis.attach

ments.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="soapmonitor" type="java:org.apache.axis.handlers.SOAPMonitor

Handler">

 <ns1:parameter name="wsdlURL" value="/axis/SOAPMonitorService-impl.wsdl"/>

 <ns1:parameter name="namespace" value="http://tempuri.org/wsdl/2001/12/SOAPMon

itorService-impl.wsdl"/>

 <ns1:parameter name="serviceName" value="SOAPMonitorService"/>

 <ns1:parameter name="portName" value="Demo"/>

 </ns1:handler>

 .......other ns1:handler

 <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>

 .......other 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.QSListHand

ler"/>

.......other parameter

 </ns1:transport>

 ......other transport

</ns1:deployment>

在上面的打印的信息中，包含了services、handlers、transports和其它的内容。实际上它就是server-config.wsdd文件的内容。我们在稍后会更详细的介绍它。

更多的部署相关—Handlers和Chains 处理器和链

现在介绍一些Axis更强大的特性。比方说，想统计一下服务被调用了多少次，那么就是用一个handler来完成。在Axis包含这样的例子。当需要使用一个如上的handler类的时候，首先需要部署Handler本身(也就是说在wsdd文件中需要对其进行声明)，然后在service中使用handler的名字，这个名字由你决定。下面是一个handler的wsdd文件：

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

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

 <!-- define the logging handler configuration -->

 <handler name="track" type="java:samples.userguide.example4.LogHandler">

 <parameter name="filename" value="d:/MyService.log"/>

 </handler>

 <!-- define the service, using the log handler we just defined -->

 <service name="LogTestService" provider="java:RPC">

 <requestFlow>

   <handler type="track"/>

 </requestFlow>

 <parameter name="className" value="samples.userguide.example4.Service"/>

 <parameter name="allowedMethods" value="*"/>

 </service>

</deployment>

第一部分定义了一个Handler叫做”track”，实现的类为samples.userguide.example4.LogHandler。这个类接受一个参数filename，用于将日志信息记录到这个文件中。

然后再wsdd重定义了LogTestService服务，和第一个例子相似，也是RPC服务。不同之处在于service元素包含了一个<requestFlow>元素，这表示当服务被调用的时候，一些Handlers会被提前调用。通过插入一个track引用，这样就可以确保在调用服务的时候，每个消息都会被记录。

根据前面的例子，发布服务并调用：

         执行多次调用后，查看d:/MyService.log文件的内容，如下所示：

远程管理

默认情况下，Axis服务器只允许在本机上访问管理请求，如果希望启用远程管理，那么需要设置AdminService的enableRemoteAdmin属性为true。查看TOMCAT_HOME\webapps\axis\WEB-INF目录下的server-config.wsdd文件，可以看到AdminService的部署描述，添加如下的属性：

<service name="AdminService" provider="java:MSG">

 <parameter name="allowedMethods" value="AdminService"/>

 <parameter name="enableRemoteAdmin" value="true"/>

 <parameter name="className" value="org.apache.axis.utils.Admin"/>

 <namespace>http://xml.apache.org/axis/wsdd/</namespace>

 </service>

启用远程管理的话将允许未被授权的访问，如果启用的话，需要确保在配置中添加了安全限制。