構文
<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 値』を参照してください。