Spring Cloud Stream 简化开发 抛弃繁琐配置 全注解生产与消费

看到这篇文章的你是幸运的,因为不必再去搜索各种SpringCloudStream千篇一律并且繁琐的配置文件。

笔者在经过大量搜索后,发现全网并没有一种好的方式简化Stream的配置。

本文提出一种解决方案,希望能够帮助大家。

最终使用方式

yaml文件

spring:
  cloud:
    stream:
      default:
        group: ${spring.application.name}-${spring.profiles.active}
      rocketmq:
        binder:
          name-server: 127.0.0.1:9876
      其他配置自己找文档...

是的,你没有看错,我们不再需要在配置文件中指定每一个input和output并且为两者绑定destination

启动类配置

//自定义注解
@StreamBindingsScan
@SpringBootApplication
public class Application{
    @Bean
    public BindingsConfig bindingsConfig(BindingServiceProperties bindingServiceProperties) {
        BindingsConfig bindingsConfig = new BindingsConfig();
        bindingsConfig.setBindingServiceProperties(bindingServiceProperties);
        bindingsConfig.resetBindingProperties();
        return bindingsConfig;
    }
}

事件接口

//自定义注解
//bindings接管了真正与中间件交互的topic或者exchange,此处定义的即为在中间件中真实创建的主题或通道
@StreamBindings("test-topic")
public interface TestEventStream {
    
    String INPUT = "test-topic-input";
    String OUTPUT = "test-topic-output";

    //该注解意义在于创建代理Bean放入Spring中,INPUT常量仅存在于Spring中,而非exchange或者topic
    @Input(INPUT)
    SubscribableChannel input();

    //该注解意义在于创建代理Bean放入Spring中,OUTPUT常量仅存在于Spring中,而非exchange或者topic
    @Output(OUTPUT)
    MessageChannel output();
}

创建消费者监听

@EnableBinding({EventStream.class})
public class TestListener {
    @StreamListener(EventStream.INPUT)
    public void consumer(@Payload String msg) {
        System.out.println("收到消息了");
        System.out.println(msg);
    }

}

生产者发出消息

@RestController
@RequestMapping("/app/test")
public class TestController {
    @Autowired
    private TestEventStream eventStream;

    @GetMapping
    public String test() {
        eventStream.output().send(MessageBuilder.withPayload("test msg").build());
        return "success";
    }

}

实现代码

annotation

StreamBindings

import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;

/**
 * 被该注解标注的接口,会注入input与output的绑定关系,绑定值为value
 *
 * @author zhangbowen.mail@gmail.com
 * @since 2021-02-18 21:06
 */
@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.TYPE)
public @interface StreamBindings {
    /**
     * @return 相当于目标地址(destination),即topic or exchange
     */
    String value();
}

StreamBindingsScan

import org.springframework.context.annotation.Import;

import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;

/**
 * 扫描{@link StreamBindings}
 *
 * @author zhangbowen.mail@gmail.com
 * @since 2021-02-18 21:06
 */
@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.TYPE)
@Import(BindingsRegistrar.class)
public @interface StreamBindingsScan {
    /**
     * @return 扫描的包
     */
    String[] basePackages() default {};
}

BindingsRegistrar

import lombok.extern.slf4j.Slf4j;
import org.springframework.beans.BeansException;
import org.springframework.beans.factory.BeanFactory;
import org.springframework.beans.factory.BeanFactoryAware;
import org.springframework.beans.factory.config.BeanDefinitionHolder;
import org.springframework.beans.factory.support.BeanDefinitionRegistry;
import org.springframework.boot.autoconfigure.AutoConfigurationPackages;
import org.springframework.cloud.stream.annotation.Input;
import org.springframework.cloud.stream.annotation.Output;
import org.springframework.cloud.stream.binding.BindingBeanDefinitionRegistryUtils;
import org.springframework.cloud.stream.config.BindingProperties;
import org.springframework.context.ResourceLoaderAware;
import org.springframework.context.annotation.ImportBeanDefinitionRegistrar;
import org.springframework.context.annotation.ScannedGenericBeanDefinition;
import org.springframework.core.annotation.AnnotationAttributes;
import org.springframework.core.annotation.AnnotationUtils;
import org.springframework.core.io.ResourceLoader;
import org.springframework.core.type.AnnotationMetadata;
import org.springframework.core.type.filter.AnnotationTypeFilter;
import org.springframework.util.ClassUtils;
import org.springframework.util.ReflectionUtils;
import org.springframework.util.StringUtils;

import java.util.List;
import java.util.Objects;
import java.util.Set;

/**
 * 扫描所有的StreamBindings,input 与 output 绑定关系注入
 *
 * @author zhangbowen.mail@gmail.com
 * @since 2021-02-18 21:09
 */
@Slf4j
public class BindingsRegistrar implements BeanFactoryAware, ImportBeanDefinitionRegistrar, ResourceLoaderAware {
    private BeanFactory beanFactory;
    private ResourceLoader resourceLoader;

    @Override
    public void setBeanFactory(BeanFactory beanFactory) throws BeansException {
        this.beanFactory = beanFactory;
    }

    @Override
    public void setResourceLoader(ResourceLoader resourceLoader) {
        this.resourceLoader = resourceLoader;
    }

    @Override
    public void registerBeanDefinitions(AnnotationMetadata importingClassMetadata, BeanDefinitionRegistry registry) {
        AnnotationAttributes annotationAttributes = AnnotationAttributes.fromMap(importingClassMetadata.getAnnotationAttributes(StreamBindingsScan.class.getCanonicalName()));
        if (annotationAttributes == null) {
            log.warn("No Any StreamBindingsScan...");
            return;
        }
        ClassPathStreamBindingScanner classPathGrpcServiceScanner = new ClassPathStreamBindingScanner(registry);
        classPathGrpcServiceScanner.setResourceLoader(this.resourceLoader);
        classPathGrpcServiceScanner.addIncludeFilter(new AnnotationTypeFilter(StreamBindings.class));
        List<String> basePackages = AutoConfigurationPackages.get(this.beanFactory);
        for (String pkg : annotationAttributes.getStringArray("basePackages")) {
            if (StringUtils.hasText(pkg)) {
                basePackages.add(pkg);
            }
        }
        Set<BeanDefinitionHolder> beanDefinitions = classPathGrpcServiceScanner.doScan(StringUtils.toStringArray(basePackages));
        if (beanDefinitions.isEmpty()) {
            log.warn("No StreamBindings was found.");
            return;
        }
        processBeanDefinitions(beanDefinitions);
    }

    /**
     * 处理扫描到的StreamBindings
     *
     * @param beanDefinitions beanDefinitions
     */
    private void processBeanDefinitions(Set<BeanDefinitionHolder> beanDefinitions) {
        for (BeanDefinitionHolder beanDefinitionHolder : beanDefinitions) {
            ScannedGenericBeanDefinition definition = (ScannedGenericBeanDefinition) beanDefinitionHolder.getBeanDefinition();
            AnnotationMetadata annotationMetadata = definition.getMetadata();

            String destination = (String) Objects.requireNonNull(annotationMetadata.getAnnotationAttributes(StreamBindings.class.getName())).get("value");

            Class<?> currentClass = ClassUtils.resolveClassName(annotationMetadata.getClassName(), null);
            ReflectionUtils.doWithMethods(currentClass, method -> {
                Input input = AnnotationUtils.findAnnotation(method, Input.class);
                if (input != null) {
                    String name = BindingBeanDefinitionRegistryUtils.getBindingTargetName(input, method);
                    BindingProperties bindingProperties = new BindingProperties();
                    bindingProperties.setDestination(destination);
                    BindingsConfig.cacheMap.put(name, bindingProperties);
                }
                Output output = AnnotationUtils.findAnnotation(method, Output.class);
                if (output != null) {
                    String name = BindingBeanDefinitionRegistryUtils.getBindingTargetName(output, method);
                    BindingProperties bindingProperties = new BindingProperties();
                    bindingProperties.setDestination(destination);
                    BindingsConfig.cacheMap.put(name, bindingProperties);
                }
            });
        }
    }
}

ClassPathStreamBindingScanner


import lombok.extern.slf4j.Slf4j;
import org.springframework.beans.factory.annotation.AnnotatedBeanDefinition;
import org.springframework.beans.factory.config.BeanDefinition;
import org.springframework.beans.factory.config.BeanDefinitionHolder;
import org.springframework.beans.factory.support.BeanDefinitionRegistry;
import org.springframework.context.annotation.ClassPathBeanDefinitionScanner;

import java.util.LinkedHashSet;
import java.util.Set;

/**
 * @author zhangbowen.mail@gmail.com
 * @since 2019/1/15
 */
@Slf4j
public class ClassPathStreamBindingScanner extends ClassPathBeanDefinitionScanner {

    public ClassPathStreamBindingScanner(BeanDefinitionRegistry registry) {
        super(registry, false);
    }

    /**
     * {@inheritDoc}
     */
    @Override
    protected boolean isCandidateComponent(AnnotatedBeanDefinition beanDefinition) {
        return beanDefinition.getMetadata().isInterface() && beanDefinition.getMetadata().isIndependent();
    }


    @Override
    public Set<BeanDefinitionHolder> doScan(String... basePackages) {
        Set<BeanDefinitionHolder> beanDefinitions = new LinkedHashSet<>();
        for (String basePackage : basePackages) {
            Set<BeanDefinition> candidates = findCandidateComponents(basePackage);
            for (BeanDefinition candidate : candidates) {
                BeanDefinitionHolder definitionHolder = new BeanDefinitionHolder(candidate, candidate.getBeanClassName());
                beanDefinitions.add(definitionHolder);
            }
        }
        return beanDefinitions;
    }
}

BindingsConfig

import lombok.Data;
import org.springframework.cloud.stream.config.BindingProperties;
import org.springframework.cloud.stream.config.BindingServiceProperties;
import org.springframework.util.StringUtils;

import java.util.HashMap;
import java.util.Map;

/**
 * 重置bindings配置
 *
 * @author zhangbowen.mail@gmail.com
 * @since 2021-02-18 22:20
 */
@Data
public class BindingsConfig {
    private BindingServiceProperties bindingServiceProperties;
    public static Map<String, BindingProperties> cacheMap = new HashMap<>();

    /**
     * 重置绑定配置
     */
    public void resetBindingProperties() {
        Map<String, BindingProperties> existBindings = bindingServiceProperties.getBindings();
        String defaultGroup = bindingServiceProperties.getGroup("default");
        cacheMap.entrySet().stream().filter(
                item -> existBindings.containsKey(item.getKey())
        ).forEach(item -> {
            String name = item.getKey();
            BindingProperties value = item.getValue();
            BindingProperties existValue = existBindings.get(name);
            existValue.setDestination(value.getDestination());
            String group = StringUtils.isEmpty(defaultGroup) ? value.getDestination() : (defaultGroup + "-" + value.getDestination());
            existValue.setGroup(group);
            existBindings.put(name, existValue);
        });
        cacheMap.clear();
        cacheMap = null;
    }
}

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 203,324评论 5 476
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 85,303评论 2 381
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 150,192评论 0 337
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,555评论 1 273
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,569评论 5 365
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,566评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 37,927评论 3 395
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,583评论 0 257
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,827评论 1 297
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,590评论 2 320
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,669评论 1 329
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,365评论 4 318
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,941评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,928评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,159评论 1 259
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 42,880评论 2 349
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,399评论 2 342

推荐阅读更多精彩内容