net.kencochrane.raven.connection

Class AbstractConnection

java.lang.Object

net.kencochrane.raven.connection.AbstractConnection

All Implemented Interfaces:

Closeable, AutoCloseable, Connection

Direct Known Subclasses:

HttpConnection, UdpConnection

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 long	DEFAULT_BASE_WAITING_TIME Default base duration for a lockdown.
static long	DEFAULT_MAX_WAITING_TIME Default maximum duration for a lockdown.
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
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.
void	setBaseWaitingTime(long baseWaitingTime)
void	setMaxWaitingTime(long maxWaitingTime)

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

DEFAULT_MAX_WAITING_TIME

public static final long DEFAULT_MAX_WAITING_TIME

Default maximum duration for a lockdown.

DEFAULT_BASE_WAITING_TIME

public static final long DEFAULT_BASE_WAITING_TIME

Default base duration for a lockdown.

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)

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.

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.

setMaxWaitingTime

public void setMaxWaitingTime(long maxWaitingTime)

setBaseWaitingTime

public void setBaseWaitingTime(long baseWaitingTime)