Package org.jboss.logmanager.formatters
Class Formatters
java.lang.Object
org.jboss.logmanager.formatters.Formatters
Formatter utility methods.
-
Nested Class Summary
Nested ClassesModifier and TypeClassDescriptionprivate static class
(package private) static class
private static class
-
Field Summary
Fields -
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionprivate static String
applySegments
(int count, String subject) Apply up tocount
trailing segments of the given string to the givenbuilder
.private static String
applySegments
(String precision, String subject) Apply up toprecision
trailing segments of the given string to the givenbuilder
.static FormatStep
classNameFormatStep
(boolean leftJustify, int minimumWidth, boolean truncateBeginning, int maximumWidth, String precision) Create a format step which emits the source class name with the given justification rules (NOTE: call stack introspection introduces a significant performance penalty).static FormatStep
classNameFormatStep
(boolean leftJustify, int minimumWidth, int maximumWidth, String precision) Create a format step which emits the source class name with the given justification rules (NOTE: call stack introspection introduces a significant performance penalty).static FormatStep
dateFormatStep
(String formatString, boolean leftJustify, int minimumWidth, int maximumWidth) Create a format step which emits the date of the log record with the given justification rules.static FormatStep
dateFormatStep
(TimeZone timeZone, String formatString, boolean leftJustify, int minimumWidth, boolean truncateBeginning, int maximumWidth) Create a format step which emits the date of the log record with the given justification rules.static FormatStep
dateFormatStep
(TimeZone timeZone, String formatString, boolean leftJustify, int minimumWidth, int maximumWidth) Create a format step which emits the date of the log record with the given justification rules.static FormatStep
exceptionFormatStep
(boolean leftJustify, int minimumWidth, boolean truncateBeginning, int maximumWidth, String argument, boolean extended) Create a format step which emits the stack trace of an exception with the given justification rules.static FormatStep
exceptionFormatStep
(boolean leftJustify, int minimumWidth, int maximumWidth, boolean extended) Create a format step which emits the stack trace of an exception with the given justification rules.static FormatStep
fileNameFormatStep
(boolean leftJustify, int minimumWidth, boolean truncateBeginning, int maximumWidth) Create a format step which emits the source file name with the given justification rules (NOTE: call stack introspection introduces a significant performance penalty).static FormatStep
fileNameFormatStep
(boolean leftJustify, int minimumWidth, int maximumWidth) Create a format step which emits the source file name with the given justification rules (NOTE: call stack introspection introduces a significant performance penalty).private static String
findHostname
(Properties props, Map<String, String> env, boolean qualified) private static String
findQualifiedHostname
(Properties props, Map<String, String> env) static FormatStep
formatColor
(ColorMap colors, String color) (package private) static String
getJarName
(URL resource, String classResourceName) static FormatStep
hostnameFormatStep
(boolean leftJustify, int minimumWidth, boolean truncateBeginning, int maximumWidth, boolean qualified) Create a format step which emits the hostname.static FormatStep
levelFormatStep
(boolean leftJustify, int minimumWidth, boolean truncateBeginning, int maximumWidth) Create a format step which emits the log level name.static FormatStep
levelFormatStep
(boolean leftJustify, int minimumWidth, int maximumWidth) Create a format step which emits the log level name.static FormatStep
lineNumberFormatStep
(boolean leftJustify, int minimumWidth, boolean truncateBeginning, int maximumWidth) Create a format step which emits the source file line number with the given justification rules (NOTE: call stack introspection introduces a significant performance penalty).static FormatStep
lineNumberFormatStep
(boolean leftJustify, int minimumWidth, int maximumWidth) Create a format step which emits the source file line number with the given justification rules (NOTE: call stack introspection introduces a significant performance penalty).static FormatStep
lineSeparatorFormatStep
(boolean leftJustify, int minimumWidth, boolean truncateBeginning, int maximumWidth) Create a format step which emits the platform line separator.static FormatStep
lineSeparatorFormatStep
(boolean leftJustify, int minimumWidth, int maximumWidth) Create a format step which emits the platform line separator.static FormatStep
localizedLevelFormatStep
(boolean leftJustify, int minimumWidth, boolean truncateBeginning, int maximumWidth) Create a format step which emits the localized log level name.static FormatStep
localizedLevelFormatStep
(boolean leftJustify, int minimumWidth, int maximumWidth) Create a format step which emits the localized log level name.static FormatStep
locationInformationFormatStep
(boolean leftJustify, int minimumWidth, boolean truncateBeginning, int maximumWidth) Create a format step which emits the complete source location information with the given justification rules (NOTE: call stack introspection introduces a significant performance penalty).static FormatStep
locationInformationFormatStep
(boolean leftJustify, int minimumWidth, int maximumWidth) Create a format step which emits the complete source location information with the given justification rules (NOTE: call stack introspection introduces a significant performance penalty).static FormatStep
loggerNameFormatStep
(boolean leftJustify, int minimumWidth, boolean truncateBeginning, int maximumWidth, String precision) Create a format step which emits the logger name with the given justification rules.static FormatStep
loggerNameFormatStep
(boolean leftJustify, int minimumWidth, int maximumWidth, String precision) Create a format step which emits the logger name with the given justification rules.static FormatStep
mdcFormatStep
(String key, boolean leftJustify, int minimumWidth, boolean truncateBeginning, int maximumWidth) Create a format step which emits the MDC value associated with the given key of the log record.static FormatStep
mdcFormatStep
(String key, boolean leftJustify, int minimumWidth, int maximumWidth) Create a format step which emits the MDC value associated with the given key of the log record.static FormatStep
messageFormatStep
(boolean leftJustify, int minimumWidth, boolean truncateBeginning, int maximumWidth) Create a format step which emits the formatted log message text with the given justification rules.static FormatStep
messageFormatStep
(boolean leftJustify, int minimumWidth, int maximumWidth) Create a format step which emits the formatted log message text with the given justification rules.static FormatStep
methodNameFormatStep
(boolean leftJustify, int minimumWidth, boolean truncateBeginning, int maximumWidth) Create a format step which emits the source method name with the given justification rules (NOTE: call stack introspection introduces a significant performance penalty).static FormatStep
methodNameFormatStep
(boolean leftJustify, int minimumWidth, int maximumWidth) Create a format step which emits the source method name with the given justification rules (NOTE: call stack introspection introduces a significant performance penalty).static FormatStep
ndcFormatStep
(boolean leftJustify, int minimumWidth, boolean truncateBeginning, int maximumWidth, int count) Create a format step which emits the NDC value of the log record.static FormatStep
ndcFormatStep
(boolean leftJustify, int minimumWidth, int maximumWidth) Create a format step which emits the NDC value of the log record.static Formatter
Get the null formatter, which outputs nothing.parseCategorySegments
(String category) (package private) static Map<Integer,
Formatters.Segment> parsePatternSegments
(String pattern) static FormatStep
relativeTimeFormatStep
(long baseTime, boolean leftJustify, int minimumWidth, boolean truncateBeginning, int maximumWidth) Create a format step which emits the number of milliseconds since the given base time.static FormatStep
relativeTimeFormatStep
(long baseTime, boolean leftJustify, int minimumWidth, int maximumWidth) Create a format step which emits the number of milliseconds since the given base time.static FormatStep
resourceKeyFormatStep
(boolean leftJustify, int minimumWidth, boolean truncateBeginning, int maximumWidth) Create a format step which emits the log message resource key (if any) with the given justification rules.static FormatStep
resourceKeyFormatStep
(boolean leftJustify, int minimumWidth, int maximumWidth) Create a format step which emits the log message resource key (if any) with the given justification rules.static FormatStep
simpleMessageFormatStep
(boolean leftJustify, int minimumWidth, boolean truncateBeginning, int maximumWidth) Create a format step which emits the formatted log message text (simple version, no exception traces) with the given justification rules.static FormatStep
simpleMessageFormatStep
(boolean leftJustify, int minimumWidth, int maximumWidth) Create a format step which emits the formatted log message text (simple version, no exception traces) with the given justification rules.static FormatStep
systemPropertyFormatStep
(String argument, boolean leftJustify, int minimumWidth, boolean truncateBeginning, int maximumWidth) Create a format step which emits a system property value associated with the given key.static FormatStep
textFormatStep
(String string) Create a format step which simply emits the given string.static FormatStep
threadFormatStep
(String argument, boolean leftJustify, int minimumWidth, boolean truncateBeginning, int maximumWidth) Create a format step which emits the id ifid
is passed as the argument, otherwise the the thread name is used.static FormatStep
threadIdFormatStep
(boolean leftJustify, int minimumWidth, boolean truncateBeginning, int maximumWidth) Create a format step which emits the id of the thread which originated the log record.static FormatStep
threadNameFormatStep
(boolean leftJustify, int minimumWidth, boolean truncateBeginning, int maximumWidth) Create a format step which emits the name of the thread which originated the log record.static FormatStep
threadNameFormatStep
(boolean leftJustify, int minimumWidth, int maximumWidth) Create a format step which emits the name of the thread which originated the log record.
-
Field Details
-
THREAD_ID
- See Also:
-
DEFAULT_TRUNCATE_BEGINNING
private static final boolean DEFAULT_TRUNCATE_BEGINNING- See Also:
-
NEW_LINE
-
PRECISION_INT_PATTERN
-
NULL_FORMATTER
-
separatorString
-
-
Constructor Details
-
Formatters
private Formatters()
-
-
Method Details
-
nullFormatter
Get the null formatter, which outputs nothing.- Returns:
- the null formatter
-
textFormatStep
Create a format step which simply emits the given string.- Parameters:
string
- the string to emit- Returns:
- a format step
-
applySegments
Apply up tocount
trailing segments of the given string to the givenbuilder
.- Parameters:
count
- the maximum number of segments to includesubject
- the subject string- Returns:
- the substring
-
applySegments
Apply up toprecision
trailing segments of the given string to the givenbuilder
. If the precision contains non-integer values- Parameters:
precision
- the precision used tosubject
- the subject string- Returns:
- the substring
-
loggerNameFormatStep
public static FormatStep loggerNameFormatStep(boolean leftJustify, int minimumWidth, int maximumWidth, String precision) Create a format step which emits the logger name with the given justification rules.- Parameters:
leftJustify
-true
to left justify,false
to right justifyminimumWidth
- the minimum field width, or 0 for nonemaximumWidth
- the maximum field width (must be greater thanminimumFieldWidth
), or 0 for noneprecision
- the argument used for the logger name, may benull
or contain dots to format the logger name- Returns:
- the format
-
loggerNameFormatStep
public static FormatStep loggerNameFormatStep(boolean leftJustify, int minimumWidth, boolean truncateBeginning, int maximumWidth, String precision) Create a format step which emits the logger name with the given justification rules.- Parameters:
leftJustify
-true
to left justify,false
to right justifyminimumWidth
- the minimum field width, or 0 for nonetruncateBeginning
-true
to truncate the beginning, otherwisefalse
to truncate the endmaximumWidth
- the maximum field width (must be greater thanminimumFieldWidth
), or 0 for noneprecision
- the argument used for the logger name, may benull
or contain dots to format the logger name- Returns:
- the format
-
classNameFormatStep
public static FormatStep classNameFormatStep(boolean leftJustify, int minimumWidth, int maximumWidth, String precision) Create a format step which emits the source class name with the given justification rules (NOTE: call stack introspection introduces a significant performance penalty).- Parameters:
leftJustify
-true
to left justify,false
to right justifyminimumWidth
- the minimum field width, or 0 for nonemaximumWidth
- the maximum field width (must be greater thanminimumFieldWidth
), or 0 for noneprecision
- the argument used for the class name, may benull
or contain dots to format the class name- Returns:
- the format step
-
classNameFormatStep
public static FormatStep classNameFormatStep(boolean leftJustify, int minimumWidth, boolean truncateBeginning, int maximumWidth, String precision) Create a format step which emits the source class name with the given justification rules (NOTE: call stack introspection introduces a significant performance penalty).- Parameters:
leftJustify
-true
to left justify,false
to right justifyminimumWidth
- the minimum field width, or 0 for nonetruncateBeginning
-true
to truncate the beginning, otherwisefalse
to truncate the endmaximumWidth
- the maximum field width (must be greater thanminimumFieldWidth
), or 0 for noneprecision
- the argument used for the class name, may benull
or contain dots to format the class name- Returns:
- the format step
-
dateFormatStep
public static FormatStep dateFormatStep(TimeZone timeZone, String formatString, boolean leftJustify, int minimumWidth, int maximumWidth) Create a format step which emits the date of the log record with the given justification rules.- Parameters:
timeZone
- the time zone to format toformatString
- the date format stringleftJustify
-true
to left justify,false
to right justifyminimumWidth
- the minimum field width, or 0 for nonemaximumWidth
- the maximum field width (must be greater thanminimumFieldWidth
), or 0 for none- Returns:
- the format step
-
dateFormatStep
public static FormatStep dateFormatStep(TimeZone timeZone, String formatString, boolean leftJustify, int minimumWidth, boolean truncateBeginning, int maximumWidth) Create a format step which emits the date of the log record with the given justification rules.- Parameters:
timeZone
- the time zone to format toformatString
- the date format stringleftJustify
-true
to left justify,false
to right justifyminimumWidth
- the minimum field width, or 0 for nonetruncateBeginning
-true
to truncate the beginning, otherwisefalse
to truncate the endmaximumWidth
- the maximum field width (must be greater thanminimumFieldWidth
), or 0 for none- Returns:
- the format step
-
dateFormatStep
public static FormatStep dateFormatStep(String formatString, boolean leftJustify, int minimumWidth, int maximumWidth) Create a format step which emits the date of the log record with the given justification rules.- Parameters:
formatString
- the date format stringleftJustify
-true
to left justify,false
to right justifyminimumWidth
- the minimum field width, or 0 for nonemaximumWidth
- the maximum field width (must be greater thanminimumFieldWidth
), or 0 for none- Returns:
- the format step
-
fileNameFormatStep
public static FormatStep fileNameFormatStep(boolean leftJustify, int minimumWidth, int maximumWidth) Create a format step which emits the source file name with the given justification rules (NOTE: call stack introspection introduces a significant performance penalty).- Parameters:
leftJustify
-true
to left justify,false
to right justifyminimumWidth
- the minimum field width, or 0 for nonemaximumWidth
- the maximum field width (must be greater thanminimumFieldWidth
), or 0 for none- Returns:
- the format step
-
fileNameFormatStep
public static FormatStep fileNameFormatStep(boolean leftJustify, int minimumWidth, boolean truncateBeginning, int maximumWidth) Create a format step which emits the source file name with the given justification rules (NOTE: call stack introspection introduces a significant performance penalty).- Parameters:
leftJustify
-true
to left justify,false
to right justifyminimumWidth
- the minimum field width, or 0 for nonetruncateBeginning
-true
to truncate the beginning, otherwisefalse
to truncate the endmaximumWidth
- the maximum field width (must be greater thanminimumFieldWidth
), or 0 for none- Returns:
- the format step
-
hostnameFormatStep
public static FormatStep hostnameFormatStep(boolean leftJustify, int minimumWidth, boolean truncateBeginning, int maximumWidth, boolean qualified) Create a format step which emits the hostname.- Parameters:
leftJustify
-true
to left justify,false
to right justifyminimumWidth
- the minimum field width, or 0 for nonetruncateBeginning
-true
to truncate the beginning, otherwisefalse
to truncate the endmaximumWidth
- the maximum field width (must be greater thanminimumFieldWidth
), or 0 for nonequalified
-true
to use the fully qualified host name,false
to only use the- Returns:
- the format step
-
locationInformationFormatStep
public static FormatStep locationInformationFormatStep(boolean leftJustify, int minimumWidth, int maximumWidth) Create a format step which emits the complete source location information with the given justification rules (NOTE: call stack introspection introduces a significant performance penalty).- Parameters:
leftJustify
-true
to left justify,false
to right justifyminimumWidth
- the minimum field width, or 0 for nonemaximumWidth
- the maximum field width (must be greater thanminimumFieldWidth
), or 0 for none- Returns:
- the format step
-
locationInformationFormatStep
public static FormatStep locationInformationFormatStep(boolean leftJustify, int minimumWidth, boolean truncateBeginning, int maximumWidth) Create a format step which emits the complete source location information with the given justification rules (NOTE: call stack introspection introduces a significant performance penalty).- Parameters:
leftJustify
-true
to left justify,false
to right justifyminimumWidth
- the minimum field width, or 0 for nonetruncateBeginning
-true
to truncate the beginning, otherwisefalse
to truncate the endmaximumWidth
- the maximum field width (must be greater thanminimumFieldWidth
), or 0 for none- Returns:
- the format step
-
lineNumberFormatStep
public static FormatStep lineNumberFormatStep(boolean leftJustify, int minimumWidth, int maximumWidth) Create a format step which emits the source file line number with the given justification rules (NOTE: call stack introspection introduces a significant performance penalty).- Parameters:
leftJustify
-true
to left justify,false
to right justifyminimumWidth
- the minimum field width, or 0 for nonemaximumWidth
- the maximum field width (must be greater thanminimumFieldWidth
), or 0 for none- Returns:
- the format step
-
lineNumberFormatStep
public static FormatStep lineNumberFormatStep(boolean leftJustify, int minimumWidth, boolean truncateBeginning, int maximumWidth) Create a format step which emits the source file line number with the given justification rules (NOTE: call stack introspection introduces a significant performance penalty).- Parameters:
leftJustify
-true
to left justify,false
to right justifyminimumWidth
- the minimum field width, or 0 for nonetruncateBeginning
-true
to truncate the beginning, otherwisefalse
to truncate the endmaximumWidth
- the maximum field width (must be greater thanminimumFieldWidth
), or 0 for none- Returns:
- the format step
-
messageFormatStep
Create a format step which emits the formatted log message text with the given justification rules.- Parameters:
leftJustify
-true
to left justify,false
to right justifyminimumWidth
- the minimum field width, or 0 for nonemaximumWidth
- the maximum field width (must be greater thanminimumFieldWidth
), or 0 for none- Returns:
- the format step
-
messageFormatStep
public static FormatStep messageFormatStep(boolean leftJustify, int minimumWidth, boolean truncateBeginning, int maximumWidth) Create a format step which emits the formatted log message text with the given justification rules.- Parameters:
leftJustify
-true
to left justify,false
to right justifyminimumWidth
- the minimum field width, or 0 for nonetruncateBeginning
-true
to truncate the beginning, otherwisefalse
to truncate the endmaximumWidth
- the maximum field width (must be greater thanminimumFieldWidth
), or 0 for none- Returns:
- the format step
-
simpleMessageFormatStep
public static FormatStep simpleMessageFormatStep(boolean leftJustify, int minimumWidth, int maximumWidth) Create a format step which emits the formatted log message text (simple version, no exception traces) with the given justification rules.- Parameters:
leftJustify
-true
to left justify,false
to right justifyminimumWidth
- the minimum field width, or 0 for nonemaximumWidth
- the maximum field width (must be greater thanminimumFieldWidth
), or 0 for none- Returns:
- the format step
-
simpleMessageFormatStep
public static FormatStep simpleMessageFormatStep(boolean leftJustify, int minimumWidth, boolean truncateBeginning, int maximumWidth) Create a format step which emits the formatted log message text (simple version, no exception traces) with the given justification rules.- Parameters:
leftJustify
-true
to left justify,false
to right justifyminimumWidth
- the minimum field width, or 0 for nonetruncateBeginning
-true
to truncate the beginning, otherwisefalse
to truncate the endmaximumWidth
- the maximum field width (must be greater thanminimumFieldWidth
), or 0 for none- Returns:
- the format step
-
exceptionFormatStep
public static FormatStep exceptionFormatStep(boolean leftJustify, int minimumWidth, int maximumWidth, boolean extended) Create a format step which emits the stack trace of an exception with the given justification rules.- Parameters:
leftJustify
-true
to left justify,false
to right justifyminimumWidth
- the minimum field width, or 0 for nonemaximumWidth
- the maximum field width (must be greater thanminimumFieldWidth
), or 0 for noneextended
-true
if the stack trace should attempt to include extended JAR version information- Returns:
- the format step
-
exceptionFormatStep
public static FormatStep exceptionFormatStep(boolean leftJustify, int minimumWidth, boolean truncateBeginning, int maximumWidth, String argument, boolean extended) Create a format step which emits the stack trace of an exception with the given justification rules.- Parameters:
leftJustify
-true
to left justify,false
to right justifyminimumWidth
- the minimum field width, or 0 for nonetruncateBeginning
-true
to truncate the beginning, otherwisefalse
to truncate the endmaximumWidth
- the maximum field width (must be greater thanminimumFieldWidth
), or 0 for noneextended
-true
if the stack trace should attempt to include extended JAR version information- Returns:
- the format step
-
getJarName
-
resourceKeyFormatStep
public static FormatStep resourceKeyFormatStep(boolean leftJustify, int minimumWidth, int maximumWidth) Create a format step which emits the log message resource key (if any) with the given justification rules.- Parameters:
leftJustify
-true
to left justify,false
to right justifyminimumWidth
- the minimum field width, or 0 for nonemaximumWidth
- the maximum field width (must be greater thanminimumFieldWidth
), or 0 for none- Returns:
- the format step
-
resourceKeyFormatStep
public static FormatStep resourceKeyFormatStep(boolean leftJustify, int minimumWidth, boolean truncateBeginning, int maximumWidth) Create a format step which emits the log message resource key (if any) with the given justification rules.- Parameters:
leftJustify
-true
to left justify,false
to right justifyminimumWidth
- the minimum field width, or 0 for nonetruncateBeginning
-true
to truncate the beginning, otherwisefalse
to truncate the endmaximumWidth
- the maximum field width (must be greater thanminimumFieldWidth
), or 0 for none- Returns:
- the format step
-
methodNameFormatStep
public static FormatStep methodNameFormatStep(boolean leftJustify, int minimumWidth, int maximumWidth) Create a format step which emits the source method name with the given justification rules (NOTE: call stack introspection introduces a significant performance penalty).- Parameters:
leftJustify
-true
to left justify,false
to right justifyminimumWidth
- the minimum field width, or 0 for nonemaximumWidth
- the maximum field width (must be greater thanminimumFieldWidth
), or 0 for none- Returns:
- the format step
-
methodNameFormatStep
public static FormatStep methodNameFormatStep(boolean leftJustify, int minimumWidth, boolean truncateBeginning, int maximumWidth) Create a format step which emits the source method name with the given justification rules (NOTE: call stack introspection introduces a significant performance penalty).- Parameters:
leftJustify
-true
to left justify,false
to right justifyminimumWidth
- the minimum field width, or 0 for nonetruncateBeginning
-true
to truncate the beginning, otherwisefalse
to truncate the endmaximumWidth
- the maximum field width (must be greater thanminimumFieldWidth
), or 0 for none- Returns:
- the format step
-
lineSeparatorFormatStep
public static FormatStep lineSeparatorFormatStep(boolean leftJustify, int minimumWidth, int maximumWidth) Create a format step which emits the platform line separator.- Parameters:
leftJustify
-true
to left justify,false
to right justifyminimumWidth
- the minimum field width, or 0 for nonemaximumWidth
- the maximum field width (must be greater thanminimumFieldWidth
), or 0 for none- Returns:
- the format step
-
lineSeparatorFormatStep
public static FormatStep lineSeparatorFormatStep(boolean leftJustify, int minimumWidth, boolean truncateBeginning, int maximumWidth) Create a format step which emits the platform line separator.- Parameters:
leftJustify
-true
to left justify,false
to right justifyminimumWidth
- the minimum field width, or 0 for nonetruncateBeginning
-true
to truncate the beginning, otherwisefalse
to truncate the endmaximumWidth
- the maximum field width (must be greater thanminimumFieldWidth
), or 0 for none- Returns:
- the format step
-
levelFormatStep
Create a format step which emits the log level name.- Parameters:
leftJustify
-true
to left justify,false
to right justifyminimumWidth
- the minimum field width, or 0 for nonemaximumWidth
- the maximum field width (must be greater thanminimumFieldWidth
), or 0 for none- Returns:
- the format step
-
levelFormatStep
public static FormatStep levelFormatStep(boolean leftJustify, int minimumWidth, boolean truncateBeginning, int maximumWidth) Create a format step which emits the log level name.- Parameters:
leftJustify
-true
to left justify,false
to right justifyminimumWidth
- the minimum field width, or 0 for nonetruncateBeginning
-true
to truncate the beginning, otherwisefalse
to truncate the endmaximumWidth
- the maximum field width (must be greater thanminimumFieldWidth
), or 0 for none- Returns:
- the format step
-
localizedLevelFormatStep
public static FormatStep localizedLevelFormatStep(boolean leftJustify, int minimumWidth, int maximumWidth) Create a format step which emits the localized log level name.- Parameters:
leftJustify
-true
to left justify,false
to right justifyminimumWidth
- the minimum field width, or 0 for nonemaximumWidth
- the maximum field width (must be greater thanminimumFieldWidth
), or 0 for none- Returns:
- the format step
-
localizedLevelFormatStep
public static FormatStep localizedLevelFormatStep(boolean leftJustify, int minimumWidth, boolean truncateBeginning, int maximumWidth) Create a format step which emits the localized log level name.- Parameters:
leftJustify
-true
to left justify,false
to right justifyminimumWidth
- the minimum field width, or 0 for nonetruncateBeginning
-true
to truncate the beginning, otherwisefalse
to truncate the endmaximumWidth
- the maximum field width (must be greater thanminimumFieldWidth
), or 0 for none- Returns:
- the format step
-
relativeTimeFormatStep
public static FormatStep relativeTimeFormatStep(long baseTime, boolean leftJustify, int minimumWidth, int maximumWidth) Create a format step which emits the number of milliseconds since the given base time.- Parameters:
baseTime
- the base time as milliseconds as perSystem.currentTimeMillis()
leftJustify
-true
to left justify,false
to right justifyminimumWidth
- the minimum field width, or 0 for nonemaximumWidth
- the maximum field width (must be greater thanminimumFieldWidth
), or 0 for none- Returns:
- the format step
-
relativeTimeFormatStep
public static FormatStep relativeTimeFormatStep(long baseTime, boolean leftJustify, int minimumWidth, boolean truncateBeginning, int maximumWidth) Create a format step which emits the number of milliseconds since the given base time.- Parameters:
baseTime
- the base time as milliseconds as perSystem.currentTimeMillis()
leftJustify
-true
to left justify,false
to right justifyminimumWidth
- the minimum field width, or 0 for nonetruncateBeginning
-true
to truncate the beginning, otherwisefalse
to truncate the endmaximumWidth
- the maximum field width (must be greater thanminimumFieldWidth
), or 0 for none- Returns:
- the format step
-
threadFormatStep
public static FormatStep threadFormatStep(String argument, boolean leftJustify, int minimumWidth, boolean truncateBeginning, int maximumWidth) Create a format step which emits the id ifid
is passed as the argument, otherwise the the thread name is used.- Parameters:
argument
- the argument which may beid
to indicate the thread id ornull
to indicate the thread nameleftJustify
-true
to left justify,false
to right justifyminimumWidth
- the minimum field width, or 0 for nonetruncateBeginning
-true
to truncate the beginning, otherwisefalse
to truncate the endmaximumWidth
- the maximum field width (must be greater thanminimumFieldWidth
), or 0 for none- Returns:
- the format step
-
threadIdFormatStep
public static FormatStep threadIdFormatStep(boolean leftJustify, int minimumWidth, boolean truncateBeginning, int maximumWidth) Create a format step which emits the id of the thread which originated the log record.- Parameters:
leftJustify
-true
to left justify,false
to right justifyminimumWidth
- the minimum field width, or 0 for nonetruncateBeginning
-true
to truncate the beginning, otherwisefalse
to truncate the endmaximumWidth
- the maximum field width (must be greater thanminimumFieldWidth
), or 0 for none- Returns:
- the format step
-
threadNameFormatStep
public static FormatStep threadNameFormatStep(boolean leftJustify, int minimumWidth, int maximumWidth) Create a format step which emits the name of the thread which originated the log record.- Parameters:
leftJustify
-true
to left justify,false
to right justifyminimumWidth
- the minimum field width, or 0 for nonemaximumWidth
- the maximum field width (must be greater thanminimumFieldWidth
), or 0 for none- Returns:
- the format step
-
threadNameFormatStep
public static FormatStep threadNameFormatStep(boolean leftJustify, int minimumWidth, boolean truncateBeginning, int maximumWidth) Create a format step which emits the name of the thread which originated the log record.- Parameters:
leftJustify
-true
to left justify,false
to right justifyminimumWidth
- the minimum field width, or 0 for nonetruncateBeginning
-true
to truncate the beginning, otherwisefalse
to truncate the endmaximumWidth
- the maximum field width (must be greater thanminimumFieldWidth
), or 0 for none- Returns:
- the format step
-
ndcFormatStep
Create a format step which emits the NDC value of the log record.- Parameters:
leftJustify
-true
to left justify,false
to right justifyminimumWidth
- the minimum field width, or 0 for nonemaximumWidth
- the maximum field width (must be greater thanminimumFieldWidth
), or 0 for none- Returns:
- the format step
-
ndcFormatStep
public static FormatStep ndcFormatStep(boolean leftJustify, int minimumWidth, boolean truncateBeginning, int maximumWidth, int count) Create a format step which emits the NDC value of the log record.- Parameters:
leftJustify
-true
to left justify,false
to right justifyminimumWidth
- the minimum field width, or 0 for nonetruncateBeginning
-true
to truncate the beginning, otherwisefalse
to truncate the endmaximumWidth
- the maximum field width (must be greater thanminimumFieldWidth
), or 0 for nonecount
- the limit to the number of segments to format- Returns:
- the format step
-
mdcFormatStep
public static FormatStep mdcFormatStep(String key, boolean leftJustify, int minimumWidth, int maximumWidth) Create a format step which emits the MDC value associated with the given key of the log record.- Parameters:
leftJustify
-true
to left justify,false
to right justifyminimumWidth
- the minimum field width, or 0 for nonemaximumWidth
- the maximum field width (must be greater thanminimumFieldWidth
), or 0 for none- Returns:
- the format step
-
mdcFormatStep
public static FormatStep mdcFormatStep(String key, boolean leftJustify, int minimumWidth, boolean truncateBeginning, int maximumWidth) Create a format step which emits the MDC value associated with the given key of the log record.- Parameters:
leftJustify
-true
to left justify,false
to right justifyminimumWidth
- the minimum field width, or 0 for nonetruncateBeginning
-true
to truncate the beginning, otherwisefalse
to truncate the endmaximumWidth
- the maximum field width (must be greater thanminimumFieldWidth
), or 0 for none- Returns:
- the format step
-
formatColor
-
systemPropertyFormatStep
public static FormatStep systemPropertyFormatStep(String argument, boolean leftJustify, int minimumWidth, boolean truncateBeginning, int maximumWidth) Create a format step which emits a system property value associated with the given key.- Parameters:
argument
- the argument that may be a key or key with a default value separated by a colon, cannot benull
leftJustify
-true
to left justify,false
to right justifyminimumWidth
- the minimum field width, or 0 for nonetruncateBeginning
-true
to truncate the beginning, otherwisefalse
to truncate the endmaximumWidth
- the maximum field width (must be greater thanminimumFieldWidth
), or 0 for none- Returns:
- the format step
- Throws:
IllegalArgumentException
- if theargument
isnull
SecurityException
- if a security manager exists and itscheckPropertyAccess
method doesn't allow access to the specified system property
-
parsePatternSegments
-
parseCategorySegments
-
findHostname
-
findQualifiedHostname
-