org.ujorm.tools.msg

Class MessageService

java.lang.Object

org.ujorm.tools.msg.MessageService

@Immutable
public class MessageService
extends Object

Message Service. See the next example

  final MessageService service = new MessageService();
  final MessageArg<String> NAME = new MessageArg<>("NAME");
  final MessageArg<String> TYPE = new MessageArg<>("TYPE");

  String expResult = "The ORM framework Ujorm.";
  String expTemplate = "The ${TYPE} framework ${NAME}.";
  String template = service.template("The ", TYPE, " framework ", NAME, ".");
  Map args = service.map
      ( TYPE, "ORM"
      , NAME, "Ujorm");
  String result = service.format(template, args);
  assertEquals(expTemplate, template);
  assertEquals(expResult, result);
 

Since:

1.53

Field Summary

Fields

Modifier and Type	Field and Description
protected Locale	defaultLocale Default locale
static String	PARAM_BEG Two-character mark ("${") to introducing a template argument.
static char	PARAM_END The mark ("}") to finishing a template argument.

Constructor Summary

Constructors

Constructor and Description
MessageService() Create new instance with the Locale.ENGLISH
MessageService(Locale defaultLocale)

Method Summary

Modifier and Type	Method and Description
protected String	convertKey(Object key) Convert value.
String	format(String msg, Map<String,Object> args) Format a template message using named variables.
String	format(String msg, Map<String,Object> args, Locale locale) Format a template message using named variables.
static String	formatMsg(String template, Map<String,Object> args) Format a target message by a template with arguments
Map<String,Object>	map(Object... args) Create a map from man pairs key-value
String	template(Object... args) Create a message template from argument pairs key-value
protected void	writeValue(Object value, CharArrayWriter writer, Locale locale) Write a value to the output buffer.

Methods inherited from class java.lang.Object

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

Field Detail

PARAM_BEG

public static final String PARAM_BEG

Two-character mark ("${") to introducing a template argument.

See Also:

Constant Field Values

PARAM_END

public static final char PARAM_END

The mark ("}") to finishing a template argument.

See Also:

Constant Field Values

defaultLocale

@Nonnull
protected final Locale defaultLocale

Default locale

Constructor Detail

MessageService

public MessageService()

Create new instance with the Locale.ENGLISH

MessageService

public MessageService(@Nonnull
                      Locale defaultLocale)

Method Detail

map

public Map<String,Object> map(@Nonnull
                              Object... args)

Create a map from man pairs key-value

Parameters:

args - Key-value pairs

template

public String template(@Nonnull
                       Object... args)

Create a message template from argument pairs key-value

Parameters:

args - Sequence of the Objects and Arguments

format

public final String format(@Nullable
                           String msg,
                           @Nullable
                           Map<String,Object> args)

Format a template message using named variables. Each variable must be surrounded by two marks "${" and "}". The first mark is forbidden in a common text and can be replaced by the variable #{MARK}.

Parameters:

msg - Template message, see the simple example:

"The input date ${KEY,%s} must be less than: ${DATE,%F}"

or

"The input date ${KEY,%s} must be less than: ${DATE,%tY-%tm-%td %tH:%tM:%tS}"

The format expression is separated by the character (,) a and it is not mandatory.

args - Key-value map arguments

Returns:

Target result

See Also:

Formatter

format

public final String format(@Nullable
                           String msg,
                           @Nullable
                           Map<String,Object> args,
                           @Nullable
                           Locale locale)

Format a template message using named variables. Each variable must be surrounded by two marks "${" and "}". The first mark is forbidden in a common text and can be replaced by the variable #{MARK}.

Parameters:

msg - Template message, see the simple example:

"The input date ${KEY,%s} must be less than: ${DATE,%F}"

or

"The input date ${KEY,%s} must be less than: ${DATE,%tY-%tm-%td %tH:%tM:%tS}"

The format expression is separated by the character (,) a and it is not mandatory.

args - Key-value map arguments where arguments type of Supplier ares supported.

locale - The target locale for an argument format, the null locale will be replaced by the defaultLocale.

Returns:

Target result

See Also:

Formatter

convertKey

@Nullable
protected String convertKey(@Nonnull
                                      Object key)

Convert value. The method can be overwrited for special data types, for example: Key -> Key.getFullName() .

writeValue

protected void writeValue(@Nonnull
                          Object value,
                          @Nonnull
                          CharArrayWriter writer,
                          @Nullable
                          Locale locale)

Write a value to the output buffer. The method can be overwrited to escaping values. The method can be overwrited for special data types.

formatMsg

public static final String formatMsg(@Nullable
                                     String template,
                                     @Nullable
                                     Map<String,Object> args)

Format a target message by a template with arguments