org.apache.logging.log4j.core.layout

Class YamlLayout

java.lang.Object

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

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

org.apache.logging.log4j.core.layout.YamlLayout

All Implemented Interfaces:

LocationAware, Layout<String>, Encoder<LogEvent>, StringLayout

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

Appends a series of YAML events as strings serialized as bytes.

Encoding

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

Additional Fields

This property allows addition of custom fields into generated JSON. <YamlLayout><KeyValuePair key="foo" value="bar"/></YamlLayout> inserts foo: "bar" directly into YAML output. Supports Lookup expressions.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	AbstractJacksonLayout.LogEventWithAdditionalFields
protected static class	AbstractJacksonLayout.ResolvableKeyValuePair
static class	YamlLayout.Builder<B extends YamlLayout.Builder<B>>

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
protected AbstractJacksonLayout.ResolvableKeyValuePair[]	additionalFields
protected boolean	compact
protected static String	COMPACT_EOL
protected boolean	complete
protected static String	DEFAULT_EOL
protected String	eol
protected boolean	includeNullDelimiter
protected com.fasterxml.jackson.databind.ObjectWriter	objectWriter

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
protected	YamlLayout(Configuration config, boolean locationInfo, boolean properties, boolean complete, boolean compact, boolean eventEol, String headerPattern, String footerPattern, Charset charset, boolean includeStacktrace) Deprecated. Use newBuilder() instead

Method Summary

Modifier and Type	Method and Description
static org.apache.logging.log4j.core.layout.AbstractJacksonLayout	createDefaultLayout() Creates a YAML Layout using the default settings.
static org.apache.logging.log4j.core.layout.AbstractJacksonLayout	createLayout(Configuration config, boolean locationInfo, boolean properties, String headerPattern, String footerPattern, Charset charset, boolean includeStacktrace) Deprecated. Use newBuilder() instead
Map<String,String>	getContentFormat() Returns a description of the content format.
String	getContentType() Returns the content type output by this layout.
byte[]	getFooter() Returns appropriate YAML footer.
byte[]	getHeader() Returns appropriate YAML header.
static <B extends YamlLayout.Builder<B>> B	newBuilder()
String	toSerializable(LogEvent event) Formats a LogEvent.
void	toSerializable(LogEvent event, Writer writer)
protected static boolean	valueNeedsLookup(String value)
protected Object	wrapLogEvent(LogEvent event)

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

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

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

encode, getConfiguration, markEvent

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.Encoder

encode

Field Detail

DEFAULT_EOL

protected static final String DEFAULT_EOL

See Also:

Constant Field Values

COMPACT_EOL

protected static final String COMPACT_EOL

See Also:

Constant Field Values

eol

protected final String eol

objectWriter

protected final com.fasterxml.jackson.databind.ObjectWriter objectWriter

compact

protected final boolean compact

complete

protected final boolean complete

includeNullDelimiter

protected final boolean includeNullDelimiter

additionalFields

protected final AbstractJacksonLayout.ResolvableKeyValuePair[] additionalFields

Constructor Detail

YamlLayout

@Deprecated
protected YamlLayout(Configuration config,
                                 boolean locationInfo,
                                 boolean properties,
                                 boolean complete,
                                 boolean compact,
                                 boolean eventEol,
                                 String headerPattern,
                                 String footerPattern,
                                 Charset charset,
                                 boolean includeStacktrace)

Deprecated. Use newBuilder() instead

Method Detail

getHeader

public byte[] getHeader()

Returns appropriate YAML header.

Specified by:

getHeader in interface Layout<String>

Overrides:

getHeader in class AbstractStringLayout

Returns:

a byte array containing the header, opening the YAML array.

getFooter

public byte[] getFooter()

Returns appropriate YAML footer.

Specified by:

getFooter in interface Layout<String>

Overrides:

getFooter in class AbstractStringLayout

Returns:

a byte array containing the footer, closing the YAML array.

getContentFormat

public Map<String,String> getContentFormat()

Description copied from interface: Layout

Returns a description of the content format.

Specified by:

getContentFormat in interface Layout<String>

Overrides:

getContentFormat in class AbstractLayout<String>

Returns:

a Map of key/value pairs describing the Layout-specific content format, or an empty Map if no content format descriptors are specified.

getContentType

public 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<String>

Overrides:

getContentType in class AbstractStringLayout

Returns:

The content type.

createLayout

@Deprecated
public static org.apache.logging.log4j.core.layout.AbstractJacksonLayout createLayout(Configuration config,
                                                                                                  boolean locationInfo,
                                                                                                  boolean properties,
                                                                                                  String headerPattern,
                                                                                                  String footerPattern,
                                                                                                  Charset charset,
                                                                                                  boolean includeStacktrace)

Deprecated. Use newBuilder() instead

Creates a YAML Layout.

Parameters:

config - The plugin configuration.

locationInfo - If "true", includes the location information in the generated YAML.

properties - If "true", includes the thread context map in the generated YAML.

headerPattern - The header pattern, defaults to "" if null.

footerPattern - The header pattern, defaults to "" if null.

charset - The character set to use, if null, uses "UTF-8".

includeStacktrace - If "true", includes the stacktrace of any Throwable in the generated YAML, defaults to "true".

Returns:

A YAML Layout.

newBuilder

@PluginBuilderFactory
public static <B extends YamlLayout.Builder<B>> B newBuilder()

createDefaultLayout

public static org.apache.logging.log4j.core.layout.AbstractJacksonLayout createDefaultLayout()

Creates a YAML Layout using the default settings. Useful for testing.

Returns:

A YAML Layout.

valueNeedsLookup

protected static boolean valueNeedsLookup(String value)

toSerializable

public String toSerializable(LogEvent event)

Formats a LogEvent.

Parameters:

event - The LogEvent.

Returns:

The XML representation of the LogEvent.

wrapLogEvent

protected Object wrapLogEvent(LogEvent event)

toSerializable

public void toSerializable(LogEvent event,
                           Writer writer)
                    throws com.fasterxml.jackson.core.JsonGenerationException,
                           com.fasterxml.jackson.databind.JsonMappingException,
                           IOException

Throws:

com.fasterxml.jackson.core.JsonGenerationException

com.fasterxml.jackson.databind.JsonMappingException

IOException