Module io.jstach.rainbowgum.json

Package io.jstach.rainbowgum.json

Class JsonBuffer

java.lang.Object

io.jstach.rainbowgum.json.JsonBuffer

All Implemented Interfaces:

LogEncoder.Buffer, AutoCloseable

public final class JsonBuffer
extends Object
implements LogEncoder.Buffer

A buffer designed for encoding JSON efficiently.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static enum	JsonBuffer.ExtendedFieldPrefix	Extended fields are just fields that have some special prefix for things like GELF and ECS.
static enum	JsonBuffer.JSONToken	JSON tokens.

Nested classes/interfaces inherited from interface io.jstach.rainbowgum.LogEncoder.Buffer

LogEncoder.Buffer.StringBuilderBuffer

Field Summary

Fields

Modifier and Type	Field	Description
static final int	EXTENDED_F	A flag to indicate this field is extended which means it will be prefixed with JsonBuffer.ExtendedFieldPrefix.

Constructor Summary

Constructors

Constructor	Description
JsonBuffer(boolean prettyPrint, JsonBuffer.ExtendedFieldPrefix extendedFieldPrefix)	Create a JSON buffer.

Method Summary

Modifier and Type	Method	Description
void	clear()	Prepare the buffer for reuse.
void	drain(LogOutput output, LogEvent event)	The appender will call this usually within a lock to transfer content from the buffer to the output.
StringBuilder	getFormattedMessageBuilder()	Reusable String buffer for formatted messages.
final void	write(JsonBuffer.JSONToken token)	Writes a JSON token.
final int	write(String k, @Nullable String v, int index)	Writes a string field.
final int	write(String k, @Nullable String v, int index, int flag)	Writes a string field.
final int	writeDouble(String k, double v, int index, int flag)	Writes a double field.
final int	writeInt(String k, int v, int index, int flag)	Writes a string field.
final void	writeLineFeed()	Efficiently writes a line feed.

Methods inherited from class java.lang.Object

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

Methods inherited from interface io.jstach.rainbowgum.LogEncoder.Buffer

close

Field Details

EXTENDED_F

public static final int EXTENDED_F

A flag to indicate this field is extended which means it will be prefixed with JsonBuffer.ExtendedFieldPrefix.

See Also:

• Constant Field Values

Constructor Details

JsonBuffer

public JsonBuffer(boolean prettyPrint,
 JsonBuffer.ExtendedFieldPrefix extendedFieldPrefix)

Create a JSON buffer.

Parameters:

prettyPrint - whether or not to pretty print the JSON.

extendedFieldPrefix - prefix for extended fields.

Method Details

drain

public void drain(LogOutput output,
 LogEvent event)

Description copied from interface: LogEncoder.Buffer

The appender will call this usually within a lock to transfer content from the buffer to the output.

Specified by:

drain in interface LogEncoder.Buffer

Parameters:

output - output to receive content.

event - log event.

clear

public void clear()

Description copied from interface: LogEncoder.Buffer

Prepare the buffer for reuse.

An appender may not call clear before being passed to the encoder so the encoder should do its own clearing.

Specified by:

clear in interface LogEncoder.Buffer

getFormattedMessageBuilder

public StringBuilder getFormattedMessageBuilder()

Reusable String buffer for formatted messages.

Returns:

buffer.

write

public final void write(JsonBuffer.JSONToken token)

Writes a JSON token.

Parameters:

token - token not null.

writeLineFeed

public final void writeLineFeed()

Efficiently writes a line feed.

write

public final int write(String k,
 @Nullable String v,
 int index)

Writes a string field.

Parameters:

k - field name

v - value

index - the current index for comma determination

Returns:

index + 1

write

public final int write(String k,
 @Nullable String v,
 int index,
 int flag)

Writes a string field.

Parameters:

k - field name

v - value

index - the current index for comma determination

flag - see EXTENDED_F

Returns:

index + 1

writeDouble

public final int writeDouble(String k,
 double v,
 int index,
 int flag)

Writes a double field.

Parameters:

k - field name

v - value

index - the current index for comma determination

flag - see EXTENDED_F

Returns:

index + 1

writeInt

public final int writeInt(String k,
 int v,
 int index,
 int flag)

Writes a string field.

Parameters:

k - field name

v - value

index - the current index for comma determination

flag - see EXTENDED_F

Returns:

index + 1