Package org.apache.taglibs.standard.tag.common.fmt

Class BundleSupport

  • All Implemented Interfaces:
    java.io.Serializable, javax.servlet.jsp.tagext.BodyTag, javax.servlet.jsp.tagext.IterationTag, javax.servlet.jsp.tagext.JspTag, javax.servlet.jsp.tagext.Tag
    Direct Known Subclasses:
    BundleTag, BundleTag
    public abstract class BundleSupport
extends javax.servlet.jsp.tagext.BodyTagSupport
    Support for tag handlers for <bundle>, the resource bundle loading tag in JSTL 1.0.
    See Also:
    Serialized Form

    • Field Summary

      Fields 
      Modifier and Type Field Description
      protected java.lang.String basename  
      private static java.util.Locale EMPTY_LOCALE  
      private java.util.Locale fallbackLocale  
      private LocalizationContext locCtxt  
      protected java.lang.String prefix  

      • Fields inherited from class javax.servlet.jsp.tagext.BodyTagSupport

        bodyContent

      • Fields inherited from class javax.servlet.jsp.tagext.TagSupport

        id, pageContext

      • Fields inherited from interface javax.servlet.jsp.tagext.BodyTag

        EVAL_BODY_BUFFERED, EVAL_BODY_TAG

      • Fields inherited from interface javax.servlet.jsp.tagext.IterationTag

        EVAL_BODY_AGAIN

      • Fields inherited from interface javax.servlet.jsp.tagext.Tag

        EVAL_BODY_INCLUDE, EVAL_PAGE, SKIP_BODY, SKIP_PAGE

    • Constructor Summary

      Constructors 
      Constructor Description
      BundleSupport()  

    • Method Summary

      All Methods Static Methods Instance Methods Concrete Methods 
      Modifier and Type Method Description
      int doStartTag()  
      private static java.util.ResourceBundle findMatch​(java.lang.String basename, java.util.Locale pref)  
      private static LocalizationContext findMatch​(javax.servlet.jsp.PageContext pageContext, java.lang.String basename)  
      private static java.lang.ClassLoader getClassLoaderCheckingPrivilege()  
      LocalizationContext getLocalizationContext()  
      static LocalizationContext getLocalizationContext​(javax.servlet.jsp.PageContext pc)
      Gets the default I18N localization context.
      static LocalizationContext getLocalizationContext​(javax.servlet.jsp.PageContext pc, java.lang.String basename)
      Gets the resource bundle with the given base name, whose locale is determined as follows:
      java.lang.String getPrefix()  
      private void init()  
      void release()  

      • Methods inherited from class javax.servlet.jsp.tagext.BodyTagSupport

        doAfterBody, doEndTag, doInitBody, getBodyContent, getPreviousOut, setBodyContent

      • Methods inherited from class javax.servlet.jsp.tagext.TagSupport

        findAncestorWithClass, getId, getParent, getValue, getValues, removeValue, setId, setPageContext, setParent, setValue

      • Methods inherited from class java.lang.Object

        clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

      • Methods inherited from interface javax.servlet.jsp.tagext.Tag

        getParent, setPageContext, setParent

    • Field Detail

      • EMPTY_LOCALE

        private static final java.util.Locale EMPTY_LOCALE

      • basename

        protected java.lang.String basename

      • prefix

        protected java.lang.String prefix

      • fallbackLocale

        private java.util.Locale fallbackLocale

    • Constructor Detail

      • BundleSupport

        public BundleSupport()

    • Method Detail

      • init

        private void init()

      • getPrefix

        public java.lang.String getPrefix()

      • doStartTag

        public int doStartTag()
               throws javax.servlet.jsp.JspException
        Specified by:
        doStartTag in interface javax.servlet.jsp.tagext.Tag
        Overrides:
        doStartTag in class javax.servlet.jsp.tagext.BodyTagSupport
        Throws:
        javax.servlet.jsp.JspException

      • release

        public void release()
        Specified by:
        release in interface javax.servlet.jsp.tagext.Tag
        Overrides:
        release in class javax.servlet.jsp.tagext.BodyTagSupport

      • getLocalizationContext

        public static LocalizationContext getLocalizationContext​(javax.servlet.jsp.PageContext pc)
        Gets the default I18N localization context.
        Parameters:
        pc - Page in which to look up the default I18N localization context

      • getLocalizationContext

        public static LocalizationContext getLocalizationContext​(javax.servlet.jsp.PageContext pc,
                                                         java.lang.String basename)
        Gets the resource bundle with the given base name, whose locale is determined as follows:

        Check if a match exists between the ordered set of preferred locales and the available locales, for the given base name. The set of preferred locales consists of a single locale (if the javax.servlet.jsp.jstl.fmt.locale configuration setting is present) or is equal to the client's preferred locales determined from the client's browser settings.

        If no match was found in the previous step, check if a match exists between the fallback locale (given by the javax.servlet.jsp.jstl.fmt.fallbackLocale configuration setting) and the available locales, for the given base name.

        Parameters:
        pc - Page in which the resource bundle with the given base name is requested
        basename - Resource bundle base name
        Returns:
        Localization context containing the resource bundle with the given base name and the locale that led to the resource bundle match, or the empty localization context if no resource bundle match was found

      • findMatch

        private static LocalizationContext findMatch​(javax.servlet.jsp.PageContext pageContext,
                                             java.lang.String basename)

      • findMatch

        private static java.util.ResourceBundle findMatch​(java.lang.String basename,
                                                  java.util.Locale pref)

      • getClassLoaderCheckingPrivilege

        private static java.lang.ClassLoader getClassLoaderCheckingPrivilege()