Spring Web Services 1.5 有什么新功能?

工程 | Arjen Poutsma | 2008年3月29日 | ...

经过大约六个月的开发,我很高兴地宣布 Spring Web Services 1.5.0 已发布!在这篇文章中,我想介绍一些主要的新功能。

新传输

1.5 版本包含两个新传输:JMS 和电子邮件。使用这些新传输无需更改 Java 代码:只需添加少量配置即可!JMS 传输与 Spring 2 的 消息驱动 POJO 模型完美集成,如下面的配置片段摘自 airline 示例应用程序所示:


<jms:listener-container connection-factory="connectionFactory">
  <jms:listener destination="RequestQueue" ref="messageListener"/>
</jms:listener-container>

<bean id="messageListener" class="org.springframework.ws.transport.jms.WebServiceMessageListener">
  <property name="messageFactory" ref="messageFactory"/>
  <property name="messageReceiver" ref="messageReceiver"/>
</bean>

除了标准的 JMS 配置(连接工厂和要侦听的目标名称)外,您只需定义一个 WebServiceMessageListener,并为其提供一个指向您正在使用的消息工厂(通常是 SaajSoapMessageFactory)和消息分发器的引用。如果您仍在使用 EJB,甚至还有一个 MessageDrivenBean 可供您使用!有关更多详细信息,请参阅 airline 示例或 参考文档

在客户端,同样简单。将 WebServiceTemplate 配置为使用 JmsMessageSender,并指定一个jmsURL 来发送消息。以下是一个示例,再次摘自 airline 示例:


<bean id="jmsClient" class="org.springframework.ws.samples.airline.client.jms.JmsClient">
  <property name="defaultUri" value="jms:RequestQueue"/>
  <property name="messageSenders">
    <bean class="org.springframework.ws.transport.jms.JmsMessageSender">
      <property name="connectionFactory" ref="connectionFactory"/>
    </bean>
  </property>
</bean>

除了 JMS 传输之外,Spring Web Services 1.5 还引入了电子邮件传输,从而符合 Zawinski 的软件封装法则 ;)。此传输将轮询您的 POP3 或 IMAP 服务器以获取新消息,或者(如果您的服务器支持)使用 IMAP IDLE 命令异步接收新消息。

基于 WSS4J 的 WS-Security 实现

另一个新功能是基于 Apache WSS4J 的 WS-Security 实现。在 1.0 版本中,Spring Web Services 已经有一个基于 SUN XWSS 的 WS-Security 实现,但它需要 Java 1.5,并且只能在 SUN JDK 上运行。基于 WSS4J 的解决方案可以在 JDK 1.4(以及 Spring-WS 的其余部分)以及用于 WebSphere 的 IBM JDK 上运行。

有关更多详细信息,请参阅 参考文档

WS-Addressing 支持

WS-Addressing 是一个 W3C 规范,它定义了一种与传输无关的路由机制。它基于To还是ActionSOAP 头部,分别表示 SOAP 消息的目的地和意图。Spring Web Services 1.5.0 实现了一个是 1.0(2006 年 5 月)版本的 WS-Addressing 规范,以及 August 2004 版本(仍然被广泛使用)。

您可以通过 XML(在应用程序上下文中)或通过注解来配置 WS-Addressing。


package samples;

import org.springframework.ws.server.endpoint.annotation.Endpoint;
import org.springframework.ws.soap.addressing.server.annotation.Action

@Endpoint
public class AnnotationOrderEndpoint {
  private final OrderService orderService;

  public AnnotationOrderEndpoint(OrderService orderService) {
    this.orderService = orderService;
  }

  @Action("http://samples/RequestOrder")
  public Order getOrder(OrderRequest orderRequest) {
    return orderService.getOrder(orderRequest.getId());
  }

  @Action("http://samples/CreateOrder")
  public void order(Order order) {
    orderService.createOrder(order);
  }

}

在这种情况下,如果一个 WS-Addressing 消息传入,其中包含一个Actionheader valuehttp://samples/RequestOrder它将调用getOrder()方法。有关更多详细信息,请参阅 stockquote 示例或 参考文档

另一个不错的新功能是,@Endpoints 现在使用 @Component 进行注解,因此如果您正在使用 Spring 2.5 的 组件扫描,**您的端点将被自动拾取**,无需 XML 配置!对于 Spring-WS 组件的配置,我们现在提供两个新命名空间来配置 OXM 编组器和其他常用构造。例如,这是 JAXB2 编组器的配置:


<oxm:jaxb2-marshaller id="marshaller" contextPath="org.springframework.ws.samples.airline.schema"/>

其他新功能

Spring Web Services 1.5 还引入了以下其他新功能:

  • 原生支持 Java 6,包括 JAXP 1.4,以及捆绑的 SAAJ 1.3 和 JAXB 2.0,以及 嵌入式 HTTP 服务器。有关更多详细信息,请参阅 stockquote 示例。
  • Spring-WS jar 现在是 OSGi bundle,使其更易于在基于 OSGi 的应用程序中使用。
  • 一个新的、改进的 XSD 到 WSDL 生成器,它可以内联包含和导入的 XSD,从而使 WSDL 更易于被不遵循这些引用的客户端访问。
  • 一个新的、客户端的拦截机制,包括 WS-Security 支持。
  • 支持 Spring Security

更多信息

如果您想尝试 Spring Web Services 1.5,您可以访问 网站,或者直接访问 下载部分

更新 2008-04-18:更改了 JMS 配置以使用命名空间。

获取 Spring 新闻通讯

通过 Spring 新闻通讯保持联系

订阅

领先一步

VMware 提供培训和认证,助您加速进步。

了解更多

获得支持

Tanzu Spring 提供 OpenJDK™、Spring 和 Apache Tomcat® 的支持和二进制文件,只需一份简单的订阅。

了解更多

即将举行的活动

查看 Spring 社区所有即将举行的活动。

查看所有