net.kencochrane.raven.event.interfaces

Class MessageInterface

java.lang.Object

net.kencochrane.raven.event.interfaces.MessageInterface

All Implemented Interfaces:

Serializable, SentryInterface

public class MessageInterface
extends Object
implements SentryInterface

The Message interface for Sentry allows to send the original pattern to Sentry, allowing the events to be grouped by original message (rather than the formatted version).

Sentry's ability to regroup event with the same messages is based on the content of the message, meaning that an Event with the message "User1 failed to provide an email address" won't be grouped with an Event with the message "User2 failed to provide an email address".

To allow this kind of grouping, sentry supports the message interface which will provide both the pattern of the message and the parameters. In this example the pattern could be:
{} failed to provide an email address
And the parameters would be User1 in the first Event and User2 in the second Event.
This way, Sentry will be able to put the two events in the same category.

Note: Sentry won't attempt to format the message, this is why the formatted message should be set through EventBuilder.setMessage(String) in any case.

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
static String	MESSAGE_INTERFACE Name of the message interface in Sentry.

Constructor Summary

Constructors

Constructor and Description
MessageInterface(String message) Deprecated. Use EventBuilder.setMessage(String) instead.
MessageInterface(String message, List<String> parameters) Creates a parametrised message for an Event.
MessageInterface(String message, String... params) Creates a parametrised message for an Event.

Method Summary

Methods

Modifier and Type	Method and Description
boolean	equals(Object o)
String	getInterfaceName() Gets the unique name of the interface.
String	getMessage()
List<String>	getParameters()
int	hashCode()
String	toString()

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Field Detail

MESSAGE_INTERFACE

public static final String MESSAGE_INTERFACE

Name of the message interface in Sentry.

See Also:

Constant Field Values

Constructor Detail

MessageInterface

@Deprecated
public MessageInterface(String message)

Deprecated. Use EventBuilder.setMessage(String) instead.

Creates a non parametrised message.

While it's technically possible to create a non parametrised message with MessageInterface, it's recommended to use EventBuilder.setMessage(String) instead.

Parameters:

message - message to add to the event.

MessageInterface

public MessageInterface(String message,
                String... params)

Creates a parametrised message for an Event.

Parameters:

message - original message.

params - parameters of the message.

MessageInterface

public MessageInterface(String message,
                List<String> parameters)

Creates a parametrised message for an Event.

Parameters:

message - original message.

parameters - parameters of the message.

Method Detail

getInterfaceName

public String getInterfaceName()

Description copied from interface: SentryInterface

Gets the unique name of the interface.

Specified by:

getInterfaceName in interface SentryInterface

Returns:

name of the interface.

getMessage

public String getMessage()

getParameters

public List<String> getParameters()

toString

public String toString()

Overrides:

toString in class Object

equals

public boolean equals(Object o)

Overrides:

equals in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object