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

cxs7225032

也可以使用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>
启用远程管理的话将允许未被授权的访问，如果启用的话，需要确保在配置中添加了安全限制。