net.kencochrane.raven.marshaller.json

Class JsonMarshaller

java.lang.Object

net.kencochrane.raven.marshaller.json.JsonMarshaller

All Implemented Interfaces:

Marshaller

public class JsonMarshaller
extends Object
implements Marshaller

Event marshaller using JSON to send the data.

The content can also be compressed with DeflaterOutputStream in which case the binary result is encoded in base 64.

Nested Class Summary

Nested classes/interfaces inherited from interface net.kencochrane.raven.marshaller.Marshaller

Marshaller.UncloseableOutputStream

Field Summary

Fields

Modifier and Type	Field and Description
static String	CHECKSUM Checksum for the event, allowing to group events with a similar checksum.
static String	CULPRIT Function call which was the primary perpetrator of this event.
static String	EVENT_ID Hexadecimal string representing a uuid4 value.
static String	EXTRA An arbitrary mapping of additional metadata to store with the event.
static String	LEVEL The record severity.
static String	LOGGER The name of the logger which created the record.
static int	MAX_MESSAGE_LENGTH Maximum length for a message.
static String	MESSAGE User-readable representation of this event.
static String	MODULES A list of relevant modules and their versions.
static String	PLATFORM A string representing the platform the client is submitting from.
static String	SERVER_NAME Identifies the host client from which the event was recorded.
static String	TAGS A map or list of tags for this event.
static String	TIMESTAMP Indicates when the logging record was created.

Constructor Summary

Constructors

Constructor and Description
JsonMarshaller()

Method Summary

Methods

Modifier and Type	Method and Description
<T extends SentryInterface,F extends T> void	addInterfaceBinding(Class<F> sentryInterfaceClass, InterfaceBinding<T> binding) Add an interface binding to send a type of SentryInterface through a JSON stream.
void	marshall(Event event, OutputStream destination) Serialises an event and sends it through an OutputStream.
void	setCompression(boolean compression) Enables the JSON compression with deflate.

Methods inherited from class java.lang.Object

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

Field Detail

EVENT_ID

public static final String EVENT_ID

Hexadecimal string representing a uuid4 value.

See Also:

Constant Field Values

MESSAGE

public static final String MESSAGE

User-readable representation of this event.

See Also:

Constant Field Values

TIMESTAMP

public static final String TIMESTAMP

Indicates when the logging record was created.

See Also:

Constant Field Values

LEVEL

public static final String LEVEL

The record severity.

See Also:

Constant Field Values

LOGGER

public static final String LOGGER

The name of the logger which created the record.

See Also:

Constant Field Values

PLATFORM

public static final String PLATFORM

A string representing the platform the client is submitting from.

See Also:

Constant Field Values

CULPRIT

public static final String CULPRIT

Function call which was the primary perpetrator of this event.

See Also:

Constant Field Values

TAGS

public static final String TAGS

A map or list of tags for this event.

See Also:

Constant Field Values

SERVER_NAME

public static final String SERVER_NAME

Identifies the host client from which the event was recorded.

See Also:

Constant Field Values

MODULES

public static final String MODULES

A list of relevant modules and their versions.

See Also:

Constant Field Values

EXTRA

public static final String EXTRA

An arbitrary mapping of additional metadata to store with the event.

See Also:

Constant Field Values

CHECKSUM

public static final String CHECKSUM

Checksum for the event, allowing to group events with a similar checksum.

See Also:

Constant Field Values

MAX_MESSAGE_LENGTH

public static final int MAX_MESSAGE_LENGTH

Maximum length for a message.

See Also:

Constant Field Values

Constructor Detail

JsonMarshaller

public JsonMarshaller()

Method Detail

marshall

public void marshall(Event event,
            OutputStream destination)

Description copied from interface: Marshaller

Serialises an event and sends it through an OutputStream.

The marshaller should not close the given stream, use Marshaller.UncloseableOutputStream to prevent automatic calls to OutputStream.close().

Specified by:

marshall in interface Marshaller

Parameters:

event - event to serialise.

destination - destination stream.

addInterfaceBinding

public <T extends SentryInterface,F extends T> void addInterfaceBinding(Class<F> sentryInterfaceClass,
                                                               InterfaceBinding<T> binding)

Add an interface binding to send a type of SentryInterface through a JSON stream.

Type Parameters:

T - Type of SentryInterface received by the InterfaceBinding.

F - Type of the interface stored in the event to send to the InterfaceBinding.

Parameters:

sentryInterfaceClass - Actual type of SentryInterface supported by the InterfaceBinding

binding - InterfaceBinding converting SentryInterfaces of type sentryInterfaceClass.

setCompression

public void setCompression(boolean compression)

Enables the JSON compression with deflate.

Parameters:

compression - state of the compression.