io.sentry.connection

Class AsyncConnection

java.lang.Object

io.sentry.connection.AsyncConnection

All Implemented Interfaces:

Connection, Closeable, AutoCloseable

public class AsyncConnection
extends Object
implements Connection

Asynchronous usage of a connection.

Instead of synchronously sending each event to a connection, use a ThreadPool to establish the connection and submit the event.

Constructor Summary

Constructors

Constructor and Description
AsyncConnection(Connection actualConnection, ExecutorService executorService, boolean gracefulShutdown, long shutdownTimeout) Creates a connection which will rely on an executor to send events.

Method Summary

Methods

Modifier and Type	Method and Description
void	addEventSendCallback(EventSendCallback eventSendCallback) Add a callback that is called when an exception occurs while attempting to send events to the Sentry server.
void	close() .
void	send(Event event) Sends an event to the Sentry server.

Methods inherited from class java.lang.Object

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

Constructor Detail

AsyncConnection

public AsyncConnection(Connection actualConnection,
               ExecutorService executorService,
               boolean gracefulShutdown,
               long shutdownTimeout)

Creates a connection which will rely on an executor to send events.

Will propagate the close() operation.

Parameters:

actualConnection - connection used to send the events.

executorService - executorService used to process events, if null, the executorService will automatically be set to Executors.newSingleThreadExecutor()

gracefulShutdown - Indicates whether or not the shutdown operation should be managed by a ShutdownHook.

shutdownTimeout - timeout for graceful shutdown of the executor, in milliseconds.

Method Detail

send

public void send(Event event)

Sends an event to the Sentry server.

The event will be added to a queue and will be handled by a separate Thread later on.

Specified by:

send in interface Connection

Parameters:

event - captured event to add in Sentry.

addEventSendCallback

public void addEventSendCallback(EventSendCallback eventSendCallback)

Description copied from interface: Connection

Add a callback that is called when an exception occurs while attempting to send events to the Sentry server.

Specified by:

addEventSendCallback in interface Connection

Parameters:

eventSendCallback - callback instance

close

public void close()
           throws IOException

.

Closing the AsyncConnection will attempt a graceful shutdown of the executorService with a timeout of shutdownTimeout, allowing the current events to be submitted while new events will be rejected.
If the shutdown times out, the executorService will be forced to shutdown.

Specified by:

close in interface Closeable

Specified by:

close in interface AutoCloseable

Throws:

IOException