write (Struts Taglib Tag library documentation)

Overview

Library

Tag

Help

FRAMES NO FRAMES

bean
Tag write

Render the value of the specified bean property to the current JspWriter.

Retrieve the value of the specified bean property, and render it to the current JspWriter as a String by the ways:

If format attribute exists then value will be formatted on base of format string from format attribute and default system locale.
If in resources exists format string for value data type (view format attribute description) then value will be formatted on base of format string from resources. Resources bundle and target locale can be specified with bundle and locale attributes. If nothing specified then default resource bundle and current user locale will be used.
If there is a PropertyEditor configured for the property value's class, the getAsText() method will be called.
Otherwise, the usual toString() conversions will be applied.

When a format string is provided, numeric values are formatted using the java.text.DecimalFormat class; if the format string came from a resource, the applyLocalisedPattern() method is used, and applyPattern() is used otherwise. Dates are formatted using the SimpleDateFormat class. For details of the specific format patterns, please see the Javadocs for those classes.

If a problem occurs while retrieving the specified bean property, a request time exception will be thrown.

Tag Information
Tag Class	org.apache.struts.taglib.bean.WriteTag
TagExtraInfo Class	None
Body Content	empty
Display Name	None

Attributes
Name	Required	Request-time	Type	Description
bundle	false	true	`java.lang.String`	The name of the application scope bean under which the `MessageResources` object containing our messages is stored.
filter	false	true	`boolean`	If this attribute is set to `true`, the rendered property value will be filtered for characters that are sensitive in HTML, and any such characters will be replaced by their entity equivalents.
format	false	true	`java.lang.String`	Specifies the format string to use to convert bean or property value to the `String`. If nothing specified, then default format string for value data type will be searched in message resources by according key.
formatKey	false	true	`java.lang.String`	Specifies the key to search format string in application resources.
ignore	false	true	`boolean`	If this attribute is set to `true`, and the bean specified by the `name` and `scope` attributes does not exist, simply return without writing anything. If this attribute is set to `false`, a runtime exception to be thrown, consistent with the other tags in this tag library.
locale	false	true	`java.lang.String`	The name of the session scope bean under which our currently selected `Locale` object is stored.
name	true	true	`java.lang.String`	Specifies the attribute name of the bean whose property is accessed to retrieve the value specified by `property` (if specified). If `property` is not specified, the value of this bean itself will be rendered.
property	false	true	`java.lang.String`	Specifies the name of the property to be accessed on the bean specified by `name`. This value may be a simple, indexed, or nested property reference expression. If not specified, the bean identified by `name` will itself be rendered. If the specified property returns null, no output will be rendered.
scope	false	true	`java.lang.String`	Specifies the variable scope searched to retrieve the bean specified by `name`. If not specified, the default rules applied by `PageContext.findAttribute()` are applied.

Variables
No Variables Defined.

Overview

Library

Tag

Help

FRAMES NO FRAMES

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

bean Tag write

bean
Tag write