<x:getColumn>

x:getColumn アクションは、桁の値を得るために使用されるものです。 どの桁を、どの行の、どの Select または ProcedureCall で選択するかについて明示して指定することができ、以下に述べるように属性 index、row、および name の中で上記の選択項目をデフォルトにすることができます。 こうしたことが特に有用となるのは、アクションが x:repeat の本体の内部で起こる場合です。

構文

<x:getColumn 	name = "target bean name"
			colName = "name"
			index = "number"
			row = "rowNumber"	
			nullToken = "string" />

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

name
桁値を得る元となる結果セットを含む DBSelect または DBProcedureCall Bean の名前。 値には大/小文字の区別があり、 この値はスコープ内にある Select または ProcedureCall 変数に一致させる必要があります。 この name 属性が指定されている x:repeat の本体の内側にアクションがない (直接にせよ間接にせよ) 場合は、この属性が必須となります。 このような場合、この name 属性は、デフォルトにより最も近くの収容 x:repeat の中に指定されているものと同じ値に設定されます。
colName
桁の名前。 この値には大/小文字の区別があります。この属性はオプションです。この属性にはデフォルト値はありません。over="columns" が指定されている x:repeat の本体の内部でアクションが起こらない場合は、 この属性または index 属性のいずれかを使用して桁を識別する必要があります。 両方を明示して指定するとエラーになります。
index
桁の索引。1 桁目は索引の 1 です。この属性はオプションです。 over="columns" が指定されている x:repeat の本体の内部でアクションが起こる場合は、 この属性のデフォルトは x:repeat の索引変数の値になります。 アクションが起こらない場合は、この属性または colName 属性のいずれかを使用して桁を識別する必要があります。両方を明示して指定するとエラーになります。
row
桁値を得る行の番号。最初の行の番号は 1 です。この属性はオプションです。 指定しなければ、デフォルト値は、 このアクションが over="rows" の指定されている x:repeat の本体の内部にあるかどうかに応じて決まります。 この場合、その x:repeat の索引変数の値が使用されます。 指定している場合は、結果セットの現在行の索引が使用されます。
nullToken
大/小文字が区別されるストリング値を指定します。この値は、JSP 出力の中のデータベースの NULL 値を表すために使用されます。

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


フィードバック