io.reactivex.netty.metrics

Class MetricEventsSubject<E extends MetricsEvent<?>>

java.lang.Object

io.reactivex.netty.metrics.MetricEventsSubject<E>

All Implemented Interfaces:

MetricEventsListener<E>, MetricEventsPublisher<E>

Direct Known Subclasses:

NoOpChannelMetricEventProvider.NoOpMetricEventsSubject

public class MetricEventsSubject<E extends MetricsEvent<?>>
extends java.lang.Object
implements MetricEventsPublisher<E>, MetricEventsListener<E>

A subject which is both a MetricEventsListener and MetricEventsPublisher. Any invocation of MetricEventsListener methods invoke on this will in turn call all the underlying listeners. If any of the listener throws a fatal exception (as determined by Exceptions.throwIfFatal(Throwable)) no other listener is invoked, otherwise all the listeners are invoked. In case any of the listener threw a non-fatal exception, eventually, the invoked method on this subject will throw a ListenerInvocationException with all the non-fatal exceptions thrown by all listeners for this call.

Field Summary

Fields inherited from interface io.reactivex.netty.metrics.MetricEventsListener

NO_DURATION, NO_ERROR, NO_TIME_UNIT, NO_VALUE

Constructor Summary

Constructors

Constructor and Description
MetricEventsSubject()

Method Summary

Modifier and Type	Method and Description
protected ListenerInvocationException	handleListenerError(ListenerInvocationException exception, io.reactivex.netty.metrics.MetricEventsSubject.SafeListener<? extends E> listener, java.lang.Throwable e)
void	onCompleted() Marks the end of all event callbacks.
void	onEvent(E event)
void	onEvent(E event, long durationInMillis)
void	onEvent(E event, long durationInMillis, java.lang.Object value)
void	onEvent(E event, long durationInMillis, java.lang.Throwable throwable)
void	onEvent(E event, long durationInMillis, java.lang.Throwable throwable, java.lang.Object value)
void	onEvent(E event, long duration, java.util.concurrent.TimeUnit timeUnit)
void	onEvent(E event, long duration, java.util.concurrent.TimeUnit timeUnit, java.lang.Object value)
void	onEvent(E event, long duration, java.util.concurrent.TimeUnit timeUnit, java.lang.Throwable throwable)
void	onEvent(E event, long duration, java.util.concurrent.TimeUnit timeUnit, java.lang.Throwable throwable, java.lang.Object value) Event callback for any MetricsEvent.
void	onEvent(E event, java.lang.Object value)
void	onEvent(E event, java.lang.Throwable throwable)
void	onSubscribe() A callback when this listener is subscribed to a MetricEventsPublisher.
rx.Subscription	subscribe(MetricEventsListener<? extends E> listener)
protected void	throwIfErrorOccured(ListenerInvocationException exception)

Methods inherited from class java.lang.Object

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

Constructor Detail

MetricEventsSubject

public MetricEventsSubject()

Method Detail

onEvent

public void onEvent(E event,
                    long duration,
                    java.util.concurrent.TimeUnit timeUnit,
                    java.lang.Throwable throwable,
                    java.lang.Object value)

Description copied from interface: MetricEventsListener

Event callback for any MetricsEvent. The parameters passed are all the contextual information possible for any event. There presence or absence will depend on the type of event.

Specified by:

onEvent in interface MetricEventsListener<E extends MetricsEvent<?>>

Parameters:

event - Event for which this callback has been invoked. This will never be null

duration - If the passed event is MetricsEvent.isTimed() then the actual duration, else MetricEventsListener.NO_DURATION

timeUnit - The time unit for the duration, if exists, else MetricEventsListener.NO_TIME_UNIT

throwable - If the passed event is MetricsEvent.isError() then the cause of the error, else MetricEventsListener.NO_ERROR

value - If the passed event requires custom object to be passed, then that object, else MetricEventsListener.NO_VALUE

onEvent

public void onEvent(E event,
                    long durationInMillis,
                    java.lang.Throwable throwable,
                    java.lang.Object value)

onEvent

public void onEvent(E event)

onEvent

public void onEvent(E event,
                    java.lang.Throwable throwable)

onEvent

public void onEvent(E event,
                    long duration,
                    java.util.concurrent.TimeUnit timeUnit)

onEvent

public void onEvent(E event,
                    long duration,
                    java.util.concurrent.TimeUnit timeUnit,
                    java.lang.Throwable throwable)

onEvent

public void onEvent(E event,
                    long duration,
                    java.util.concurrent.TimeUnit timeUnit,
                    java.lang.Object value)

onEvent

public void onEvent(E event,
                    long durationInMillis)

onEvent

public void onEvent(E event,
                    long durationInMillis,
                    java.lang.Throwable throwable)

onEvent

public void onEvent(E event,
                    long durationInMillis,
                    java.lang.Object value)

onEvent

public void onEvent(E event,
                    java.lang.Object value)

onCompleted

public void onCompleted()

Description copied from interface: MetricEventsListener

Marks the end of all event callbacks. No methods on this listener will ever be called once this method is called.

Specified by:

onCompleted in interface MetricEventsListener<E extends MetricsEvent<?>>

onSubscribe

public void onSubscribe()

Description copied from interface: MetricEventsListener

A callback when this listener is subscribed to a MetricEventsPublisher.

Specified by:

onSubscribe in interface MetricEventsListener<E extends MetricsEvent<?>>

subscribe

public rx.Subscription subscribe(MetricEventsListener<? extends E> listener)

Specified by:

subscribe in interface MetricEventsPublisher<E extends MetricsEvent<?>>

handleListenerError

protected ListenerInvocationException handleListenerError(ListenerInvocationException exception,
                                                          io.reactivex.netty.metrics.MetricEventsSubject.SafeListener<? extends E> listener,
                                                          java.lang.Throwable e)

throwIfErrorOccured

protected void throwIfErrorOccured(ListenerInvocationException exception)