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

Class BundleSupport

java.lang.Object

jakarta.servlet.jsp.tagext.TagSupport

jakarta.servlet.jsp.tagext.BodyTagSupport

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

All Implemented Interfaces:

BodyTag, IterationTag, JspTag, Tag, Serializable

Direct Known Subclasses:

BundleTag, BundleTag

public abstract class BundleSupport
extends BodyTagSupport

Support for tag handlers for <bundle>, the resource bundle loading tag in JSTL 1.0.

Author:

Jan Luehe

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field	Description
protected String	basename
protected String	prefix

Fields inherited from class jakarta.servlet.jsp.tagext.BodyTagSupport

bodyContent

Fields inherited from class jakarta.servlet.jsp.tagext.TagSupport

id, pageContext

Fields inherited from interface jakarta.servlet.jsp.tagext.BodyTag

EVAL_BODY_BUFFERED, EVAL_BODY_TAG

Fields inherited from interface jakarta.servlet.jsp.tagext.IterationTag

EVAL_BODY_AGAIN

Fields inherited from interface jakarta.servlet.jsp.tagext.Tag

EVAL_BODY_INCLUDE, EVAL_PAGE, SKIP_BODY, SKIP_PAGE

Constructor Summary

Constructors

Constructor	Description
BundleSupport()

Method Summary

Modifier and Type	Method	Description
int	doEndTag()	Default processing of the end tag returning EVAL_PAGE.
int	doStartTag()	Default processing of the start tag returning EVAL_BODY_BUFFERED.
LocalizationContext	getLocalizationContext()
static LocalizationContext	getLocalizationContext(PageContext pc)	Gets the default I18N localization context.
static LocalizationContext	getLocalizationContext(PageContext pc, 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.
String	getPrefix()
void	release()	Release state.

Methods inherited from class jakarta.servlet.jsp.tagext.BodyTagSupport

doAfterBody, doInitBody, getBodyContent, getPreviousOut, setBodyContent

Methods inherited from class jakarta.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 jakarta.servlet.jsp.tagext.Tag

getParent, setPageContext, setParent

Field Detail

basename

protected String basename

prefix

protected String prefix

Constructor Detail

BundleSupport

public BundleSupport()

Method Detail

getLocalizationContext

public LocalizationContext getLocalizationContext()

getPrefix

public String getPrefix()

doStartTag

public int doStartTag()
               throws JspException

Description copied from class: BodyTagSupport

Default processing of the start tag returning EVAL_BODY_BUFFERED.

Specified by:

doStartTag in interface Tag

Overrides:

doStartTag in class BodyTagSupport

Returns:

EVAL_BODY_BUFFERED

Throws:

JspException - if an error occurred while processing this tag

See Also:

Tag.doStartTag()

doEndTag

public int doEndTag()
             throws JspException

Description copied from class: BodyTagSupport

Default processing of the end tag returning EVAL_PAGE.

Specified by:

doEndTag in interface Tag

Overrides:

doEndTag in class BodyTagSupport

Returns:

EVAL_PAGE

Throws:

JspException - if an error occurred while processing this tag

See Also:

Tag.doEndTag()

release

public void release()

Description copied from class: BodyTagSupport

Release state.

Specified by:

release in interface Tag

Overrides:

release in class BodyTagSupport

See Also:

Tag.release()

getLocalizationContext

public static LocalizationContext getLocalizationContext(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(PageContext pc,
                                                         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 jakarta.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 jakarta.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