io.sentry.appengine.connection

Class AppEngineAsyncConnection

java.lang.Object

io.sentry.appengine.connection.AppEngineAsyncConnection

All Implemented Interfaces:

Connection, Closeable, AutoCloseable

public class AppEngineAsyncConnection
extends Object
implements Connection

Asynchronous connections that can be used within Google App Engine.

Instead of synchronously sending each event, use a the App Engine queue system to establish the connection and send the event.

Google App Engine serialises the tasks before queuing them, to keep a link between the task and the AppEngineAsyncConnection associated, a register of the instances of AppEngineAsyncConnection is kept in APP_ENGINE_ASYNC_CONNECTIONS.
This register is populated when a new instance of AppEngineAsyncConnection is created and the connection is removed from the register when it has been closed with close().
The register works based on identifier defined by the user. There is no ID conflict handling, the user is expected to manage the uniqueness of those ID.

Constructor Summary

Constructors

Constructor and Description
AppEngineAsyncConnection(String id, Connection actualConnection) 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)
void	close() .
void	send(Event event)
void	setQueue(String queueName) Set the queue used to send EventSubmitter tasks.

Methods inherited from class java.lang.Object

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

Constructor Detail

AppEngineAsyncConnection

public AppEngineAsyncConnection(String id,
                        Connection actualConnection)

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

Will propagate the close() operation.

Parameters:

id - Identifier of the connection shared across all the instances of the application.

actualConnection - Connection used to send the events.

Method Detail

send

public void send(Event event)

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

Specified by:

send in interface Connection

addEventSendCallback

public void addEventSendCallback(EventSendCallback eventSendCallback)

Specified by:

addEventSendCallback in interface Connection

close

public void close()
           throws IOException

.

Closing the AppEngineAsyncConnection will gracefully remove every task created earlier from the queue.

Specified by:

close in interface Closeable

Specified by:

close in interface AutoCloseable

Throws:

IOException

setQueue

public void setQueue(String queueName)

Set the queue used to send EventSubmitter tasks.

Parameters:

queueName - name of the queue to use.