<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 陳述式中沒有使用參數名稱,您必須利用這個屬性來建立對應關係。 否則,您必須省略這個屬性,改指定 name 屬性。
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> 中的範例。

讀者意見
(C) Copyright IBM Corporation 2000, 2005. All Rights Reserved.