基于Spring的远程访问与Web Service（二）

Spring框架对远程访问技术提供了很好的集成机制，Spring目前支持的技术包括：
1. Remote Method Invocation (RMI)。通过 RmiProxyFactoryBean和RmiServiceExporter，Spring支持以java.rmi.Remote和java.rmi.RemoteException 定义的传统RMI接口，提供经由RMI的透明访问；
2.Spring内置的HTTP invoker远程调用机制。Spring开发团队意识到在RMI服务和基于HTTP的服务（如Hessian和Burlap）之间的空白。一方面，RMI使用Java标准的对象序列化，但很难穿越防火墙；另一方面，Hessian/Burlap能很好地穿过防火墙工作，但使用自己私有的一套对象序列化机制。因此，Spring的HTTP invoker应运而生。HTTP invoker是一个全新的远程调用模型，作为Spring框架的一部分，来执行基于HTTP的远程调用（可穿越防火墙），并使用Java的序列化机制（从而降低开发工作的难度）。当参数或返回值是复杂类型，并且不能通过Hessian的序列化机制序列化时，Http invoker就很有优势。 Spring中相应的支持类是HttpInvokerProxyFactoryBean和HttpInvokerServiceExporter；
3.Hessian。作为一个轻量级分布式组件技术，Hessian采用了自己定义的二进制协议，这似乎与目前业界大量应用SOAP的趋势背道而驰，但对于一些简单的远程访问服务，Hessian足够应对。在Spring中，通过HessianProxyFactoryBean和HessianServiceExporter两个类，我们可以透明地将需要对外提供的服务发布出去，当然这里依旧采用Caucho这家来自California的公司的二进制协议；
4.Burlap。Burlap可以说是Hessian的XML版本。Spring中的支持类包括BurlapProxyFactoryBean和BurlapServiceExporter；
5.JAX RPC(Java APIs for XML-based Remote Procedure Call)。 Spring支持通过JAX RPC访问的Web Service。事实上，Spring对于Web Service的封装相当简单，Spring提供了一个代理工厂Bean：JaxRpcPortProxyFactoryBean，能让你在应用中无缝集成一个web sevice，作为另一个Bean的协作者,JaxRpcPortProxyFactoryBean类用JAX-RPC来访问远程Web Service。
6.JMS。Spring中对应的支持类包括JmsInvokerServiceExporter和JmsInvokerProxyFactoryBean。

    这里，我们着重讨论一下Spring对于Web Service的支持。这种支持包括两方面：
    第一，基于JAX-RPC发布Web Service。
    第二，访问Web Service。

    对于需要发布为Web Service的业务逻辑bean，只需要继承Spring的ServletEndpointSupport 类即可。假设有如下业务接口以及相应的实现类：
public interface SayHello
{
  public String sayHello(String who);
}
public class SayHelloImpl implements SayHello
{
  public String sayHello(String who)
  {
      return "Hello，"+who;
  }
}
如果需要将SayHelloImpl 发布为Web Service，则需要编写一个Web Service类，让该类实现SayHello接口，并继承ServletEndpointSupport类。示例如下：

public class SayHelloEndPoint extends ServletEndpointSupport implements SayHello
{
     
  private SayHello sh;

  protected void onInit()
  {
      this.sh = (SayHello) getWebApplicationContext().getBean("sayHello");
  }

  //将业务逻辑bean的业务方法公开发布为WebService
  public String sayHello(String who) throws RemoteException
  {
      return sh.sayHello(who);
  }
}
   
    而后，定义Spring的配置文件，在配置文件中部署业务bean，示例如下：

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE beans PUBLIC "-//SPRING//DTD BEAN//EN"
  "http://www.springframework.org/dtd/spring-beans.dtd">

<beans>
  <bean id="sayHello" class="com.ws.SayHelloImpl">
        <property name=>
  </bean >
</beans>

    然后修改web.xml文件，让AxisServlet拦截某些请求 ，示例如下：
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE web-app PUBLIC "-//Sun Microsystems, Inc.//DTD WebApplication 2.3//EN"
"http://java.sun.com/dtd/web-app_2_3.dtd">

<web-app>
    <listener>
      <listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
    </listener>

    <!-- 定义AxisServlet-->
  <servlet>
      <servlet-name>AxisServlet</servlet-name>
      <servlet-class>org.apache.axis.transport.http.AxisServlet</servlet-class>
  </servlet>

      <!-- 映射AxisServlet-->
      <servlet-mapping>
            <servlet-name>AxisServlet</servlet-name>
            <url-pattern>/axis/*</url-pattern>
      </servlet-mapping>
</web-app>

    在上述配置文件中，可以看到所有匹配/axis/*模式的请求都由AxisServlet处理。即：Spring发布的Web Service都在放在axis路径下。
    然后编写WSDL文件，或者使用工具生成。WSDL文件如下：

<?xml version="1.0" encoding="UTF-8"?>
<!-- wsdl的根元素，包含schema等信息-->
<deployment xmlns="http://xml.apache.org/axis/wsdd/"
xmlns:java="http://xml.apache.org/axis/wsdd/providers/java">
<!-- wsdl的全局配置-->
      <globalConfiguration>
            <parameter name="adminPassword" value="admin"/>
            <parameter name="sendXsiTypes" value="true"/>
            <parameter name="sendMultiRefs" value="true"/>
            <parameter name="sendXMLDeclaration" value="true"/>
            <parameter name="axis.sendMinimizedElements" value="true"/>
            <requestFlow>
                  <handler type="java:org.apache.axis.handlers.JWSHandler">
                        <parameter name="scope" value="session"/>
                  </handler>
                  <handler type="java:org.apache.axis.handlers.JWSHandler">
                        <parameter name="scope" value="request"/>
                        <parameter name="extension" value=".jwr"/>
                  </handler>
            </requestFlow>
      </globalConfiguration>
      <handler name="Authenticate" type="java:org.apache.axis.handlers.SimpleAuthenticationHandler"/>
      <handler name="LocalResponder" type="java:org.apache.axis.transport.local.LocalResponder"/>
      <handler name="URLMapper" type="java:org.apache.axis.handlers.http.URLMapper"/>
      <!-- 定义WebService的管理台-->
      <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>
      <!-- 定义自己的WebService-->
      <service name="SayHelloService" provider="java:RPC">
            <parameter name="allowedMethods" value="*"/>
            <!-- 定义WebService的实现类-->
            <parameter name="className" value="com.ws.SayHelloEndpoint"/>
      </service>
      <!-- 定义WebSerivice的系统服务。-->
      <service name="Version" provider="java:RPC">
            <parameter name="allowedMethods" value="getVersion"/>
            <parameter name="className" value="org.apache.axis.Version"/>
      </service>
      <transport name="http">
            <requestFlow>
                  <handler type="URLMapper"/>
                  <handler type="java:org.apache.axis.handlers.http.HTTPAuthHandler"/>
            </requestFlow>
      </transport>
      <transport name="local">
            <responseFlow>
                  <handler type="LocalResponder"/>
            </responseFlow>
      </transport>
</deployment>

经过上述这些步骤，可将部署在Spring的普通业务逻辑bean发布成Web Service。

  Spring发布的Web Service是标准的基于SOAP协议的Web Service。因此可以使用标准客户端访问，也可以利用IoC容器来管理Web Service，利用IoC容器时，必须借助于JaxRpcPortProxyFactoryBean。
使用标准客户端访问Web Service非常简单，只需要获得WebService的URL以及方法名即可。根据上面的发布，知道Web Service的URL如下：http://localhost:8080/axis-spring/axis/SayHelloService，则客户端代码示例如下：

public class WebServiceClient
{
  public static void main(String args[])
  {
      System.out.println("开始调用WebService");    
      try
      {
          //WebService所在的URL
          String endpoint = "http://localhost:8080/axis-spring/axis/SayHelloService";
          //创建Service对象，Service对用用于创建Call对象
          Service service = new Service();
          //创建Call对象，Call对象用于调用服务
          Call call = (Call)service.createCall();
        //为Call对象设置WebService的url
          call.setTargetEndpointAddress(new java.net.URL(endpoint));
          //为Call对象设置调用的方法名
          call.setOperationName("sayHello");
          //调用WebService的方法，并获得返回值
          String s = (String)call.invoke(new Object[] {"刘德华"});

          System.out.println(s);
      }
      catch (Exception e)
      {
          System.out.println(e.toString());
      }
      System.out.println("调用Web Service正常结束");    
}
}

而如果利用IoC容器管理WebService，必须借助于JaxRpcPortProxyFactoryBean类，该类是个工厂bean，与所有的工厂bean一样，对该bean的请求将返回它的产品。
配置JaxRpcPortProxyFactoryBean，只需提供WebService的URL、命名空间等必需信息，将可以返回Web Service服务。在Spring配置文件中JaxRpcPortProxyFactoryBean的定义如下：
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE beans PUBLIC "-//SPRING//DTD BEAN//EN"
"http://www.springframework.org/dtd/spring-beans.dtd">
<beans>
      <!-- 配置测试bean-->
  <bean id="test" class="com.ws.Test">
      <property name="sayHello">
          <ref local="sayHelloService"/>
      </property>
</bean>
<!-- 配置WebService bean-->
  <bean id="sayHelloService" class="org.springframework.remoting.jaxrpc.JaxRpcPortProxyFactoryBean">
            <!-- 配置WebService实现的接口-->
      <property name="serviceInterface">
          <value>com.ws.SayHello</value>
      </property>
            <!-- 配置WebService的wsdl的URL-->
      <property name="wsdlDocumentUrl">
          <value>http://localhost:8080/axis-spring/axis/SayHelloService?wsdl</value>
      </property>
            <!-- 配置WebService的命名空间uri-->
      <property name="namespaceUri">
          <value>http://localhost:8080/axis-spring/axis/SayHelloService</value>
      </property>
            <!-- 配置WebService的服务名-->
      <property name="serviceName">
          <value>SayHelloService</value>
      </property>
            <!-- 配置WebService的portName-->
      <property name="portName">
          <value>SayHelloService"</value>
      </property>
  </bean>
</beans>

（声明：本文部分内容来自《Spring Reference》和《Spring 2.0宝典》）