Package kos.core.events

Class EventBusSinkManager

java.lang.Object

kos.core.events.EventBusSinkManager

public class EventBusSinkManager
extends Object

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
(package private) static class	EventBusSinkManager.InitializationResult

Field Summary

Fields

Modifier and Type	Field	Description
private Set<Class>	classesWhichCodedHaveBeenRegistered
private Iterable<EventPublisherSink>	eventPublisherSinks
private Iterable<EventSubscriptionSink>	eventSubscriberSinks
protected KosContext	kosContext
private io.vertx.core.impl.logging.Logger	logger

Constructor Summary

Constructors

Constructor	Description
EventBusSinkManager(KosContext kosContext, Iterable<EventSubscriptionSink> eventSubscriberSinks, Iterable<EventPublisherSink> eventPublisherSinks)

Method Summary

Modifier and Type	Method	Description
private <T> EventBusSink.EventBusSyncInitializationRequest<T>	constructPublishingRequestFor(String address, Class<T> expectedType)
<T> io.vertx.core.eventbus.MessageProducer<T>	createProducer(String address, Class<T> expectedType)	Creates a MessageProducer that expects messages of type EventBusSinkManager.
<T> void	ensureEventBusCanSerializeType(Class<T> targetType)
private <T> EventBusSinkManager.InitializationResult	performInitialization(@NonNull String address, Class<T> expectedType, Iterable<? extends EventBusSink> eventBusSinks)
<T> void	subscribe(String address, Class<T> expectedType, io.vertx.core.Handler<io.vertx.core.eventbus.Message<T>> messageHandler)	Registers a message consumer messageHandler that will receive messages of the type EventBusSinkManager published into the given address.
(package private) <T> EventBusSinkManager.InitializationResult	tryInitializeSink(@NonNull String address, Class<T> expectedType, Iterable<? extends EventBusSink> eventBusSinks)	Initializes the Sink responsible for bridging the communication between the local EventBus with a remote broker, if any.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

logger

private final io.vertx.core.impl.logging.Logger logger

classesWhichCodedHaveBeenRegistered

private final Set<Class> classesWhichCodedHaveBeenRegistered

kosContext

protected final KosContext kosContext

eventSubscriberSinks

private final Iterable<EventSubscriptionSink> eventSubscriberSinks

eventPublisherSinks

private final Iterable<EventPublisherSink> eventPublisherSinks

Constructor Detail

EventBusSinkManager

public EventBusSinkManager(KosContext kosContext,
                           Iterable<EventSubscriptionSink> eventSubscriberSinks,
                           Iterable<EventPublisherSink> eventPublisherSinks)

Method Detail

subscribe

public <T> void subscribe(String address,
                          Class<T> expectedType,
                          io.vertx.core.Handler<io.vertx.core.eventbus.Message<T>> messageHandler)

Registers a message consumer messageHandler that will receive messages of the type EventBusSinkManager published into the given address.

Parameters:

address - a free-format String. EventPublisherSink implementations might have to parse this address to communicate with external services.

expectedType - the expected contract used when serialising messages.

Throws:

KosException - whenever it reaches a terminal, but unrecoverable state.

createProducer

public <T> io.vertx.core.eventbus.MessageProducer<T> createProducer(String address,
                                                                    Class<T> expectedType)

Creates a MessageProducer that expects messages of type EventBusSinkManager.

Parameters:

address - a free-format String. EventPublisherSink implementations might have to parse this address to communicate with external services.

expectedType - the expected contract used when serialising messages.

Throws:

KosException - whenever it reaches a terminal, but unrecoverable state.

tryInitializeSink

final <T> EventBusSinkManager.InitializationResult tryInitializeSink(@NonNull
                                                                     @NonNull String address,
                                                                     Class<T> expectedType,
                                                                     Iterable<? extends EventBusSink> eventBusSinks)

Initializes the Sink responsible for bridging the communication between the local EventBus with a remote broker, if any. Sinks must be able to successfully finish its initialization. Any Exception thrown during this process will be considered a terminal, non-recoverable state - leading to an abrupt interruption of the whole application.

Returns:

performInitialization

private <T> EventBusSinkManager.InitializationResult performInitialization(@NonNull
                                                                           @NonNull String address,
                                                                           Class<T> expectedType,
                                                                           Iterable<? extends EventBusSink> eventBusSinks)

constructPublishingRequestFor

private <T> EventBusSink.EventBusSyncInitializationRequest<T> constructPublishingRequestFor(String address,
                                                                                            Class<T> expectedType)

ensureEventBusCanSerializeType

public <T> void ensureEventBusCanSerializeType(Class<T> targetType)