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입니다.
이 속성은 선택사항입니다. over="columns"가 지정된 x:repeat 본문 내에서
조치가 발생할 경우, 속성 기본값은 x:repeat의 index 변수 값입니다.
그렇지 않으면, 이 속성이나 colName 속성으로 열을
식별해야 합니다. 두 속성 모두를 명시적으로 지정하면 오류가 발생합니다.
- row
- 열 값을 확보할 행의 번호를 지정합니다. 첫 번째 행의 번호가 1입니다.
이 속성은 선택사항입니다. 이 속성을 지정하지 않을 경우, 기본값은
over="rows"가 지정된 x:repeat 본문 내에 조치가 있는지 여부에 따라
다릅니다. 안에 있으면 그 x:repeat의 index 변수 값이 사용되고,
없으면 결과 세트의 현재 행 색인이 사용됩니다.
- nullToken
- JSP 출력에서 데이터베이스 널 값을 표시하기 위해 사용할
대소문자 구분 문자열 값을 지정합니다.
이 속성은
선택사항입니다. 이 속성을 생략하면
연관된 x:select 또는 x:procedureCall 조치에서 동일 속성의 값이 사용됩니다.
두 곳에서 모두 속성을 생략하면, 기본값은 &empty입니다. (&empty는
HTML 문자 엔티티와 유사한 특수 값으로, 이 속성에서 빈 문자열을 표시하는 것으로
인식됩니다.) 널 값 표시에 대한 자세한 정보는 널 값을
참조하십시오.