org.graylog2.syslog4j.impl.message.structured

Class StructuredSyslogMessage

java.lang.Object

org.graylog2.syslog4j.impl.message.AbstractSyslogMessage

org.graylog2.syslog4j.impl.message.structured.StructuredSyslogMessage

All Implemented Interfaces:

Serializable, StructuredSyslogMessageIF, SyslogMessageIF

public class StructuredSyslogMessage
extends AbstractSyslogMessage
implements StructuredSyslogMessageIF

SyslogStructuredMessage extends AbstractSyslogMessage's ability to provide support for turning POJO (Plain Ol' Java Objects) into Syslog messages. It adds support for structured syslog messages as specified by draft-ietf-syslog-protocol-23. More information here:

http://tools.ietf.org/html/draft-ietf-syslog-protocol-23#section-6

Syslog4j is licensed under the Lesser GNU Public License v2.1. A copy of the LGPL license is available in the META-INF folder in all distributions of Syslog4j and in the base directory of the "doc" ZIP.

Version:

$Id: StructuredSyslogMessage.java,v 1.5 2010/09/11 16:49:24 cvs Exp $

Author:

Manish Motwani

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
static String	EMPTY_STRUCTURED_DATA_PREFIX
static int	EMPTY_STRUCTURED_DATA_PREFIX_LENGTH

Fields inherited from class org.graylog2.syslog4j.impl.message.AbstractSyslogMessage

DEFAULT_DATE_FORMAT, DEFAULT_DELIMITER, DEFAULT_REPLACE_DELIMITER, DEFAULT_TIME_FORMAT, UNDEFINED

Constructor Summary

Constructors

Constructor and Description

StructuredSyslogMessage(String messageId, String procId, Map<String,Map<String,String>> structuredData, String message) Constructs the StructuredSyslogMessage using MSGID, STRUCTURED-DATA and MSG fields, as described in: http://tools.ietf.org/html/draft-ietf-syslog-protocol-23#section-6 The Map must be a String -> (Map of String -> String), which encompasses the STRUCTURED-DATA field described in above document.

Method Summary

Modifier and Type	Method and Description
static boolean	checkIsPrintable(String value)
String	createMessage()
boolean	equals(Object obj)
static StructuredSyslogMessage	fromString(String syslogMessageStr) Parses and loads a StructuredSyslogMessage from string.
String	getMessage() Returns the MSG field of the structured message format, as described in: http://tools.ietf.org/html/draft-ietf-syslog-protocol-23#section-6
String	getMessageId() Returns the MSGID field of the structured message format, as described in: http://tools.ietf.org/html/draft-ietf-syslog-protocol-23#section-6
String	getProcId()
Map<String,Map<String,String>>	getStructuredData() Returns the structured data map.
int	hashCode()
static int	matchChar(String data, int start, char... matchChars)
static String	nilProtect(String value)
static void	sdEscape(StringBuffer sb, String value)
String	toString()

Methods inherited from class org.graylog2.syslog4j.impl.message.AbstractSyslogMessage

generateDate, generateDateAndTime, generateLocalHostName, generateTime, getDateFormat, getDelimiter, getReplaceDelimiter, getTimeFormat, nullOrEmpty, replaceDelimiter

Methods inherited from class java.lang.Object

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

Field Detail

EMPTY_STRUCTURED_DATA_PREFIX

public static final String EMPTY_STRUCTURED_DATA_PREFIX

See Also:

Constant Field Values

EMPTY_STRUCTURED_DATA_PREFIX_LENGTH

public static final int EMPTY_STRUCTURED_DATA_PREFIX_LENGTH

Constructor Detail

StructuredSyslogMessage

public StructuredSyslogMessage(String messageId,
                               String procId,
                               Map<String,Map<String,String>> structuredData,
                               String message)

Constructs the StructuredSyslogMessage using MSGID, STRUCTURED-DATA and MSG fields, as described in:

http://tools.ietf.org/html/draft-ietf-syslog-protocol-23#section-6

The Map must be a String -> (Map of String -> String), which encompasses the STRUCTURED-DATA field described in above document.

Parameters:

messageId -

structuredData -

message -

Method Detail

fromString

public static StructuredSyslogMessage fromString(String syslogMessageStr)

Parses and loads a StructuredSyslogMessage from string.

Parameters:

syslogMessageStr -

Returns:

Returns an instance of StructuredSyslogMessage.

getMessageId

public String getMessageId()

Returns the MSGID field of the structured message format, as described in:

http://tools.ietf.org/html/draft-ietf-syslog-protocol-23#section-6

Returns:

Returns the MSG ID field.

getStructuredData

public Map<String,Map<String,String>> getStructuredData()

Returns the structured data map. The Map is a String -> (Map of String -> String), which encompasses the STRUCTURED-DATA field, as described in:

http://tools.ietf.org/html/draft-ietf-syslog-protocol-23#section-6

Returns:

Returns a Map object containing structured data.

getMessage

public String getMessage()

Returns the MSG field of the structured message format, as described in:

http://tools.ietf.org/html/draft-ietf-syslog-protocol-23#section-6

Returns:

Returns the MSG field.

getProcId

public String getProcId()

createMessage

public String createMessage()

Specified by:

createMessage in interface SyslogMessageIF

Specified by:

createMessage in class AbstractSyslogMessage

sdEscape

public static void sdEscape(StringBuffer sb,
                            String value)

checkIsPrintable

public static boolean checkIsPrintable(String value)

nilProtect

public static String nilProtect(String value)

matchChar

public static int matchChar(String data,
                            int start,
                            char... matchChars)

hashCode

public int hashCode()

Overrides:

hashCode in class Object

equals

public boolean equals(Object obj)

Overrides:

equals in class Object

toString

public String toString()

Overrides:

toString in class Object