net.logstash.logback.marker

Class SingleFieldAppendingMarker

java.lang.Object

net.logstash.logback.marker.LogstashBasicMarker

net.logstash.logback.marker.LogstashMarker

net.logstash.logback.marker.SingleFieldAppendingMarker

All Implemented Interfaces:

Serializable, Iterable<org.slf4j.Marker>, StructuredArgument, org.slf4j.Marker

Direct Known Subclasses:

ObjectAppendingMarker, RawJsonAppendingMarker

public abstract class SingleFieldAppendingMarker
extends LogstashMarker
implements StructuredArgument

A Marker OR StructuredArgument that appends a single field into the JSON event.

When writing to the JSON data (via ArgumentsJsonProvider or LogstashMarkersJsonProvider):

• Field names are written via writeFieldName(JsonGenerator), which just uses fieldName is used as the field name
• Values are written via writeFieldValue(JsonGenerator), which subclasses must override

When writing to a String (when used as a StructuredArgument to the event's formatted message), the messageFormatPattern is used to construct the string output. getFieldName() will be substituted in {0} in the messageFormatPattern. getFieldValue() will be substituted in {1} in the messageFormatPattern. Subclasses must override getFieldValue() to provide the field value to include.

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
static String	MARKER_NAME_PREFIX

Fields inherited from interface org.slf4j.Marker

ANY_MARKER, ANY_NON_NULL_MARKER

Constructor Summary

Constructors

Constructor and Description
SingleFieldAppendingMarker(String markerName, String fieldName)
SingleFieldAppendingMarker(String markerName, String fieldName, String messageFormatPattern)

Method Summary

Modifier and Type	Method and Description
boolean	equals(Object obj)
String	getFieldName()
abstract Object	getFieldValue() Return the value that should be included in the output of LogstashMarker.toString().
int	hashCode()
String	toStringSelf() Returns a string representation of this object, without including any references.
protected void	writeFieldName(JsonGenerator generator) Writes the field name to the generator.
protected abstract void	writeFieldValue(JsonGenerator generator) Writes the field value to the generator.
void	writeTo(JsonGenerator generator) Writes the data associated with this marker to the given JsonGenerator.

Methods inherited from class net.logstash.logback.marker.LogstashMarker

and, toString, with

Methods inherited from class net.logstash.logback.marker.LogstashBasicMarker

add, contains, contains, getName, hasChildren, hasReferences, iterator, remove

Methods inherited from class java.lang.Object

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

Methods inherited from interface net.logstash.logback.argument.StructuredArgument

toString

Methods inherited from interface java.lang.Iterable

forEach, iterator, spliterator

Field Detail

MARKER_NAME_PREFIX

public static final String MARKER_NAME_PREFIX

See Also:

Constant Field Values

Constructor Detail

SingleFieldAppendingMarker

public SingleFieldAppendingMarker(String markerName,
                                  String fieldName)

SingleFieldAppendingMarker

public SingleFieldAppendingMarker(String markerName,
                                  String fieldName,
                                  String messageFormatPattern)

Method Detail

getFieldName

public String getFieldName()

writeTo

public void writeTo(JsonGenerator generator)
             throws IOException

Description copied from class: LogstashMarker

Writes the data associated with this marker to the given JsonGenerator.

Specified by:

writeTo in interface StructuredArgument

Specified by:

writeTo in class LogstashMarker

Parameters:

generator - the generator to which to write the output of this marker.

Throws:

IOException - if there was an error writing to the generator

writeFieldName

protected void writeFieldName(JsonGenerator generator)
                       throws IOException

Writes the field name to the generator.

Throws:

IOException

writeFieldValue

protected abstract void writeFieldValue(JsonGenerator generator)
                                 throws IOException

Writes the field value to the generator.

Throws:

IOException

toStringSelf

public String toStringSelf()

Description copied from class: LogstashMarker

Returns a string representation of this object, without including any references.

Subclasses should override LogstashMarker.toStringSelf() instead of LogstashMarker.toString(), since LogstashMarker.toString() will automatically include the LogstashMarker.toStringSelf() and references.

Overrides:

toStringSelf in class LogstashMarker

Returns:

a string representation of this object, without including any references.

getFieldValue

public abstract Object getFieldValue()

Return the value that should be included in the output of LogstashMarker.toString().

equals

public boolean equals(Object obj)

Specified by:

equals in interface org.slf4j.Marker

Overrides:

equals in class LogstashBasicMarker

hashCode

public int hashCode()

Specified by:

hashCode in interface org.slf4j.Marker

Overrides:

hashCode in class LogstashBasicMarker