net.openhft.chronicle.threads

Class EventGroup

java.lang.Object

net.openhft.chronicle.core.io.AbstractCloseable

net.openhft.chronicle.threads.AbstractLifecycleEventLoop

net.openhft.chronicle.threads.EventGroup

All Implemented Interfaces:

Closeable, AutoCloseable, net.openhft.chronicle.core.io.ManagedCloseable, net.openhft.chronicle.core.io.Monitorable, net.openhft.chronicle.core.io.QueryCloseable, net.openhft.chronicle.core.io.ReferenceOwner, net.openhft.chronicle.core.io.SingleThreadedChecked, net.openhft.chronicle.core.threads.EventLoop

public class EventGroup
extends AbstractLifecycleEventLoop
implements net.openhft.chronicle.core.threads.EventLoop

Composes child event loops to support all HandlerPriority priorities. This class will delegate any EventHandler that is installed on it (via addHandler(EventHandler)) to a child event loop appropriately. See also other implementations of EventLoop in this library.

Supports event loop monitoring - controlled by system property MONITOR_INTERVAL_MS and documented in README.adoc

Field Summary

Fields

Modifier and Type	Field and Description
static int	CONC_THREADS

Fields inherited from class net.openhft.chronicle.threads.AbstractLifecycleEventLoop

name

Fields inherited from class net.openhft.chronicle.core.io.AbstractCloseable

closedHere, DISABLE_DISCARD_WARNING, WARN_NS

Fields inherited from interface net.openhft.chronicle.core.threads.EventLoop

DEBUG_ADDING_HANDLERS

Fields inherited from interface net.openhft.chronicle.core.io.ReferenceOwner

INIT, TMP

Fields inherited from interface net.openhft.chronicle.core.io.SingleThreadedChecked

DISABLE_SINGLE_THREADED_CHECK

Constructor Summary

Constructors

Constructor and Description
EventGroup(boolean daemon, @NotNull Pauser pauser, Pauser replicationPauser, String binding, String bindingReplication, @NotNull String name, int concThreadsNum, String concBinding, @NotNull Supplier<Pauser> concPauserSupplier, Set<net.openhft.chronicle.core.threads.HandlerPriority> priorities, @NotNull Supplier<Pauser> blockingPauserSupplier)

Method Summary

Modifier and Type	Method and Description
void	addHandler(@NotNull net.openhft.chronicle.core.threads.EventHandler handler)
void	addTimingMonitor(String description, long timeLimitNS, LongSupplier timeSupplier, Supplier<Thread> threadSupplier)
static EventGroupBuilder	builder() Create an EventGroup builder
boolean	isAlive()
protected void	performClose()
protected void	performStart() Starts the event loop and waits for the core (or monitor) event loop thread to start before returning (or timing out)
protected void	performStopFromNew() Implement a stop from EventLoopLifecycle.NEW state, should block until all handlers have had EventHandler.loopFinished() called.
protected void	performStopFromStarted() Implement a stop from EventLoopLifecycle.STARTED state, should block until all handlers have completed their final iteration and had EventHandler.loopFinished() called.
boolean	runsInsideCoreLoop()
void	setupTimeLimitMonitor(long timeLimitNS, LongSupplier timeOfStart)
void	unpause()

Methods inherited from class net.openhft.chronicle.threads.AbstractLifecycleEventLoop

awaitTermination, isStarted, isStopped, name, nameWithSlash, start, stop

Methods inherited from class net.openhft.chronicle.core.io.AbstractCloseable

assertCloseable, assertCloseablesClosed, close, createdHere, disableCloseableTracing, enableCloseableTracing, gcAndWaitForCloseablesToClose, isClosed, isClosing, isInUserThread, referenceId, shouldPerformCloseInBackground, shouldWaitForClosed, singleThreadedCheckDisabled, singleThreadedCheckDisabled, singleThreadedCheckReset, threadSafetyCheck, throwExceptionIfClosed, throwExceptionIfClosedInSetter, toString, unmonitor, unmonitor, waitForCloseablesToClose, waitForClosed, warnAndCloseIfNotClosed

Methods inherited from class java.lang.Object

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

Methods inherited from interface net.openhft.chronicle.core.threads.EventLoop

close, inEventLoop, isStopped, name, start, stop

Methods inherited from interface net.openhft.chronicle.core.io.Closeable

closeQuietly, closeQuietly

Methods inherited from interface net.openhft.chronicle.core.io.QueryCloseable

isClosed, isClosing

Methods inherited from interface net.openhft.chronicle.core.io.ReferenceOwner

referenceName, temporary

Methods inherited from interface net.openhft.chronicle.core.io.Monitorable

unmonitor

Field Detail

CONC_THREADS

public static final int CONC_THREADS

Constructor Detail

EventGroup

public EventGroup(boolean daemon,
                  @NotNull
                  @NotNull Pauser pauser,
                  Pauser replicationPauser,
                  String binding,
                  String bindingReplication,
                  @NotNull
                  @NotNull String name,
                  int concThreadsNum,
                  String concBinding,
                  @NotNull
                  @NotNull Supplier<Pauser> concPauserSupplier,
                  Set<net.openhft.chronicle.core.threads.HandlerPriority> priorities,
                  @NotNull
                  @NotNull Supplier<Pauser> blockingPauserSupplier)

Method Detail

builder

public static EventGroupBuilder builder()

Create an EventGroup builder

Returns:

A new EventGroupBuilder

unpause

public void unpause()

Specified by:

unpause in interface net.openhft.chronicle.core.threads.EventLoop

addHandler

public void addHandler(@NotNull
                       @NotNull net.openhft.chronicle.core.threads.EventHandler handler)

Specified by:

addHandler in interface net.openhft.chronicle.core.threads.EventLoop

setupTimeLimitMonitor

public void setupTimeLimitMonitor(long timeLimitNS,
                                  LongSupplier timeOfStart)

addTimingMonitor

public void addTimingMonitor(String description,
                             long timeLimitNS,
                             LongSupplier timeSupplier,
                             Supplier<Thread> threadSupplier)

performStart

protected void performStart()

Starts the event loop and waits for the core (or monitor) event loop thread to start before returning (or timing out)

Specified by:

performStart in class AbstractLifecycleEventLoop

performStopFromNew

protected void performStopFromNew()

Description copied from class: AbstractLifecycleEventLoop

Implement a stop from EventLoopLifecycle.NEW state, should block until all handlers have had EventHandler.loopFinished() called.

Specified by:

performStopFromNew in class AbstractLifecycleEventLoop

performStopFromStarted

protected void performStopFromStarted()

Description copied from class: AbstractLifecycleEventLoop

Implement a stop from EventLoopLifecycle.STARTED state, should block until all handlers have completed their final iteration and had EventHandler.loopFinished() called.

Specified by:

performStopFromStarted in class AbstractLifecycleEventLoop

isAlive

public boolean isAlive()

Specified by:

isAlive in interface net.openhft.chronicle.core.threads.EventLoop

performClose

protected void performClose()

Overrides:

performClose in class AbstractLifecycleEventLoop

runsInsideCoreLoop

public boolean runsInsideCoreLoop()

Specified by:

runsInsideCoreLoop in interface net.openhft.chronicle.core.threads.EventLoop