com.optimizely.ab.event

Class AsyncEventHandler

java.lang.Object

com.optimizely.ab.event.AsyncEventHandler

All Implemented Interfaces:

com.optimizely.ab.event.EventHandler, java.lang.AutoCloseable

public class AsyncEventHandler
extends java.lang.Object
implements com.optimizely.ab.event.EventHandler, java.lang.AutoCloseable

EventHandler implementation that queues events and has a separate pool of threads responsible for the dispatch.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	AsyncEventHandler.Builder

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	CONFIG_MAX_CONNECTIONS
static java.lang.String	CONFIG_MAX_PER_ROUTE
static java.lang.String	CONFIG_NUM_WORKERS
static java.lang.String	CONFIG_QUEUE_CAPACITY
static java.lang.String	CONFIG_VALIDATE_AFTER_INACTIVITY
static int	DEFAULT_MAX_CONNECTIONS
static int	DEFAULT_MAX_PER_ROUTE
static int	DEFAULT_NUM_WORKERS
static int	DEFAULT_QUEUE_CAPACITY
static int	DEFAULT_VALIDATE_AFTER_INACTIVITY

Constructor Summary

Constructors

Constructor and Description
AsyncEventHandler(int queueCapacity, int numWorkers) Deprecated. Use the builder AsyncEventHandler.Builder
AsyncEventHandler(int queueCapacity, int numWorkers, int maxConnections, int connectionsPerRoute, int validateAfter) Deprecated. Use the builder AsyncEventHandler.Builder
AsyncEventHandler(int queueCapacity, int numWorkers, int maxConnections, int connectionsPerRoute, int validateAfter, long closeTimeout, java.util.concurrent.TimeUnit closeTimeoutUnit)
AsyncEventHandler(OptimizelyHttpClient httpClient, java.util.concurrent.ExecutorService workerExecutor)

Method Summary

Modifier and Type	Method and Description
static AsyncEventHandler.Builder	builder()
void	close()
void	dispatchEvent(com.optimizely.ab.event.LogEvent logEvent)
void	shutdownAndAwaitTermination(long timeout, java.util.concurrent.TimeUnit unit) Attempts to gracefully terminate all event dispatch workers and close all resources.

Methods inherited from class java.lang.Object

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

Field Detail

CONFIG_QUEUE_CAPACITY

public static final java.lang.String CONFIG_QUEUE_CAPACITY

See Also:

Constant Field Values

CONFIG_NUM_WORKERS

public static final java.lang.String CONFIG_NUM_WORKERS

See Also:

Constant Field Values

CONFIG_MAX_CONNECTIONS

public static final java.lang.String CONFIG_MAX_CONNECTIONS

See Also:

Constant Field Values

CONFIG_MAX_PER_ROUTE

public static final java.lang.String CONFIG_MAX_PER_ROUTE

See Also:

Constant Field Values

CONFIG_VALIDATE_AFTER_INACTIVITY

public static final java.lang.String CONFIG_VALIDATE_AFTER_INACTIVITY

See Also:

Constant Field Values

DEFAULT_QUEUE_CAPACITY

public static final int DEFAULT_QUEUE_CAPACITY

See Also:

Constant Field Values

DEFAULT_NUM_WORKERS

public static final int DEFAULT_NUM_WORKERS

See Also:

Constant Field Values

DEFAULT_MAX_CONNECTIONS

public static final int DEFAULT_MAX_CONNECTIONS

See Also:

Constant Field Values

DEFAULT_MAX_PER_ROUTE

public static final int DEFAULT_MAX_PER_ROUTE

See Also:

Constant Field Values

DEFAULT_VALIDATE_AFTER_INACTIVITY

public static final int DEFAULT_VALIDATE_AFTER_INACTIVITY

See Also:

Constant Field Values

Constructor Detail

AsyncEventHandler

@Deprecated
public AsyncEventHandler(int queueCapacity,
                                     int numWorkers)

Deprecated. Use the builder AsyncEventHandler.Builder

Parameters:

queueCapacity - A depth of the event queue

numWorkers - The number of workers

AsyncEventHandler

@Deprecated
public AsyncEventHandler(int queueCapacity,
                                     int numWorkers,
                                     int maxConnections,
                                     int connectionsPerRoute,
                                     int validateAfter)

Deprecated. Use the builder AsyncEventHandler.Builder

Parameters:

queueCapacity - A depth of the event queue

numWorkers - The number of workers

maxConnections - The max number of concurrent connections

connectionsPerRoute - The max number of concurrent connections per route

validateAfter - An inactivity period in milliseconds after which persistent connections must be re-validated prior to being leased to the consumer.

AsyncEventHandler

public AsyncEventHandler(int queueCapacity,
                         int numWorkers,
                         int maxConnections,
                         int connectionsPerRoute,
                         int validateAfter,
                         long closeTimeout,
                         java.util.concurrent.TimeUnit closeTimeoutUnit)

AsyncEventHandler

public AsyncEventHandler(OptimizelyHttpClient httpClient,
                         java.util.concurrent.ExecutorService workerExecutor)

Method Detail

dispatchEvent

public void dispatchEvent(com.optimizely.ab.event.LogEvent logEvent)

Specified by:

dispatchEvent in interface com.optimizely.ab.event.EventHandler

shutdownAndAwaitTermination

public void shutdownAndAwaitTermination(long timeout,
                                        java.util.concurrent.TimeUnit unit)

Attempts to gracefully terminate all event dispatch workers and close all resources. This method blocks, awaiting the completion of any queued or ongoing event dispatches.

Note: termination of ongoing event dispatching is best-effort.

Parameters:

timeout - maximum time to wait for event dispatches to complete

unit - the time unit of the timeout argument

close

public void close()

Specified by:

close in interface java.lang.AutoCloseable

builder

public static AsyncEventHandler.Builder builder()