<x:parameter>

x:parameter 元素主要用来为 SQL 语句中的参数提供值,但也可用来提供关于参数的其他信息。此元素在 x:selectx:modifyx:procedureCall 操作中使用。对每个参数使用一个元素。它们可以按任意顺序出现。

关于 SQL 语句中的参数的信息来自两个源的组合:x:sql 元素和 x:parameter 元素。

在 SQL 语句本身中的参数与 x:parameter 元素之间必须存在一一对应关系。可以使用参数名或位置来建立对应关系。两个源之间的任何对立信息都会被标记为错误。

语法

<x:parameter	parmName = "name"
			position = "number"
			value = "value"
			type = "sqlType"
			mode = "in|out|inout"
			nullToken = "string" />

x:parameter 元素具有下列属性:

parmName
指定参数的名称。值区分大小写。如果在 SQL 语句中使用参数名,则必须使用此属性来建立对应关系。否则,必须省略此属性,并指定 position 属性。
position
指定 SQL 语句中的参数的位置。x:parameter 元素可以按任意顺序出现。第一个参数的位置是 1。如果不在 SQL 语句中使用参数名,则必须使用此属性来建立对应关系。否则,必须省略此属性,并指定名称属性。
value
参数的值。您提供的值可以是计算任何 Java™ 对象的表达式。如果省略此值,则在执行 SQL 语句之前,不会为这个参数将任何值传送给数据库。如果参数方式为 out,则此属性被忽略。

如果提供的值为字符串,则此操作会将它转换为适合于参数的 Java 对象类型。保留您输入的大小写不变。如果值为任何其他类型的对象, 则必须是对该参数正确的类型,否则会出错。

我们提供了两个可用来设置此属性的特殊值:&empty 和 &null,它们分别代表空字符串和空对象引用。指定 value="" 等价于指定 value="<%=2.23 nullObj %>,其中 nullObj 是空对象引用。

type
参数的 SQL 类型。有效值是 JDBC 类 java.sql.Types 中定义的常量的名称,例如,VARCHAR。
mode
参数的方式。此属性是可选的。如果未指定方式,则此参数缺省为 in。
nullToken
指定将被视为数据库空值的区分大小写字符串值。如果 value 属性包含此字符串,则将在数据库中将此参数设置为空。

此属性是可选的。如果省略它,则使用包含此属性的 x:selectx:modifyx:procedureCall 操作上的同一属性的值。如果在两个位置中都省略此属性,则缺省值为 &empty。&empty 是一个特殊值,类似于 HTML 字符实体,在此属性中,将其识别为代表空字符串。有关空值表示法的更多信息,请参阅空值

示例

请参阅 <x:procedureCall> 中的示例


反馈