<x:getParameter>

An x:getParameter action is used to get the value of a parameter. You can explicitly specify which parameter in which Select, Modify, or ProcedureCall, or you can let these choices default, as described below in the attributes position and name. This can be particularly useful if the action occurs inside the body of an x:repeat.

 

Syntax

<x:getParameter     name = "target bean name"
            parmName = "name"
            position = "number"
            nullToken = "string" />

The x:getParameter element has the following attributes:

name

The name of the DBSelect, DBModify, or DBProcedureCall bean for which a parameter value is to be obtained. The value is case sensitive and must match a Select, Modify, or ProcedureCall variable that is in scope. This attribute is required unless the action is (directly or indirectly) inside the body of an x:repeat for which the name attribute has been specified. In that case, the name attribute defaults to the same value specified in the closest containing x:repeat.

parmName

The name of the parameter. This value is case sensitive. The attribute is optional. It has no default value. You must identify a parameter with either this attribute or the position attribute. It is an error to explicitly specify both.

position

The position of the parameter. The first parameter has a position of 1. This attribute is optional. You must identify a parameter with either this attribute or the parmName attribute. It is an error to explicitly specify both.

nullToken

Specifies a case-sensitive String value that will be used to represent the database null value in JSP output.

This attribute is optional. If you omit it, the value for the same attribute on the associated x:select, x:modify, or x:procedureCall action is used. If the attribute is omitted in both places, the default is &empty. (&empty is a special value, similar to an HTML character entity, recognized in this attribute as representing an empty String.) See Null values for more on null value representation.