Spring认证指南：如何构建使用Spring Integration来获取数据
原标题：如何构建使用Spring Integration来获取数据，处理数据并将其写入文件的应用程序。（Spring中国教育管理中心）
本指南将引导您完成使用 Spring Integration 创建一个简单的应用程序的过程，该应用程序从 RSS 源（Spring 博客）中检索数据，操作数据，然后将其写入文件。本指南使用传统的 Spring Integration XML 配置。其他指南展示了如何在有或没有 JDK 8 Lambda 表达式的情况下使用 Java 配置和 DSL。
您将构建的内容
您将使用传统的 XML 配置创建具有 Spring 集成的流。
你需要什么
- 约15分钟
- 喜欢的文本编辑器或 IDE
- JDK 1.8或更高版本
- 格拉德尔 4+或梅文 3.2+
- 您还可以将代码直接导入到 IDE 中：
- 弹簧工具套件 （STS）
- IntelliJ IDEA
如何完成本指南
像大多数春天一样入门指南，您可以从头开始并完成每个步骤，也可以绕过您已经熟悉的基本设置步骤。无论哪种方式，你最终都会得到工作代码。
要从头开始，请转到从 Spring Initializr 开始.
要跳过基础知识，请执行以下操作：
- 下载并解压缩本指南的源存储库，或使用Git:git clone https://github.com/spring-guides/gs-integration.git
- 光盘成gs-integration/initial
- 跳到定义集成流.
完成后，您可以根据 中的代码检查结果。gs-integration/complete
从 Spring Initializr 开始
您可以使用它预初始化项目，然后单击生成以下载 ZIP 文件。此项目配置为适合本教程中的示例。
手动初始化项目：
- 导航到https://start.spring.io.此服务提取应用程序所需的所有依赖项，并为您完成大部分设置。
- 选择 Gradle 或 Maven 以及您要使用的语言。本指南假定您选择了 Java。
- 单击依赖关系，然后选择弹簧集成。
- 单击"生成"。
- 下载生成的 ZIP 文件，该文件是使用您的选择配置的 Web 应用程序的存档。
如果您的 IDE 具有 Spring Initializr 集成，则可以从 IDE 完成此过程。
您还可以从 Github 分叉项目，然后在 IDE 或其他编辑器中打开它。
添加到构建文件
对于此示例，您需要添加两个依赖项：
- spring-integration-feed
- spring-integration-file
以下列表显示了最终文件：pom.xml
4.0.0
org.springframework.boot
spring-boot-starter-parent
2.6.3
com.example
integration-complete
0.0.1-SNAPSHOT
integration-complete
Demo project for Spring Boot
1.8
org.springframework.boot
spring-boot-starter-integration
org.springframework.integration
spring-integration-feed
org.springframework.integration
spring-integration-file
org.springframework.boot
spring-boot-starter-test
test
org.springframework.integration
spring-integration-test
test
org.springframework.boot
spring-boot-maven-plugin
以下列表显示了最终文件：build.gradle
plugins {
id 'org.springframework.boot' version '2.6.3'
id 'io.spring.dependency-management' version '1.0.11.RELEASE'
id 'java'
}
group = 'com.example'
version = '0.0.1-SNAPSHOT'
sourceCompatibility = '1.8'
repositories {
mavenCentral()
}
dependencies {
implementation 'org.springframework.boot:spring-boot-starter-integration'
implementation 'org.springframework.integration:spring-integration-feed'
implementation 'org.springframework.integration:spring-integration-file'
testImplementation('org.springframework.boot:spring-boot-starter-test')
testImplementation 'org.springframework.integration:spring-integration-test'
}
test {
useJUnitPlatform()
}定义集成流
对于本指南的示例应用程序，您将定义一个 Spring 集成流，该流：
- 在 spring.io 阅读 RSS 源中的博客文章。
- 将它们转换为易于阅读的，由帖子标题和帖子的URL组成。String
- 将其追加到文件 （） 的末尾。String/tmp/si/SpringBlog
要定义集成流，您可以使用Spring Integration的XML命名空间中的一些元素创建Spring XML配置。具体来说，对于所需的集成流，您可以使用这些 Spring Integration 命名空间中的元素：核心、源和文件。（获得最后两个是我们必须修改Spring Initializr提供的构建文件的原因。
以下 XML 配置文件（来自 ）定义了集成流：
src/main/resources/integration/integration.xml
COPY这里有三个集成元素在起作用：
下图显示了此简单流程：
暂时忽略该属性。稍后在讨论测试时，我们将重新讨论这一点。现在，请注意，默认情况下，它是 ，这意味着在应用程序启动时会提取帖子。另请注意 中的属性占位符。这意味着默认值为，但可以使用属性覆盖。
auto-startuptruefilename-generator-expressionSpringBlog
使应用程序可执行
尽管在较大的应用程序（甚至可能是 Web 应用程序）中配置 Spring 集成流是很常见的，但没有理由不能在更简单的独立应用程序中定义它。这就是您接下来要执行的操作：创建一个主类，该类启动集成流，并声明少量 Bean 以支持集成流。您还将应用程序构建到一个独立的可执行 JAR 文件中。我们使用Spring Boot的注释来创建应用程序上下文。由于本指南将 XML 命名空间用于集成流，因此必须使用注释将其加载到应用程序上下文中。以下列表（从 ）显示了应用程序文件：@SpringBootApplication@
ImportResourcesrc/main/java/com/example/integration/IntegrationApplication.java
package com.example.integration;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.context.ConfigurableApplicationContext;
import org.springframework.context.annotation.ImportResource;
@SpringBootApplication
@ImportResource("/integration/integration.xml")
public class IntegrationApplication {
public static void main(String[] args) throws Exception {
ConfigurableApplicationContext ctx = new SpringApplication(IntegrationApplication.class).run(args);
System.out.println("Hit Enter to terminate");
System.in.read();
ctx.close();
}
}COPY构建可执行的 JAR
您可以使用 Gradle 或 Maven 从命令行运行应用程序。您还可以构建一个包含所有必要依赖项、类和资源的可执行 JAR 文件并运行该文件。通过构建可执行 jar，可以轻松地在整个开发生命周期中跨不同环境等将服务作为应用程序进行交付、版本控制和部署。
如果您使用 Gradle，则可以使用 运行应用程序。或者，您可以使用 JAR 文件构建 JAR 文件，然后运行该 JAR 文件，如下所示：./gradlew bootRun./gradlew build
java -jar build/libs/gs-integration-0.1.0.jar如果使用 Maven，则可以使用 运行应用程序。或者，您可以使用 JAR 文件构建 JAR 文件，然后运行该 JAR 文件，如下所示：./mvnw spring-boot:run./mvnw clean package
java -jar target/gs-integration-0.1.0.jar此处描述的步骤将创建一个可运行的 JAR。您还可以构建经典 WAR 文件.
运行应用程序
现在，您可以通过运行以下命令从 jar 运行应用程序：
java -jar build/libs/{project_id}-0.1.0.jar
... app starts up ...COPY应用程序启动后，它将连接到 RSS 源并开始获取博客文章。应用程序通过您定义的集成流处理这些帖子，最终将帖子信息追加到 文件。/tmp/si/SpringBlog
应用程序运行一段时间后，您应该能够查看文件，以查看少量帖子中的数据。在基于 UNIX 的操作系统上，还可以通过运行以下命令来查看写入结果的文件：/tmp/si/SpringBlogtail
tail -f /tmp/si/SpringBlogCOPY您应该会看到类似于以下示例输出的内容（尽管实际新闻会有所不同）：
Spring Integration Java DSL 1.0 GA Released @ https://spring.io/blog/2014/11/24/spring-integration-java-dsl-1-0-ga-released
This Week in Spring - November 25th, 2014 @ https://spring.io/blog/2014/11/25/this-week-in-spring-november-25th-2014
Spring Integration Java DSL: Line by line tutorial @ https://spring.io/blog/2014/11/25/spring-integration-java-dsl-line-by-line-tutorial
Spring for Apache Hadoop 2.1.0.M2 Released @ https://spring.io/blog/2014/11/14/spring-for-apache-hadoop-2-1-0-m2-releasedCOPY测试
检查项目，您将看到一个测试用例，在：
completesrc/test/java/com/example/integration/FlowTests.java
package com.example.integration;
import static org.assertj.core.api.Assertions.assertThat;
import java.io.BufferedReader;
import java.io.File;
import java.io.FileReader;
import org.junit.jupiter.api.Test;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.test.context.SpringBootTest;
import org.springframework.integration.endpoint.SourcePollingChannelAdapter;
import org.springframework.integration.support.MessageBuilder;
import org.springframework.messaging.MessageChannel;
import com.rometools.rome.feed.synd.SyndEntryImpl;
@SpringBootTest({ "auto.startup=false", // we don't want to start the real feed
"feed.file.name=Test" }) // use a different file
public class FlowTests {
@Autowired
private SourcePollingChannelAdapter newsAdapter;
@Autowired
private MessageChannel news;
@Test
public void test() throws Exception {
assertThat(this.newsAdapter.isRunning()).isFalse();
SyndEntryImpl syndEntry = new SyndEntryImpl();
syndEntry.setTitle("Test Title");
syndEntry.setLink("http://characters/frodo");
File out = new File("/tmp/si/Test");
out.delete();
assertThat(out.exists()).isFalse();
this.news.send(MessageBuilder.withPayload(syndEntry).build());
assertThat(out.exists()).isTrue();
BufferedReader br = new BufferedReader(new FileReader(out));
String line = br.readLine();
assertThat(line).isEqualTo("Test Title @ http://characters/frodo");
br.close();
out.delete();
}
}COPY此测试使用 Spring Boot 的测试支持来设置名为 的属性。通常，依靠网络连接进行测试不是一个好主意，尤其是在 CI 环境中。相反，我们阻止进料适配器启动，并将 a 注入通道中，以便流的其余部分进行处理。测试还会设置 ，以便测试写入其他文件。然后它：
auto.startupfalseSyndEntrynewsfeed.file.name
- 验证适配器是否已停止。
- 创建测试 。SyndEntry
- 删除测试输出文件（如果存在）。
- 发送消息。
- 验证文件是否存在。
- 读取文件并验证数据是否符合预期。
总结
祝贺！您开发了一个简单的应用程序，该应用程序使用Spring Integration从 spring.io 中获取博客文章，处理它们并将其写入文件。