基于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宝典》)

阅读更多
个人分类: 转载文章
上一篇以WEB方式监控平台运行情况
下一篇Java远程通讯可选技术及原理
想对作者说点什么? 我来说一句

没有更多推荐了,返回首页

关闭
关闭
关闭