全局属性

可以通过在类路径上提供属性文件来覆盖某些全局框架属性。

默认属性可以在 org.springframework.integration.context.IntegrationProperties 类中找到。以下列表显示了默认值

spring.integration.channels.autoCreate=true (1)
spring.integration.channels.maxUnicastSubscribers=0x7fffffff (2)
spring.integration.channels.maxBroadcastSubscribers=0x7fffffff (3)
spring.integration.taskScheduler.poolSize=10 (4)
spring.integration.messagingTemplate.throwExceptionOnLateReply=false (5)
spring.integration.readOnly.headers= (6)
spring.integration.endpoints.noAutoStartup= (7)
spring.integration.channels.error.requireSubscribers=true (8)
spring.integration.channels.error.ignoreFailures=true (9)
spring.integration.endpoints.defaultTimeout=30000 (10)
1 如果为真,则当在应用程序上下文中未明确找到时,input-channel 实例将自动声明为 DirectChannel 实例。
2 设置允许在例如 DirectChannel 上订阅的默认订阅者数量。它可以用来避免无意中将多个端点订阅到同一个通道。可以通过设置 max-subscribers 属性来覆盖单个通道上的此属性。
3 此属性提供允许在例如 PublishSubscribeChannel 上订阅的默认订阅者数量。它可以用来避免无意中将超过预期数量的端点订阅到同一个通道。可以通过设置 max-subscribers 属性来覆盖单个通道上的此属性。
4 默认 taskScheduler bean 中可用的线程数。参见 配置任务调度器
5 当设置为 true 时,到达网关回复通道的消息会在网关未预期回复时(由于发送线程超时或已收到回复)抛出异常。
6 在头复制操作期间,不应填充到 Message 实例中的消息头名称的逗号分隔列表。该列表由 DefaultMessageBuilderFactory bean 使用,并传播到用于通过 MessageBuilder 构建消息的 IntegrationMessageHeaderAccessor 实例(参见 MessageHeaderAccessor API)(参见 MessageBuilder 辅助类)。默认情况下,在消息构建期间,只有 MessageHeaders.IDMessageHeaders.TIMESTAMP 不会被复制。自版本 4.3.2 起。
7 一个逗号分隔的 AbstractEndpoint bean 名称模式列表(xxx*xxx*xxxxxx*yyy),这些模式在应用程序启动期间不应自动启动。您可以稍后通过控制总线(参见 控制总线)按其 bean 名称手动启动这些端点,也可以通过 SmartLifecycleRoleController 按其角色启动(参见 端点角色),或者通过 Lifecycle bean 注入启动。您可以通过指定 auto-startup XML 注解或 autoStartup 注解属性,或在 bean 定义中调用 AbstractEndpoint.setAutoStartup() 来显式覆盖此全局属性的效果。自版本 4.3.12 起。
8 一个布尔标志,指示默认全局 errorChannel 必须使用 requireSubscribers 选项进行配置。自版本 5.4.3 起。有关更多信息,请参见 错误处理
9 一个布尔标志,指示默认全局 errorChannel 必须忽略调度错误并将消息传递给下一个处理程序。自版本 5.5 起。
10 端点中请求和回复超时的默认毫秒数。默认值为 30 秒,以避免无限期阻塞。可以配置为负值以恢复端点中的无限期阻塞行为。自版本 6.2 起。

这些属性可以通过在类路径中添加 /META-INF/spring.integration.properties 文件或为 org.springframework.integration.context.IntegrationProperties 实例添加 IntegrationContextUtils.INTEGRATION_GLOBAL_PROPERTIES_BEAN_NAME bean 来覆盖。您无需提供所有属性,只需提供要覆盖的属性即可。

从 5.1 版本开始,当为 org.springframework.integration 类别启用 DEBUG 逻辑级别时,所有合并的全局属性将在应用程序上下文启动后打印到日志中。输出如下所示

Spring Integration global properties:

spring.integration.endpoints.noAutoStartup=fooService*
spring.integration.taskScheduler.poolSize=20
spring.integration.channels.maxUnicastSubscribers=0x7fffffff
spring.integration.channels.autoCreate=true
spring.integration.channels.maxBroadcastSubscribers=0x7fffffff
spring.integration.readOnly.headers=
spring.integration.messagingTemplate.throwExceptionOnLateReply=true
spring.integration.endpoints.defaultTimeout=-1