Package io.micronaut.context

Interface MessageSource

All Superinterfaces:
Ordered
All Known Implementing Classes:
AbstractMessageSource, CompositeMessageSource, ResourceBundleMessageSource, StaticMessageSource
@Singleton @Indexed(MessageSource.class) public interface MessageSource extends Ordered
Interface for resolving messages from some source.
Since:
1.2
Author:
graemerocher

  • Field Details

    • EMPTY

      static final MessageSource EMPTY
      An empty message source.

  • Method Details

    • getMessage

      default Optional<String> getMessage(String code, Locale locale)
      Resolve a message for the given code and context.
      Parameters:
      code - The code
      locale - The locale to use to resolve messages.
      Returns:
      A message if present

    • getMessage

      default Optional<String> getMessage(String code, Locale locale, Object... variables)
      Resolve a message for the given code and context.
      Parameters:
      code - The code
      locale - The locale to use to resolve messages.
      variables - The variables to use resolve message placeholders
      Returns:
      A message if present

    • getMessage

      default Optional<String> getMessage(String code, Locale locale, Map<String,Object> variables)
      Resolve a message for the given code and context.
      Parameters:
      code - The code
      locale - The locale to use to resolve messages.
      variables - The variables to use resolve message placeholders
      Returns:
      A message if present

    • getMessage

      default Optional<String> getMessage(String code, MessageSource.MessageContext context)
      Resolve a message for the given code and context.
      Parameters:
      code - The code
      context - The context
      Returns:
      A message if present

    • getMessage

      default String getMessage(String code, String defaultMessage, Locale locale)
      Resolve a message for the given code and context.
      Parameters:
      code - The code
      defaultMessage - The default message to use if no other message is found
      locale - The locale to use to resolve messages.
      Returns:
      A message if present

    • getMessage

      default String getMessage(String code, String defaultMessage, Locale locale, Map<String,Object> variables)
      Resolve a message for the given code and context.
      Parameters:
      code - The code
      defaultMessage - The default message to use if no other message is found
      locale - The locale to use to resolve messages.
      variables - The variables to use resolve message placeholders
      Returns:
      A message if present

    • getMessage

      default String getMessage(String code, String defaultMessage, Locale locale, Object... variables)
      Resolve a message for the given code and context.
      Parameters:
      code - The code
      defaultMessage - The default message to use if no other message is found
      locale - The locale to use to resolve messages.
      variables - The variables to use resolve message placeholders
      Returns:
      A message if present

    • getMessage

      default String getMessage(String code, MessageSource.MessageContext context, String defaultMessage)
      Resolve a message for the given code and context.
      Parameters:
      code - The code
      context - The context
      defaultMessage - The default message to use if no other message is found
      Returns:
      A message if present

    • getRawMessage

      Optional<String> getRawMessage(String code, MessageSource.MessageContext context)
      Resolve a message for the given code and context.
      Parameters:
      code - The code
      context - The context
      Returns:
      A message if present

    • getRawMessage

      default String getRawMessage(String code, MessageSource.MessageContext context, String defaultMessage)
      Resolve a message for the given code and context.
      Parameters:
      code - The code
      context - The context
      defaultMessage - The default message to use if no other message is found
      Returns:
      A message if present

    • interpolate

      String interpolate(String template, MessageSource.MessageContext context)
      Interpolate the given message template.
      Parameters:
      template - The template
      context - The context to use.
      Returns:
      The interpolated message.
      Throws:
      IllegalArgumentException - If any argument specified is null

    • getRequiredMessage

      default String getRequiredMessage(String code, MessageSource.MessageContext context)
      Resolve a message for the given code and context or throw an exception.
      Parameters:
      code - The code
      context - The context
      Returns:
      The message
      Throws:
      NoSuchMessageException - if the message is not found

    • getRequiredRawMessage

      default String getRequiredRawMessage(String code, MessageSource.MessageContext context)
      Resolve a message for the given code and context or throw an exception.
      Parameters:
      code - The code
      context - The context
      Returns:
      The message
      Throws:
      NoSuchMessageException - if the message is not found