public class EventLogMessage
extends java.lang.Object
Name and value pairs are added into the record with add() methods which, by virtue of returning the newly modified LogMessage instance, can be chained together.
The user can set the timestamp to something other than the time of the call by calling setTimeStamp{Millis,Nanos}() as part of the chain.
To format the message, call toString(). The output format is CEDPS "Best Practices" format.
Since the addition of the nanosecond timestamp (which is rounded down to microseconds, and no I don't want to discuss it), this class requires Java 1.5
Modifier and Type | Class and Description |
---|---|
private static class |
EventLogMessage.Log4jFilter
In log4j, ignore all messages not specifically directed
at this appender.
|
Modifier and Type | Field and Description |
---|---|
static java.lang.String |
APPENDER |
private java.lang.StringBuffer |
buf |
private static java.util.GregorianCalendar |
calendar |
static java.lang.String |
DATE_KW |
private int |
dateEnd |
private int |
dateStart |
private static char[] |
DIGIT |
private static Escape |
escape |
static java.lang.String |
EVENT_KW |
static java.lang.String |
FAKE_DATE |
private static java.text.SimpleDateFormat |
format |
static java.lang.String |
LEVEL_KW |
private static long |
micro0 |
private static long |
micro1 |
private long |
micro2 |
private static long |
nano0 |
private static java.lang.String |
timeString |
private static java.util.concurrent.locks.Lock |
timeStringLock |
private int |
usecEnd |
private int |
usecStart |
Modifier | Constructor and Description |
---|---|
protected |
EventLogMessage(java.lang.String eventName)
Create a new LogMessage at the current time with a given event name.
|
Modifier and Type | Method and Description |
---|---|
EventLogMessage |
add(java.lang.String key,
double value)
Add a double.
|
EventLogMessage |
add(java.lang.String key,
float value)
Add a float.
|
EventLogMessage |
add(java.lang.String key,
int value)
Add an int.
|
EventLogMessage |
add(java.lang.String key,
long value)
Add a long.
|
EventLogMessage |
add(java.lang.String key,
java.lang.String value)
Add a string.
|
EventLogMessage |
addList(java.lang.String key,
java.util.List list) |
EventLogMessage |
addMap(java.lang.String key,
java.util.Map map)
Add a Map to the buffer.
|
EventLogMessage |
addMsg(java.lang.String msg)
Add an natural language message to the log message.
|
EventLogMessage |
addPair(java.lang.String key,
java.lang.String pairKey,
java.lang.String pairValue)
Add a key,value pair
The result looks like: key = (pairKey, pairValue)
|
EventLogMessage |
addTime(java.lang.String key,
long timeInMillis) |
private void |
addTimeStamp()
Add a timestamp to the message.
|
EventLogMessage |
addWQ(java.lang.String key,
java.lang.String value)
Add a string.
|
EventLogMessage |
setTimeStampMillis(long millis)
Set the timestamp from milliseconds
returned by System.currentTimeMillis().
|
EventLogMessage |
setTimeStampNanos(long nano1)
Set the timestamp from nanoseconds
returned by System.nanoTime().
|
java.lang.String |
toString()
Format a message in CEDPS Best Practices format.
|
private final java.lang.StringBuffer buf
private static long micro0
private static long nano0
private static long micro1
private long micro2
private static java.lang.String timeString
private static java.text.SimpleDateFormat format
private static final java.util.GregorianCalendar calendar
private static java.util.concurrent.locks.Lock timeStringLock
public static final java.lang.String APPENDER
public static final java.lang.String EVENT_KW
public static final java.lang.String DATE_KW
public static final java.lang.String FAKE_DATE
private final int dateStart
private final int dateEnd
private final int usecStart
private final int usecEnd
public static final java.lang.String LEVEL_KW
private static final char[] DIGIT
private static Escape escape
protected EventLogMessage(java.lang.String eventName)
setTimeStampMillis
or setTimeStampNanos
.eventName
- Name of this logging event.setTimeStampMillis(long)
,
setTimeStampNanos(long)
public EventLogMessage add(java.lang.String key, java.lang.String value)
public EventLogMessage addWQ(java.lang.String key, java.lang.String value)
public EventLogMessage add(java.lang.String key, int value)
public EventLogMessage add(java.lang.String key, long value)
public EventLogMessage add(java.lang.String key, float value)
public EventLogMessage add(java.lang.String key, double value)
public EventLogMessage addPair(java.lang.String key, java.lang.String pairKey, java.lang.String pairValue)
key
- pairKey
- pairValue
- public EventLogMessage addTime(java.lang.String key, long timeInMillis)
public EventLogMessage addMap(java.lang.String key, java.util.Map map)
key
- map
- public EventLogMessage addList(java.lang.String key, java.util.List list)
public EventLogMessage addMsg(java.lang.String msg)
msg
- public EventLogMessage setTimeStampMillis(long millis)
public EventLogMessage setTimeStampNanos(long nano1)
public java.lang.String toString()
toString
in class java.lang.Object
private void addTimeStamp()