馈送适配器

Spring Integration 通过 Feed 适配器提供对联合的支 持。该实现基于 ROME 框架。

您需要将此依赖项包含到您的项目中

  • Maven

  • Gradle

<dependency>
    <groupId>org.springframework.integration</groupId>
    <artifactId>spring-integration-feed</artifactId>
    <version>6.3.5</version>
</dependency>
compile "org.springframework.integration:spring-integration-feed:6.3.5"

网络联合是一种发布材料的方式，例如新闻报道、新闻稿、博客文章和其他通常在网站上可用，但也以 RSS 或 ATOM 等 Feed 格式提供的项目。

Spring Integration 通过其“Feed”适配器提供对网络联合的支持，并为此提供方便的基于命名空间的配置。要配置“Feed”命名空间，请将以下元素包含在 XML 配置文件的标题中

xmlns:int-feed="http://www.springframework.org/schema/integration/feed"
xsi:schemaLocation="http://www.springframework.org/schema/integration/feed
	https://www.springframework.org/schema/integration/feed/spring-integration-feed.xsd"

Feed 入站通道适配器

您真正需要的唯一适配器来支持检索 Feed 是入站通道适配器。它允许您订阅特定 URL。以下示例显示了可能的配置

  • Java DSL

  • Java

  • XML

@Configuration
@EnableIntegration
public class ContextConfiguration {

    @Value("org/springframework/integration/feed/sample.rss")
    private Resource feedResource;

    @Bean
    public IntegrationFlow feedFlow() {
        return IntegrationFlow
                .from(Feed.inboundAdapter(this.feedResource, "feedTest")
                                .preserveWireFeed(true),
                        e -> e.poller(p -> p.fixedDelay(100)))
                .channel(c -> c.queue("entries"))
                .get();
    }

}
@Bean
@InboundChannelAdapter(inputChannel = "fromFeed")
public FeedEntryMessageSource feedEntrySource() {
    return new FeedEntryMessageSource("https://feeds.bbci.co.uk/news/rss.xml", "metadataKey");
}
<int-feed:inbound-channel-adapter id="feedAdapter"
        channel="feedChannel"
        url="https://feeds.bbci.co.uk/news/rss.xml">
    <int:poller fixed-rate="10000" max-messages-per-poll="100" />
</int-feed:inbound-channel-adapter>

在前面的配置中，我们正在订阅由url属性标识的 URL。

随着新闻项目的检索，它们被转换为消息并发送到由channel属性标识的通道。每条消息的有效负载都是一个com.rometools.rome.feed.synd.SyndEntry实例。每个实例都封装了关于新闻项目的各种数据（内容、日期、作者和其他详细信息）。

入站 Feed 通道适配器是一个轮询使用者。这意味着您必须提供轮询器配置。但是，关于 Feed，您必须了解的一件重要事情是，它的内部工作方式与大多数其他轮询使用者略有不同。启动入站 Feed 适配器时，它会进行第一次轮询并接收com.rometools.rome.feed.synd.SyndFeed实例。该对象包含多个SyndEntry对象。每个条目都存储在本地条目队列中，并根据max-messages-per-poll属性中的值释放，以便每条消息都包含单个条目。如果在从条目队列检索条目期间，队列已为空，则适配器会尝试更新 Feed，从而使用更多条目（SyndEntry实例）填充队列（如果可用）。否则，下次尝试轮询 Feed 将由轮询器的触发器确定（在前面的配置中为每十秒钟一次）。

重复条目

轮询 Feed 可能导致已处理的条目（“我已经阅读了该新闻项目，为什么还要再次显示给我？”）。Spring Integration 提供了一种方便的机制来消除无需担心重复条目的需要。每个 Feed 条目都有一个“发布日期”字段。每次生成并发送新Message时，Spring Integration 会将最新发布日期的值存储在MetadataStore策略的实例中（请参见元数据存储）。metadataKey用于持久化最新的发布日期。

其他选项

从 5.0 版本开始，已弃用的com.rometools.fetcher.FeedFetcher选项已被删除，并为org.springframework.core.io.Resource提供了重载的FeedEntryMessageSource构造函数。当 Feed 源不是 HTTP 端点而是任何其他资源（例如本地或远程 FTP）时，这很有用。在FeedEntryMessageSource逻辑中，此类资源（或提供的URL）由SyndFeedInput解析为SyndFeed对象，用于前面提到的处理。您还可以将自定义的SyndFeedInput（例如，使用allowDoctypes选项）实例注入到FeedEntryMessageSource中。

如果 Feed 连接需要一些自定义，例如连接和读取超时，则必须使用具有其customizeConnection(HttpURLConnection)覆盖的org.springframework.core.io.UrlResource扩展，而不是将普通的URL注入到FeedEntryMessageSource中。例如

@Bean
@InboundChannelAdapter("feedChannel")
FeedEntryMessageSource feedEntrySource() {
    UrlResource urlResource =
	    new UrlResource(url) {

	        @Override
	        protected void customizeConnection(HttpURLConnection connection) throws IOException {
	            super.customizeConnection(connection);
	            connection.setConnectTimeout(10000);
	            connection.setReadTimeout(5000);
	        }
	    };
    return new FeedEntryMessageSource(urlResource, "myKey");
}