You are on page 1of 108

TLDDoc Generated Documentation

TLDDoc Generated Documentation Overview Library Tag Help


All Tags / Functions FRAMES NO FRAMES

Tag Libraries
JSTL core JavaServer Pages Standard Tag Library 1.1 Tag
JSTL fmt Reference
JSTL sql
JSTL XML
JSTL functions Tag Libraries
JSTL core JSTL 1.1 core library

All Tags / Functions JSTL fmt JSTL 1.1 i18n-capable formatting library
c:catch
c:choose JSTL sql JSTL 1.1 sql library
c:forEach
c:forTokens JSTL XML JSTL 1.1 XML library
c:if
c:import
c:otherwise JSTL JSTL 1.1 functions library
c:out functions
c:param
c:redirect
c:remove Overview Library Tag Help
c:set FRAMES NO FRAMES
c:url
c:when Output Generated by TLDDoc. Java, JSP, and JavaServer Pages are trademarks or registered
fmt:bundle 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.
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/index.html (1 of 2)23/01/08 10:11:11 AM


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


All Tags / 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()

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


All Tags / Functions

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)

Overview Library Tag Help


FRAMES NO FRAMES

JSTL core
Tag catch

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

Tag Information
Tag Class org.apache.taglibs.standard.tag.common.core.CatchTag
TagExtraInfo Class None
Body Content JSP
Display Name None

Attributes
Name 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.

Variables
No Variables Defined.

Overview Library Tag Help


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/c/catch.html23/01/08 10:11:17 AM
Overview (TLDDoc Generated Documentation)

Overview Library Tag Help


FRAMES NO FRAMES

JavaServer Pages Standard Tag Library 1.1 Tag Reference

Tag Libraries
JSTL 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

Overview Library Tag Help


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/overview-summary.html23/01/08 10:11:18 AM
API Help (TLDDoc Generated Documentation)

Overview Library Tag Help


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.

Overview Library Tag Help


PREV NEXT 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/help-doc.html (2 of 2)23/01/08 10:11:20 AM


JSTL core (TLDDoc Generated Documentation)

Overview Library Tag Help


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 Information


Display Name JSTL core
Version 1.1
Short Name c
URI http://java.sun.com/jsp/jstl/core

Tag Summary
catch Catches any Throwable that occurs in its body and optionally exposes it.
Simple conditional tag that establishes a context for mutually exclusive conditional
choose
operations, marked by <when> and <otherwise>
Simple conditional tag, which evalutes its body if the supplied condition is true and
if optionally exposes a Boolean scripting variable representing the evaluation of this
condition
Retrieves an absolute or relative URL and exposes its contents to either the page, a
import
String in 'var', or a Reader in 'varReader'.
The basic iteration tag, accepting many different collection types and supporting
forEach
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.


Subtag of <choose> that follows <when> tags and runs only if all of the prior
otherwise
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 Validator


org.apache. Provides core validation features for JSTL tags.
taglibs.
standard.tlv.
JstlCoreTLV

Overview Library Tag Help


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)

Overview Library Tag Help


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 Information
Tag Class org.apache.taglibs.standard.tag.common.core.ChooseTag
TagExtraInfo Class None
Body Content JSP
Display Name None

Attributes
No Attributes Defined.

Variables
No Variables Defined.

Overview Library Tag Help


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/c/choose.html23/01/08 10:11:31 AM
if (TLDDoc Generated Documentation)

Overview Library Tag Help


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 Information
Tag Class org.apache.taglibs.standard.tag.rt.core.IfTag
TagExtraInfo Class None
Body Content JSP
Display Name None

Attributes
Name Required Request-time Type Description
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.

Variables
No Variables Defined.

Overview Library Tag Help

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


if (TLDDoc Generated Documentation)

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/c/if.html (2 of 2)23/01/08 10:11:33 AM


import (TLDDoc Generated Documentation)

Overview Library Tag Help


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 Information
Tag Class org.apache.taglibs.standard.tag.rt.core.ImportTag
TagExtraInfo Class org.apache.taglibs.standard.tei.ImportTEI
Body Content JSP
Display Name None

Attributes
Name Required Request-time Type Description
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.
scope false false java.lang.String Scope for var.
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.

Variables
No Variables Defined.

Overview Library Tag Help


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/c/import.html (2 of 2)23/01/08 10:11:35 AM


forEach (TLDDoc Generated Documentation)

Overview Library Tag Help


FRAMES NO FRAMES

JSTL core
Tag forEach

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

Tag Information
Tag Class org.apache.taglibs.standard.tag.rt.core.ForEachTag
TagExtraInfo Class org.apache.taglibs.standard.tei.ForEachTEI
Body Content JSP
Display Name None

Attributes
Name Required Request-time Type Description
items false true java.lang. Collection of items to iterate over.
Object
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


forEach (TLDDoc Generated Documentation)

var false false java.lang. Name of the exported scoped variable


String 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. Name of the exported scoped variable
String for the status of the iteration. Object
exported is of type javax.servlet.jsp.jstl.
core.LoopTagStatus. This scoped
variable has nested visibility.

Variables
No Variables Defined.

Overview Library Tag Help


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/c/forEach.html (2 of 2)23/01/08 10:11:37 AM


forTokens (TLDDoc Generated Documentation)

Overview Library Tag Help


FRAMES NO FRAMES

JSTL core
Tag forTokens

Iterates over tokens, separated by the supplied delimeters

Tag Information
Tag Class org.apache.taglibs.standard.tag.rt.core.ForTokensTag
TagExtraInfo Class None
Body Content JSP
Display Name None

Attributes
Name Required Request-time Type Description
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.

Variables
No Variables Defined.

Overview Library Tag Help


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/c/forTokens.html (2 of 2)23/01/08 10:11:40 AM


out (TLDDoc Generated Documentation)

Overview Library Tag Help


FRAMES NO FRAMES

JSTL core
Tag out

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

Tag Information
Tag Class org.apache.taglibs.standard.tag.rt.core.OutTag
TagExtraInfo Class None
Body Content JSP
Display Name None

Attributes
Name Required Request-time Type Description
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.

Variables
No Variables Defined.

Overview Library Tag Help


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


out (TLDDoc Generated Documentation)

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/c/out.html (2 of 2)23/01/08 10:11:42 AM


otherwise (TLDDoc Generated Documentation)

Overview Library Tag Help


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 Information
Tag Class org.apache.taglibs.standard.tag.common.core.OtherwiseTag
TagExtraInfo Class None
Body Content JSP
Display Name None

Attributes
No Attributes Defined.

Variables
No Variables Defined.

Overview Library Tag Help


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/c/otherwise.html23/01/08 10:11:44 AM
param (TLDDoc Generated Documentation)

Overview Library Tag Help


FRAMES NO FRAMES

JSTL core
Tag param

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

Tag Information
Tag Class org.apache.taglibs.standard.tag.rt.core.ParamTag
TagExtraInfo Class None
Body Content JSP
Display Name None

Attributes
Name Required Request-time Type Description
name true true java.lang.String Name of the query string parameter.
value false true java.lang.String Value of the parameter.

Variables
No Variables Defined.

Overview Library Tag Help


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/c/param.html23/01/08 10:11:46 AM
redirect (TLDDoc Generated Documentation)

Overview Library Tag Help


FRAMES NO FRAMES

JSTL core
Tag redirect

Redirects to a new URL.

Tag Information
Tag Class org.apache.taglibs.standard.tag.rt.core.RedirectTag
TagExtraInfo Class None
Body Content JSP
Display Name None

Attributes
Name Required Request-time Type Description
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.

Variables
No Variables Defined.

Overview Library Tag Help


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/c/redirect.html23/01/08 10:11:47 AM
remove (TLDDoc Generated Documentation)

Overview Library Tag Help


FRAMES NO FRAMES

JSTL core
Tag remove

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

Tag Information
Tag Class org.apache.taglibs.standard.tag.common.core.RemoveTag
TagExtraInfo Class None
Body Content empty
Display Name None

Attributes
Name Required Request-time Type Description
var true false java.lang.String Name of the scoped variable to be
removed.
scope false false java.lang.String Scope for var.

Variables
No Variables Defined.

Overview Library Tag Help


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/c/remove.html23/01/08 10:11:49 AM
set (TLDDoc Generated Documentation)

Overview Library Tag Help


FRAMES NO FRAMES

JSTL core
Tag set

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

Tag Information
Tag Class org.apache.taglibs.standard.tag.rt.core.SetTag
TagExtraInfo Class None
Body Content JSP
Display Name None

Attributes
Name Required Request-time Type Description
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.
scope false false java.lang.String Scope for var.

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


set (TLDDoc Generated Documentation)

Variables
No Variables Defined.

Overview Library Tag Help


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/c/set.html (2 of 2)23/01/08 10:11:50 AM


url (TLDDoc Generated Documentation)

Overview Library Tag Help


FRAMES NO FRAMES

JSTL core
Tag url

Creates a URL with optional query parameters.

Tag Information
Tag Class org.apache.taglibs.standard.tag.rt.core.UrlTag
TagExtraInfo Class None
Body Content JSP
Display Name None

Attributes
Name Required Request-time Type Description
var false false java.lang.String Name of the exported scoped variable for
the processed url. The type of the scoped
variable is String.
scope false false java.lang.String Scope for var.
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.

Variables
No Variables Defined.

Overview Library Tag Help


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)

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/c/url.html (2 of 2)23/01/08 10:11:51 AM


when (TLDDoc Generated Documentation)

Overview Library Tag Help


FRAMES NO FRAMES

JSTL core
Tag when

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

Tag Information
Tag Class org.apache.taglibs.standard.tag.rt.core.WhenTag
TagExtraInfo Class None
Body Content JSP
Display Name None

Attributes
Name Required Request-time Type Description
test true true boolean The test condition that determines whether or not the
body content should be processed.

Variables
No Variables Defined.

Overview Library Tag Help


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/c/when.html23/01/08 10:11:53 AM
bundle (TLDDoc Generated Documentation)

Overview Library Tag Help


FRAMES NO FRAMES

JSTL fmt
Tag bundle

Loads a resource bundle to be used by its tag body

Tag Information
Tag Class org.apache.taglibs.standard.tag.rt.fmt.BundleTag
TagExtraInfo Class None
Body Content JSP
Display Name None

Attributes
Name Required Request-time Type Description
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.

Variables
No Variables Defined.

Overview Library Tag Help

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

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/fmt/bundle.html (2 of 2)23/01/08 10:11:54 AM


JSTL fmt (TLDDoc Generated Documentation)

Overview Library Tag Help


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 Information


Display Name JSTL fmt
Version 1.1
Short Name fmt
URI http://java.sun.com/jsp/jstl/fmt

Tag Summary
requestEncoding Sets the request character encoding
setLocale Stores the given locale in the locale configuration variable
Specifies the time zone for any time formatting or parsing actions nested in its
timeZone
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
Loads a resource bundle and stores it in the named scoped variable or the bundle
setBundle
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 Validator


org.apache. Provides core validation features for JSTL tags.
taglibs.
standard.tlv.
JstlFmtTLV

Overview Library Tag Help


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/fmt/tld-summary.html (2 of 2)23/01/08 10:11:59 AM


requestEncoding (TLDDoc Generated Documentation)

Overview Library Tag Help


FRAMES NO FRAMES

JSTL fmt
Tag requestEncoding

Sets the request character encoding

Tag Information
Tag Class org.apache.taglibs.standard.tag.rt.fmt.RequestEncodingTag
TagExtraInfo Class None
Body Content empty
Display Name None

Attributes
Name Required Request-time Type Description
value false true java.lang.String Name of character encoding to be applied
when decoding request parameters.

Variables
No Variables Defined.

Overview Library Tag Help


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/fmt/requestEncoding.html23/01/08 10:12:00 AM
setLocale (TLDDoc Generated Documentation)

Overview Library Tag Help


FRAMES NO FRAMES

JSTL fmt
Tag setLocale

Stores the given locale in the locale configuration variable

Tag Information
Tag Class org.apache.taglibs.standard.tag.rt.fmt.SetLocaleTag
TagExtraInfo Class None
Body Content empty
Display Name None

Attributes
Name Required Request-time Type Description
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.

Overview Library Tag Help


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/fmt/setLocale.html (2 of 2)23/01/08 10:12:02 AM


timeZone (TLDDoc Generated Documentation)

Overview Library Tag Help


FRAMES NO FRAMES

JSTL fmt
Tag timeZone

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

Tag Information
Tag Class org.apache.taglibs.standard.tag.rt.fmt.TimeZoneTag
TagExtraInfo Class None
Body Content JSP
Display Name None

Attributes
Name Required Request-time Type Description
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.

Variables
No Variables Defined.

Overview Library Tag Help


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)

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/fmt/timeZone.html (2 of 2)23/01/08 10:12:08 AM


setTimeZone (TLDDoc Generated Documentation)

Overview Library Tag Help


FRAMES NO FRAMES

JSTL fmt
Tag setTimeZone

Stores the given time zone in the time zone configuration variable

Tag Information
Tag Class org.apache.taglibs.standard.tag.rt.fmt.SetTimeZoneTag
TagExtraInfo Class None
Body Content empty
Display Name None

Attributes
Name Required Request-time Type Description
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)

No Variables Defined.

Overview Library Tag Help


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/fmt/setTimeZone.html (2 of 2)23/01/08 10:12:09 AM


setBundle (TLDDoc Generated Documentation)

Overview Library Tag Help


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 Information
Tag Class org.apache.taglibs.standard.tag.rt.fmt.SetBundleTag
TagExtraInfo Class None
Body Content empty
Display Name None

Attributes
Name Required Request-time Type Description
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)

No Variables Defined.

Overview Library Tag Help


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/fmt/setBundle.html (2 of 2)23/01/08 10:12:11 AM


message (TLDDoc Generated Documentation)

Overview Library Tag Help


FRAMES NO FRAMES

JSTL fmt
Tag message

Maps key to localized message and performs parametric replacement

Tag Information
Tag Class org.apache.taglibs.standard.tag.rt.fmt.MessageTag
TagExtraInfo Class None
Body Content JSP
Display Name None

Attributes
Name Required Request-time Type Description
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.

Variables
No Variables Defined.

Overview Library Tag Help


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


param (TLDDoc Generated Documentation)

Overview Library Tag Help


FRAMES NO FRAMES

JSTL fmt
Tag param

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

Tag Information
Tag Class org.apache.taglibs.standard.tag.rt.fmt.ParamTag
TagExtraInfo Class None
Body Content JSP
Display Name None

Attributes
Name Required Request-time Type Description
value false true java.lang.String Argument used for parametric
replacement.

Variables
No Variables Defined.

Overview Library Tag Help


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/fmt/param.html23/01/08 10:12:14 AM
formatNumber (TLDDoc Generated Documentation)

Overview Library Tag Help


FRAMES NO FRAMES

JSTL fmt
Tag formatNumber

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

Tag Information
Tag Class org.apache.taglibs.standard.tag.rt.fmt.FormatNumberTag
TagExtraInfo Class None
Body Content JSP
Display Name None

Attributes
Name Required Request-time Type Description
value false true java.lang. Numeric value to be formatted.
String
type false true java.lang. Specifies whether the value is
String to be formatted as number,
currency, or percentage.
pattern false true java.lang. Custom formatting pattern.
String
currencyCode false true java.lang. ISO 4217 currency code.
String 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. Currency symbol. Applied


String only when formatting
currencies (i.e. if type is equal
to "currency"); ignored
otherwise.
groupingUsed false true java.lang. Specifies whether the
String formatted output will contain
any grouping separators.
maxIntegerDigits false true java.lang. Maximum number of digits in
String the integer portion of the
formatted output.
minIntegerDigits false true java.lang. Minimum number of digits in
String the integer portion of the
formatted output.
maxFractionDigits false true java.lang. Maximum number of digits in
String the fractional portion of the
formatted output.
minFractionDigits false true java.lang. Minimum number of digits in
String the fractional portion of the
formatted output.
var false false java.lang. Name of the exported scoped
String variable which stores the
formatted result as a String.
scope false false java.lang. Scope of var.
String

Variables
No Variables Defined.

Overview Library Tag Help


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/fmt/formatNumber.html (2 of 2)23/01/08 10:12:16 AM


parseNumber (TLDDoc Generated Documentation)

Overview Library Tag Help


FRAMES NO FRAMES

JSTL fmt
Tag parseNumber

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

Tag Information
Tag Class org.apache.taglibs.standard.tag.rt.fmt.ParseNumberTag
TagExtraInfo Class None
Body Content JSP
Display Name None

Attributes
Name Required Request-time Type Description
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).
scope false false java.lang.String Scope of var.

Variables
No Variables Defined.

Overview Library Tag Help


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/fmt/parseNumber.html (2 of 2)23/01/08 10:12:17 AM


formatDate (TLDDoc Generated Documentation)

Overview Library Tag Help


FRAMES NO FRAMES

JSTL fmt
Tag formatDate

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

Tag Information
Tag Class org.apache.taglibs.standard.tag.rt.fmt.FormatDateTag
TagExtraInfo Class None
Body Content empty
Display Name None

Attributes
Name Required Request-time Type Description
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.
scope false false java.lang.String Scope of var.

Variables
No Variables Defined.

Overview Library Tag Help


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/fmt/formatDate.html (2 of 2)23/01/08 10:12:19 AM


parseDate (TLDDoc Generated Documentation)

Overview Library Tag Help


FRAMES NO FRAMES

JSTL fmt
Tag parseDate

Parses the string representation of a date and/or time

Tag Information
Tag Class org.apache.taglibs.standard.tag.rt.fmt.ParseDateTag
TagExtraInfo Class None
Body Content JSP
Display Name None

Attributes
Name Required Request-time Type Description
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.
scope false false java.lang.String Scope of var.

Variables
No Variables Defined.

Overview Library Tag Help


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/fmt/parseDate.html (2 of 2)23/01/08 10:12:21 AM


contains (TLDDoc Generated Documentation)

Overview Library Tag Help


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 Information
Function Class org.apache.taglibs.standard.functions.Functions
Function Signature boolean contains(java.lang.String, java.lang.String)
Display Name None

Overview Library Tag Help


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/fn/contains.fn.html23/01/08 10:12:23 AM
JSTL functions (TLDDoc Generated Documentation)

Overview Library Tag Help


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 Information


Display Name JSTL functions
Version 1.1
Short Name fn
URI http://java.sun.com/jsp/jstl/functions

Function Summary
Tests if an
input string
contains
boolean contains( java.lang.String, java.lang.String)
the
specified
substring.
Tests if an
input string
contains
the
boolean containsIgnoreCase( java.lang.String, java.lang.String) specified
substring in
a case
insensitive
way.
Tests if an
input string
ends with
boolean endsWith( java.lang.String, java.lang.String)
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


JSTL functions (TLDDoc Generated Documentation)

Escapes
characters
that could
java.lang.String escapeXml( java.lang.String) be
interpreted
as XML
markup.
Returns the
index
withing a
string of
int indexOf( java.lang.String, java.lang.String) the first
occurrence
of a
specified
substring.
Joins all
elements of
java.lang.String join( java.lang.String[], java.lang.String) an array
into a
string.
Returns the
number of
items in a
collection,
int length( java.lang.Object)
or the
number of
characters
in a string.
Returns a
string
resulting
from
replacing in
an input
java.lang.String replace( java.lang.String, java.lang.String, java.lang.String) string all
occurrences
of a
"before"
string into
an "after"
substring.
Splits a
string into
java.lang.String[] split( java.lang.String, java.lang.String)
an array of
substrings.
Tests if an
input string
starts with
boolean startsWith( java.lang.String, java.lang.String)
the
specified
prefix.

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


JSTL functions (TLDDoc Generated Documentation)

Returns a
java.lang.String substring( java.lang.String, int, int) subset of a
string.
Returns a
subset of a
string
java.lang.String substringAfter( java.lang.String, java.lang.String)
following a
specific
substring.
Returns a
subset of a
string
java.lang.String substringBefore( java.lang.String, java.lang.String)
before a
specific
substring.
Converts
all of the
characters
java.lang.String toLowerCase( java.lang.String)
of a string
to lower
case.
Converts
all of the
characters
java.lang.String toUpperCase( java.lang.String)
of a string
to upper
case.
Removes
white
spaces
java.lang.String trim( java.lang.String)
from both
ends of a
string.

Overview Library Tag Help


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/fn/tld-summary.html (3 of 3)23/01/08 10:12:25 AM


containsIgnoreCase (TLDDoc Generated Documentation)

Overview Library Tag Help


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 Information
Function Class org.apache.taglibs.standard.functions.Functions
Function Signature boolean containsIgnoreCase(java.lang.String, java.lang.String)
Display Name None

Overview Library Tag Help


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/fn/containsIgnoreCase.fn.html23/01/08 10:12:27 AM
endsWith (TLDDoc Generated Documentation)

Overview Library Tag Help


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 Information
Function Class org.apache.taglibs.standard.functions.Functions
Function Signature boolean endsWith(java.lang.String, java.lang.String)
Display Name None

Overview Library Tag Help


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/fn/endsWith.fn.html23/01/08 10:12:29 AM
escapeXml (TLDDoc Generated Documentation)

Overview Library Tag Help


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 Information
Function Class org.apache.taglibs.standard.functions.Functions
Function Signature java.lang.String escapeXml(java.lang.String)
Display Name None

Overview Library Tag Help


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/fn/escapeXml.fn.html23/01/08 10:12:31 AM
indexOf (TLDDoc Generated Documentation)

Overview Library Tag Help


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 Information
Function Class org.apache.taglibs.standard.functions.Functions
Function Signature int indexOf(java.lang.String, java.lang.String)
Display Name None

Overview Library Tag Help


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/fn/indexOf.fn.html23/01/08 10:12:33 AM
join (TLDDoc Generated Documentation)

Overview Library Tag Help


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 Information
Function Class org.apache.taglibs.standard.functions.Functions
Function Signature java.lang.String join(java.lang.String[], java.lang.String)
Display Name None

Overview Library Tag Help


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/fn/join.fn.html23/01/08 10:12:35 AM
length (TLDDoc Generated Documentation)

Overview Library Tag Help


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 Information
Function Class org.apache.taglibs.standard.functions.Functions
Function Signature int length(java.lang.Object)
Display Name None

Overview Library Tag Help


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/fn/length.fn.html23/01/08 10:12:38 AM
replace (TLDDoc Generated Documentation)

Overview Library Tag Help


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 Information
Function Class org.apache.taglibs.standard.functions.Functions
Function Signature java.lang.String replace(java.lang.String, java.lang.String, java.lang.String)
Display Name None

Overview Library Tag Help


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/fn/replace.fn.html23/01/08 10:12:40 AM
split (TLDDoc Generated Documentation)

Overview Library Tag Help


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 Information
Function Class org.apache.taglibs.standard.functions.Functions
Function Signature java.lang.String[] split(java.lang.String, java.lang.String)
Display Name None

Overview Library Tag Help


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/fn/split.fn.html23/01/08 10:12:42 AM
startsWith (TLDDoc Generated Documentation)

Overview Library Tag Help


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 Information
Function Class org.apache.taglibs.standard.functions.Functions
Function Signature boolean startsWith(java.lang.String, java.lang.String)
Display Name None

Overview Library Tag Help


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/fn/startsWith.fn.html23/01/08 10:12:44 AM
substring (TLDDoc Generated Documentation)

Overview Library Tag Help


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 Information
Function Class org.apache.taglibs.standard.functions.Functions
Function Signature java.lang.String substring(java.lang.String, int, int)
Display Name None

Overview Library Tag Help


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/fn/substring.fn.html23/01/08 10:12:46 AM
substringAfter (TLDDoc Generated Documentation)

Overview Library Tag Help


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 Information
Function Class org.apache.taglibs.standard.functions.Functions
Function Signature java.lang.String substringAfter(java.lang.String, java.lang.String)
Display Name None

Overview Library Tag Help


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/fn/substringAfter.fn.html23/01/08 10:12:48 AM
substringBefore (TLDDoc Generated Documentation)

Overview Library Tag Help


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 Information
Function Class org.apache.taglibs.standard.functions.Functions
Function Signature java.lang.String substringBefore(java.lang.String, java.lang.String)
Display Name None

Overview Library Tag Help


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/fn/substringBefore.fn.html23/01/08 10:12:50 AM
toLowerCase (TLDDoc Generated Documentation)

Overview Library Tag Help


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 Information
Function Class org.apache.taglibs.standard.functions.Functions
Function Signature java.lang.String toLowerCase(java.lang.String)
Display Name None

Overview Library Tag Help


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/fn/toLowerCase.fn.html23/01/08 10:12:53 AM
toUpperCase (TLDDoc Generated Documentation)

Overview Library Tag Help


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 Information
Function Class org.apache.taglibs.standard.functions.Functions
Function Signature java.lang.String toUpperCase(java.lang.String)
Display Name None

Overview Library Tag Help


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/fn/toUpperCase.fn.html23/01/08 10:12:55 AM
trim (TLDDoc Generated Documentation)

Overview Library Tag Help


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 Information
Function Class org.apache.taglibs.standard.functions.Functions
Function Signature java.lang.String trim(java.lang.String)
Display Name None

Overview Library Tag Help


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/fn/trim.fn.html23/01/08 10:12:57 AM
dateParam (TLDDoc Generated Documentation)

Overview Library Tag Help


FRAMES NO FRAMES

JSTL sql
Tag dateParam

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

Tag Information
Tag Class org.apache.taglibs.standard.tag.rt.sql.DateParamTag
TagExtraInfo Class None
Body Content empty
Display Name None

Attributes
Name Required Request-time Type Description
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".

Variables
No Variables Defined.

Overview Library Tag Help


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/sql/dateParam.html23/01/08 10:12:59 AM
JSTL sql (TLDDoc Generated Documentation)

Overview Library Tag Help


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 Information


Display Name JSTL sql
Version 1.1
Short Name sql
URI http://java.sun.com/jsp/jstl/sql

Tag Summary
Provides nested database action elements with a shared Connection, set up to execute
transaction
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 Validator


org.apache. Provides core validation features for JSTL tags.
taglibs.
standard.tlv.
JstlSqlTLV

Overview Library Tag Help


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/sql/tld-summary.html (2 of 2)23/01/08 10:13:01 AM


transaction (TLDDoc Generated Documentation)

Overview Library Tag Help


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 Information
Tag Class org.apache.taglibs.standard.tag.rt.sql.TransactionTag
TagExtraInfo Class None
Body Content JSP
Display Name None

Attributes
Name Required Request-time Type Description
dataSource false true java.lang. DataSource associated with the
String 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. Transaction isolation level. If not
String specified, it is the isolation level the
DataSource has been configured with.

Variables
No Variables Defined.

Overview Library Tag Help


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)

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/sql/transaction.html (2 of 2)23/01/08 10:13:03 AM


query (TLDDoc Generated Documentation)

Overview Library Tag Help


FRAMES NO FRAMES

JSTL sql
Tag query

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

Tag Information
Tag Class org.apache.taglibs.standard.tag.rt.sql.QueryTag
TagExtraInfo Class None
Body Content JSP
Display Name None

Attributes
Name Required Request-time Type Description
var true false java.lang. Name of the exported scoped variable
String for the query result. The type of the
scoped variable is javax.servlet.jsp.jstl.
sql. Result (see Chapter 16 "Java
APIs").
scope false false java.lang. Scope of var.
String
sql false true java.lang. SQL query statement.
String
dataSource false true java.lang. Data source associated with the
String 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. The returned Result object includes


String 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. The maximum number of rows to be
String included in the query result. If not
specified, or set to -1, no limit on the
maximum number of rows is enforced.

Variables
No Variables Defined.

Overview Library Tag Help


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/sql/query.html (2 of 2)23/01/08 10:13:05 AM


update (TLDDoc Generated Documentation)

Overview Library Tag Help


FRAMES NO FRAMES

JSTL sql
Tag update

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

Tag Information
Tag Class org.apache.taglibs.standard.tag.rt.sql.UpdateTag
TagExtraInfo Class None
Body Content JSP
Display Name None

Attributes
Name Required Request-time Type Description
var false false java.lang. Name of the exported scoped variable
String for the result of the database update.
The type of the scoped variable is java.
lang.Integer.
scope false false java.lang. Scope of var.
String
sql false true java.lang. SQL update statement.
String
dataSource false true java.lang. Data source associated with the
String 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)

No Variables Defined.

Overview Library Tag Help


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/sql/update.html (2 of 2)23/01/08 10:13:06 AM


param (TLDDoc Generated Documentation)

Overview Library Tag Help


FRAMES NO FRAMES

JSTL sql
Tag param

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

Tag Information
Tag Class org.apache.taglibs.standard.tag.rt.sql.ParamTag
TagExtraInfo Class None
Body Content JSP
Display Name None

Attributes
Name Required Request-time Type Description
value false true java.lang.String Parameter value.

Variables
No Variables Defined.

Overview Library Tag Help


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/sql/param.html23/01/08 10:13:10 AM
setDataSource (TLDDoc Generated Documentation)

Overview Library Tag Help


FRAMES NO FRAMES

JSTL sql
Tag setDataSource

Creates a simple DataSource suitable only for prototyping.

Tag Information
Tag Class org.apache.taglibs.standard.tag.rt.sql.SetDataSourceTag
TagExtraInfo Class None
Body Content empty
Display Name None

Attributes
Name Required Request-time Type Description
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

Variables
No Variables Defined.

Overview Library Tag Help


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/sql/setDataSource.html (2 of 2)23/01/08 10:13:12 AM


choose (TLDDoc Generated Documentation)

Overview Library Tag Help


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 Information
Tag Class org.apache.taglibs.standard.tag.common.core.ChooseTag
TagExtraInfo Class None
Body Content JSP
Display Name None

Attributes
No Attributes Defined.

Variables
No Variables Defined.

Overview Library Tag Help


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/x/choose.html23/01/08 10:13:13 AM
JSTL XML (TLDDoc Generated Documentation)

Overview Library Tag Help


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 Information


Display Name JSTL XML
Version 1.1
Short Name x
URI http://java.sun.com/jsp/jstl/xml

Tag Summary
Simple conditional tag that establishes a context for mutually exclusive conditional
choose
operations, marked by <when> and <otherwise>
out Like <%= ... >, but for XPath expressions.
XML conditional tag, which evalutes its body if the supplied XPath expression
if
evalutes to 'true' as a boolean
forEach XML iteration tag.
Subtag of <choose> that follows <when> tags and runs only if all of the prior
otherwise
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 Validator


org.apache. Provides validation features for JSTL XML tags.
taglibs.
standard.tlv.
JstlXmlTLV

Overview Library Tag Help


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/x/tld-summary.html (2 of 2)23/01/08 10:13:15 AM


out (TLDDoc Generated Documentation)

Overview Library Tag Help


FRAMES NO FRAMES

JSTL XML
Tag out

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

Tag Information
Tag Class org.apache.taglibs.standard.tag.rt.xml.ExprTag
TagExtraInfo Class None
Body Content empty
Display Name None

Attributes
Name Required Request-time Type Description
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.

Variables
No Variables Defined.

Overview Library Tag Help


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


out (TLDDoc Generated Documentation)

Clara, CA 95054, U.S.A. All Rights Reserved.

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


if (TLDDoc Generated Documentation)

Overview Library Tag Help


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 Information
Tag Class org.apache.taglibs.standard.tag.common.xml.IfTag
TagExtraInfo Class None
Body Content JSP
Display Name None

Attributes
Name Required Request-time Type Description
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.
scope false false java.lang.String Scope for var.

Variables
No Variables Defined.

Overview Library Tag Help


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


if (TLDDoc Generated Documentation)

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/x/if.html (2 of 2)23/01/08 10:13:17 AM


forEach (TLDDoc Generated Documentation)

Overview Library Tag Help


FRAMES NO FRAMES

JSTL XML
Tag forEach

XML iteration tag.

Tag Information
Tag Class org.apache.taglibs.standard.tag.common.xml.ForEachTag
TagExtraInfo Class None
Body Content JSP
Display Name None

Attributes
Name Required Request-time Type Description
var false false java.lang. Name of the exported scoped variable
String 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. XPath expression to be evaluated.
String
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


forEach (TLDDoc Generated Documentation)

varStatus false false java.lang. Name of the exported scoped variable


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

Variables
No Variables Defined.

Overview Library Tag Help


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/x/forEach.html (2 of 2)23/01/08 10:13:19 AM


otherwise (TLDDoc Generated Documentation)

Overview Library Tag Help


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 Information
Tag Class org.apache.taglibs.standard.tag.common.core.OtherwiseTag
TagExtraInfo Class None
Body Content JSP
Display Name None

Attributes
No Attributes Defined.

Variables
No Variables Defined.

Overview Library Tag Help


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/x/otherwise.html23/01/08 10:13:20 AM
param (TLDDoc Generated Documentation)

Overview Library Tag Help


FRAMES NO FRAMES

JSTL XML
Tag param

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

Tag Information
Tag Class org.apache.taglibs.standard.tag.rt.xml.ParamTag
TagExtraInfo Class None
Body Content JSP
Display Name None

Attributes
Name Required Request-time Type Description
name true true java.lang.String Name of the transformation parameter.
value false true java.lang.String Value of the parameter.

Variables
No Variables Defined.

Overview Library Tag Help


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/x/param.html23/01/08 10:13:22 AM
parse (TLDDoc Generated Documentation)

Overview Library Tag Help


FRAMES NO FRAMES

JSTL XML
Tag parse

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

Tag Information
Tag Class org.apache.taglibs.standard.tag.rt.xml.ParseTag
TagExtraInfo Class org.apache.taglibs.standard.tei.XmlParseTEI
Body Content JSP
Display Name None

Attributes
Name Required Request-time Type Description
var false false java.lang. Name of the exported scoped variable
String for the parsed XML document. The
type of the scoped variable is
implementation dependent.
varDom false false java.lang. Name of the exported scoped variable
String for the parsed XML document. The
type of the scoped variable is org.w3c.
dom.Document.
scope false false java.lang. Scope for var.
String
scopeDom false false java.lang. Scope for varDom.
String
xml false true java.lang. Deprecated. Use attribute 'doc' instead.
String

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. Source XML document to be parsed.


String
systemId false true java.lang. The system identifier (URI) for parsing
String the XML document.
filter false true java.lang. Filter to be applied to the source
String document.

Variables
No Variables Defined.

Overview Library Tag Help


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/x/parse.html (2 of 2)23/01/08 10:13:23 AM


set (TLDDoc Generated Documentation)

Overview Library Tag Help


FRAMES NO FRAMES

JSTL XML
Tag set

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

Tag Information
Tag Class org.apache.taglibs.standard.tag.common.xml.SetTag
TagExtraInfo Class None
Body Content empty
Display Name None

Attributes
Name Required Request-time Type Description
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.
scope false false java.lang.String Scope for var.

Variables
No Variables Defined.

Overview Library Tag Help


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


set (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/x/set.html (2 of 2)23/01/08 10:13:24 AM


transform (TLDDoc Generated Documentation)

Overview Library Tag Help


FRAMES NO FRAMES

JSTL XML
Tag transform

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

Tag Information
Tag Class org.apache.taglibs.standard.tag.rt.xml.TransformTag
TagExtraInfo Class org.apache.taglibs.standard.tei.XmlTransformTEI
Body Content JSP
Display Name None

Attributes
Name Required Request-time Type Description
var false false java.lang. Name of the exported scoped
String variable for the transformed XML
document. The type of the scoped
variable is org.w3c.dom.Document.
scope false false java.lang. Scope for var.
String
result false true java.lang. Result Object that captures or
String processes the transformation result.
xml false true java.lang. Deprecated. Use attribute 'doc'
String instead.
doc false true java.lang. Source XML document to be
String 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. Deprecated. Use attribute


String 'docSystemId' instead.
docSystemId false true java.lang. The system identifier (URI) for
String parsing the XML document.
xslt false true java.lang. javax.xml.transform.Source
String Transformation stylesheet as a String,
Reader, or Source object.
xsltSystemId false true java.lang. The system identifier (URI) for
String parsing the XSLT stylesheet.

Variables
No Variables Defined.

Overview Library Tag Help


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/x/transform.html (2 of 2)23/01/08 10:13:26 AM


when (TLDDoc Generated Documentation)

Overview Library Tag Help


FRAMES NO FRAMES

JSTL XML
Tag when

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

Tag Information
Tag Class org.apache.taglibs.standard.tag.common.xml.WhenTag
TagExtraInfo Class None
Body Content JSP
Display Name None

Attributes
Name Required Request-time Type Description
select true false java.lang.String The test condition that tells whether or not
the body content should be processed

Variables
No Variables Defined.

Overview Library Tag Help


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/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

You might also like