x:parameter 元素主要用來在 SQL 陳述式中提供參數值,但它也提供參數的其他相關資訊。這個元素用在 x:select、x:modify 和 x: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 元素有下列屬性:
如果您提供的值是空值,這個動作會將它轉換成參數的適當 Java 物件類型。輸入的大小寫會保留下來。如果值是任何其他種類的物件,它必須是該參數的正確類型,否則會發生錯誤。
我們提供了兩個特殊值,您可以利用它來設定這個屬性:&empty 和 &null,它們分別代表空字串和空值物件參照。 指定 value="" 相當於指定 value="<%=2.23 nullObj %>,其中 nullObj 是空值物件參照。
這個屬性是選用的。 如果您忽略它的話,就會使用含有這個屬性的 x:select、x:modify 或 x:procedureCall 動作之相同屬性的值。如果兩個位置都略過這個屬性,預設值就是 &empty(&empty 是一個類似於 HTML 字元實體的特殊值,在這個屬性中,被識別為代表空字串。) 請參閱空值,以取得空值表示法的詳細資料。
請參閱 <x:procedureCall> 中的範例。