org.apache.logging.log4j.core.pattern

Class JAnsiTextRenderer

java.lang.Object

org.apache.logging.log4j.core.pattern.JAnsiTextRenderer

All Implemented Interfaces:

TextRenderer

public final class JAnsiTextRenderer
extends Object
implements TextRenderer

Renders an input as ANSI escaped output. Uses the JAnsi rendering syntax as the default to render a message into an ANSI escaped string. The default syntax for embedded ANSI codes is:

   @|code(,code)* text|@
 

For example, to render the message "Hello" in green, use:

   @|green Hello|@
 

To render the message "Hello" in bold and red, use:

   @|bold,red Warning!|@
 

You can also define custom style names in the configuration with the syntax:

 %message{ansi}{StyleName=value(,value)*( StyleName=value(,value)*)*}%n
 

For example:

 %message{ansi}{WarningStyle=red,bold KeyStyle=white ValueStyle=blue}%n
 

The call site can look like this:

 logger.info("@|KeyStyle {}|@ = @|ValueStyle {}|@", entry.getKey(), entry.getValue());
 

Note: This class originally copied and then heavily modified code from JAnsi's AnsiRenderer (which is licensed as Apache 2.0.)

See Also:

AnsiRenderer

Field Summary

Fields

Modifier and Type	Field and Description
static Map<String,org.fusesource.jansi.AnsiRenderer.Code[]>	DefaultExceptionStyleMap

Constructor Summary

Constructors

Constructor and Description
JAnsiTextRenderer(String[] formats, Map<String,org.fusesource.jansi.AnsiRenderer.Code[]> defaultStyleMap)

Method Summary

Modifier and Type	Method and Description
Map<String,org.fusesource.jansi.AnsiRenderer.Code[]>	getStyleMap()
void	render(StringBuilder input, StringBuilder output) Renders input text to an output.
void	render(String input, StringBuilder output, String styleName) Renders input text to an output.
String	toString()

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

DefaultExceptionStyleMap

public static final Map<String,org.fusesource.jansi.AnsiRenderer.Code[]> DefaultExceptionStyleMap

Constructor Detail

JAnsiTextRenderer

public JAnsiTextRenderer(String[] formats,
                         Map<String,org.fusesource.jansi.AnsiRenderer.Code[]> defaultStyleMap)

Method Detail

getStyleMap

public Map<String,org.fusesource.jansi.AnsiRenderer.Code[]> getStyleMap()

render

public void render(String input,
                   StringBuilder output,
                   String styleName)
            throws IllegalArgumentException

Description copied from interface: TextRenderer

Renders input text to an output.

Specified by:

render in interface TextRenderer

Parameters:

input - The input

output - The output

styleName - The style name to use to render the input on the output.

Throws:

IllegalArgumentException

render

public void render(StringBuilder input,
                   StringBuilder output)
            throws IllegalArgumentException

Description copied from interface: TextRenderer

Renders input text to an output.

Specified by:

render in interface TextRenderer

Parameters:

input - The input

output - The output

Throws:

IllegalArgumentException

toString

public String toString()

Overrides:

toString in class Object