jstl reference

TLDDoc Generated Documentation

TLDDoc Generated DocumentationAll Tags / Functions

Tag Libraries JSTL core JSTL fmt JSTL sql JSTL XML JSTL functions

All Tags / Functions

c:catch c:choose c:forEach c:forTokens c:if c:import c:otherwise c:out c:param c:redirect c:remove c:set c:url c:when fmt:bundle fmt:formatDate fmt:formatNumber fmt:message fmt:param fmt:parseDate fmt:parseNumber fmt:requestEncoding fmt:setBundle fmt:setLocale fmt:setTimeZone fmt:timeZone fn:contains() fn:containsIgnoreCase() fn:endsWith() fn:escapeXml() fn:indexOf() fn:join() fn:length() fn:replace() fn:split() fn:startsWith() fn:substring()

Overview Library Tag Help

FRAMES NO FRAMES

JavaServer Pages Standard Tag Library 1.1 Tag Reference

Tag LibrariesJSTL core JSTL 1.1 core library

JSTL fmt JSTL 1.1 i18n-capable formatting library

JSTL sql JSTL 1.1 sql library

JSTL XML JSTL 1.1 XML library

JSTL functions

JSTL 1.1 functions library


FRAMES NO FRAMES

Output Generated by TLDDoc. Java, JSP, and JavaServer Pages are trademarks or registered trademarks of Sun Microsystems, Inc. in the US and other countries. Copyright 2002-3 Sun Microsystems, Inc. 4150 Network Circle Santa Clara, CA 95054, U.S.A. All Rights Reserved.

http://java.sun.com/products/jsp/jstl/1.1/docs/tlddocs/index.html (1 of 2)23/01/08 10:11:11 AM

http://developers.sun.com/dev/coolstuff/tlddoc/

TLDDoc Generated Documentation

fn:substringAfter() fn:substringBefore() fn:toLowerCase() fn:toUpperCase() fn:trim() sql:dateParam sql:param sql:query sql:setDataSource sql:transaction sql:update x:choose x:forEach x:if x:otherwise x:out x:param x:parse x:set x:transform x:when

http://java.sun.com/products/jsp/jstl/1.1/docs/tlddocs/index.html (2 of 2)23/01/08 10:11:11 AM



c:catch c:choose c:forEach c:forTokens c:if c:import c:otherwise c:out c:param c:redirect c:remove c:set c:url c:when fmt:bundle fmt:formatDate fmt:formatNumber fmt:message fmt:param fmt:parseDate fmt:parseNumber fmt:requestEncoding fmt:setBundle fmt:setLocale fmt:setTimeZone fmt:timeZone fn:contains() fn:containsIgnoreCase() fn:endsWith() fn:escapeXml() fn:indexOf() fn:join() fn:length() fn:replace() fn:split() fn:startsWith() fn:substring()

http://java.sun.com/products/jsp/jstl/1.1/docs/tlddocs/alltags-frame.html (1 of 2)23/01/08 10:11:14 AM


fn:substringAfter() fn:substringBefore() fn:toLowerCase() fn:toUpperCase() fn:trim() sql:dateParam sql:param sql:query sql:setDataSource sql:transaction sql:update x:choose x:forEach x:if x:otherwise x:out x:param x:parse x:set x:transform x:when

http://java.sun.com/products/jsp/jstl/1.1/docs/tlddocs/alltags-frame.html (2 of 2)23/01/08 10:11:14 AM

catch (TLDDoc Generated Documentation)


FRAMES NO FRAMES

JSTL core Tag catch

Catches any Throwable that occurs in its body and optionally exposes it.

Tag InformationTag Class org.apache.taglibs.standard.tag.common.core.CatchTag

TagExtraInfo Class None

Body Content JSP

Display Name None

AttributesName Required Request-time Type Description

var false false java.lang.String Name of the exported scoped variable for the exception thrown from a nested action. The type of the scoped variable is the type of the exception thrown.

VariablesNo Variables Defined.


FRAMES NO FRAMES


http://java.sun.com/products/jsp/jstl/1.1/docs/tlddocs/c/catch.html23/01/08 10:11:17 AM

http://tlddoc.dev.java.net/

Overview (TLDDoc Generated Documentation)


FRAMES NO FRAMES

JavaServer Pages Standard Tag Library 1.1 Tag Reference

Tag LibrariesJSTL core JSTL 1.1 core library

JSTL fmt JSTL 1.1 i18n-capable formatting library

JSTL sql JSTL 1.1 sql library

JSTL XML JSTL 1.1 XML library

JSTL functions JSTL 1.1 functions library


FRAMES NO FRAMES


http://java.sun.com/products/jsp/jstl/1.1/docs/tlddocs/overview-summary.html23/01/08 10:11:18 AM

http://developers.sun.com/dev/coolstuff/tlddoc/

API Help (TLDDoc Generated Documentation)


PREV NEXT FRAMES NO FRAMES

How This Tag Library Document Is Organized

This TLD (Tag Library Descriptor) document has pages corresponding to the items in the navigation bar, described as follows.

Overview

The Overview page is the front page of this TLD document and provides a list of all tag libraries with a summary for each.

Library

Each tag library has a page that contains a list of its validator, listeners, tags, and functions, with a summary for each. This page can contain four categories:

● Validator● Listeners● Tags● Functions

Validator

A tag library can have at most one validator. If a tag library has a validator, it has its own page describing the validator, the class that implements the validator, and the available initialization parameters.

Listeners

A tag library can have zero or more listeners. If a tag library has at least one listener, a page is generated that lists all listener classes registered for the tag library.

Tags

A tag library can have zero or more tags. Each tag has its own page that describes the tag, its display name, its unique action name, the class that implements the tag, the

http://java.sun.com/products/jsp/jstl/1.1/docs/tlddocs/help-doc.html (1 of 2)23/01/08 10:11:20 AM

API Help (TLDDoc Generated Documentation)

TagExtraInfo class, the body content type, scripting variable information, attributes, whether the tag supports dynamic attributes, and an optional example use of the tag.

Functions

A tag library can contain zero or more EL functions. If a tag library has at least one function, a page is generated that lists all functions, the class that implements the function, the function signature, and an optional example use of the function.

Prev/Next

These links take you to the next or previous validator, listener, tag, function, or related page.

Frames/No Frames

These links show and hide the HTML frames. All pages are available with or without frames.


PREV NEXT FRAMES NO FRAMES


http://java.sun.com/products/jsp/jstl/1.1/docs/tlddocs/help-doc.html (2 of 2)23/01/08 10:11:20 AM


JSTL core (TLDDoc Generated Documentation)


FRAMES NO FRAMES

JSTL core

Standard Syntax: <%@ taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core" %>

XML Syntax: <anyxmlelement xmlns:c="http://java.sun.com/jsp/jstl/core" />

JSTL 1.1 core library

Tag Library InformationDisplay Name JSTL core

Version 1.1

Short Name c

URI http://java.sun.com/jsp/jstl/core

Tag Summarycatch Catches any Throwable that occurs in its body and optionally exposes it.

choose Simple conditional tag that establishes a context for mutually exclusive conditional operations, marked by <when> and <otherwise>

ifSimple conditional tag, which evalutes its body if the supplied condition is true and optionally exposes a Boolean scripting variable representing the evaluation of this condition

import Retrieves an absolute or relative URL and exposes its contents to either the page, a String in 'var', or a Reader in 'varReader'.

forEach The basic iteration tag, accepting many different collection types and supporting subsetting and other functionality

forTokens Iterates over tokens, separated by the supplied delimeters

http://java.sun.com/products/jsp/jstl/1.1/docs/tlddocs/c/tld-summary.html (1 of 2)23/01/08 10:11:22 AM

JSTL core (TLDDoc Generated Documentation)

out Like <%= ... >, but for expressions.

otherwise Subtag of <choose> that follows <when> tags and runs only if all of the prior conditions evaluated to 'false'

param Adds a parameter to a containing 'import' tag's URL.

redirect Redirects to a new URL.

remove Removes a scoped variable (from a particular scope, if specified).

set Sets the result of an expression evaluation in a 'scope'

url Creates a URL with optional query parameters.

when Subtag of <choose> that includes its body if its condition evalutes to 'true'

Tag Library Validatororg.apache.taglibs.standard.tlv.JstlCoreTLV

Provides core validation features for JSTL tags.


FRAMES NO FRAMES

Java, JSP, and JavaServer Pages are trademarks or registered trademarks of Sun Microsystems, Inc. in the US and other countries. Copyright 2002-3 Sun Microsystems, Inc. 4150 Network Circle Santa Clara, CA 95054, U.S.A. All Rights Reserved.

http://java.sun.com/products/jsp/jstl/1.1/docs/tlddocs/c/tld-summary.html (2 of 2)23/01/08 10:11:22 AM

choose (TLDDoc Generated Documentation)


FRAMES NO FRAMES

JSTL core Tag choose

Simple conditional tag that establishes a context for mutually exclusive conditional operations, marked by <when> and <otherwise>

Tag InformationTag Class org.apache.taglibs.standard.tag.common.core.ChooseTag


Body Content JSP

Display Name None

AttributesNo Attributes Defined.



FRAMES NO FRAMES


http://java.sun.com/products/jsp/jstl/1.1/docs/tlddocs/c/choose.html23/01/08 10:11:31 AM


if (TLDDoc Generated Documentation)


FRAMES NO FRAMES

JSTL core Tag if

Simple conditional tag, which evalutes its body if the supplied condition is true and optionally exposes a Boolean scripting variable representing the evaluation of this condition

Tag InformationTag Class org.apache.taglibs.standard.tag.rt.core.IfTag


Body Content JSP

Display Name None


test true true boolean The test condition that determines whether or not the body content should be processed.

var false false java.lang.String Name of the exported scoped variable for the resulting value of the test condition. The type of the scoped variable is Boolean.

scope false false java.lang.String Scope for var.



http://java.sun.com/products/jsp/jstl/1.1/docs/tlddocs/c/if.html (1 of 2)23/01/08 10:11:33 AM


FRAMES NO FRAMES


http://java.sun.com/products/jsp/jstl/1.1/docs/tlddocs/c/if.html (2 of 2)23/01/08 10:11:33 AM


import (TLDDoc Generated Documentation)


FRAMES NO FRAMES

JSTL core Tag import

Retrieves an absolute or relative URL and exposes its contents to either the page, a String in 'var', or a Reader in 'varReader'.

Tag InformationTag Class org.apache.taglibs.standard.tag.rt.core.ImportTag

TagExtraInfo Class org.apache.taglibs.standard.tei.ImportTEI

Body Content JSP

Display Name None


url true true java.lang.String The URL of the resource to import.

var false false java.lang.String Name of the exported scoped variable for the resource's content. The type of the scoped variable is String.


varReader false false java.lang.String Name of the exported scoped variable for the resource's content. The type of the scoped variable is Reader.

context false true java.lang.String Name of the context when accessing a relative URL resource that belongs to a foreign context.

http://java.sun.com/products/jsp/jstl/1.1/docs/tlddocs/c/import.html (1 of 2)23/01/08 10:11:35 AM

import (TLDDoc Generated Documentation)

charEncoding false true java.lang.String Character encoding of the content at the input resource.



FRAMES NO FRAMES


http://java.sun.com/products/jsp/jstl/1.1/docs/tlddocs/c/import.html (2 of 2)23/01/08 10:11:35 AM


forEach (TLDDoc Generated Documentation)


FRAMES NO FRAMES

JSTL core Tag forEach

The basic iteration tag, accepting many different collection types and supporting subsetting and other functionality

Tag InformationTag Class org.apache.taglibs.standard.tag.rt.core.ForEachTag

TagExtraInfo Class org.apache.taglibs.standard.tei.ForEachTEI

Body Content JSP

Display Name None


items false true java.lang.Object

Collection of items to iterate over.

begin false true int If items specified: Iteration begins at the item located at the specified index. First item of the collection has index 0. If items not specified: Iteration begins with index set at the value specified.

end false true int If items specified: Iteration ends at the item located at the specified index (inclusive). If items not specified: Iteration ends when index reaches the value specified.

step false true int Iteration will only process every step items of the collection, starting with the first one.

http://java.sun.com/products/jsp/jstl/1.1/docs/tlddocs/c/forEach.html (1 of 2)23/01/08 10:11:37 AM


var false false java.lang.String

Name of the exported scoped variable for the current item of the iteration. This scoped variable has nested visibility. Its type depends on the object of the underlying collection.

varStatus false false java.lang.String

Name of the exported scoped variable for the status of the iteration. Object exported is of type javax.servlet.jsp.jstl.core.LoopTagStatus. This scoped variable has nested visibility.



FRAMES NO FRAMES


http://java.sun.com/products/jsp/jstl/1.1/docs/tlddocs/c/forEach.html (2 of 2)23/01/08 10:11:37 AM


forTokens (TLDDoc Generated Documentation)


FRAMES NO FRAMES

JSTL core Tag forTokens

Iterates over tokens, separated by the supplied delimeters

Tag InformationTag Class org.apache.taglibs.standard.tag.rt.core.ForTokensTag


Body Content JSP

Display Name None


items true true java.lang.String String of tokens to iterate over.

delims true true java.lang.String The set of delimiters (the characters that separate the tokens in the string).

begin false true int Iteration begins at the token located at the specified index. First token has index 0.

end false true int Iteration ends at the token located at the specified index (inclusive).

step false true int Iteration will only process every step tokens of the string, starting with the first one.

var false false java.lang.String Name of the exported scoped variable for the current item of the iteration. This scoped variable has nested visibility.

http://java.sun.com/products/jsp/jstl/1.1/docs/tlddocs/c/forTokens.html (1 of 2)23/01/08 10:11:40 AM

forTokens (TLDDoc Generated Documentation)

varStatus false false java.lang.String Name of the exported scoped variable for the status of the iteration. Object exported is of type javax.servlet.jsp.jstl.core.LoopTag Status. This scoped variable has nested visibility.



FRAMES NO FRAMES


http://java.sun.com/products/jsp/jstl/1.1/docs/tlddocs/c/forTokens.html (2 of 2)23/01/08 10:11:40 AM


out (TLDDoc Generated Documentation)


FRAMES NO FRAMES

JSTL core Tag out

Like <%= ... >, but for expressions.

Tag InformationTag Class org.apache.taglibs.standard.tag.rt.core.OutTag


Body Content JSP

Display Name None


value true true java.lang.String Expression to be evaluated.

default false true java.lang.String Default value if the resulting value is null.

escapeXml false true java.lang.String Determines whether characters <,>,&,'," in the resulting string should be converted to their corresponding character entity codes. Default value is true.



FRAMES NO FRAMES

http://java.sun.com/products/jsp/jstl/1.1/docs/tlddocs/c/out.html (1 of 2)23/01/08 10:11:42 AM



http://java.sun.com/products/jsp/jstl/1.1/docs/tlddocs/c/out.html (2 of 2)23/01/08 10:11:42 AM


otherwise (TLDDoc Generated Documentation)


FRAMES NO FRAMES

JSTL core Tag otherwise

Subtag of <choose> that follows <when> tags and runs only if all of the prior conditions evaluated to 'false'

Tag InformationTag Class org.apache.taglibs.standard.tag.common.core.OtherwiseTag


Body Content JSP

Display Name None




FRAMES NO FRAMES


http://java.sun.com/products/jsp/jstl/1.1/docs/tlddocs/c/otherwise.html23/01/08 10:11:44 AM


param (TLDDoc Generated Documentation)


FRAMES NO FRAMES

JSTL core Tag param

Adds a parameter to a containing 'import' tag's URL.

Tag InformationTag Class org.apache.taglibs.standard.tag.rt.core.ParamTag


Body Content JSP

Display Name None


name true true java.lang.String Name of the query string parameter.

value false true java.lang.String Value of the parameter.



FRAMES NO FRAMES


http://java.sun.com/products/jsp/jstl/1.1/docs/tlddocs/c/param.html23/01/08 10:11:46 AM


redirect (TLDDoc Generated Documentation)


FRAMES NO FRAMES

JSTL core Tag redirect

Redirects to a new URL.

Tag InformationTag Class org.apache.taglibs.standard.tag.rt.core.RedirectTag


Body Content JSP

Display Name None


url false true java.lang.String The URL of the resource to redirect to.

context false true java.lang.String Name of the context when redirecting to a relative URL resource that belongs to a foreign context.



FRAMES NO FRAMES


http://java.sun.com/products/jsp/jstl/1.1/docs/tlddocs/c/redirect.html23/01/08 10:11:47 AM


remove (TLDDoc Generated Documentation)


FRAMES NO FRAMES

JSTL core Tag remove

Removes a scoped variable (from a particular scope, if specified).

Tag InformationTag Class org.apache.taglibs.standard.tag.common.core.RemoveTag


Body Content empty

Display Name None


var true false java.lang.String Name of the scoped variable to be removed.




FRAMES NO FRAMES


http://java.sun.com/products/jsp/jstl/1.1/docs/tlddocs/c/remove.html23/01/08 10:11:49 AM


set (TLDDoc Generated Documentation)


FRAMES NO FRAMES

JSTL core Tag set

Sets the result of an expression evaluation in a 'scope'

Tag InformationTag Class org.apache.taglibs.standard.tag.rt.core.SetTag


Body Content JSP

Display Name None


var false false java.lang.String Name of the exported scoped variable to hold the value specified in the action. The type of the scoped variable is whatever type the value expression evaluates to.

value false true java.lang.String Expression to be evaluated.

target false true java.lang.String Target object whose property will be set. Must evaluate to a JavaBeans object with setter property property, or to a java.util.Map object.

property false true java.lang.String Name of the property to be set in the target object.


http://java.sun.com/products/jsp/jstl/1.1/docs/tlddocs/c/set.html (1 of 2)23/01/08 10:11:50 AM




FRAMES NO FRAMES


http://java.sun.com/products/jsp/jstl/1.1/docs/tlddocs/c/set.html (2 of 2)23/01/08 10:11:50 AM


url (TLDDoc Generated Documentation)


FRAMES NO FRAMES

JSTL core Tag url

Creates a URL with optional query parameters.

Tag InformationTag Class org.apache.taglibs.standard.tag.rt.core.UrlTag


Body Content JSP

Display Name None


var false false java.lang.String Name of the exported scoped variable for the processed url. The type of the scoped variable is String.


value false true java.lang.String URL to be processed.

context false true java.lang.String Name of the context when specifying a relative URL resource that belongs to a foreign context.



FRAMES NO FRAMES

http://java.sun.com/products/jsp/jstl/1.1/docs/tlddocs/c/url.html (1 of 2)23/01/08 10:11:51 AM

url (TLDDoc Generated Documentation)


http://java.sun.com/products/jsp/jstl/1.1/docs/tlddocs/c/url.html (2 of 2)23/01/08 10:11:51 AM


when (TLDDoc Generated Documentation)


FRAMES NO FRAMES

JSTL core Tag when

Subtag of <choose> that includes its body if its condition evalutes to 'true'

Tag InformationTag Class org.apache.taglibs.standard.tag.rt.core.WhenTag


Body Content JSP

Display Name None


test true true boolean The test condition that determines whether or not the body content should be processed.



FRAMES NO FRAMES


http://java.sun.com/products/jsp/jstl/1.1/docs/tlddocs/c/when.html23/01/08 10:11:53 AM


bundle (TLDDoc Generated Documentation)


FRAMES NO FRAMES

JSTL fmt Tag bundle

Loads a resource bundle to be used by its tag body

Tag InformationTag Class org.apache.taglibs.standard.tag.rt.fmt.BundleTag


Body Content JSP

Display Name None


basename true true java.lang.String Resource bundle base name. This is the bundle's fully-qualified resource name, which has the same form as a fully-qualified class name, that is, it uses "." as the package component separator and does not have any file type (such as ".class" or ".properties") suffix.

prefix false true java.lang.String Prefix to be prepended to the value of the message key of any nested <fmt:message> action.



http://java.sun.com/products/jsp/jstl/1.1/docs/tlddocs/fmt/bundle.html (1 of 2)23/01/08 10:11:54 AM

bundle (TLDDoc Generated Documentation)

FRAMES NO FRAMES


http://java.sun.com/products/jsp/jstl/1.1/docs/tlddocs/fmt/bundle.html (2 of 2)23/01/08 10:11:54 AM


JSTL fmt (TLDDoc Generated Documentation)


FRAMES NO FRAMES

JSTL fmt

Standard Syntax: <%@ taglib prefix="fmt" uri="http://java.sun.com/jsp/jstl/fmt" %>

XML Syntax: <anyxmlelement xmlns:fmt="http://java.sun.com/jsp/jstl/fmt" />

JSTL 1.1 i18n-capable formatting library

Tag Library InformationDisplay Name JSTL fmt

Version 1.1

Short Name fmt

URI http://java.sun.com/jsp/jstl/fmt

Tag SummaryrequestEncoding Sets the request character encoding

setLocale Stores the given locale in the locale configuration variable

timeZone Specifies the time zone for any time formatting or parsing actions nested in its body

setTimeZone Stores the given time zone in the time zone configuration variable

bundle Loads a resource bundle to be used by its tag body

setBundle Loads a resource bundle and stores it in the named scoped variable or the bundle configuration variable

message Maps key to localized message and performs parametric replacement

http://java.sun.com/products/jsp/jstl/1.1/docs/tlddocs/fmt/tld-summary.html (1 of 2)23/01/08 10:11:59 AM

JSTL fmt (TLDDoc Generated Documentation)

param Supplies an argument for parametric replacement to a containing <message> tag

formatNumber Formats a numeric value as a number, currency, or percentage

parseNumber Parses the string representation of a number, currency, or percentage

formatDate Formats a date and/or time using the supplied styles and pattern

parseDate Parses the string representation of a date and/or time

Tag Library Validatororg.apache.taglibs.standard.tlv.JstlFmtTLV



FRAMES NO FRAMES


http://java.sun.com/products/jsp/jstl/1.1/docs/tlddocs/fmt/tld-summary.html (2 of 2)23/01/08 10:11:59 AM

requestEncoding (TLDDoc Generated Documentation)


FRAMES NO FRAMES

JSTL fmt Tag requestEncoding

Sets the request character encoding

Tag InformationTag Class org.apache.taglibs.standard.tag.rt.fmt.RequestEncodingTag


Body Content empty

Display Name None


value false true java.lang.String Name of character encoding to be applied when decoding request parameters.



FRAMES NO FRAMES


http://java.sun.com/products/jsp/jstl/1.1/docs/tlddocs/fmt/requestEncoding.html23/01/08 10:12:00 AM


setLocale (TLDDoc Generated Documentation)


FRAMES NO FRAMES

JSTL fmt Tag setLocale

Stores the given locale in the locale configuration variable

Tag InformationTag Class org.apache.taglibs.standard.tag.rt.fmt.SetLocaleTag


Body Content empty

Display Name None


value true true java.lang.String A String value is interpreted as the printable representation of a locale, which must contain a two-letter (lower-case) language code (as defined by ISO-639), and may contain a two-letter (upper-case) country code (as defined by ISO-3166). Language and country codes must be separated by hyphen (-) or underscore (_).

variant false true java.lang.String Vendor- or browser-specific variant. See the java.util.Locale javadocs for more information on variants.

scope false false java.lang.String Scope of the locale configuration variable.

Variables

http://java.sun.com/products/jsp/jstl/1.1/docs/tlddocs/fmt/setLocale.html (1 of 2)23/01/08 10:12:02 AM

setLocale (TLDDoc Generated Documentation)

No Variables Defined.


FRAMES NO FRAMES


http://java.sun.com/products/jsp/jstl/1.1/docs/tlddocs/fmt/setLocale.html (2 of 2)23/01/08 10:12:02 AM


timeZone (TLDDoc Generated Documentation)


FRAMES NO FRAMES

JSTL fmt Tag timeZone

Specifies the time zone for any time formatting or parsing actions nested in its body

Tag InformationTag Class org.apache.taglibs.standard.tag.rt.fmt.TimeZoneTag


Body Content JSP

Display Name None


value true true java.lang.String The time zone. A String value is interpreted as a time zone ID. This may be one of the time zone IDs supported by the Java platform (such as "America/Los_Angeles") or a custom time zone ID (such as "GMT-8"). See java.util.TimeZone for more information on supported time zone formats.



FRAMES NO FRAMES

http://java.sun.com/products/jsp/jstl/1.1/docs/tlddocs/fmt/timeZone.html (1 of 2)23/01/08 10:12:08 AM

timeZone (TLDDoc Generated Documentation)


http://java.sun.com/products/jsp/jstl/1.1/docs/tlddocs/fmt/timeZone.html (2 of 2)23/01/08 10:12:08 AM


setTimeZone (TLDDoc Generated Documentation)


FRAMES NO FRAMES

JSTL fmt Tag setTimeZone

Stores the given time zone in the time zone configuration variable

Tag InformationTag Class org.apache.taglibs.standard.tag.rt.fmt.SetTimeZoneTag


Body Content empty

Display Name None


value true true java.lang.String The time zone. A String value is interpreted as a time zone ID. This may be one of the time zone IDs supported by the Java platform (such as "America/Los_Angeles") or a custom time zone ID (such as "GMT-8"). See java.util.TimeZone for more information on supported time zone formats.

var false false java.lang.String Name of the exported scoped variable which stores the time zone of type java.util.TimeZone.

scope false false java.lang.String Scope of var or the time zone configuration variable.

Variables

http://java.sun.com/products/jsp/jstl/1.1/docs/tlddocs/fmt/setTimeZone.html (1 of 2)23/01/08 10:12:09 AM

setTimeZone (TLDDoc Generated Documentation)



FRAMES NO FRAMES


http://java.sun.com/products/jsp/jstl/1.1/docs/tlddocs/fmt/setTimeZone.html (2 of 2)23/01/08 10:12:09 AM


setBundle (TLDDoc Generated Documentation)


FRAMES NO FRAMES

JSTL fmt Tag setBundle

Loads a resource bundle and stores it in the named scoped variable or the bundle configuration variable

Tag InformationTag Class org.apache.taglibs.standard.tag.rt.fmt.SetBundleTag


Body Content empty

Display Name None


basename true true java.lang.String Resource bundle base name. This is the bundle's fully-qualified resource name, which has the same form as a fully-qualified class name, that is, it uses "." as the package component separator and does not have any file type (such as ".class" or ".properties") suffix.

var false false java.lang.String Name of the exported scoped variable which stores the i18n localization context of type javax.servlet.jsp.jstl.fmt.LocalizationC ontext.

scope false false java.lang.String Scope of var or the localization context configuration variable.

Variables

http://java.sun.com/products/jsp/jstl/1.1/docs/tlddocs/fmt/setBundle.html (1 of 2)23/01/08 10:12:11 AM

setBundle (TLDDoc Generated Documentation)



FRAMES NO FRAMES


http://java.sun.com/products/jsp/jstl/1.1/docs/tlddocs/fmt/setBundle.html (2 of 2)23/01/08 10:12:11 AM


message (TLDDoc Generated Documentation)


FRAMES NO FRAMES

JSTL fmt Tag message

Maps key to localized message and performs parametric replacement

Tag InformationTag Class org.apache.taglibs.standard.tag.rt.fmt.MessageTag


Body Content JSP

Display Name None


key false true java.lang.String Message key to be looked up.

bundle false true java.lang.String Localization context in whose resource bundle the message key is looked up.

var false false java.lang.String Name of the exported scoped variable which stores the localized message.

scope false false java.lang.String Scope of var.



FRAMES NO FRAMES

Output Generated by TLDDoc. Java, JSP, and JavaServer Pages are trademarks or registered trademarks of Sun

http://java.sun.com/products/jsp/jstl/1.1/docs/tlddocs/fmt/message.html (1 of 2)23/01/08 10:12:12 AM


message (TLDDoc Generated Documentation)

Microsystems, Inc. in the US and other countries. Copyright 2002-3 Sun Microsystems, Inc. 4150 Network Circle Santa Clara, CA 95054, U.S.A. All Rights Reserved.

http://java.sun.com/products/jsp/jstl/1.1/docs/tlddocs/fmt/message.html (2 of 2)23/01/08 10:12:12 AM



FRAMES NO FRAMES

JSTL fmt Tag param

Supplies an argument for parametric replacement to a containing <message> tag

Tag InformationTag Class org.apache.taglibs.standard.tag.rt.fmt.ParamTag


Body Content JSP

Display Name None


value false true java.lang.String Argument used for parametric replacement.



FRAMES NO FRAMES


http://java.sun.com/products/jsp/jstl/1.1/docs/tlddocs/fmt/param.html23/01/08 10:12:14 AM


formatNumber (TLDDoc Generated Documentation)


FRAMES NO FRAMES

JSTL fmt Tag formatNumber

Formats a numeric value as a number, currency, or percentage

Tag InformationTag Class org.apache.taglibs.standard.tag.rt.fmt.FormatNumberTag


Body Content JSP

Display Name None


value false true java.lang.String

Numeric value to be formatted.

type false true java.lang.String

Specifies whether the value is to be formatted as number, currency, or percentage.

pattern false true java.lang.String

Custom formatting pattern.

currencyCode false true java.lang.String

ISO 4217 currency code. Applied only when formatting currencies (i.e. if type is equal to "currency"); ignored otherwise.

http://java.sun.com/products/jsp/jstl/1.1/docs/tlddocs/fmt/formatNumber.html (1 of 2)23/01/08 10:12:16 AM

formatNumber (TLDDoc Generated Documentation)

currencySymbol false true java.lang.String

Currency symbol. Applied only when formatting currencies (i.e. if type is equal to "currency"); ignored otherwise.

groupingUsed false true java.lang.String

Specifies whether the formatted output will contain any grouping separators.

maxIntegerDigits false true java.lang.String

Maximum number of digits in the integer portion of the formatted output.

minIntegerDigits false true java.lang.String

Minimum number of digits in the integer portion of the formatted output.

maxFractionDigits false true java.lang.String

Maximum number of digits in the fractional portion of the formatted output.

minFractionDigits false true java.lang.String

Minimum number of digits in the fractional portion of the formatted output.


Name of the exported scoped variable which stores the formatted result as a String.

scope false false java.lang.String

Scope of var.



FRAMES NO FRAMES


http://java.sun.com/products/jsp/jstl/1.1/docs/tlddocs/fmt/formatNumber.html (2 of 2)23/01/08 10:12:16 AM


parseNumber (TLDDoc Generated Documentation)


FRAMES NO FRAMES

JSTL fmt Tag parseNumber

Parses the string representation of a number, currency, or percentage

Tag InformationTag Class org.apache.taglibs.standard.tag.rt.fmt.ParseNumberTag


Body Content JSP

Display Name None


value false true java.lang.String String to be parsed.

type false true java.lang.String Specifies whether the string in the value attribute should be parsed as a number, currency, or percentage.

pattern false true java.lang.String Custom formatting pattern that determines how the string in the value attribute is to be parsed.

parseLocale false true java.lang.String Locale whose default formatting pattern (for numbers, currencies, or percentages, respectively) is to be used during the parse operation, or to which the pattern specified via the pattern attribute (if present) is applied.

http://java.sun.com/products/jsp/jstl/1.1/docs/tlddocs/fmt/parseNumber.html (1 of 2)23/01/08 10:12:17 AM

parseNumber (TLDDoc Generated Documentation)

integerOnly false true java.lang.String Specifies whether just the integer portion of the given value should be parsed.

var false false java.lang.String Name of the exported scoped variable which stores the parsed result (of type java.lang.Number).




FRAMES NO FRAMES


http://java.sun.com/products/jsp/jstl/1.1/docs/tlddocs/fmt/parseNumber.html (2 of 2)23/01/08 10:12:17 AM


formatDate (TLDDoc Generated Documentation)


FRAMES NO FRAMES

JSTL fmt Tag formatDate

Formats a date and/or time using the supplied styles and pattern

Tag InformationTag Class org.apache.taglibs.standard.tag.rt.fmt.FormatDateTag


Body Content empty

Display Name None


value true true java.lang.String Date and/or time to be formatted.

type false true java.lang.String Specifies whether the time, the date, or both the time and date components of the given date are to be formatted.

dateStyle false true java.lang.String Predefined formatting style for dates. Follows the semantics defined in class java.text.DateFormat. Applied only when formatting a date or both a date and time (i.e. if type is missing or is equal to "date" or "both"); ignored otherwise.

http://java.sun.com/products/jsp/jstl/1.1/docs/tlddocs/fmt/formatDate.html (1 of 2)23/01/08 10:12:19 AM

formatDate (TLDDoc Generated Documentation)

timeStyle false true java.lang.String Predefined formatting style for times. Follows the semantics defined in class java.text.DateFormat. Applied only when formatting a time or both a date and time (i.e. if type is equal to "time" or "both"); ignored otherwise.

pattern false true java.lang.String Custom formatting style for dates and times.

timeZone false true java.lang.String Time zone in which to represent the formatted time.

var false false java.lang.String Name of the exported scoped variable which stores the formatted result as a String.




FRAMES NO FRAMES


http://java.sun.com/products/jsp/jstl/1.1/docs/tlddocs/fmt/formatDate.html (2 of 2)23/01/08 10:12:19 AM


parseDate (TLDDoc Generated Documentation)


FRAMES NO FRAMES

JSTL fmt Tag parseDate

Parses the string representation of a date and/or time

Tag InformationTag Class org.apache.taglibs.standard.tag.rt.fmt.ParseDateTag


Body Content JSP

Display Name None


value false true java.lang.String Date string to be parsed.

type false true java.lang.String Specifies whether the date string in the value attribute is supposed to contain a time, a date, or both.

dateStyle false true java.lang.String Predefined formatting style for days which determines how the date component of the date string is to be parsed. Applied only when formatting a date or both a date and time (i.e. if type is missing or is equal to "date" or "both"); ignored otherwise.

http://java.sun.com/products/jsp/jstl/1.1/docs/tlddocs/fmt/parseDate.html (1 of 2)23/01/08 10:12:21 AM

parseDate (TLDDoc Generated Documentation)

timeStyle false true java.lang.String Predefined formatting styles for times which determines how the time component in the date string is to be parsed. Applied only when formatting a time or both a date and time (i.e. if type is equal to "time" or "both"); ignored otherwise.

pattern false true java.lang.String Custom formatting pattern which determines how the date string is to be parsed.

timeZone false true java.lang.String Time zone in which to interpret any time information in the date string.

parseLocale false true java.lang.String Locale whose predefined formatting styles for dates and times are to be used during the parse operation, or to which the pattern specified via the pattern attribute (if present) is applied.

var false false java.lang.String Name of the exported scoped variable in which the parsing result (of type java.util.Date) is stored.




FRAMES NO FRAMES


http://java.sun.com/products/jsp/jstl/1.1/docs/tlddocs/fmt/parseDate.html (2 of 2)23/01/08 10:12:21 AM


contains (TLDDoc Generated Documentation)


FRAMES NO FRAMES

JSTL functions Function contains

boolean contains(java.lang.String, java.lang.String)

Tests if an input string contains the specified substring.

Example:

<c:if test="${fn:contains(name, searchString)}">

Function InformationFunction Class org.apache.taglibs.standard.functions.Functions

Function Signature boolean contains(java.lang.String, java.lang.String)

Display Name None


FRAMES NO FRAMES


http://java.sun.com/products/jsp/jstl/1.1/docs/tlddocs/fn/contains.fn.html23/01/08 10:12:23 AM

http://java.sun.com/products/jsp/jstl/1.1/docs/tlddocs/fn/contains.html

http://java.sun.com/products/jsp/jstl/1.1/docs/tlddocs/fn/contains.html


JSTL functions (TLDDoc Generated Documentation)


FRAMES NO FRAMES

JSTL functions

Standard Syntax: <%@ taglib prefix="fn" uri="http://java.sun.com/jsp/jstl/functions" %>

XML Syntax: <anyxmlelement xmlns:fn="http://java.sun.com/jsp/jstl/functions" />

JSTL 1.1 functions library

Tag Library InformationDisplay Name JSTL functions

Version 1.1

Short Name fn

URI http://java.sun.com/jsp/jstl/functions

Function Summary

boolean contains( java.lang.String, java.lang.String)

Tests if an input string contains the specified substring.

boolean containsIgnoreCase( java.lang.String, java.lang.String)

Tests if an input string contains the specified substring in a case insensitive way.

boolean endsWith( java.lang.String, java.lang.String)

Tests if an input string ends with the specified suffix.

http://java.sun.com/products/jsp/jstl/1.1/docs/tlddocs/fn/tld-summary.html (1 of 3)23/01/08 10:12:25 AM


java.lang.String escapeXml( java.lang.String)

Escapes characters that could be interpreted as XML markup.

int indexOf( java.lang.String, java.lang.String)

Returns the index withing a string of the first occurrence of a specified substring.

java.lang.String join( java.lang.String[], java.lang.String)

Joins all elements of an array into a string.

int length( java.lang.Object)

Returns the number of items in a collection, or the number of characters in a string.

java.lang.String replace( java.lang.String, java.lang.String, java.lang.String)

Returns a string resulting from replacing in an input string all occurrences of a "before" string into an "after" substring.

java.lang.String[] split( java.lang.String, java.lang.String)

Splits a string into an array of substrings.

boolean startsWith( java.lang.String, java.lang.String)

Tests if an input string starts with the specified prefix.



java.lang.String substring( java.lang.String, int, int)Returns a subset of a string.

java.lang.String substringAfter( java.lang.String, java.lang.String)

Returns a subset of a string following a specific substring.

java.lang.String substringBefore( java.lang.String, java.lang.String)

Returns a subset of a string before a specific substring.

java.lang.String toLowerCase( java.lang.String)

Converts all of the characters of a string to lower case.

java.lang.String toUpperCase( java.lang.String)

Converts all of the characters of a string to upper case.

java.lang.String trim( java.lang.String)

Removes white spaces from both ends of a string.


FRAMES NO FRAMES



containsIgnoreCase (TLDDoc Generated Documentation)


FRAMES NO FRAMES

JSTL functions Function containsIgnoreCase

boolean containsIgnoreCase(java.lang.String, java.lang.String)

Tests if an input string contains the specified substring in a case insensitive way.

Example:

<c:if test="${fn:containsIgnoreCase(name, searchString)}">


Function Signature boolean containsIgnoreCase(java.lang.String, java.lang.String)

Display Name None


FRAMES NO FRAMES


http://java.sun.com/products/jsp/jstl/1.1/docs/tlddocs/fn/containsIgnoreCase.fn.html23/01/08 10:12:27 AM

http://java.sun.com/products/jsp/jstl/1.1/docs/tlddocs/fn/containsIgnoreCase.html

http://java.sun.com/products/jsp/jstl/1.1/docs/tlddocs/fn/containsIgnoreCase.html


endsWith (TLDDoc Generated Documentation)


FRAMES NO FRAMES

JSTL functions Function endsWith

boolean endsWith(java.lang.String, java.lang.String)

Tests if an input string ends with the specified suffix.

Example:

<c:if test="${fn:endsWith(filename, ".txt")}">


Function Signature boolean endsWith(java.lang.String, java.lang.String)

Display Name None


FRAMES NO FRAMES


http://java.sun.com/products/jsp/jstl/1.1/docs/tlddocs/fn/endsWith.fn.html23/01/08 10:12:29 AM

http://java.sun.com/products/jsp/jstl/1.1/docs/tlddocs/fn/endsWith.html

http://java.sun.com/products/jsp/jstl/1.1/docs/tlddocs/fn/endsWith.html


escapeXml (TLDDoc Generated Documentation)


FRAMES NO FRAMES

JSTL functions Function escapeXml

java.lang.String escapeXml(java.lang.String)

Escapes characters that could be interpreted as XML markup.

Example:

${fn:escapeXml(param:info)}


Function Signature java.lang.String escapeXml(java.lang.String)

Display Name None


FRAMES NO FRAMES


http://java.sun.com/products/jsp/jstl/1.1/docs/tlddocs/fn/escapeXml.fn.html23/01/08 10:12:31 AM

http://java.sun.com/products/jsp/jstl/1.1/docs/tlddocs/fn/escapeXml.html

http://java.sun.com/products/jsp/jstl/1.1/docs/tlddocs/fn/escapeXml.html


indexOf (TLDDoc Generated Documentation)


FRAMES NO FRAMES

JSTL functions Function indexOf

int indexOf(java.lang.String, java.lang.String)

Returns the index withing a string of the first occurrence of a specified substring.

Example:

${fn:indexOf(name, "-")}


Function Signature int indexOf(java.lang.String, java.lang.String)

Display Name None


FRAMES NO FRAMES


http://java.sun.com/products/jsp/jstl/1.1/docs/tlddocs/fn/indexOf.fn.html23/01/08 10:12:33 AM

http://java.sun.com/products/jsp/jstl/1.1/docs/tlddocs/fn/indexOf.html

http://java.sun.com/products/jsp/jstl/1.1/docs/tlddocs/fn/indexOf.html


join (TLDDoc Generated Documentation)


FRAMES NO FRAMES

JSTL functions Function join

java.lang.String join(java.lang.String[], java.lang.String)

Joins all elements of an array into a string.

Example:

${fn:join(array, ";")}


Function Signature java.lang.String join(java.lang.String[], java.lang.String)

Display Name None


FRAMES NO FRAMES


http://java.sun.com/products/jsp/jstl/1.1/docs/tlddocs/fn/join.fn.html23/01/08 10:12:35 AM

http://java.sun.com/products/jsp/jstl/1.1/docs/tlddocs/fn/join.html

http://java.sun.com/products/jsp/jstl/1.1/docs/tlddocs/fn/join.html


length (TLDDoc Generated Documentation)


FRAMES NO FRAMES

JSTL functions Function length

int length(java.lang.Object)

Returns the number of items in a collection, or the number of characters in a string.

Example:

You have ${fn:length(shoppingCart.products)} in your shopping cart.


Function Signature int length(java.lang.Object)

Display Name None


FRAMES NO FRAMES


http://java.sun.com/products/jsp/jstl/1.1/docs/tlddocs/fn/length.fn.html23/01/08 10:12:38 AM

http://java.sun.com/products/jsp/jstl/1.1/docs/tlddocs/fn/length.html

http://java.sun.com/products/jsp/jstl/1.1/docs/tlddocs/fn/length.html


replace (TLDDoc Generated Documentation)


FRAMES NO FRAMES

JSTL functions Function replace

java.lang.String replace(java.lang.String, java.lang.String, java.lang.String)

Returns a string resulting from replacing in an input string all occurrences of a "before" string into an "after" substring.

Example:

${fn:replace(text, "-", "•")}


Function Signature java.lang.String replace(java.lang.String, java.lang.String, java.lang.String)

Display Name None


FRAMES NO FRAMES


http://java.sun.com/products/jsp/jstl/1.1/docs/tlddocs/fn/replace.fn.html23/01/08 10:12:40 AM

http://java.sun.com/products/jsp/jstl/1.1/docs/tlddocs/fn/replace.html

http://java.sun.com/products/jsp/jstl/1.1/docs/tlddocs/fn/replace.html


split (TLDDoc Generated Documentation)


FRAMES NO FRAMES

JSTL functions Function split

java.lang.String[] split(java.lang.String, java.lang.String)

Splits a string into an array of substrings.

Example:

${fn:split(customerNames, ";")}


Function Signature java.lang.String[] split(java.lang.String, java.lang.String)

Display Name None


FRAMES NO FRAMES


http://java.sun.com/products/jsp/jstl/1.1/docs/tlddocs/fn/split.fn.html23/01/08 10:12:42 AM

http://java.sun.com/products/jsp/jstl/1.1/docs/tlddocs/fn/split.html

http://java.sun.com/products/jsp/jstl/1.1/docs/tlddocs/fn/split.html


startsWith (TLDDoc Generated Documentation)


FRAMES NO FRAMES

JSTL functions Function startsWith

boolean startsWith(java.lang.String, java.lang.String)

Tests if an input string starts with the specified prefix.

Example:

<c:if test="${fn:startsWith(product.id, "100-")}">


Function Signature boolean startsWith(java.lang.String, java.lang.String)

Display Name None


FRAMES NO FRAMES


http://java.sun.com/products/jsp/jstl/1.1/docs/tlddocs/fn/startsWith.fn.html23/01/08 10:12:44 AM

http://java.sun.com/products/jsp/jstl/1.1/docs/tlddocs/fn/startsWith.html

http://java.sun.com/products/jsp/jstl/1.1/docs/tlddocs/fn/startsWith.html


substring (TLDDoc Generated Documentation)


FRAMES NO FRAMES

JSTL functions Function substring

java.lang.String substring(java.lang.String, int, int)

Returns a subset of a string.

Example:

P.O. Box: ${fn:substring(zip, 6, -1)}


Function Signature java.lang.String substring(java.lang.String, int, int)

Display Name None


FRAMES NO FRAMES


http://java.sun.com/products/jsp/jstl/1.1/docs/tlddocs/fn/substring.fn.html23/01/08 10:12:46 AM

http://java.sun.com/products/jsp/jstl/1.1/docs/tlddocs/fn/substring.html

http://java.sun.com/products/jsp/jstl/1.1/docs/tlddocs/fn/substring.html


substringAfter (TLDDoc Generated Documentation)


FRAMES NO FRAMES

JSTL functions Function substringAfter

java.lang.String substringAfter(java.lang.String, java.lang.String)

Returns a subset of a string following a specific substring.

Example:

P.O. Box: ${fn:substringAfter(zip, "-")}


Function Signature java.lang.String substringAfter(java.lang.String, java.lang.String)

Display Name None


FRAMES NO FRAMES


http://java.sun.com/products/jsp/jstl/1.1/docs/tlddocs/fn/substringAfter.fn.html23/01/08 10:12:48 AM

http://java.sun.com/products/jsp/jstl/1.1/docs/tlddocs/fn/substringAfter.html

http://java.sun.com/products/jsp/jstl/1.1/docs/tlddocs/fn/substringAfter.html


substringBefore (TLDDoc Generated Documentation)


FRAMES NO FRAMES

JSTL functions Function substringBefore

java.lang.String substringBefore(java.lang.String, java.lang.String)

Returns a subset of a string before a specific substring.

Example:

Zip (without P.O. Box): ${fn:substringBefore(zip, "-")}


Function Signature java.lang.String substringBefore(java.lang.String, java.lang.String)

Display Name None


FRAMES NO FRAMES


http://java.sun.com/products/jsp/jstl/1.1/docs/tlddocs/fn/substringBefore.fn.html23/01/08 10:12:50 AM

http://java.sun.com/products/jsp/jstl/1.1/docs/tlddocs/fn/substringBefore.html

http://java.sun.com/products/jsp/jstl/1.1/docs/tlddocs/fn/substringBefore.html


toLowerCase (TLDDoc Generated Documentation)


FRAMES NO FRAMES

JSTL functions Function toLowerCase

java.lang.String toLowerCase(java.lang.String)

Converts all of the characters of a string to lower case.

Example:

Product name: ${fn.toLowerCase(product.name)}


Function Signature java.lang.String toLowerCase(java.lang.String)

Display Name None


FRAMES NO FRAMES


http://java.sun.com/products/jsp/jstl/1.1/docs/tlddocs/fn/toLowerCase.fn.html23/01/08 10:12:53 AM

http://java.sun.com/products/jsp/jstl/1.1/docs/tlddocs/fn/toLowerCase.html

http://java.sun.com/products/jsp/jstl/1.1/docs/tlddocs/fn/toLowerCase.html


toUpperCase (TLDDoc Generated Documentation)


FRAMES NO FRAMES

JSTL functions Function toUpperCase

java.lang.String toUpperCase(java.lang.String)

Converts all of the characters of a string to upper case.

Example:

Product name: ${fn.UpperCase(product.name)}


Function Signature java.lang.String toUpperCase(java.lang.String)

Display Name None


FRAMES NO FRAMES


http://java.sun.com/products/jsp/jstl/1.1/docs/tlddocs/fn/toUpperCase.fn.html23/01/08 10:12:55 AM

http://java.sun.com/products/jsp/jstl/1.1/docs/tlddocs/fn/toUpperCase.html

http://java.sun.com/products/jsp/jstl/1.1/docs/tlddocs/fn/toUpperCase.html


trim (TLDDoc Generated Documentation)


FRAMES NO FRAMES

JSTL functions Function trim

java.lang.String trim(java.lang.String)

Removes white spaces from both ends of a string.

Example:

Name: ${fn.trim(name)}


Function Signature java.lang.String trim(java.lang.String)

Display Name None


FRAMES NO FRAMES


http://java.sun.com/products/jsp/jstl/1.1/docs/tlddocs/fn/trim.fn.html23/01/08 10:12:57 AM

http://java.sun.com/products/jsp/jstl/1.1/docs/tlddocs/fn/trim.html

http://java.sun.com/products/jsp/jstl/1.1/docs/tlddocs/fn/trim.html


dateParam (TLDDoc Generated Documentation)


FRAMES NO FRAMES

JSTL sql Tag dateParam

Sets a parameter in an SQL statement to the specified java.util.Date value.

Tag InformationTag Class org.apache.taglibs.standard.tag.rt.sql.DateParamTag


Body Content empty

Display Name None


value true true java.lang.String Parameter value for DATE, TIME, or TIMESTAMP column in a database table.

type false true java.lang.String One of "date", "time" or "timestamp".



FRAMES NO FRAMES


http://java.sun.com/products/jsp/jstl/1.1/docs/tlddocs/sql/dateParam.html23/01/08 10:12:59 AM


JSTL sql (TLDDoc Generated Documentation)


FRAMES NO FRAMES

JSTL sql

Standard Syntax: <%@ taglib prefix="sql" uri="http://java.sun.com/jsp/jstl/sql" %>

XML Syntax: <anyxmlelement xmlns:sql="http://java.sun.com/jsp/jstl/sql" />

JSTL 1.1 sql library

Tag Library InformationDisplay Name JSTL sql

Version 1.1

Short Name sql

URI http://java.sun.com/jsp/jstl/sql

Tag Summary

transaction Provides nested database action elements with a shared Connection, set up to execute all statements as one transaction.

query Executes the SQL query defined in its body or through the sql attribute.

update Executes the SQL update defined in its body or through the sql attribute.

param Sets a parameter in an SQL statement to the specified value.

dateParam Sets a parameter in an SQL statement to the specified java.util.Date value.

setDataSource Creates a simple DataSource suitable only for prototyping.

http://java.sun.com/products/jsp/jstl/1.1/docs/tlddocs/sql/tld-summary.html (1 of 2)23/01/08 10:13:01 AM

JSTL sql (TLDDoc Generated Documentation)

Tag Library Validatororg.apache.taglibs.standard.tlv.JstlSqlTLV



FRAMES NO FRAMES


http://java.sun.com/products/jsp/jstl/1.1/docs/tlddocs/sql/tld-summary.html (2 of 2)23/01/08 10:13:01 AM

transaction (TLDDoc Generated Documentation)


FRAMES NO FRAMES

JSTL sql Tag transaction

Provides nested database action elements with a shared Connection, set up to execute all statements as one transaction.

Tag InformationTag Class org.apache.taglibs.standard.tag.rt.sql.TransactionTag


Body Content JSP

Display Name None


dataSource false true java.lang.String

DataSource associated with the database to access. A String value represents a relative path to a JNDI resource or the parameters for the JDBC DriverManager facility.

isolation false true java.lang.String

Transaction isolation level. If not specified, it is the isolation level the DataSource has been configured with.



FRAMES NO FRAMES

http://java.sun.com/products/jsp/jstl/1.1/docs/tlddocs/sql/transaction.html (1 of 2)23/01/08 10:13:03 AM

transaction (TLDDoc Generated Documentation)


http://java.sun.com/products/jsp/jstl/1.1/docs/tlddocs/sql/transaction.html (2 of 2)23/01/08 10:13:03 AM


query (TLDDoc Generated Documentation)


FRAMES NO FRAMES

JSTL sql Tag query

Executes the SQL query defined in its body or through the sql attribute.

Tag InformationTag Class org.apache.taglibs.standard.tag.rt.sql.QueryTag


Body Content JSP

Display Name None


var true false java.lang.String

Name of the exported scoped variable for the query result. The type of the scoped variable is javax.servlet.jsp.jstl.sql. Result (see Chapter 16 "Java APIs").


Scope of var.

sql false true java.lang.String

SQL query statement.


Data source associated with the database to query. A String value represents a relative path to a JNDI resource or the parameters for the DriverManager class.

http://java.sun.com/products/jsp/jstl/1.1/docs/tlddocs/sql/query.html (1 of 2)23/01/08 10:13:05 AM

query (TLDDoc Generated Documentation)

startRow false true java.lang.String

The returned Result object includes the rows starting at the specified index. The first row of the original query result set is at index 0. If not specified, rows are included starting from the first row at index 0.

maxRows false true java.lang.String

The maximum number of rows to be included in the query result. If not specified, or set to -1, no limit on the maximum number of rows is enforced.



FRAMES NO FRAMES


http://java.sun.com/products/jsp/jstl/1.1/docs/tlddocs/sql/query.html (2 of 2)23/01/08 10:13:05 AM


update (TLDDoc Generated Documentation)


FRAMES NO FRAMES

JSTL sql Tag update

Executes the SQL update defined in its body or through the sql attribute.

Tag InformationTag Class org.apache.taglibs.standard.tag.rt.sql.UpdateTag


Body Content JSP

Display Name None



Name of the exported scoped variable for the result of the database update. The type of the scoped variable is java.lang.Integer.


Scope of var.

sql false true java.lang.String

SQL update statement.


Data source associated with the database to update. A String value represents a relative path to a JNDI resource or the parameters for the JDBC DriverManager class.

Variables

http://java.sun.com/products/jsp/jstl/1.1/docs/tlddocs/sql/update.html (1 of 2)23/01/08 10:13:06 AM

update (TLDDoc Generated Documentation)



FRAMES NO FRAMES


http://java.sun.com/products/jsp/jstl/1.1/docs/tlddocs/sql/update.html (2 of 2)23/01/08 10:13:06 AM




FRAMES NO FRAMES

JSTL sql Tag param

Sets a parameter in an SQL statement to the specified value.

Tag InformationTag Class org.apache.taglibs.standard.tag.rt.sql.ParamTag


Body Content JSP

Display Name None


value false true java.lang.String Parameter value.



FRAMES NO FRAMES


http://java.sun.com/products/jsp/jstl/1.1/docs/tlddocs/sql/param.html23/01/08 10:13:10 AM


setDataSource (TLDDoc Generated Documentation)


FRAMES NO FRAMES

JSTL sql Tag setDataSource

Creates a simple DataSource suitable only for prototyping.

Tag InformationTag Class org.apache.taglibs.standard.tag.rt.sql.SetDataSourceTag


Body Content empty

Display Name None


var false false java.lang.String Name of the exported scoped variable for the data source specified. Type can be String or DataSource.

scope false false java.lang.String If var is specified, scope of the exported variable. Otherwise, scope of the data source configuration variable.

dataSource false true java.lang.String Data source. If specified as a string, it can either be a relative path to a JNDI resource, or a JDBC parameters string as defined in Section 10.1.1.

driver false true java.lang.String JDBC parameter: driver class name.

url false true java.lang.String JDBC parameter: URL associated with the database.

http://java.sun.com/products/jsp/jstl/1.1/docs/tlddocs/sql/setDataSource.html (1 of 2)23/01/08 10:13:12 AM

setDataSource (TLDDoc Generated Documentation)

user false true java.lang.String JDBC parameter: database user on whose behalf the connection to the database is being made.

password false true java.lang.String JDBC parameter: user password



FRAMES NO FRAMES


http://java.sun.com/products/jsp/jstl/1.1/docs/tlddocs/sql/setDataSource.html (2 of 2)23/01/08 10:13:12 AM


choose (TLDDoc Generated Documentation)


FRAMES NO FRAMES

JSTL XML Tag choose

Simple conditional tag that establishes a context for mutually exclusive conditional operations, marked by <when> and <otherwise>

Tag InformationTag Class org.apache.taglibs.standard.tag.common.core.ChooseTag


Body Content JSP

Display Name None




FRAMES NO FRAMES


http://java.sun.com/products/jsp/jstl/1.1/docs/tlddocs/x/choose.html23/01/08 10:13:13 AM


JSTL XML (TLDDoc Generated Documentation)


FRAMES NO FRAMES

JSTL XML

Standard Syntax: <%@ taglib prefix="x" uri="http://java.sun.com/jsp/jstl/xml" %>

XML Syntax: <anyxmlelement xmlns:x="http://java.sun.com/jsp/jstl/xml" />

JSTL 1.1 XML library

Tag Library InformationDisplay Name JSTL XML

Version 1.1

Short Name x

URI http://java.sun.com/jsp/jstl/xml

Tag Summary

choose Simple conditional tag that establishes a context for mutually exclusive conditional operations, marked by <when> and <otherwise>

out Like <%= ... >, but for XPath expressions.

if XML conditional tag, which evalutes its body if the supplied XPath expression evalutes to 'true' as a boolean

forEach XML iteration tag.

otherwise Subtag of <choose> that follows <when> tags and runs only if all of the prior conditions evaluated to 'false'

param Adds a parameter to a containing 'transform' tag's Transformer

parse Parses XML content from 'source' attribute or 'body'

http://java.sun.com/products/jsp/jstl/1.1/docs/tlddocs/x/tld-summary.html (1 of 2)23/01/08 10:13:15 AM

JSTL XML (TLDDoc Generated Documentation)

set Saves the result of an XPath expression evaluation in a 'scope'

transform Conducts a transformation given a source XML document and an XSLT stylesheet

when Subtag of <choose> that includes its body if its expression evalutes to 'true'

Tag Library Validatororg.apache.taglibs.standard.tlv.JstlXmlTLV

Provides validation features for JSTL XML tags.


FRAMES NO FRAMES


http://java.sun.com/products/jsp/jstl/1.1/docs/tlddocs/x/tld-summary.html (2 of 2)23/01/08 10:13:15 AM



FRAMES NO FRAMES

JSTL XML Tag out

Like <%= ... >, but for XPath expressions.

Tag InformationTag Class org.apache.taglibs.standard.tag.rt.xml.ExprTag


Body Content empty

Display Name None


select true false java.lang.String XPath expression to be evaluated.

escapeXml false true java.lang.String Determines whether characters <,>,&,'," in the resulting string should be converted to their corresponding character entity codes. Default value is true.



FRAMES NO FRAMES

Output Generated by TLDDoc. Java, JSP, and JavaServer Pages are trademarks or registered trademarks of Sun Microsystems, Inc. in the US and other countries. Copyright 2002-3 Sun Microsystems, Inc. 4150 Network Circle Santa

http://java.sun.com/products/jsp/jstl/1.1/docs/tlddocs/x/out.html (1 of 2)23/01/08 10:13:16 AM




FRAMES NO FRAMES

JSTL XML Tag if

XML conditional tag, which evalutes its body if the supplied XPath expression evalutes to 'true' as a boolean

Tag InformationTag Class org.apache.taglibs.standard.tag.common.xml.IfTag


Body Content JSP

Display Name None


select true false java.lang.String The test condition that tells whether or not the body content should be processed.

var false false java.lang.String Name of the exported scoped variable for the resulting value of the test condition. The type of the scoped variable is Boolean.




FRAMES NO FRAMES

http://java.sun.com/products/jsp/jstl/1.1/docs/tlddocs/x/if.html (1 of 2)23/01/08 10:13:17 AM



http://java.sun.com/products/jsp/jstl/1.1/docs/tlddocs/x/if.html (2 of 2)23/01/08 10:13:17 AM




FRAMES NO FRAMES

JSTL XML Tag forEach

XML iteration tag.

Tag InformationTag Class org.apache.taglibs.standard.tag.common.xml.ForEachTag


Body Content JSP

Display Name None



Name of the exported scoped variable for the current item of the iteration. This scoped variable has nested visibility. Its type depends on the result of the XPath expression in the select attribute.

select true false java.lang.String

XPath expression to be evaluated.

begin false true int Iteration begins at the item located at the specified index. First item of the collection has index 0.

end false true int Iteration ends at the item located at the specified index (inclusive).

step false true int Iteration will only process every step items of the collection, starting with the first one.

http://java.sun.com/products/jsp/jstl/1.1/docs/tlddocs/x/forEach.html (1 of 2)23/01/08 10:13:19 AM


varStatus false false java.lang.String

Name of the exported scoped variable for the status of the iteration. Object exported is of type javax.servlet.jsp.jstl.core.LoopTagStatus. This scoped variable has nested visibility.



FRAMES NO FRAMES


http://java.sun.com/products/jsp/jstl/1.1/docs/tlddocs/x/forEach.html (2 of 2)23/01/08 10:13:19 AM


otherwise (TLDDoc Generated Documentation)


FRAMES NO FRAMES

JSTL XML Tag otherwise

Subtag of <choose> that follows <when> tags and runs only if all of the prior conditions evaluated to 'false'

Tag InformationTag Class org.apache.taglibs.standard.tag.common.core.OtherwiseTag


Body Content JSP

Display Name None




FRAMES NO FRAMES


http://java.sun.com/products/jsp/jstl/1.1/docs/tlddocs/x/otherwise.html23/01/08 10:13:20 AM




FRAMES NO FRAMES

JSTL XML Tag param

Adds a parameter to a containing 'transform' tag's Transformer

Tag InformationTag Class org.apache.taglibs.standard.tag.rt.xml.ParamTag


Body Content JSP

Display Name None


name true true java.lang.String Name of the transformation parameter.

value false true java.lang.String Value of the parameter.



FRAMES NO FRAMES


http://java.sun.com/products/jsp/jstl/1.1/docs/tlddocs/x/param.html23/01/08 10:13:22 AM


parse (TLDDoc Generated Documentation)


FRAMES NO FRAMES

JSTL XML Tag parse

Parses XML content from 'source' attribute or 'body'

Tag InformationTag Class org.apache.taglibs.standard.tag.rt.xml.ParseTag

TagExtraInfo Class org.apache.taglibs.standard.tei.XmlParseTEI

Body Content JSP

Display Name None



Name of the exported scoped variable for the parsed XML document. The type of the scoped variable is implementation dependent.

varDom false false java.lang.String

Name of the exported scoped variable for the parsed XML document. The type of the scoped variable is org.w3c.dom.Document.


Scope for var.

scopeDom false false java.lang.String

Scope for varDom.

xml false true java.lang.String

Deprecated. Use attribute 'doc' instead.

http://java.sun.com/products/jsp/jstl/1.1/docs/tlddocs/x/parse.html (1 of 2)23/01/08 10:13:23 AM

parse (TLDDoc Generated Documentation)

doc false true java.lang.String

Source XML document to be parsed.

systemId false true java.lang.String

The system identifier (URI) for parsing the XML document.

filter false true java.lang.String

Filter to be applied to the source document.



FRAMES NO FRAMES


http://java.sun.com/products/jsp/jstl/1.1/docs/tlddocs/x/parse.html (2 of 2)23/01/08 10:13:23 AM




FRAMES NO FRAMES

JSTL XML Tag set

Saves the result of an XPath expression evaluation in a 'scope'

Tag InformationTag Class org.apache.taglibs.standard.tag.common.xml.SetTag


Body Content empty

Display Name None


var true false java.lang.String Name of the exported scoped variable to hold the value specified in the action. The type of the scoped variable is whatever type the select expression evaluates to.

select false false java.lang.String XPath expression to be evaluated.




FRAMES NO FRAMES

Output Generated by TLDDoc. Java, JSP, and JavaServer Pages are trademarks or registered trademarks of Sun

http://java.sun.com/products/jsp/jstl/1.1/docs/tlddocs/x/set.html (1 of 2)23/01/08 10:13:24 AM



Microsystems, Inc. in the US and other countries. Copyright 2002-3 Sun Microsystems, Inc. 4150 Network Circle Santa Clara, CA 95054, U.S.A. All Rights Reserved.

http://java.sun.com/products/jsp/jstl/1.1/docs/tlddocs/x/set.html (2 of 2)23/01/08 10:13:24 AM

transform (TLDDoc Generated Documentation)


FRAMES NO FRAMES

JSTL XML Tag transform

Conducts a transformation given a source XML document and an XSLT stylesheet

Tag InformationTag Class org.apache.taglibs.standard.tag.rt.xml.TransformTag

TagExtraInfo Class org.apache.taglibs.standard.tei.XmlTransformTEI

Body Content JSP

Display Name None



Name of the exported scoped variable for the transformed XML document. The type of the scoped variable is org.w3c.dom.Document.


Scope for var.

result false true java.lang.String

Result Object that captures or processes the transformation result.

xml false true java.lang.String

Deprecated. Use attribute 'doc' instead.

doc false true java.lang.String

Source XML document to be transformed. (If exported by <x:set>, it must correspond to a well-formed XML document, not a partial document.)

http://java.sun.com/products/jsp/jstl/1.1/docs/tlddocs/x/transform.html (1 of 2)23/01/08 10:13:26 AM

transform (TLDDoc Generated Documentation)

xmlSystemId false true java.lang.String

Deprecated. Use attribute 'docSystemId' instead.

docSystemId false true java.lang.String

The system identifier (URI) for parsing the XML document.

xslt false true java.lang.String

javax.xml.transform.Source Transformation stylesheet as a String, Reader, or Source object.

xsltSystemId false true java.lang.String

The system identifier (URI) for parsing the XSLT stylesheet.



FRAMES NO FRAMES


http://java.sun.com/products/jsp/jstl/1.1/docs/tlddocs/x/transform.html (2 of 2)23/01/08 10:13:26 AM


when (TLDDoc Generated Documentation)


FRAMES NO FRAMES

JSTL XML Tag when

Subtag of <choose> that includes its body if its expression evalutes to 'true'

Tag InformationTag Class org.apache.taglibs.standard.tag.common.xml.WhenTag


Body Content JSP

Display Name None


select true false java.lang.String The test condition that tells whether or not the body content should be processed



FRAMES NO FRAMES


http://java.sun.com/products/jsp/jstl/1.1/docs/tlddocs/x/when.html23/01/08 10:13:27 AM


JSTL core (JSTL 1.1 core library)

JSTL core

Tags c:catch c:choose c:if c:import c:forEach c:forTokens c:out c:otherwise c:param c:redirect c:remove c:set c:url c:when

Validator org.apache.taglibs.standard.tlv.JstlCoreTLV

http://java.sun.com/products/jsp/jstl/1.1/docs/tlddocs/c/tld-frame.html23/01/08 10:13:28 AM

JSTL fmt (JSTL 1.1 i18n-capable formatting library)

JSTL fmt

Tags fmt:requestEncoding fmt:setLocale fmt:timeZone fmt:setTimeZone fmt:bundle fmt:setBundle fmt:message fmt:param fmt:formatNumber fmt:parseNumber fmt:formatDate fmt:parseDate

Validator org.apache.taglibs.standard.tlv.JstlFmtTLV

http://java.sun.com/products/jsp/jstl/1.1/docs/tlddocs/fmt/tld-frame.html23/01/08 10:13:29 AM

JSTL sql (JSTL 1.1 sql library)

JSTL sql

Tags sql:transaction sql:query sql:update sql:param sql:dateParam sql:setDataSource

Validator org.apache.taglibs.standard.tlv.JstlSqlTLV

http://java.sun.com/products/jsp/jstl/1.1/docs/tlddocs/sql/tld-frame.html23/01/08 10:13:31 AM

JSTL XML (JSTL 1.1 XML library)

JSTL XML

Tags x:choose x:out x:if x:forEach x:otherwise x:param x:parse x:set x:transform x:when

Validator org.apache.taglibs.standard.tlv.JstlXmlTLV

http://java.sun.com/products/jsp/jstl/1.1/docs/tlddocs/x/tld-frame.html23/01/08 10:13:33 AM

JSTL functions (JSTL 1.1 functions library)

JSTL functions

Functions fn:contains() fn:containsIgnoreCase() fn:endsWith() fn:escapeXml() fn:indexOf() fn:join() fn:length() fn:replace() fn:split() fn:startsWith() fn:substring() fn:substringAfter() fn:substringBefore() fn:toLowerCase() fn:toUpperCase() fn:trim()

http://java.sun.com/products/jsp/jstl/1.1/docs/tlddocs/fn/tld-frame.html23/01/08 10:13:34 AM

jstl reference

Documents

variablesno variables defined

attributesname required request

package component separator

character entity codes

attributesno attributes defined

removes white spaces

named scoped variable

simple datasource suitable