Home > Contents > Index >
Template Tags TOC | Alpha TOC | Tag Family TOC | Purpose TOC | Annotated TOC | Index
object:gather
Gathers fields into an object.
Syntax
<object:gather name="object name" prefix="prefix" [fieldlist="list of field names"]/>Parameters
name (required)
- Name of the object in the object pool.
prefix (required)
- Specifies the name of a string to be used as the prefix for variable names, which may exist in the environment. A colon (:) is used as a prefix separator, followed by a field name when the
object:gather
tag is looking for variables in the environment.fieldlist (optional)
- Specifies a comma-separated list of field names that should be gathered. Any field in the list that does not exist in the environment is cleared. If this parameter is not specified, then the
object:gather
tag looks at all fields in the environment. If they are not found the existing value is maintained.Description
This tag retrieves name/value pairs from the environment, and sets them into a loaded object. The name/value pairs are grouped together using a prefix and a prefix separator.
Error Numbers
The possible values of errno include:
Value Description -10004 A required parameter is missing. -10005 The requested object is not in the object pool (is not loaded intomemory).Example
The following example gathers the
name
anddescription
fields from the environment intoobject1,
using the prefixsample
:<object:gather name="object1" prefix="sample" fieldlist="name,description"/>See Also
Home > Contents > Index > ![]()
Oracle JSP Tag Reference
Copyright (c) 2013, 2015, Oracle and/or its affiliates. All rights reserved.