org.apache.logging.log4j.core.layout

Class HtmlLayout

java.lang.Object

org.apache.logging.log4j.core.layout.AbstractLayout<java.lang.String>

org.apache.logging.log4j.core.layout.AbstractStringLayout

org.apache.logging.log4j.core.layout.HtmlLayout

All Implemented Interfaces:

Layout<java.lang.String>, Encoder<LogEvent>, StringLayout

@Plugin(name="HtmlLayout",
        category="Core",
        elementType="layout",
        printObject=true)
public final class HtmlLayout
extends AbstractStringLayout

Outputs events as rows in an HTML table on an HTML page.

Appenders using this layout should have their encoding set to UTF-8 or UTF-16, otherwise events containing non ASCII characters could result in corrupted log files.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	HtmlLayout.Builder
static class	HtmlLayout.FontSize Possible font sizes

Nested classes/interfaces inherited from class org.apache.logging.log4j.core.layout.AbstractStringLayout

AbstractStringLayout.Serializer, AbstractStringLayout.Serializer2

Field Summary

Fields

Modifier and Type	Field and Description
private java.lang.String	contentType
private static java.lang.String	DEFAULT_CONTENT_TYPE
static java.lang.String	DEFAULT_FONT_FAMILY Default font family: "arial,sans-serif".
private static java.lang.String	DEFAULT_TITLE
private java.lang.String	font
private java.lang.String	fontSize
private java.lang.String	headerSize
private long	jvmStartTime
private boolean	locationInfo
private static java.lang.String	REGEXP
private java.lang.String	title
private static java.lang.String	TRACE_PREFIX

Fields inherited from class org.apache.logging.log4j.core.layout.AbstractStringLayout

DEFAULT_STRING_BUILDER_SIZE, MAX_STRING_BUILDER_SIZE

Fields inherited from class org.apache.logging.log4j.core.layout.AbstractLayout

configuration, eventCount, footer, header, LOGGER

Fields inherited from interface org.apache.logging.log4j.core.Layout

ELEMENT_TYPE

Constructor Summary

Constructors

Modifier	Constructor and Description
private	HtmlLayout(boolean locationInfo, java.lang.String title, java.lang.String contentType, java.nio.charset.Charset charset, java.lang.String font, java.lang.String fontSize, java.lang.String headerSize)

Method Summary

Modifier and Type	Method and Description
private java.lang.String	addCharsetToContentType(java.lang.String contentType)
private java.lang.StringBuilder	append(java.lang.StringBuilder sbuilder, java.lang.String s)
private java.lang.StringBuilder	appendLs(java.lang.StringBuilder sbuilder, java.lang.String s)
private void	appendThrowableAsHtml(java.lang.Throwable throwable, java.lang.StringBuilder sbuf)
static HtmlLayout	createDefaultLayout() Creates an HTML Layout using the default settings.
static HtmlLayout	createLayout(boolean locationInfo, java.lang.String title, java.lang.String contentType, java.nio.charset.Charset charset, java.lang.String fontSize, java.lang.String font) Creates an HTML Layout.
java.lang.String	getContentType() Returns the content type output by this layout.
byte[]	getFooter() Returns the appropriate HTML footers.
byte[]	getHeader() Returns appropriate HTML headers.
java.lang.String	getTitle() For testing purposes.
boolean	isLocationInfo() For testing purposes.
static HtmlLayout.Builder	newBuilder()
java.lang.String	toSerializable(LogEvent event) Formats as a String.

Methods inherited from class org.apache.logging.log4j.core.layout.AbstractStringLayout

getBytes, getCharset, getFooterSerializer, getHeaderSerializer, getStringBuilder, getStringBuilderEncoder, serializeToBytes, serializeToString, toByteArray, trimToMaxSize

Methods inherited from class org.apache.logging.log4j.core.layout.AbstractLayout

encode, getConfiguration, getContentFormat, markEvent, writeTo

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.apache.logging.log4j.core.Layout

getContentFormat

Methods inherited from interface org.apache.logging.log4j.core.layout.Encoder

encode

Field Detail

DEFAULT_FONT_FAMILY

public static final java.lang.String DEFAULT_FONT_FAMILY

Default font family: "arial,sans-serif".

See Also:

Constant Field Values

TRACE_PREFIX

private static final java.lang.String TRACE_PREFIX

See Also:

Constant Field Values

REGEXP

private static final java.lang.String REGEXP

DEFAULT_TITLE

private static final java.lang.String DEFAULT_TITLE

See Also:

Constant Field Values

DEFAULT_CONTENT_TYPE

private static final java.lang.String DEFAULT_CONTENT_TYPE

See Also:

Constant Field Values

jvmStartTime

private final long jvmStartTime

locationInfo

private final boolean locationInfo

title

private final java.lang.String title

contentType

private final java.lang.String contentType

font

private final java.lang.String font

fontSize

private final java.lang.String fontSize

headerSize

private final java.lang.String headerSize

Constructor Detail

HtmlLayout

private HtmlLayout(boolean locationInfo,
                   java.lang.String title,
                   java.lang.String contentType,
                   java.nio.charset.Charset charset,
                   java.lang.String font,
                   java.lang.String fontSize,
                   java.lang.String headerSize)

Method Detail

getTitle

public java.lang.String getTitle()

For testing purposes.

isLocationInfo

public boolean isLocationInfo()

For testing purposes.

addCharsetToContentType

private java.lang.String addCharsetToContentType(java.lang.String contentType)

toSerializable

public java.lang.String toSerializable(LogEvent event)

Formats as a String.

Parameters:

event - The Logging Event.

Returns:

A String containing the LogEvent as HTML.

getContentType

public java.lang.String getContentType()

Description copied from interface: Layout

Returns the content type output by this layout. The base class returns "text/plain".

Specified by:

getContentType in interface Layout<java.lang.String>

Overrides:

getContentType in class AbstractStringLayout

Returns:

The default content type for Strings.

appendThrowableAsHtml

private void appendThrowableAsHtml(java.lang.Throwable throwable,
                                   java.lang.StringBuilder sbuf)

appendLs

private java.lang.StringBuilder appendLs(java.lang.StringBuilder sbuilder,
                                         java.lang.String s)

append

private java.lang.StringBuilder append(java.lang.StringBuilder sbuilder,
                                       java.lang.String s)

getHeader

public byte[] getHeader()

Returns appropriate HTML headers.

Specified by:

getHeader in interface Layout<java.lang.String>

Overrides:

getHeader in class AbstractStringLayout

Returns:

The header as a byte array.

getFooter

public byte[] getFooter()

Returns the appropriate HTML footers.

Specified by:

getFooter in interface Layout<java.lang.String>

Overrides:

getFooter in class AbstractStringLayout

Returns:

the footer as a byte array.

createLayout

@PluginFactory
public static HtmlLayout createLayout(@PluginAttribute(value="locationInfo")
                                                     boolean locationInfo,
                                                     @PluginAttribute(value="title",defaultString="Log4j Log Messages")
                                                     java.lang.String title,
                                                     @PluginAttribute(value="contentType")
                                                     java.lang.String contentType,
                                                     @PluginAttribute(value="charset",defaultString="UTF-8")
                                                     java.nio.charset.Charset charset,
                                                     @PluginAttribute(value="fontSize")
                                                     java.lang.String fontSize,
                                                     @PluginAttribute(value="fontName",defaultString="arial,sans-serif")
                                                     java.lang.String font)

Creates an HTML Layout.

Parameters:

locationInfo - If "true", location information will be included. The default is false.

title - The title to include in the file header. If none is specified the default title will be used.

contentType - The content type. Defaults to "text/html".

charset - The character set to use. If not specified, the default will be used.

fontSize - The font size of the text.

font - The font to use for the text.

Returns:

An HTML Layout.

createDefaultLayout

public static HtmlLayout createDefaultLayout()

Creates an HTML Layout using the default settings.

Returns:

an HTML Layout.

newBuilder

@PluginBuilderFactory
public static HtmlLayout.Builder newBuilder()