美文网首页springboot
一步一步教你使用Spring框架中的事件订阅发布

一步一步教你使用Spring框架中的事件订阅发布

作者: 码农小胖哥 | 来源:发表于2019-12-31 10:26 被阅读0次

    1. 前言

    Java 开发中有些逻辑是这样的,完成了A操作,再继续B操作,在继续C操作。这么描述好像有点不清楚。打个比方把,你吃晚饭,通知你老婆(女友)来收碗筷,然后通知你的线上兄弟告诉他们你回来了准备开黑。至于你老婆(女友)来不来收拾无所谓,反正你告诉她了。至于你兄弟你也是通知他们,人家也不一定组你,万一他们正在跟一个一拖三的carry大佬玩的正起劲儿呢。

    2. 事件的概念

    吃晚饭就是一个所谓的事件。触发了随后的两个操作,他们只存在因果关系。但是它们互不干扰,各自为政。一个完整的事件由 事件源、事件发布、事件监听 组成。 接下来我们聊聊 Spring 中的事件。

    3. Spring 中的事件

    Spring 框架中使用了大量的事件机制,比如 Spring Boot 的启动。方便起见我们新建一个 Spring Boot 工程。然后跟着我一步步的来进行事件的操作。

    3.1 声明事件

    • 声明一个事件。通过继承 org.springframework.context.ApplicationEvent 来编写事件。时间里定义好事件推送到监听器需要执行的方法,当然也可以在监听器里写触发逻辑。我们来声明一下:
    package cn.felord.boot.event;
    
    import lombok.extern.slf4j.Slf4j;
    import org.springframework.context.ApplicationEvent;
    import org.springframework.context.ApplicationListener;
    
    /**
     * 吃饭事件
     *
     * @author dax
     * @since 2019 /7/8 21:54
     */
    @Slf4j
    public class EatEvent extends ApplicationEvent {
        private Boolean eatFinished;
    
    
        /**
         * Instantiates a new Eat event.
         *
         * @param eatFinished 吃饭是否完成的信号 这里也可以传递其他资源
         */
        public EatEvent(Boolean eatFinished) {
            super(eatFinished);
            this.eatFinished = eatFinished;
        }
    
        /**
         * 这里会由对应监听器{@link ApplicationListener<EatEvent>} 执行
         *
         * 叫女友收拾碗筷.
         */
        public void callGirlFriend() {
            log.info("亲爱的! 我吃完饭了,来收拾收拾吧");
        }
    
        /**
         * 这里会由对应监听器{@link ApplicationListener<EatEvent>} 执行
         * 呼叫兄弟开黑.
         */
        public void callBrothers() {
            log.info("兄弟们! 我吃完饭了,带我开黑");
        }
    
        /**
         * 吃晚饭的信号.
         *
         * @return the boolean
         */
        public Boolean isEatFinished() {
            return this.eatFinished;
        }
    }
    

    3.2 事件发布

    发布事件通过实现事件发布接口 org.springframework.context.ApplicationEventPublisher 或者其门面接口 org.springframework.context.ApplicationEventPublisherAware, 推荐门面接口,里面要定义一个主动推送事件的方法如下面的 refreshEvent 方法,实际代理了 ApplicationEventPublisher 执行其 publishEvent 方法:

    package cn.felord.boot.event;
    
    import lombok.extern.slf4j.Slf4j;
    import org.springframework.context.ApplicationEvent;
    import org.springframework.context.ApplicationEventPublisher;
    import org.springframework.context.ApplicationEventPublisherAware;
    
    /**
     * 发布事件 发布事件通过实现 事件发布接口 {@link ApplicationEventPublisher}
     * 或者通过门面接口{@link ApplicationEventPublisherAware}
     * 推荐按照下面的实现方式,而且该类需要注册为spring bean
     *
     * @author dax
     * @since 2019 /7/8 22:04
     */
    @Slf4j
    public class EatEventPublisherAware implements ApplicationEventPublisherAware {
        private ApplicationEventPublisher applicationEventPublisher;
    
        private ApplicationEvent eatEvent;
    
        public EatEventPublisherAware(ApplicationEvent eatEvent) {
            this.eatEvent = eatEvent;
        }
    
        @Override
        public void setApplicationEventPublisher(ApplicationEventPublisher applicationEventPublisher) {
            this.applicationEventPublisher = applicationEventPublisher;
        }
    
        /**
         * 发送事件动作   事件的动作需要主动触发  调用此方法进行事件触发
         * 代理{@link ApplicationEventPublisher#publishEvent(ApplicationEvent)}
         */
        public void refreshEvent() {
            log.info("发送事件中……");
            this.applicationEventPublisher.publishEvent(eatEvent);
        }
    
    }
    

    3.3 事件监听

    事件监听用来监听事件以触发相关的逻辑。通过实现 org.springframework.context.ApplicationListener<E extends ApplicationEvent> 来实现事件的监听。特别注意泛型E,如果不指定事件将可以接收任何事件,尽量职责单一。

    package cn.felord.boot.event;
    
    import lombok.extern.slf4j.Slf4j;
    import org.springframework.context.ApplicationListener;
    
    /**
     * {@link EatEvent}事件的专属事件监听器
     * @author dax
     * @since 2019/7/8 22:11
     */
    @Slf4j
    public class EatEventListener implements ApplicationListener<EatEvent> {
        @Override
        public void onApplicationEvent(EatEvent eatEvent) {
            //如果吃完饭了
            if (eatEvent.isEatFinished()) {
                eatEvent.callGirlFriend();
                log.error("来自母老虎的咆哮:滚犊子");
                eatEvent.callBrothers();
                log.error("太晚了,我们已经满了,明天带你");
                log.info("还是关注一下 【码农小胖哥】 学习点新知识吧");
            }
        }
    }
    

    3.4 注入Spring IoC

    将上面三个类注入 Spring 容器中,这里我们采用了 JavaConfig 方式,看起来更明显。

    package cn.felord.boot.config;
    
    import cn.felord.boot.event.EatEvent;
    import cn.felord.boot.event.EatEventListener;
    import cn.felord.boot.event.EatEventPublisherAware;
    import org.springframework.context.ApplicationEvent;
    import org.springframework.context.ApplicationEventPublisherAware;
    import org.springframework.context.ApplicationListener;
    import org.springframework.context.annotation.Bean;
    import org.springframework.context.annotation.Configuration;
    
    /**
     * 这三个一定要配置成bean
     *
     * @author dax
     * @since 2019/7/8 22:16
     */
    @Configuration
    public class EventConfig {
    
        @Bean
        public ApplicationEvent eatEvent() {
            return new EatEvent(true);
        }
    
        @Bean
        public ApplicationListener eatEventListener() {
            return new EatEventListener();
        }
    
        @Bean
        public ApplicationEventPublisherAware eatEventPublisherAware(ApplicationEvent eatEvent) {
            return new EatEventPublisherAware(eatEvent);
        }
    
    }
    

    4. 测试

    这里就大功告成了,那么如何使用呢,执行事件发布器的发布方法 refreshEvent 就行了,事件监听器监听到事件会自动响应。我们来写一个单元测试。

    package cn.felord.boot;
    
    import cn.felord.boot.event.EatEventPublisherAware;
    import org.junit.Test;
    import org.junit.runner.RunWith;
    import org.springframework.boot.test.context.SpringBootTest;
    import org.springframework.test.context.junit4.SpringRunner;
    
    import javax.annotation.Resource;
    
    @RunWith(SpringRunner.class)
    @SpringBootTest
    public class EventSpringApplicationTests {
    @Resource
    private EatEventPublisherAware eatEventPublisherAware;
        @Test
        public void contextLoads() {
    
            eatEventPublisherAware.refreshEvent();
        }
    
    }
    

    运行一下,入图

    到此你应该就学会使用 Spring 事件了,这样写出来的代码逼格更高。还能提现你对 Spring 框架的一些理解。当然还有一种更加简单的、基于注解的方式,这里不再阐述。相关代码在我的 码云仓库

    关注公众号:码农小胖哥,获取更多资讯

    个人博客:https://felord.cn

    相关文章

      网友评论

        本文标题:一步一步教你使用Spring框架中的事件订阅发布

        本文链接:https://www.haomeiwen.com/subject/tfkboctx.html