io.sentry.connection

Class AbstractConnection

java.lang.Object

io.sentry.connection.AbstractConnection

All Implemented Interfaces:

Connection, Closeable, AutoCloseable

Direct Known Subclasses:

HttpConnection, NoopConnection, OutputStreamConnection

public abstract class AbstractConnection
extends Object
implements Connection

Abstract connection to a Sentry server.

Provide the basic tools to submit events to the server (authentication header, dsn).
To avoid spamming the network if and when Sentry is down, automatically lock the connection each time a ConnectionException is caught.

Field Summary

Fields

Modifier and Type	Field and Description
static String	SENTRY_PROTOCOL_VERSION Current Sentry protocol version.

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	AbstractConnection(String publicKey, String secretKey) Creates a connection based on the public and secret keys.

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.
protected abstract void	doSend(Event event) Sends an event to the Sentry server.
protected String	getAuthHeader() Creates an authentication header for the Sentry protocol.
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

Methods inherited from interface java.io.Closeable

close

Field Detail

SENTRY_PROTOCOL_VERSION

public static final String SENTRY_PROTOCOL_VERSION

Current Sentry protocol version.

See Also:

Constant Field Values

Constructor Detail

AbstractConnection

protected AbstractConnection(String publicKey,
                  String secretKey)

Creates a connection based on the public and secret keys.

Parameters:

publicKey - public key (identifier) to the Sentry server.

secretKey - secret key (password) to the Sentry server.

Method Detail

getAuthHeader

protected String getAuthHeader()

Creates an authentication header for the Sentry protocol.

Returns:

an authentication header as a String.

send

public final void send(Event event)
                throws ConnectionException

Description copied from interface: Connection

Sends an event to the Sentry server.

Specified by:

send in interface Connection

Parameters:

event - captured event to add in Sentry.

Throws:

ConnectionException - Thrown when an Event send fails.

doSend

protected abstract void doSend(Event event)
                        throws ConnectionException

Sends an event to the Sentry server.

Parameters:

event - captured event to add in Sentry.

Throws:

ConnectionException - whenever a temporary exception due to the connection happened.

addEventSendCallback

public void addEventSendCallback(EventSendCallback eventSendCallback)

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