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>

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