net.kencochrane.raven

Class DefaultRavenFactory

java.lang.Object

net.kencochrane.raven.RavenFactory

net.kencochrane.raven.DefaultRavenFactory

public class DefaultRavenFactory
extends RavenFactory

Default implementation of RavenFactory.

In most cases this is the implementation to use or extend for additional features.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
protected static class	DefaultRavenFactory.DaemonThreadFactory Thread factory generating daemon threads with a custom priority.

Field Summary

Fields

Modifier and Type	Field and Description
static String	ASYNC_OPTION Option to send events asynchronously.
static String	COMPRESSION_OPTION Option specific to raven-java, allowing to enable/disable the compression of requests to the Sentry Server.
static String	HIDE_COMMON_FRAMES_OPTION Option to hide common stackframes with enclosing exceptions.
static String	MAX_THREADS_OPTION Option for the number of threads assigned for the connection.
static String	NAIVE_PROTOCOL Protocol setting to disable security checks over an SSL connection.
static String	PRIORITY_OPTION Option for the priority of threads assigned for the connection.
static String	QUEUE_SIZE_OPTION Option for the maximum size of the queue.
static String	TIMEOUT_OPTION Option specific to raven-java, allowing to set a timeout (in ms) for a request to the Sentry server.

Constructor Summary

Constructors

Constructor and Description
DefaultRavenFactory()

Method Summary

Methods

Modifier and Type	Method and Description
protected Connection	createAsyncConnection(Dsn dsn, Connection connection) Encapsulates an already existing connection in an AsyncConnection and get the async options from the Sentry DSN.
protected Connection	createConnection(Dsn dsn) Creates a connection to the given DSN by determining the protocol.
protected Connection	createHttpConnection(Dsn dsn) Creates an HTTP connection to the Sentry server.
protected Marshaller	createMarshaller(Dsn dsn) Creates a JSON marshaller that will convert every Event in a format handled by the Sentry server.
Raven	createRavenInstance(Dsn dsn) Creates an instance of Raven given a DSN.
protected Connection	createUdpConnection(Dsn dsn) Creates an UDP connection to the Sentry server.
protected Collection<String>	getNotInAppFrames() Provides a list of package names to consider as "not in-app".

Methods inherited from class net.kencochrane.raven.RavenFactory

ravenInstance, ravenInstance, ravenInstance, ravenInstance, registerFactory

Methods inherited from class java.lang.Object

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

Field Detail

NAIVE_PROTOCOL

public static final String NAIVE_PROTOCOL

Protocol setting to disable security checks over an SSL connection.

See Also:

Constant Field Values

COMPRESSION_OPTION

public static final String COMPRESSION_OPTION

Option specific to raven-java, allowing to enable/disable the compression of requests to the Sentry Server.

See Also:

Constant Field Values

TIMEOUT_OPTION

public static final String TIMEOUT_OPTION

Option specific to raven-java, allowing to set a timeout (in ms) for a request to the Sentry server.

See Also:

Constant Field Values

ASYNC_OPTION

public static final String ASYNC_OPTION

Option to send events asynchronously.

See Also:

Constant Field Values

MAX_THREADS_OPTION

public static final String MAX_THREADS_OPTION

Option for the number of threads assigned for the connection.

See Also:

Constant Field Values

PRIORITY_OPTION

public static final String PRIORITY_OPTION

Option for the priority of threads assigned for the connection.

See Also:

Constant Field Values

QUEUE_SIZE_OPTION

public static final String QUEUE_SIZE_OPTION

Option for the maximum size of the queue.

See Also:

Constant Field Values

HIDE_COMMON_FRAMES_OPTION

public static final String HIDE_COMMON_FRAMES_OPTION

Option to hide common stackframes with enclosing exceptions.

See Also:

Constant Field Values

Constructor Detail

DefaultRavenFactory

public DefaultRavenFactory()

Method Detail

createRavenInstance

public Raven createRavenInstance(Dsn dsn)

Description copied from class: RavenFactory

Creates an instance of Raven given a DSN.

Specified by:

createRavenInstance in class RavenFactory

Parameters:

dsn - Data Source Name of the Sentry server.

Returns:

an instance of Raven.

createConnection

protected Connection createConnection(Dsn dsn)

Creates a connection to the given DSN by determining the protocol.

Parameters:

dsn - Data Source Name of the Sentry server to use.

Returns:

a connection to the server.

createAsyncConnection

protected Connection createAsyncConnection(Dsn dsn,
                               Connection connection)

Encapsulates an already existing connection in an AsyncConnection and get the async options from the Sentry DSN.

Parameters:

dsn - Data Source Name of the Sentry server.

connection - Connection to encapsulate in an AsyncConnection.

Returns:

the asynchronous connection.

createHttpConnection

protected Connection createHttpConnection(Dsn dsn)

Creates an HTTP connection to the Sentry server.

Parameters:

dsn - Data Source Name of the Sentry server.

Returns:

an HttpConnection to the server.

createUdpConnection

protected Connection createUdpConnection(Dsn dsn)

Creates an UDP connection to the Sentry server.

Parameters:

dsn - Data Source Name of the Sentry server.

Returns:

an UdpConnection to the server.

createMarshaller

protected Marshaller createMarshaller(Dsn dsn)

Creates a JSON marshaller that will convert every Event in a format handled by the Sentry server.

Parameters:

dsn - Data Source Name of the Sentry server.

Returns:

a JsonMarshaller to process the events.

getNotInAppFrames

protected Collection<String> getNotInAppFrames()

Provides a list of package names to consider as "not in-app".

Those packages will be used with the StackTraceInterface to hide frames that aren't a part of the main application.

Returns:

the list of "not in-app" packages.