org.ujorm.tools.msg

Class MsgFormatter

java.lang.Object

org.ujorm.tools.msg.MsgFormatter

Direct Known Subclasses:

ValueFormatter

@Immutable
public class MsgFormatter
extends Object

Formatter of log messages where argument is located by the {} characters. See the next correct asserts:

  assertEquals("TEST"    , MsgFormatter.format("TE{}T", "S"));
  assertEquals("TE, S, T", MsgFormatter.format("TE", "S", "T"));
  assertEquals("TES{}"   , MsgFormatter.format("TE{}{}", "S"));
 

Since:

1.73

Field Summary

Fields

Modifier and Type	Field and Description
protected static String	DEFAULT_MARK Parameter mark
protected static char	SEPARATOR Separator of unmarked arguments '{}' was changed to a single space from release 1.91

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	MsgFormatter() Static methods are available only
protected	MsgFormatter(String mark) Static methods are available only

Method Summary

Modifier and Type	Method and Description
static <T> String	format(CharSequence messageTemplate, T... arguments) Format the message, see the next correct asserts: assertEquals("TEST" , MsgFormatter.format("TE{}T", "S")); assertEquals("TE S T", MsgFormatter.format("TE", "S", "T")); assertEquals("TES{}" , MsgFormatter.format("TE{}{}", "S"));
static <T> String	format(T... templateAndArguments) Format the message from Object array
<T> String	formatMsg(CharSequence messageTemplate, T... argumentValues) Format the message, see the next correct asserts: assertEquals("TEST" , MsgFormatter.format("TE{}T", "S")); assertEquals("TE, S, T", MsgFormatter.format("TE", "S", "T")); assertEquals("TES{}" , MsgFormatter.format("TE{}{}", "S"));
protected <T> String	formatMsg(T... templateAndArguments) Format the message from Object array
protected static PrintWriter	getPrintWriter(Appendable appendable) Convert appendable to object type of PrintWriter
protected void	writeValue(Object value, StringBuilder out, boolean marked) Print argument to the Writter with an optional format.

Methods inherited from class java.lang.Object

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

Field Detail

DEFAULT_MARK

protected static final String DEFAULT_MARK

Parameter mark

See Also:

Constant Field Values

SEPARATOR

protected static final char SEPARATOR

Separator of unmarked arguments '{}' was changed to a single space from release 1.91

See Also:

Constant Field Values

Constructor Detail

MsgFormatter

protected MsgFormatter()

Static methods are available only

MsgFormatter

protected MsgFormatter(@Nonnull
                       String mark)

Static methods are available only

Method Detail

formatMsg

@Nonnull
public <T> String formatMsg(@Nullable
                                     CharSequence messageTemplate,
                                     @Nullable
                                     T... argumentValues)

Format the message, see the next correct asserts:

  assertEquals("TEST"    , MsgFormatter.format("TE{}T", "S"));
  assertEquals("TE, S, T", MsgFormatter.format("TE", "S", "T"));
  assertEquals("TES{}"   , MsgFormatter.format("TE{}{}", "S"));
 

Parameters:

messageTemplate - Template where argument position is marked by the {} characters.

argumentValues - Optional arguments, where the Supplier interface is supported.

Returns:

A result text

formatMsg

@Nullable
protected <T> String formatMsg(@Nullable
                                         T... templateAndArguments)

Format the message from Object array

Parameters:

templateAndArguments - The first item is a template where parameters are located by "{}" text and the next arguments are optional parameters of the template.

Returns:

In case the argument have no length, the result message is null.

writeValue

protected void writeValue(@Nullable
                          Object value,
                          @Nonnull
                          StringBuilder out,
                          boolean marked)

Print argument to the Writter with an optional format.

Parameters:

out - Writer

value - Value where the Supplier interface is supported.

format

@Nonnull
public static <T> String format(@Nullable
                                         CharSequence messageTemplate,
                                         @Nullable
                                         T... arguments)

Format the message, see the next correct asserts:

  assertEquals("TEST"    , MsgFormatter.format("TE{}T", "S"));
  assertEquals("TE S T", MsgFormatter.format("TE", "S", "T"));
  assertEquals("TES{}"   , MsgFormatter.format("TE{}{}", "S"));
 

Parameters:

messageTemplate - Template where argument position is marked by the {} characters.

arguments - Optional arguments, where the Supplier interface is supported.

Returns:

format

@Nullable
public static <T> String format(@Nullable
                                          T... templateAndArguments)

Format the message from Object array

Parameters:

templateAndArguments - The first item is a template where parameters are located by "{}". The Supplier interface is supported. text and the next arguments are optional parameters of the template.

Returns:

In case the argument have no length, the result message is null.

getPrintWriter

@Nonnull
protected static PrintWriter getPrintWriter(@Nonnull
                                                     Appendable appendable)

Convert appendable to object type of PrintWriter