<x:column>

x:column アクションは、更新または挿入のために桁が設定される値を指定するために使用されるものです。 x:setColumn アクションを使用して桁値を設定することもできます。しかし、 そのようなアクションはそのターゲット DBSelect Bean のスコープ内であればどこでも使用することができますが、 このアクションが起こるのは x:updateRow または x:insertRow の本体内に限られます。

構文

<x:column	 	colName = "name"
			index = "number"
			value = "value"
			nullToken = "string" />

x:column 要素には以下の属性があります。

colName
桁の名前。 この値には大/小文字の区別があります。この属性または index 属性のいずれかを指定する必要があります。 両方を指定しないようにしてください。
index
桁の索引。1 桁目は索引の 1 です。この属性または colName 属性のいずれかを指定する必要があります。 両方を指定しないようにしてください。
value
桁の値。 指定する値は、Java™ オブジェクトを評価する式とすることができます。この属性は必須です。

指定する値がストリングの場合、 このアクションではこの値が桁に合う Java オブジェクト・タイプに変換されます。大/小文字の区別は入力した通りに保存されます。この値が他のタイプのオブジェクトである場合は、 このオブジェクトは桁に合う正しいタイプであることが必要です。正しくなければ、エラーが発生します。

この属性の設定に使用できるように、2 つの特殊値 &empty と &null が用意されています。 前者は空ストリングを、後者は NULL オブジェクト参照を表します。 value="" を指定することは value="<%=2.23 nullObj %> を指定することと同じです。 ここで、nullObj は NULL オブジェクト参照です。

nullToken
大/小文字が区別されるストリング値を指定します。この値はデータベースの NULL 値として扱われます。 value 属性にこのストリングが含まれている場合は、この桁はデータベースの中で NULL 設定されます。

この属性はオプションです。この属性を省略した場合は、 関連する x:select アクション上の同じ属性の値が使用されます。両方の場所でこの属性が省略された場合のデフォルトは &empty です。 (&empty は HTML 文字エンティティーに類似した特殊値であり、この属性では空ストリングを表すものとして認識されます。) NULL 値の表記の詳細については、『NULL 値』を参照してください。

<x:updateRow> の中の例を参照してください。


フィードバック