net.logstash.logback.marker

Class LogstashMarker

java.lang.Object

net.logstash.logback.marker.LogstashBasicMarker

net.logstash.logback.marker.LogstashMarker

All Implemented Interfaces:

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

Direct Known Subclasses:

DeferredLogstashMarker, EmptyLogstashMarker, MapEntriesAppendingMarker, ObjectFieldsAppendingMarker, SingleFieldAppendingMarker

public abstract class LogstashMarker
extends LogstashBasicMarker
implements Iterable<org.slf4j.Marker>

A Marker that is known and understood by the logstash logback encoder.

In particular these markers are used to write data into the logstash json event via writeTo(JsonGenerator).

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
LogstashMarker(String name)

Method Summary

Modifier and Type	Method and Description
<T extends LogstashMarker> T	and(org.slf4j.Marker reference) Adds the given marker as a reference, and returns this marker.
String	toString() Returns a String in the form of
protected String	toStringSelf() Returns a string representation of this object, without including any references.
<T extends LogstashMarker> T	with(org.slf4j.Marker reference) Deprecated. Use and(Marker) instead
abstract void	writeTo(JsonGenerator generator) Writes the data associated with this marker to the given JsonGenerator.

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

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

Methods inherited from class java.lang.Object

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

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

LogstashMarker

public LogstashMarker(String name)

Method Detail

and

public <T extends LogstashMarker> T and(org.slf4j.Marker reference)

Adds the given marker as a reference, and returns this marker.

This can be used to chain markers together fluently on a log line. For example:

 
 import static net.logstash.logback.marker.Markers.*
     
 logger.info(append("name1", "value1).and(append("name2", "value2")), "log message");
 
 

Type Parameters:

T - subtype of LogstashMarker

Parameters:

reference - The marker to add

Returns:

A marker with this marker and the given marker

with

@Deprecated
public <T extends LogstashMarker> T with(org.slf4j.Marker reference)

Deprecated. Use and(Marker) instead

Type Parameters:

T - subtype of LogstashMarker

Parameters:

reference - The marker to add

Returns:

A marker with this marker and the given marker

See Also:

and(Marker)

writeTo

public abstract void writeTo(JsonGenerator generator)
                      throws IOException

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

Parameters:

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

Throws:

IOException - if there was an error writing to the generator

toString

public String toString()

Returns a String in the form of

     self, reference1, reference2, ...
 

Where self is the value returned by toStringSelf(), and reference* are the toString() values of any references.

It is recommended that subclasses only override toStringSelf(), so that references are automatically included in the value returned from toString().

Overrides:

toString in class LogstashBasicMarker

Returns:

a string representation of the object, which includes references

toStringSelf

protected String toStringSelf()

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

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

Returns:

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