Class TemplateNumberFormatFactory

    • Method Summary

      All Methods Instance Methods Abstract Methods 
      Modifier and Type Method Description
      abstract TemplateNumberFormat get​(java.lang.String params, java.util.Locale locale, Environment env)
      Returns a formatter for the given parameters.
      • Methods inherited from class java.lang.Object

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

      • TemplateNumberFormatFactory

        public TemplateNumberFormatFactory()
    • Method Detail

      • get

        public abstract TemplateNumberFormat get​(java.lang.String params,
                                                 java.util.Locale locale,
                                                 Environment env)
                                          throws TemplateValueFormatException
        Returns a formatter for the given parameters.

        The returned formatter can be a new instance or a reused (cached) instance. Note that Environment itself caches the returned instances, though that cache is lost with the Environment (i.e., when the top-level template execution ends), also it might flushes lot of entries if the locale or time zone is changed during template execution. So caching on the factory level is still useful, unless creating the formatters is sufficiently cheap.

        Parameters:
        params - The string that further describes how the format should look. For example, when the numberFormat is "@fooBar 1, 2", then it will be "1, 2" (and "@fooBar" selects the factory). The format of this string is up to the TemplateNumberFormatFactory implementation. Not null, often an empty string.
        locale - The locale to format for. Not null. The resulting format must be bound to this locale forever (i.e. locale changes in the Environment must not be followed).
        env - The runtime environment from which the formatting was called. This is mostly meant to be used for Environment.setCustomState(Object, Object)/Environment.getCustomState(Object).
        Throws:
        TemplateValueFormatException - if any problem occurs while parsing/getting the format. Notable subclasses: InvalidFormatParametersException if the params is malformed.