Preface
Requirements
本节详细介绍了兼容的 Java 和 Spring Framework 版本。
Code Conventions
Spring Framework 2.0 引入了对命名空间的支持,这简化了应用程序上下文的 XML 配置,并让 Spring Integration 提供广泛的命名空间支持。
在本参考指南中,int
命名空间前缀用于 Spring Integration 的核心命名空间支持。每个 Spring Integration 适配器类型(也称为模块)都提供自己的命名空间,该命名空间使用以下约定进行配置:
下面的示例展示了 int
、int-event
和 int-stream
命名空间的使用:
<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:int="http://www.springframework.org/schema/integration"
xmlns:int-webflux="http://www.springframework.org/schema/integration/webflux"
xmlns:int-stream="http://www.springframework.org/schema/integration/stream"
xsi:schemaLocation="
http://www.springframework.org/schema/beans
https://www.springframework.org/schema/beans/spring-beans.xsd
http://www.springframework.org/schema/integration
https://www.springframework.org/schema/integration/spring-integration.xsd
http://www.springframework.org/schema/integration/webflux
https://www.springframework.org/schema/integration/webflux/spring-integration-webflux.xsd
http://www.springframework.org/schema/integration/stream
https://www.springframework.org/schema/integration/stream/spring-integration-stream.xsd">
…
</beans>
有关 Spring Integration 命名空间支持的详细说明,请参阅 Namespace Support。
可以自由选择名称空间前缀。您甚至可以选择根本不使用任何名称空间前缀。因此,您应当应用最适合您应用程序的约定。不过要注意的是,SpringSource Tool Suite™ (STS) 对 Spring Integration 使用的名称空间约定与本参考指南中使用的相同。 |
Conventions in This Guide
在某些情况下,为了在指定很长的完全限定类名时帮助格式化,我们将 org.springframework
缩写为 o.s
,将 org.springframework.integration
缩写为 o.s.i
,例如,o.s.i.transaction.TransactionSynchronizationFactory
。
Feedback and Contributions
对于如何解决问题、诊断或调试问题,我们建议使用 Stack Overflow。单击 here 以获取最新问题列表。如果您比较确定 Spring Integration 中存在问题,或者想要提出一个新功能,请使用 GitHub Issues。
如果您心中已有解决方案或建议的修复方案,则可以提交拉取请求到 GitHub。但是,请记住,对于所有最基本的问题,我们希望在问题跟踪器中提交工单,其中会进行讨论并为将来的参考留下记录。
有关更多详细信息,请参阅 CONTRIBUTING、顶级项目页上的指南。
Getting Started
如果您刚刚开始使用 Spring Integration,则可能想要通过创建基于 Spring Boot 的应用程序开始。Spring Boot 提供了一种快速(且主观的)方法来创建基于 Spring 的可用于生产环境的应用程序。它基于 Spring Framework,奉行惯例优于配置,并且旨在让您尽快启动并运行。
您可以使用 start.spring.io 生成一个基本项目(添加 integration
作为依赖项),或者按照其中一个 "Getting Started" guides,如 Getting Started Building an Integrating Data。这些指南除了比较容易理解之外,还非常注重于任务,且大多数是以 Spring Boot 为基础的。