3.2.6.5. Messages
API 文档

Messages 接口提供了获取本地消息字符串的方法。

主要方法如下：

  • getMessage() – 根据消息键名、包名和需要的语言环境返回本地化的消息。该方法有几个重载，如果未在方法参数中指定语言环境，则使用当前用户语言设置。

    例如:

    @Inject
protected Messages messages;
...
String message1 = messages.getMessage(getClass(), "someMessage");
String message2 = messages.getMessage("com.abc.sales.web.customer", "someMessage");
String message3 = messages.getMessage(RoleType.STANDARD);

  • formatMessage() – 通过消息键名、包名和需要的语言环境检索本地化消息，然后使用获取到的消息格式化输入的参数。格式化消息根据 String.format() 方法的规则定义。该方法有几个重载，如果未在方法参数中指定语言环境，则使用当前用户的语言设置。

    例如:

    String formattedValue = messages.formatMessage(getClass(), "someFormat", someValue);

  • getMainMessage() – 从应用程序 block 的主消息包返回本地化消息。

    例如:

    protected Messages messages = AppBeans.get(Messages.class);
...
messages.getMainMessage("actions.Ok");

  • getMainMessagePack() – 返回应用程序 block 的主消息包的名称。

    例如:

    String formattedValue = messages.formatMessage(messages.getMainMessagePack(), "someFormat", someValue);

  • getTools() – 返回 MessageTools 接口实例（见下文）。