StreamsBuilderFactoryBean 配置器
通常需要自定义创建 KafkaStreams
对象的 StreamsBuilderFactoryBean
。
基于 Spring Kafka 提供的底层支持,绑定器允许您自定义 StreamsBuilderFactoryBean
。
您可以使用 StreamsBuilderFactoryBeanConfigurer
来自定义 StreamsBuilderFactoryBean
本身。
然后,一旦您通过此配置器访问到 StreamsBuilderFactoryBean
,您就可以使用 KafkaStreamsCustomizer
来自定义相应的 KafkaStreams
。
这两个自定义器都是 Spring for Apache Kafka 项目的一部分。
以下是使用 StreamsBuilderFactoryBeanConfigurer
的示例。
@Bean
public StreamsBuilderFactoryBeanConfigurer streamsBuilderFactoryBeanConfigurer() {
return sfb -> sfb.setStateListener((newState, oldState) -> {
//Do some action here!
});
}
上述示例旨在说明您可以自定义 StreamsBuilderFactoryBean
的方式。
您基本上可以调用 StreamsBuilderFactoryBean
中任何可用的修改操作来对其进行自定义。
此自定义器将在工厂 bean 启动之前由绑定器调用。
一旦您访问到 StreamsBuilderFactoryBean
,您还可以自定义底层的 KafkaStreams
对象。
以下是实现此目的的蓝图。
@Bean
public StreamsBuilderFactoryBeanConfigurer streamsBuilderFactoryBeanConfigurer() {
return factoryBean -> {
factoryBean.setKafkaStreamsCustomizer(new KafkaStreamsCustomizer() {
@Override
public void customize(KafkaStreams kafkaStreams) {
kafkaStreams.setUncaughtExceptionHandler((t, e) -> {
});
}
});
};
}
KafkaStreamsCustomizer
将在底层的 KafkaStreams
启动之前由 StreamsBuilderFactoryBeabn
调用。
整个应用程序中只能有一个 StreamsBuilderFactoryBeanConfigurer
。
那么,我们如何处理多个 Kafka Streams 处理器呢?因为它们中的每一个都由单独的 StreamsBuilderFactoryBean
对象支持。
在这种情况下,如果这些处理器需要不同的自定义,那么应用程序需要根据应用程序 ID 应用一些过滤器。
例如,
@Bean
public StreamsBuilderFactoryBeanConfigurer streamsBuilderFactoryBeanConfigurer() {
return factoryBean -> {
if (factoryBean.getStreamsConfiguration().getProperty(StreamsConfig.APPLICATION_ID_CONFIG)
.equals("processor1-application-id")) {
factoryBean.setKafkaStreamsCustomizer(new KafkaStreamsCustomizer() {
@Override
public void customize(KafkaStreams kafkaStreams) {
kafkaStreams.setUncaughtExceptionHandler((t, e) -> {
});
}
});
}
};
使用 StreamsBuilderFactoryBeanConfigurer 注册全局状态存储
如上所述,绑定器不提供一流的方式来注册全局状态存储作为一项功能。
为此,您需要通过 StreamsBuilderFactoryBeanConfigurer
使用自定义器。
以下是实现方法。
@Bean
public StreamsBuilderFactoryBeanConfigurer customizer() {
return streamsBuilderFactoryBean -> {
try {
streamsBuilderFactoryBean.setInfrastructureCustomizer(new KafkaStreamsInfrastructureCustomizer() {
@Override
public void configureBuilder(StreamsBuilder builder) {
builder.addGlobalStore(
...
);
}
});
}
catch (Exception e) {
}
};
}
任何对 StreamsBuilder
的自定义都必须通过 KafkaStreamsInfrastructureCustomizer
完成,如上所示。
如果调用 StreamsBuilderFactoryBean#getObject()
来访问 StreamsBuilder
对象,这可能无法奏效,因为 bean 可能处于初始化阶段,从而导致一些循环依赖问题。
如果您有多个处理器,您需要通过使用上面概述的应用程序 ID 过滤掉其他 StreamsBuilderFactoryBean
对象,将全局状态存储附加到正确的 StreamsBuilder
。
使用 StreamsBuilderFactoryBeanConfigurer 注册生产异常处理器
在错误处理部分,我们指出绑定器不提供一流的方式来处理生产异常。
尽管如此,您仍然可以使用 StreamsBuilderFactoryBean
自定义器来注册生产异常处理器。见下文。
@Bean
public StreamsBuilderFactoryBeanConfigurer configurer() {
return fb -> {
fb.getStreamsConfiguration().put(StreamsConfig.DEFAULT_PRODUCTION_EXCEPTION_HANDLER_CLASS_CONFIG,
CustomProductionExceptionHandler.class);
};
}
同样,如果您有多个处理器,您可能需要针对正确的 StreamsBuilderFactoryBean
进行适当设置。
您也可以使用配置属性添加此类生产异常处理器(有关详细信息,请参见下文),但如果您选择编程方法,这是一个选项。