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(Appendable writer, 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(Appendable writer, T... templateAndArguments) Format the message from Object array
protected void	writeValue(Object value, Appendable 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
                                     Appendable writer,
                                     @Nullable
                                     CharSequence messageTemplate,
                                     @Nullable
                                     T... argumentValues)
                              throws IOException

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:

writer - An optional writer

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

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

Returns:

A result text or an empty text, if the writer is available.

Throws:

IOException

formatMsg

@Nullable
protected <T> String formatMsg(@Nullable
                                         Appendable writer,
                                         @Nullable
                                         T... templateAndArguments)
                                  throws IOException

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.

Throws:

IOException

writeValue

protected void writeValue(@Nullable
                          Object value,
                          @Nonnull
                          Appendable out,
                          boolean marked)
                   throws IOException

Print argument to the Writter with an optional format.

Parameters:

out - Appendable

value - Value where the Supplier interface is supported.

Throws:

IOException

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.