JMX 支持

通知监听通道适配器需要一个 JMX ObjectName，用于发布通知的 MBean，此监听器应注册到该 MBean。一个非常简单的配置可能如下所示：

适配器还可以接受对 NotificationFilter 的引用和一个“handback”对象，以提供随每个通知一起传回的上下文。这两个属性都是可选的。扩展前面的示例以包含这些属性以及显式的 MBeanServer bean 名称会生成以下示例：

通知监听通道适配器是事件驱动的，并直接向 MBeanServer 注册。它不需要任何轮询器配置。

通知发布通道适配器相对简单。它在其配置中只需要一个 JMX 对象名称，如下例所示：

它还要求上下文中存在一个 MBeanExporter。这就是为什么前面的示例中也显示了 <context:mbean-export/> 元素。

当消息发送到此适配器的通道时，通知会从消息内容创建。如果有效负载是 String，它将作为通知的 message 文本传递。任何其他有效负载类型将作为通知的 userData 传递。

JMX 通知还有一个 type，它应该是一个点分隔的 String。有两种方法可以提供 type。优先级始终赋予与 JmxHeaders.NOTIFICATION_TYPE 键关联的消息头值。或者，您可以在配置中提供一个备用 default-notification-type 属性，如下例所示：

属性轮询通道适配器在您需要定期检查通过 MBean 作为受管属性可用的某个值时非常有用。您可以像 Spring Integration 中的任何其他轮询适配器一样配置轮询器（或者您可以依赖默认轮询器）。object-name 和 attribute-name 是必需的。MBeanServer 引用也是必需的。但是，默认情况下，它会自动检查名为 mbeanServer 的 bean，与前面描述的通知监听通道适配器 通知监听通道适配器 相同。以下示例展示了如何使用 XML 配置属性轮询通道适配器：

树形轮询通道适配器查询 JMX MBean 树并发送一个消息，其有效负载是与查询匹配的对象图。默认情况下，MBeans 映射到基本类型和简单对象，例如 Map、List 和数组。这样做允许简单地转换为（例如）JSON。MBeanServer 引用也是必需的。但是，默认情况下，它会自动检查名为 mbeanServer 的 bean，与前面描述的通知监听通道适配器 通知监听通道适配器 相同。以下示例展示了如何使用 XML 配置树形轮询通道适配器：

前面的示例包含所选 MBean 上的所有属性。您可以通过提供一个配置了适当过滤器的 MBeanObjectConverter 来过滤属性。您可以通过使用 converter 属性引用 bean 定义来提供转换器，或者您可以使用内部的 <bean/> 定义。Spring Integration 提供了一个 DefaultMBeanObjectConverter，它可以在其构造函数参数中接受 MBeanAttributeFilter。

Spring Integration 提供了两个标准过滤器。NamedFieldsMBeanAttributeFilter 允许您指定要包含的属性列表。NotNamedFieldsMBeanAttributeFilter 允许您指定要排除的属性列表。您还可以实现自己的过滤器。

操作调用通道适配器允许消息驱动地调用 MBean 公开的任何受管操作。每次调用都需要要调用的操作名称和目标 MBean 的对象名称。这两个必须通过适配器配置或通过 JmxHeaders.OBJECT_NAME 和 JmxHeaders.OPERATION_NAME 消息头显式提供：

然后，适配器只需要能够发现 mbeanServer bean。如果需要不同的 bean 名称，则提供带有引用的 mbean-server 属性。

消息的有效负载映射到操作的参数（如果有）。带有 String 键的 Map 类型有效负载被视为名称/值对，而 List 或数组作为简单的参数列表传递（没有显式参数名称）。如果操作需要单个参数值，则有效负载可以表示该单个值。此外，如果操作不需要参数，则有效负载将被忽略。

如果您想为单个通用操作公开一个通道，该操作由不需要包含头的消息调用，那么最后一个选项效果很好。

与操作调用通道适配器类似，Spring Integration 还提供了一个操作调用出站网关，当处理非 void 操作需要返回值时可以使用。返回值作为消息有效负载发送到网关指定的 reply-channel。以下示例展示了如何使用 XML 配置操作调用出站网关：

如果您不提供 reply-channel 属性，则回复消息将发送到由 IntegrationMessageHeaderAccessor.REPLY_CHANNEL 头标识的通道。该头通常由消息流的入口点（例如任何网关组件）自动创建。但是，如果消息流是通过手动创建 Spring Integration 消息并直接将其发送到通道来启动的，则必须显式指定消息头或使用 reply-channel 属性。

当配置 IntegrationMBeanExporter 时，Spring Integration 组件本身可以作为 MBean 公开。要创建 IntegrationMBeanExporter 的实例，请定义一个 bean 并提供对 MBeanServer 和域名的引用（如果需要）。您可以省略域，在这种情况下，默认域是 org.springframework.integration。以下示例展示了如何声明 IntegrationMBeanExporter 的实例和关联的 MBeanServer 实例：

Spring Integration 4.0 引入了 @EnableIntegrationMBeanExport 注解，允许在 @Configuration 类级别方便地配置一个默认的 integrationMbeanExporter bean，类型为 IntegrationMBeanExporter，并带有几个有用的选项。以下示例展示了如何配置此 bean：

如果您需要提供更多选项或有多个 IntegrationMBeanExporter bean（例如，用于不同的 MBean 服务器或避免与标准 Spring MBeanExporter 冲突——例如通过 @EnableMBeanExport），您可以将 IntegrationMBeanExporter 配置为通用 bean。