EventBusBuilder (EventBus 2.4.0 API)

java.lang.Object
- de.greenrobot.event.EventBusBuilder

```
public class EventBusBuilder
extends java.lang.Object
```
Creates EventBus instances with custom parameters and also allows to install a custom default EventBus instance. Create a new builder using EventBus.builder().

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`EventBus`	`build()` Builds an EventBus based on the current configuration.
`EventBusBuilder`	`eventInheritance(boolean eventInheritance)` By default, EventBus considers the event class hierarchy (subscribers to super classes will be notified).
`EventBusBuilder`	`executorService(java.util.concurrent.ExecutorService executorService)` Provide a custom thread pool to EventBus used for async and background event delivery.
`EventBus`	`installDefaultEventBus()` Installs the default EventBus returned by `EventBus.getDefault()` using this builders' values.
`EventBusBuilder`	`logNoSubscriberMessages(boolean logNoSubscriberMessages)` Default: true
`EventBusBuilder`	`logSubscriberExceptions(boolean logSubscriberExceptions)` Default: true
`EventBusBuilder`	`sendNoSubscriberEvent(boolean sendNoSubscriberEvent)` Default: true
`EventBusBuilder`	`sendSubscriberExceptionEvent(boolean sendSubscriberExceptionEvent)` Default: true
`EventBusBuilder`	`skipMethodVerificationFor(java.lang.Class<?> clazz)` Method name verification is done for methods starting with onEvent to avoid typos; using this method you can exclude subscriber classes from this check.
`EventBusBuilder`	`throwSubscriberException(boolean throwSubscriberException)` Fails if an subscriber throws an exception (default: false).

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Method Detail
  - logSubscriberExceptions
```
public EventBusBuilder logSubscriberExceptions(boolean logSubscriberExceptions)
```
    Default: true
  - logNoSubscriberMessages
```
public EventBusBuilder logNoSubscriberMessages(boolean logNoSubscriberMessages)
```
    Default: true
  - sendSubscriberExceptionEvent
```
public EventBusBuilder sendSubscriberExceptionEvent(boolean sendSubscriberExceptionEvent)
```
    Default: true
  - sendNoSubscriberEvent
```
public EventBusBuilder sendNoSubscriberEvent(boolean sendNoSubscriberEvent)
```
    Default: true
  - throwSubscriberException
```
public EventBusBuilder throwSubscriberException(boolean throwSubscriberException)
```
    Fails if an subscriber throws an exception (default: false).
    Tip: Use this with BuildConfig.DEBUG to let the app crash in DEBUG mode (only). This way, you won't miss exceptions during development.
  - eventInheritance
```
public EventBusBuilder eventInheritance(boolean eventInheritance)
```
    By default, EventBus considers the event class hierarchy (subscribers to super classes will be notified). Switching this feature off will improve posting of events. For simple event classes extending Object directly, we measured a speed up of 20% for event posting. For more complex event hierarchies, the speed up should be >20%.
    However, keep in mind that event posting usually consumes just a small proportion of CPU time inside an app, unless it is posting at high rates, e.g. hundreds/thousands of events per second.
  - executorService
```
public EventBusBuilder executorService(java.util.concurrent.ExecutorService executorService)
```
    Provide a custom thread pool to EventBus used for async and background event delivery. This is an advanced setting to that can break things: ensure the given ExecutorService won't get stuck to avoid undefined behavior.
  - skipMethodVerificationFor
```
public EventBusBuilder skipMethodVerificationFor(java.lang.Class<?> clazz)
```
    Method name verification is done for methods starting with onEvent to avoid typos; using this method you can exclude subscriber classes from this check. Also disables checks for method modifiers (public, not static nor abstract).
  - installDefaultEventBus
```
public EventBus installDefaultEventBus()
```
    Installs the default EventBus returned by EventBus.getDefault() using this builders' values. Must be done only once before the first usage of the default EventBus.
    
    Throws:
    
    EventBusException - if there's already a default EventBus instance in place
  - build
```
public EventBus build()
```
    Builds an EventBus based on the current configuration.

Class EventBusBuilder

Method Summary

Methods inherited from class java.lang.Object

Method Detail

logSubscriberExceptions

logNoSubscriberMessages

sendSubscriberExceptionEvent

sendNoSubscriberEvent

throwSubscriberException

eventInheritance

executorService

skipMethodVerificationFor

installDefaultEventBus

build