Guava库学习:学习Guava EventBus(二)EventBus 事件订阅示例

Stella981
• 阅读 904

    原文地址:Guava库学习:学习Guava EventBus(二)EventBus 事件订阅示例

上一篇Guava库学习:学习Guava EventBus(一)EventBus,我们简单的对Guava基于事件的编程进行了介绍,学习和了解了EventBus类的使用,本篇起,我们通过一系列的示例代码深入的学习EventBus类,本篇学习Guava EventBus(二)EventBus 事件订阅示例。

订阅Subscribe

首先,我们假定定义了如下所示的TradeAccountEvent类,如下:

public class TradeAccountEvent {
    private double amount;
    private Date tradeExecutionTime;
    private TradeType tradeType;
    private TradeAccount tradeAccount;
    public TradeAccountEvent(TradeAccount account, double amount,
                             Date tradeExecutionTime, TradeType tradeType) {
        checkArgument(amount > 0.0, "Trade can't be less than zero");
        this.amount = amount;
        this.tradeExecutionTime =
                checkNotNull(tradeExecutionTime, "ExecutionTime can't be null");
        this.tradeAccount = checkNotNull(account, "Account can't be null ");
        this.tradeType = checkNotNull(tradeType, "TradeType can't be null ");
    }
    //Details left out for clarity
}

每当执行买卖交易时,我们都将创建TradeAccountEvent类的一个实例。现在,假定我们有一个需要审计的交易,并且正在执行,所以我们需要有这样一个SimpleTradeAuditor类,如下所示:

    public class SimpleTradeAuditor {
        private List<TradeAccountEvent> tradeEvents =
                Lists.newArrayList();
        public SimpleTradeAuditor(EventBus eventBus) {
            eventBus.register(this);
        }
        @Subscribe
        public void auditTrade(TradeAccountEvent tradeAccountEvent) {
            tradeEvents.add(tradeAccountEvent);
            System.out.println("Received trade " + tradeAccountEvent);
        }
    }

    这里简单的分析一下上面的代码。在SimpleTradeAuditor的构造方法中,我们接收了EventBus类的一个实例,并且通过EventBus立即注册了SimpleTradeAuditor类,来接收TradeAccountEvents类的通知。我们通过在auditTrade方法上添加@Subscribe注解,来指定auditTrade作为事件处理方法。在上面的例子中,我们只是简单的把TradeAccountEvent对象添加到一个list,并简单的输出到控制台。

发布Publishing

    首先来看下面的示例代码,代码如下:

    public class SimpleTradeExecutor {
        private EventBus eventBus;
        public SimpleTradeExecutor(EventBus eventBus) {
            this.eventBus = eventBus;
        }
        public void executeTrade(TradeAccount tradeAccount, double
                amount, TradeType tradeType) {
            TradeAccountEvent tradeAccountEvent =
                    processTrade(tradeAccount, amount, tradeType);
            eventBus.post(tradeAccountEvent);
        }
        private TradeAccountEvent processTrade(TradeAccount
                                                       tradeAccount, double amount, TradeType tradeType) {
            Date executionTime = new Date();
            String message = String.format("Processed trade for %s of amount %n type %s @%s", tradeAccount, amount, tradeType, executionTime);
            TradeAccountEvent tradeAccountEvent = new TradeAccountEvent(tradeAccount, amount, executionTime, tradeType);
            System.out.println(message);
            return tradeAccountEvent;
        }
    }

    与SimpleTradeAuditor类相似,我们也通过EventBus实例,构造了SimpleTradeExecutor。但是与SimpleTradeAuditor类不同的是,我们保存了一份EventBus的引用以备后用。你可能看到过很多类似的编码,对于相同实例在两个类之间的传递,这是至关重要的。在以后的示例中,我们将会介绍使用多个EventBus实例,在本篇的例子中, 我们使用单个EventBus实例。

在上面的例子中,SimpleTradeExecutor类,有一个公共的executeTrade方法,它接收了用来处理交易所需要的所有信息。我们调用processTrade方法传递所需的信息,当执行交易的时候打印信息到控制台,然后返回一个TradeAccountEvent实例。当processTrade方法执行完成,我们调用EventBus.post()方法发布返回的TradeAccountEvent实例,并通知所有TradeAccountEvent对象的订阅者。如果我们快速的比较下SimpleTradeAuditor和SimpleTradeExecutor类,我们看到,虽然两个类都参与共享所需的信息,但是它们彼此之间没有任何的耦合。

更细粒度的订阅

    上面我们看到了使用EventBus类进行发布和订阅的简单例子,EventBus基于类型发布事件,这些类型被订阅的方法接受。这让我们能够灵活的将事件发送给不同的用户类型。例如,我们需要单独的进行买卖交易的审计。首先,我们需要创建两个不同类型的事件。

    public class SellEvent extends TradeAccountEvent {
        public SellEvent(TradeAccount tradeAccount, double amount, Date
                tradExecutionTime) {
            super(tradeAccount, amount, tradExecutionTime, TradeType.SELL);
        }
    }
    public class BuyEvent extends TradeAccountEvent {
        public BuyEvent(TradeAccount tradeAccount, double amount, Date
                tradExecutionTime) {
            super(tradeAccount, amount, tradExecutionTime, TradeType.BUY);
        }
    }

现在我们已经创建了两个离散事件类:SellEvent和BuyEvent,他们都继承了TradeAccountEvent类。为了实现单独的审计,我们首先为审计SellEvent类创建一个实例:

    public class TradeSellAuditor {
        private List<SellEvent> sellEvents = Lists.newArrayList();
        public TradeSellAuditor(EventBus eventBus) {
            eventBus.register(this);
        }
        @Subscribe
        public void auditSell(SellEvent sellEvent){
            sellEvents.add(sellEvent);
            System.out.println("Received SellEvent "+sellEvent);
        }
        public List<SellEvent> getSellEvents() {
            return sellEvents;
        }
    }

我们看到,上面的TradeSellAuditor非常类似于SimpleTradeAuditor,不过TradeSellAuditor 只会接收SellEvent实例。接下来,我们创建一个只审计BuyEvent类的实例:

    public class TradeBuyAuditor {
        private List<BuyEvent> buyEvents = Lists.newArrayList();
        public TradeBuyAuditor(EventBus eventBus) {
            eventBus.register(this);
        }
        @Subscribe
        public void auditBuy(BuyEvent buyEvent){
            buyEvents.add(buyEvent);
            System.out.println("Received TradeBuyEvent "+buyEvent);
        }
        public List<BuyEvent> getBuyEvents() {
            return buyEvents;
        }
    }

下面,我们简单的修改一下SimpleTradeExecutor类的代码,使其能够根据交易的类型来创建正确的TradeAccountEvent实例,代码如下:

   public class BuySellTradeExecutor {
        private EventBus eventBus;
        public BuySellTradeExecutor(EventBus eventBus) {
            this.eventBus = eventBus;
        }
        public void executeTrade(TradeAccount tradeAccount, double
                amount, TradeType tradeType) {
            TradeAccountEvent tradeAccountEvent =
                    processTrade(tradeAccount, amount, tradeType);
            eventBus.post(tradeAccountEvent);
        }
        private TradeAccountEvent processTrade(TradeAccount
                                                       tradeAccount, double amount, TradeType tradeType) {
            Date executionTime = new Date();
            String message = String.format("Processed trade for %s of amount %n type %s @%s", tradeAccount, amount, tradeType, executionTime);
            TradeAccountEvent tradeAccountEvent;
            if (tradeType.equals(TradeType.BUY)) {
                tradeAccountEvent = new BuyEvent(tradeAccount, amount,
                        executionTime);
            } else {
                tradeAccountEvent = new SellEvent(tradeAccount,
                        amount, executionTime);
            }
            System.out.println(message);
            return tradeAccountEvent;
        }
    }

    这样我们就已经创建了一个新的BuySellTradeExecutor类,根据交易的类型,我们将创建相应的BuyEvent或SellEvent实例,它的作用与我们之前的SimpleTradeExecutor类相似。但是,EventBus类是完全没有意识到这些变化的。我们注册了不同的订阅者并发布了不同的事件,这些变化对EventBus类来说是透明的。

注意,我们不需要为这些事件的通知创建单独的类。我们的SimpleTradeAuditor类会在事件发生时继续接收这些通知。如果我们想根据事件的类型做单独的处理,我们可以简单的添加一个检查事件的类型。最后,如果需要,我们也可以定义一个类有多个订阅方法:

        public class AllTradesAuditor {
            private List<BuyEvent> buyEvents = Lists.newArrayList();
            private List<SellEvent> sellEvents = Lists.newArrayList();
            public AllTradesAuditor(EventBus eventBus) {
                eventBus.register(this);
            }
            @Subscribe
            public void auditSell(SellEvent sellEvent) {
                sellEvents.add(sellEvent);
                System.out.println("Received TradeSellEvent " + sellEvent);
            }
            @Subscribe
            public void auditBuy(BuyEvent buyEvent) {
                buyEvents.add(buyEvent);
                System.out.println("Received TradeBuyEvent " + buyEvent);
            }
        }

    上面我们创建了一个包含两个事件处理方法的类,AllTradesAuditor方法将接收所有交易事件的通知,它只是一个被EventBus(基于事件类型)调用的方法。采取一个极端,我们可以创建一个事件处理方法,该方法接受一个Object类型的对象,Object在java中是所有对象的父类,这样我们就可以接收任何和所有由EventBus处理的事件的通知了。最后,没有什么能够阻止我们拥有多个EventBus实例。如果我们要重构BuySellTradeExecutor类成两个独立的类,我们可以为每个类注入一个单独的EventBus实例。那么它将是一个注入正确EventBus实例审计类的方法,我们就有了一套完整独立的发布-订阅事件。

取消订阅

    正如我们想订阅事件,有些情况下我们可能需要取消事件的订阅。可以通过订阅对象的eventbus.unregister方法实现。例如,如果我们需要取消订阅事件,我们可以将下面的方法添加到我们的订阅类:

        public void unregister(){
            this.eventBus.unregister(this);
        }

    一旦调用此方法,该特定实例将停止接收无论多久以前注册的事件。其他注册了相同事件的实例则会继续接收通知。

异步EventBus

    Eventbus处理所有的事件都以串行的方式,这种事件处理方法确保了处理的轻量性。不过,我们仍然有另外的选择AsyncEventBus,AsyncEventBus类提供了与EcentBus相同的功能,但是使用了java.util.concurrent.executor实例来进行方法的异步处理。

    我们可以通过类似于EventBus实例的方式,创建一个AsyncEventBus实例:

    AsyncEventBus asyncEventBus = new AsyncEventBus(executorService);

    上面我们通过一个ExecutorService实例创建了AsyncEventBus实例,除了ExecutorService实例,也可以通过提供一个字符串标识符创建AsyncEventBus。当我们的订阅者在接收事件时需要执行繁重的处理时,使用AsyncEventBus会很有用。

DeadEvents

    当EventBus收到事件通过post方法发送的通知,并且没有注册的订阅者,那么事件则是被DeadEvent类的一个实例包裹。当试图确保所有的事件都有注册的订阅者时,有一个DeadEvents实例的订阅类是非常有用的。DeadEvents类提供了一个公共的getEvent方法,可以用来检查那些未交付的原始事件。例如,我们可以通过下面的方式创建一个非常简单的例子:

    public class DeadEventSubscriber {
        public DeadEventSubscriber(EventBus eventBus) {
            eventBus.register(this);
        }
        @Subscribe
        public void handleUnsubscribedEvent(DeadEvent deadEvent) {
            System.out.println("No subscribers for " + deadEvent.getEvent());
        }
    }

    上面简单的对任何DeadEvent实例进行了注册,并记录了那些没有订阅者的事件。

Dependency injection依赖注入

    为了确保我们为相同的EventBus实例注册了订阅者和发布者,使用依赖注入框架(Spring或Guice)显得很有意义。接下来的例子中,我们会介绍怎么配置Spring框架在SimpleTradeAuditor和SimpleTradeExecutor类。首先,我们对SimpleTradeAuditor和SimpleTradeExecutor类做如下的修改:

    @Component
    public class SimpleTradeAuditor {
        private List<TradeAccountEvent> tradeEvents =
                Lists.newArrayList();
        @Autowired
        public SimpleTradeAuditor(EventBus eventBus) {
            eventBus.register(this);
        }
        @Subscribe
        public void auditTrade(TradeAccountEvent tradeAccountEvent) {
            tradeEvents.add(tradeAccountEvent);
            System.out.println("Received trade " + tradeAccountEvent);
        }
    }

    @Component
    public class SimpleTradeExecutor {
        private EventBus eventBus;
        @Autowired
        public SimpleTradeExecutor(EventBus eventBus) {
            this.eventBus = eventBus;
        }
        public void executeTrade(TradeAccount tradeAccount, double
                amount, TradeType tradeType) {
            TradeAccountEvent tradeAccountEvent =
                    processTrade(tradeAccount, amount, tradeType);
            eventBus.post(tradeAccountEvent);
        }
        private TradeAccountEvent processTrade(TradeAccount
                                                       tradeAccount, double amount, TradeType tradeType) {
            Date executionTime = new Date();
            String message = String.format("Processed trade for %s of amount %n type %s @%s", tradeAccount, amount, tradeType, executionTime);
            TradeAccountEvent tradeAccountEvent = new TradeAccountEvent(tradeAccount, amount, executionTime, tradeType);
            System.out.println(message);
            return tradeAccountEvent;
        }
    }

上面我们简单的为两个类添加了类级别的@Component注解,这是为了使Spring将这些我们想注入的类作为bean。这样,我们就需要使用构造注入,所以在两个类的构造方法上添加了@Autowired注解,@Autowired告诉Spring给两个类注入EventBus的一个实例。最后,我们有我们的配置类,来指示Spring框架在哪里寻找组件,并连接配置类中定义的bean:

    @Configuration
    @ComponentScan(basePackages = {"guava"})
    public class EventBusConfig {
        @Bean
        public EventBus eventBus() {
            return new EventBus();
        }
    }

    上面我们使用了@Configuration注解,它标识了此类作为Spring上下文包含bean的创建和注入。我们定义了eventBus方法构造并且返回了EventBus类的一个实例,它将被注入给其他对象。这种情况下,当我们在SimpleTradeAuditor和SimpleTradeExecutor类的构造方法上使用@Autowire注解,Spring会自动注入相同的EventBus实例,这正是我们所需要的。值得注意的是,Spring默认情况下创建单例类,这也是我们这里想要的。正如我们所看到的,使用依赖注入框架可以确保我们基于事件的系统配置的合理正确。

Summary

在本篇中,我们已经介绍了如何通过Guava EventBus类使用基于事件的编程,来减少我们的代码耦合。我们介绍了如何创建一个EventBus实例并注册订阅者和发布者。我们也探讨了强大的使用类型注册那些我们感兴趣的事件。我们了解了AsyncEventBus类,它允许我们发送异步事件。我们看到了如何使用DeadEvent类,以确保我们的事件都拥有订阅者。最后,我们看到了如何使用依赖注入框架来解耦我们基于事件的系统配置。

下一个系列中, 我们将会学习如何通过Guava对文件进行操作。敬请关注。

点赞
收藏
评论区
推荐文章
blmius blmius
3年前
MySQL:[Err] 1292 - Incorrect datetime value: ‘0000-00-00 00:00:00‘ for column ‘CREATE_TIME‘ at row 1
文章目录问题用navicat导入数据时,报错:原因这是因为当前的MySQL不支持datetime为0的情况。解决修改sql\mode:sql\mode:SQLMode定义了MySQL应支持的SQL语法、数据校验等,这样可以更容易地在不同的环境中使用MySQL。全局s
待兔 待兔
4个月前
手写Java HashMap源码
HashMap的使用教程HashMap的使用教程HashMap的使用教程HashMap的使用教程HashMap的使用教程22
Wesley13 Wesley13
3年前
PPDB:今晚老齐直播
【今晚老齐直播】今晚(本周三晚)20:0021:00小白开始“用”飞桨(https://www.oschina.net/action/visit/ad?id1185)由PPDE(飞桨(https://www.oschina.net/action/visit/ad?id1185)开发者专家计划)成员老齐,为深度学习小白指点迷津。
一文读懂Guava EventBus(订阅\发布事件)
作者:京东科技刘子洋背景最近项目出现同一消息发送多次的现象,对下游业务方造成困扰,经过排查发现使用EventBus方式不正确。也借此机会学习了下EventBus并进行分享。以下为分享内容,本文主要分为五个部分,篇幅较长,望大家耐心阅读。1、简述:简单介绍E
Stella981 Stella981
3年前
Guava — EventBus
Guava提供了事件总线的一个实现方案EventBus。它是事件发布订阅模式的实现,观察者模式。Guava为我们提供了同步实现EventBus和异步实现AsyncEventBus两个事件总线,他们都不是单例的eventBus.post(1);eventBus.post(1L);post方法,直接发布事件订阅者需要注册进来,ev
Stella981 Stella981
3年前
Guava库学习:学习Guava Files系列(二)
  上一篇,Guava库学习:学习GuavaFiles系列(一)(https://www.oschina.net/action/GoToLink?urlhttp%3A%2F%2Fwww.xx566.com%2Fdetail%2F216.html)中,我们简单的学习了使用Files进行文件的读写等常用操作,本篇我们继续进行GuavaFiles系列
Stella981 Stella981
3年前
Guava学习笔记:EventBus
EventBus基本用法:使用Guava之后,如果要订阅消息,就不用再继承指定的接口,只需要在指定的方法上加上@Subscribe注解即可。代码如下:消息封装类:public class TestEvent {            private final int message;          
Stella981 Stella981
3年前
Greenrobot
EventBus深入学习四之实例&类说明本篇开始,则转向greenrobot/EventBus,之前基本上将Guava中设计的思路捋了一遍,逻辑比较简单和清晰,接下来则看下广泛运用于android的这个框架又有什么不一样的地方,有什么独特的精妙所在一些废话开始之前,当然是要先把代码
Stella981 Stella981
3年前
Guava中的EventBus
其实代码中经常会遇到跟主流程分支出去的异步逻辑,比如说:爬虫处理逻辑中,进行心跳打点,订单处理中,需要触发用户的个人信息变更等。这个时候就应该使用观察者模式。EventBus是Guava的事件处理机制,是设计模式中的观察者模式(生产/消费者编程模型)的优雅实现。对于事件监听和发布订阅模式,EventBus是一个非常优雅和简单解决方案,我们不用创建
Stella981 Stella981
3年前
Guava库学习:学习Guava EventBus(一)EventBus
  在软件开发过程中,对象信息的分享以及相互直接的协作是必须的,困难在于确保对象之间的沟通是有效完成的,而不是拥有成本高度耦合的组件。当对象对其他组件的责任有太多的细节时,它被认为是高度耦合的。当一个应用程序有高度的耦合,维护将变得非常具有挑战,任何变化都将带来涟漪效应。为了解决这一类的软件设计问题,我们就需要基于事件的编程。本篇,我们就来学习Guava