Module io.jstach.jstachio

Package io.jstach.jstachio.formatters

Interface DefaultFormatter

All Superinterfaces:

Formatter, Function<@Nullable Object,String>

@JStacheFormatter
@JStacheFormatterTypes(types={java.net.URI.class,java.net.URL.class})
public interface DefaultFormatter
extends Formatter

Default formatters. Unlike the mustache spec it will throw a NPE trying to format null objects.

Author:

agentgt

Nested Class Summary

Nested classes/interfaces inherited from interface io.jstach.jstachio.Formatter

Formatter.Formattable

Method Summary

Modifier and Type	Method	Description
default <A extends Output<E>, E extends Exception> void	format(Appender downstream, A a, String path, @Nullable String s)	Formats the object and then sends the results to the downstream appender.
default <A extends Output<E>, E extends Exception> void	format(Appender downstream, A a, String path, Class<?> c, @Nullable Object o)	Formats the object and then sends the results to the downstream appender.
static Formatter	of()	Provides the default formatter for static lookup.
static Formatter	provider()	Provides the default formatter for static lookup.

Methods inherited from interface io.jstach.jstachio.Formatter

apply, format, format, format, format, format, format, format

Methods inherited from interface java.util.function.Function

andThen, compose

Method Details

format

default <A extends Output<E>,
E extends Exception>
void format(Appender downstream,
 A a,
 String path,
 Class<?> c,
 @Nullable Object o)
     throws E

Formats the object and then sends the results to the downstream appender. Will throw an NPE if parameter o is null.

Specified by:

format in interface Formatter

Type Parameters:

A - the appendable type

E - the appender exception type

Parameters:

downstream - the downstream appender to be used instead of the appendable directly

a - the appendable to be passed to the appender

path - the dotted mustache like path

c - the object class but is not guaranteed to be accurate. If it is not known Object.class will be used.

o - the object which maybe null

Throws:

E - if the appender or appendable throws an exception

format

default <A extends Output<E>,
E extends Exception>
void format(Appender downstream,
 A a,
 String path,
 @Nullable String s)
     throws E

Formats the object and then sends the results to the downstream appender. The default implementation calls Formatter.format(Appender, Output, String, Class, Object) and it is generally recommend you override for performance. Will throw an NPE if parameter s is null.

Specified by:

format in interface Formatter

Type Parameters:

A - the appendable type

E - the appender exception type

Parameters:

downstream - the downstream appender to be used instead of the appendable directly

a - the appendable to be passed to the appender

path - the dotted mustache like path

s - String value which maybe null.

Throws:

E - if the appender or appendable throws an exception

provider

static Formatter provider()

Provides the default formatter for static lookup.

Returns:

the default formatter singleton

of

static Formatter of()

Provides the default formatter for static lookup.

Returns:

the default formatter singleton