axis定时发布

2. 使用定制发布 Web Service Deployment Descriptor(WSDD)

 

　 　即时发布是一项令人激动的技术，它使Web服务的开发变得如此简单；然而即时发布并不总是最好的选择，比如有些应用系统是第三方提供的，我们没有购买源代码，只有.class文件，但我们又希望将这个应用系统的一些功能对外发布成Web服务，使其能够在更大范围内产生作用，这个时候即时发布技术就无能为力了。此外，即时发布技术并不灵活，无法进行更多的服务配置，这使得它并不能满足一些特定系统的需求。

　　因此，Axis提供了另一种服务发布方式，这就是定制发布。

　　在此给出一个从加仑到升的容积单位转换的服务，其源码如下：

　　文件Capacity.java

    package test.capacity;

    public class Capacity

    {

        public double convertGallon2Litre( double gallon )

         {

           return gallon * 4.546;// 实现加仑到升的容积转换

          }//convertGallon2Litre()

     }

将其编译成.class文件，放置到“……

\webapps\axis\WEB-INF\classes\test\capacity ”目录下，即可着手进行发布。

    定制发布不需要构建.jws文件，但必须创建服务发布描述文件deploy.wsdd（Web Service Deployment Descriptor的缩写），这个文件负责描述服务的名称、入口等信息，其内容如下：

    文件deploy.wsdd

<deployment

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

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

        <parameter name="className" value="test.capacity.Capacity"/>

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

    </service>

</deployment>

 

    在这里服务的提供者是“java:RPC”，它被内建在Axis中，而且指明了一个JAVA RPC服务，做这个处理的类是org.apache.axis.providers.java.RPCProvider。

    我们是通过一个<parameter>标签告诉RPC服务应该调用的类，而另外一个<parameter>标签则告诉引擎，它可以调用这个类中的任何的Public方法。你也可以指定通过使用名字空间或者一些可以调用的方法列表，来指明那些方法可以被调用。

 

　　将该文件也放到“……\webapps\axis\WEB-INF\classes\test\capacity”目录下，然后可以采用Axis提供的一个客户端管理工具——AdminClient来完成服务的定制发布。

   在“……\webapps\axis\test\capacity”目录下，运行：

 

set axis_lib=C:\apache-tomcat-5.5.17\webapps\axis\WEB-INF\lib

set axis_path=%axis_lib%\axis.jar;%axis_lib%\commons-discovery.jar;%axis_lib%\jaxrpc.jar;%axis_lib%\commons-logging.jar;%axis_lib%\log4j.jar;%axis_lib%\wsdl4j.jar;%axis_lib%\saaj.jar

 

java -classpath %axis_path% org.apache.axis.client.AdminClient deploy.wsdd

java -cp %axis_path% org.apache.axis.client.AdminClient list

   

 

   如果运行时说没有找到类，那么可能是类路径没有配置好，建议将所有的与axis相关的jar都写到classpath中去。这样只要运行:

 

   java org.apache.axis.client.AdminClient deploy.wsdd

   可以看到以下运行结果：

 

 Processing file deploy.wsdd

 <Admin>Doneprocessing</Admin>

 

这表明Capacity服务定制发布完成。

 

发布完成会增加或更新WEB-INF\server-config.wsdd的文件或内容。

 

<!-- handler -->

    <handler name="LocalResponder" type="java:org.apache.axis.transport.local.LocalResponder" />

    <handler name="URLMapper" type="java:org.apache.axis.handlers.http.URLMapper" />

    <handler name="Authenticate" type="java:org.apache.axis.handlers.SimpleAuthenticationHandler" />

   

    <!-- 系统服务

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

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

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

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

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

    </service>

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

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

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

    </service>

     -->

    <!-- 自定义服务 -->

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

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

       <parameter name="className" value="test.capacity.Capacity" />

    </service>

        

    <!-- transport to handler -->

    <transport name="http">

       <requestFlow>

           <handler type="URLMapper" />

           <handler type="java:org.apache.axis.handlers.http.HTTPAuthHandler" />

       </requestFlow>

       <parameter name="qs:list" value="org.apache.axis.transport.http.QSListHandler" />

       <parameter name="qs:wsdl" value="org.apache.axis.transport.http.QSWSDLHandler" />

       <parameter name="qs.list" value="org.apache.axis.transport.http.QSListHandler" />

       <parameter name="qs.method" value="org.apache.axis.transport.http.QSMethodHandler" />

       <parameter name="qs:method" value="org.apache.axis.transport.http.QSMethodHandler" />

       <parameter name="qs.wsdl"   value="org.apache.axis.transport.http.QSWSDLHandler" />

    </transport> 

    <transport name="local">

       <responseFlow>

           <handler type="LocalResponder" />

       </responseFlow>

    </transport>

 

   你也可以调用：

undeploy.wsdd 文件：

<undeployment

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

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

    <service name="Capacity"/>

</undeployment>

 

 java org.apache.axis.client.AdminClient undeploy.wsdd  来取消部署。

 

   你也可以调用：

 java org.apache.axis.client.AdminClient list 来获得所有的已经部署的服务的列表。在这里你会看到services, handlers, transports等等，注意这个调用只是列出了WEB-INF\server-config.wsdd的文件内容。

 

   一定要注意：编译后的class文件要拷贝到web-inf/classes的目录中，如果该文件中有包存在的话，别忘了还要在classes目录下创建包的目录。

   通过访问http://localhost:8080/axis/services/Capacity?wsdl可以看到这个服务的WSDL描述文件，这说明Capacity服务被成功发布了。

   你也可以通过访问http://localhost:8080/axis/servlet/AxisServlet查看所有定制发布的服务。

访问：

http://localhost:8080/axis/services/Capacity?method=convertGallon2Litre&gallon=100 可以看到执行结果。

 

 Web.xml

<servlet>

       <servlet-name>AxisServlet</servlet-name>

       <servlet-class>

           org.apache.axis.transport.http.AxisServlet

       </servlet-class>

    </servlet>

    <servlet-mapping>

       <servlet-name>AxisServlet</servlet-name>

       <url-pattern>*.jws</url-pattern>

    </servlet-mapping>

    <servlet-mapping>

       <servlet-name>AxisServlet</servlet-name>

       <url-pattern>/servlet/AxisServlet</url-pattern>

    </servlet-mapping>  

    <servlet-mapping>

       <servlet-name>AxisServlet</servlet-name>

       <url-pattern>/services/*</url-pattern>

    </servlet-mapping>  

   

    <servlet>

       <servlet-name>AdminServlet</servlet-name>

       <servlet-class>

           org.apache.axis.transport.http.AdminServlet

       </servlet-class>

       <load-on-startup>100</load-on-startup>

    </servlet>

    <servlet-mapping>

       <servlet-name>AdminServlet</servlet-name>

       <url-pattern>/servlet/AdminServlet</url-pattern>

    </servlet-mapping>