Class MessageLocalization


  • public final class MessageLocalization
    extends java.lang.Object
    Localizes error messages. The messages are located in the package com.itextpdf.text.error_messages in the form language_country.lng. The internal file encoding is UTF-8 without any escape chars, it's not a normal property file. See en.lng for more information on the internal format.
    • Field Summary

      Fields 
      Modifier and Type Field Description
      private static java.lang.String BASE_PATH  
      private static java.util.HashMap<java.lang.String,​java.lang.String> currentLanguage  
      private static java.util.HashMap<java.lang.String,​java.lang.String> defaultLanguage  
    • Constructor Summary

      Constructors 
      Modifier Constructor Description
      private MessageLocalization()  
    • Method Summary

      All Methods Static Methods Concrete Methods 
      Modifier and Type Method Description
      static java.lang.String getComposedMessage​(java.lang.String key, int p1)
      Get a message with one parameter as an primitive int.
      static java.lang.String getComposedMessage​(java.lang.String key, java.lang.Object... param)
      Get a message with param.length parameters or none if param is null.
      private static java.util.HashMap<java.lang.String,​java.lang.String> getLanguageMessages​(java.lang.String language, java.lang.String country)  
      static java.lang.String getMessage​(java.lang.String key)
      Get a message without parameters.
      static java.lang.String getMessage​(java.lang.String key, boolean useDefaultLanguageIfMessageNotFound)  
      private static java.util.HashMap<java.lang.String,​java.lang.String> readLanguageStream​(java.io.InputStream is)  
      private static java.util.HashMap<java.lang.String,​java.lang.String> readLanguageStream​(java.io.Reader r)  
      static boolean setLanguage​(java.lang.String language, java.lang.String country)
      Sets the language to be used globally for the error messages.
      static void setMessages​(java.io.Reader r)
      Sets the error messages directly from a Reader.
      • Methods inherited from class java.lang.Object

        clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
    • Field Detail

      • defaultLanguage

        private static java.util.HashMap<java.lang.String,​java.lang.String> defaultLanguage
      • currentLanguage

        private static java.util.HashMap<java.lang.String,​java.lang.String> currentLanguage
    • Constructor Detail

      • MessageLocalization

        private MessageLocalization()
    • Method Detail

      • getMessage

        public static java.lang.String getMessage​(java.lang.String key)
        Get a message without parameters.
        Parameters:
        key - the key to the message
        Returns:
        the message
      • getMessage

        public static java.lang.String getMessage​(java.lang.String key,
                                                  boolean useDefaultLanguageIfMessageNotFound)
      • getComposedMessage

        public static java.lang.String getComposedMessage​(java.lang.String key,
                                                          int p1)
        Get a message with one parameter as an primitive int. The parameter will replace the string "{1}" found in the message.
        Parameters:
        key - the key to the message
        p1 - the parameter
        Returns:
        the message
      • getComposedMessage

        public static java.lang.String getComposedMessage​(java.lang.String key,
                                                          java.lang.Object... param)
        Get a message with param.length parameters or none if param is null. In the message the "{1}", "{2}" to "{lenght of param array}" are replaced with the object.toString of the param array. (with param[0] being "{1}")
        Parameters:
        key - the key to the message
        param - array of parameter objects, (toString is used to add it to the message)
        Returns:
        the message
        Since:
        iText 5.0.6
      • setLanguage

        public static boolean setLanguage​(java.lang.String language,
                                          java.lang.String country)
                                   throws java.io.IOException
        Sets the language to be used globally for the error messages. The language is a two letter lowercase country designation like "en" or "pt". The country is an optional two letter uppercase code like "US" or "PT".
        Parameters:
        language - the language
        country - the country
        Returns:
        true if the language was found, false otherwise
        Throws:
        java.io.IOException - on error
      • setMessages

        public static void setMessages​(java.io.Reader r)
                                throws java.io.IOException
        Sets the error messages directly from a Reader.
        Parameters:
        r - the Reader
        Throws:
        java.io.IOException - on error
      • getLanguageMessages

        private static java.util.HashMap<java.lang.String,​java.lang.String> getLanguageMessages​(java.lang.String language,
                                                                                                      java.lang.String country)
                                                                                               throws java.io.IOException
        Throws:
        java.io.IOException
      • readLanguageStream

        private static java.util.HashMap<java.lang.String,​java.lang.String> readLanguageStream​(java.io.InputStream is)
                                                                                              throws java.io.IOException
        Throws:
        java.io.IOException
      • readLanguageStream

        private static java.util.HashMap<java.lang.String,​java.lang.String> readLanguageStream​(java.io.Reader r)
                                                                                              throws java.io.IOException
        Throws:
        java.io.IOException