JavaServer Pages(TM) v1.2 Syntax Reference

<jsp:getProperty>

Inserts the value of a bean property into the result.

JSP Syntax

<jsp:getProperty name="beanInstanceName" property="propertyName" />

XML Syntax

<jsp:getProperty name="beanInstanceName" property="propertyName" />

Examples

<jsp:useBean id="calendar" scope="page" class="employee.Calendar" />	
<h2>	
Calendar of <jsp:getProperty name="calendar" property="username" />	
</h2>

Description

The <jsp:getProperty> element gets a bean property value using the property's getter methods and inserts the value into the response. You must create or locate a bean with <jsp:useBean> before you use <jsp:getProperty>.

The <jsp:getProperty> element has a few limitations you should be aware of:

You cannot use <jsp:getProperty> to retrieve the values of an indexed property.
You can use <jsp:getProperty> with JavaBeans components, but not with enterprise beans. As alternatives, you can write a JSP page that retrieves values from a bean that in turn retrieves values from an enterprise bean, or you can write a custom tag that retrieves values from an enterprise bean directly.

Attributes

name="beanInstanceName"

The name of an object (usually an instance of a bean) as declared in a <jsp:useBean> element.
property="propertyName"

The name of the bean property whose value you want to display. The property is declared as a variable in a bean and must have a corresponding getter method (for more information on declaring variables and writing getter methods in beans, see http://java.sun.com/products/javabeans/docs/).

Tip

If you use <jsp:getProperty> to retrieve a property value that is null, a NullPointerException is thrown. However, if you use a scriptlet or expression to retrieve the value, the string null is displayed in the browser; see Scriptlet or Expression for more information.