public class CollectorFormatter extends Formatter
By default each CollectorFormatter is initialized using the following LogManager configuration properties where <formatter-name> refers to the fully qualified class name or the fully qualified derived class name of the formatter. If properties are not defined, or contain invalid values, then the specified default values are used.
Constructor and Description |
---|
CollectorFormatter()
Creates the formatter using the LogManager defaults.
|
CollectorFormatter(String format)
Creates the formatter using the given format.
|
CollectorFormatter(String format,
Formatter f,
Comparator<? super LogRecord> c)
Creates the formatter using the given values.
|
Modifier and Type | Method and Description |
---|---|
protected LogRecord |
apply(LogRecord t,
LogRecord u)
Used to choose the collected LogRecord.
|
protected String |
finish(String s)
Applied to the head, format, and tail returned by the target formatter.
|
String |
format(LogRecord record)
Accumulates log records which will be used to produce the final output.
|
String |
getTail(Handler h)
Formats the collected LogRecord and summary statistics.
|
String |
toString()
Formats the collected LogRecord and summary statistics.
|
formatMessage, getHead
public CollectorFormatter()
SecurityException
- if a security manager exists and the caller
does not have LoggingPermission("control").UndeclaredThrowableException
- if there are problems loading from
the LogManager.public CollectorFormatter(String format)
format
- the message format or null to use the LogManager default.SecurityException
- if a security manager exists and the caller
does not have LoggingPermission("control").UndeclaredThrowableException
- if there are problems loading from
the LogManager.public CollectorFormatter(String format, Formatter f, Comparator<? super LogRecord> c)
format
- the format string or null to use the LogManager default.f
- the formatter used on the collected log record or null to
specify no formatter.c
- the comparator used to determine which log record to format or
null to specify no comparator.SecurityException
- if a security manager exists and the caller
does not have LoggingPermission("control").UndeclaredThrowableException
- if there are problems loading from
the LogManager.public String format(LogRecord record)
getTail(java.util.logging.Handler)
method which also
resets this formatter back to its original state.format
in class Formatter
record
- the record to store.NullPointerException
- if the given record is null.public String getTail(Handler h)
head
the
head string
returned from the target formatter and
finished by this formatter.
formatted
the current log record
formatted by
the target formatter and finished
by this formatter. If the formatter is null then record is formatted by
this formatter.
tail
the
tail string
returned from the target formatter and
finished by this formatter.
count
the total number of log records
consumed by this formatter.
remaining
the count minus one.
thrown
the total number of log records
consumed by this formatter with an assigned
throwable.
normal messages
the count minus the thrown.
minMillis
the eldest log record
event time
consumed by this formatter. If the count is zero
then this is set to the previous max or approximate start time if there
was no previous max. By default this parameter is defined as a number.
The format type and format style rules from the
MessageFormat should be used to convert this from
milliseconds to a date or time.
maxMillis
the most recent log record
event time
consumed by this formatter. If the count is zero
then this is set to the current time.
By default this parameter is defined as a number. The format type and
format style rules from the MessageFormat should be
used to convert this from milliseconds to a date or time.
elapsed
the elapsed time in milliseconds between the
maxMillis
and minMillis
.
startTime
the approximate start time in milliseconds. By
default this parameter is defined as a number. The format type and format
style rules from the MessageFormat should be used to
convert this from milliseconds to a date or time.
currentTime
the
current time in milliseconds. By
default this parameter is defined as a number. The format type and format
style rules from the MessageFormat should be used to
convert this from milliseconds to a date or time.
uptime
the elapsed time in milliseconds between the
currentTime
and startTime
.
generation
the number times this method produced output with
at least one consumed log record. This can be used
to track the number of complete reports this formatter has produced.
Some example formats:
com.sun.mail.util.logging.CollectorFormatter.format={0}{1}{2}{4,choice,-1#|0#|0<... {4,number,integer} more}\n
This prints the head ({0}
), format ({1}
), and tail
({2}
) from the target formatter followed by the number of
remaining ({4}
) log records consumed by this formatter if there
are any remaining records.
Encoding failed.|NullPointerException: null String.getBytes(:913)... 3 more
com.sun.mail.util.logging.CollectorFormatter.format=These {3} messages occurred between\n{7,date,EEE, MMM dd HH:mm:ss:S ZZZ yyyy} and {8,time,EEE, MMM dd HH:mm:ss:S ZZZ yyyy}\n
This prints the count ({3}
) followed by the date and time of the
eldest log record ({7}
) and the date and time of the most recent
log record ({8}
).
These 292 messages occurred between Tue, Jul 21 14:11:42:449 -0500 2009 and Fri, Nov 20 07:29:24:0 -0600 2009
com.sun.mail.util.logging.CollectorFormatter.format=These {3} messages occurred between {9,choice,86400000#{7,date} {7,time} and {8,time}|86400000<{7,date} and {8,date}}\n
This prints the count ({3}
) and then chooses the format based on
the elapsed time ({9}
). If the elapsed time is less than one day
then the eldest log record ({7}
) date and time is formatted
followed by just the time of the most recent log record ({8}
.
Otherwise, the just the date of the eldest log record ({7}
) and
just the date of most recent log record ({8}
is formatted.
These 73 messages occurred between Jul 21, 2009 2:11:42 PM and 2:13:32 PM These 116 messages occurred between Jul 21, 2009 and Aug 20, 2009
com.sun.mail.util.logging.CollectorFormatter.format={13} alert reports since {10,date}.\n
This prints the generation ({13}
) followed by the start time
({10}
) formatted as a date.
4,320 alert reports since Jul 21, 2012.
public String toString()
toString
in class Object
getTail(java.util.logging.Handler)
protected LogRecord apply(LogRecord t, LogRecord u)
t
- the current record.u
- the record that could replace the current.NullPointerException
- may occur if either record is null.protected String finish(String s)
s
- the string to transform.NullPointerException
- if the given string is null.Copyright © 2019 Eclipse Foundation. Use is subject to license terms.