Class I18nx_impl

java.lang.Object
org.apache.uima.internal.util.I18nx_impl

public class I18nx_impl extends Object
Common implementation of InternationalizedException and InternationalizedRuntimeException
  • Field Details

    • mResourceBundleName

      private String mResourceBundleName
      The base name of the resource bundle in which the message for this exception is located.
    • mMessageKey

      private String mMessageKey
      An identifier that maps to the message for this exception.
    • mArguments

      private Object[] mArguments
      The arguments to this exception's message, if any. This allows an InternationalizedException to have a compound message, made up of multiple parts that are concatenated in a language-neutral way.
    • mCause

      private Throwable mCause
      The exception that caused this exception to occur.
    • originalContextClassLoader

      private final transient ClassLoader originalContextClassLoader
      the thread local class loader at creation time, see UIMA-4793 Transient to allow exceptions to be serialized. Deserialized versions have null as their value, which is handled by the users
    • default_localized_resourceBundle

      private final transient ResourceBundle default_localized_resourceBundle
    • default_locale

      private final transient Locale default_locale
    • user_specified_resourceBundle

      private transient ResourceBundle user_specified_resourceBundle
  • Constructor Details

    • I18nx_impl

      public I18nx_impl(String aResourceBundleName, String aMessageKey, Object[] aArguments, Throwable aCause)
      Creates a new InternationalizedException with the specified message and cause.
      Parameters:
      aResourceBundleName - the base name of the resource bundle in which the message for this exception is located.
      aMessageKey - an identifier that maps to the message for this exception. The message may contain placeholders for arguments as defined by the MessageFormat class.
      aArguments - The arguments to the message. null may be used if the message has no arguments.
      aCause - the original exception that caused this exception to be thrown, if any
  • Method Details

    • getResourceBundleName

      public String getResourceBundleName()
      Gets the base name of the resource bundle in which the message for this exception is located.
      Returns:
      the resource bundle base name. May return null if this exception has no message.
    • getMessageKey

      public String getMessageKey()
      Gets the identifier for this exception's message. This identifier can be looked up in this exception's ResourceBundle to get the locale-specific message for this exception.
      Returns:
      the resource identifier for this exception's message. May return null if this exception has no message.
    • getArguments

      public Object[] getArguments()
      Gets the arguments to this exception's message. Arguments allow a InternationalizedException to have a compound message, made up of multiple parts that are concatenated in a language-neutral way.
      Returns:
      the arguments to this exception's message.
    • getMessage

      public String getMessage()
      Gets the English detail message for this exception. For the localized message use getLocalizedMessage().
      Returns:
      the English detail message for this exception.
    • getLocalizedMessage

      public String getLocalizedMessage()
      Gets the localized detail message for this exception. This uses the default Locale for this JVM. A Locale may be specified using getLocalizedMessage(Locale).
      Returns:
      this exception's detail message, localized for the default Locale.
    • getLocalizedMessage

      public String getLocalizedMessage(Locale aLocale)
      Gets the localized detail message for this exception using the specified Locale.
      Parameters:
      aLocale - the locale to use for localizing the message
      Returns:
      this exception's detail message, localized for the specified Locale.
    • getCause

      public Throwable getCause()
      Gets the cause of this Exception.
      Returns:
      the Throwable that caused this Exception to occur, if any. Returns null if there is no such cause.
    • setCause

      public void setCause(Throwable cause)
    • hasMessageKey

      public boolean hasMessageKey(String messageKey)
      Checks if this exception, or any of its root causes, has a particular UIMA message key. This allows checking for particular error condition
      Parameters:
      messageKey - to search for in the exception chain
      Returns:
      true if this exception or any of its root causes has a particular UIMA message key.
    • setResourceBundle

      public void setResourceBundle(Locale aLocale)
      For the case where the default locale is not being used for getting messages, and the lookup path in the classpath for the resource bundle needs to be set at a specific point, call this method to set the resource bundle at that point in the call stack. Example: If in a Pear, and you are throwing an exception, which is defined in a bundle in the Pear context, but the catcher of the throw is up the stack above where the pear context exists (and therefore, is no longer present at "catch" time), and you don't want to use the default-locale for getting the message out of the message bundle, then do something like this Exception e = new AnalysisEngineProcessException(MESSAGE_BUNDLE, "TEST_KEY", objects); e.setResourceBundle(my_locale); // call this method, pass in the needed locale object throw e; // or whatever should be done with it
      Parameters:
      aLocale - the locale to use when getting the message from the message bundle at a later time