|
对于最新稳定版本，请使用spring-cloud-stream 5.0.1！ |
Spring框架的绑定可视化和控制（官方教程）
Spring Cloud Stream支持通过Actuator端点以及程序化方式对绑定进行可视化和控制。
通过编程方式
自版本 3.1 我们公开了org.springframework.cloud.stream.binding.BindingsLifecycleController它被注册为 bean 并且一旦注入就可以用来控制单个绑定的生命周期
例如，查看其中一个测试用例的片段。如您所见，我们从spring应用上下文检索BindingsLifecycleController，并执行各个方法来控制echo-in-0绑定的生命周期。。
BindingsLifecycleController bindingsController = context.getBean(BindingsLifecycleController.class);
Binding binding = bindingsController.queryState("echo-in-0");
assertThat(binding.isRunning()).isTrue();
bindingsController.changeState("echo-in-0", State.STOPPED);
//Alternative way of changing state. For convenience we expose start/stop and pause/resume operations.
//bindingsController.stop("echo-in-0")
assertThat(binding.isRunning()).isFalse();此外，从版本 4.2 开始，您还可以获取消费者和生产者配置属性，以便更动态地管理其值。
您可以根据绑定名称从 BindingsLifecycleController 请求此类属性。
例如。
KafkaConsumerProperties properties = controller.getExtensionProperties("log-in-0”);
RabbitProducerProperties properties = controller.getExtensionProperties(“log-out-0”);代码getExtensionProperties(..)操作用于确保您获得配置属性类的正确类型。
| 依类型的不同，您可能需要重新启动绑定才能使更改生效（如上所述） |
执行器
由于启动程序和 Web 是可选的，因此您必须首先手动添加 Web 依赖项之一以及启动程序依赖项。下面的例子展示了如何为 Web 框架添加依赖项：
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
</dependency>以下示例显示如何添加 WebFlux 框架的依赖项:
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-webflux</artifactId>
</dependency>您可以按如下方式添加Actuator依赖项：
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-actuator</artifactId>
</dependency>| 要在 Cloud Foundry 中运行 Spring Cloud Stream 2.0 应用程序，您必须将 0 和 1 添加到类路径。否则，由于健康检查失败，应用程序将无法启动。 |
还必须通过设置以下属性来启用bindings执行器端点: --management.endpoints.web.exposure.include=bindings。
一旦满足这些前提条件，您应该在启动应用程序时在日志中看到以下内容：
: Mapped "{[/actuator/bindings/{name}],methods=[POST]. . .
: Mapped "{[/actuator/bindings],methods=[GET]. . .
: Mapped "{[/actuator/bindings/{name}],methods=[GET]. . .
要查看当前绑定，请访问以下 URL：
<host>:<port>/actuator/bindings
Alternative, to see a single binding, access one of the URLs similar to the following: <host>:<port>/actuator/bindings/<bindingName>;
您还可以通过在同一个URL上发布state参数作为JSON来停止、启动、暂停和继续单独的绑定，如以下示例所示：
curl -d '{"state":"STOPPED"}' -H "Content-Type: application/json" -X POST http://<host>:<port>/actuator/bindings/myBindingName
curl -d '{"state":"STARTED"}' -H "Content-Type: application/json" -X POST http://<host>:<port>/actuator/bindings/myBindingName
curl -d '{"state":"PAUSED"}' -H "Content-Type: application/json" -X POST http://<host>:<port>/actuator/bindings/myBindingName
curl -d '{"state":"RESUMED"}' -H "Content-Type: application/json" -X POST http://<host>:<port>/actuator/bindings/myBindingName
PAUSED 和 RESUMED 仅在对应的 binder 以及其底层技术支持时生效，否则会在日志中看到警告信息。
目前，仅 Kafka 和 [Solace](github.com/SolaceProducts/solace-spring-cloud/tree/master/solace-spring-cloud-starters/solace-spring-cloud-stream-starter#consumer-bindings-pause resume) binders 支持 PAUSED 和 RESUMED 状态。 |
清理敏感数据
当使用绑定执行器端点时，有时需要对任何敏感数据进行消毒，例如用户凭据、SSL 密钥信息等。要实现这一点，用户可以向应用程序提供一个 0（由 Spring Boot 提供）作为 Bean。这是提供 Apache Kafka 的 1 值时混淆数据的示例。
@Bean
public SanitizingFunction sanitizingFunction() {
return sanitizableData -> {
if (sanitizableData.getKey().equals("sasl.jaas.config")) {
return sanitizableData.withValue("data-scrambled!!");
}
else {
return sanitizableData;
}
};
}