<x:setColumn>

x:setColumn 조치는 열 값을 설정하기 위해 사용됩니다. Select에서 특정 행의 특정 열을 명시적으로 지정하거나, 사용자가 아래의 index, row, name 속성에 설명된 대로 이러한 선택사항을 기본값으로 만들 수 있습니다. 이는 특히 x:repeat 본문에 조치가 발생할 경우에 유용합니다.

값을 현재 행이 아닌 다른 행에서 설정할 경우, 현재 행에서의 변경사항이 먼저 데이터베이스에 적용됩니다. 값을 설정하는 행은 조치 끝에서 현재 행이 됩니다.

열 값은 x:column 조치를 사용하여 설정할 수도 있지만 x:column 조치는 x:updateRow 또는 x:insertRow의 본문 내에서만 발생할 수 있는 반면 x:setColumn 조치는 대상 DBSelect Bean 범위 내의 어떤 곳에서나 사용할 수 있습니다.

구문

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

x:setColumn 요소에는 다음과 같은 속성이 있습니다.

name
열 값을 설정할 결과 세트를 포함하는 DBSelect Bean의 이름을 지정합니다. 값은 대소문자가 구분되며 범위 내에 있는 Select 조치와 일치해야 합니다. 이 속성은 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 변수 값이 사용되고, 없으면 결과 세트의 현재 행 색인이 사용됩니다.
value
열의 값입니다. 제공하는 값은 Java™ 오브젝트로 평가되는 표현식이 될 수 있습니다. 이 속성은 필수입니다.

제공하는 값이 문자열이면, 이 조치는 이 문자열을 해당 열에 적절한 Java 오브젝트 유형으로 변환합니다. 대소문자는 입력한 대로 보존됩니다. 값이 다른 종류의 오브젝트인 경우, 열에 올바른 유형이어야 하며, 그렇지 않으면 오류가 발생합니다.

이 속성을 설정하는 데 사용할 수 있는 두 가지의 특수 값을 제공합니다. 빈 문자열을 표시하는 &empty와 널(null) 오브젝트 참조를 표시하는 &null입니다. value=""를 지정하는 것은 value="<%=2.23 nullObj %>를 지정하는 것과 같습니다. 여기서, nullObj는 널(null) 오브젝트 참조입니다.

nullToken
데이터베이스 널 값으로 처리할 대소문자 구분 문자열 값을 지정합니다. value 속성에 이 문자열이 있으면, 열은 데이터베이스에서 널(null)로 설정됩니다.

이 속성은 선택사항입니다. 이 속성을 생략하면 연관된 x:select 조치에서 동일 속성의 값이 사용됩니다. 두 위치 모두에서 속성을 생략하면 기본값 &empty가 사용됩니다. (&empty는 HTML 문자 엔티티와 유사한 특수 값으로, 이 속성에서 빈 문자열을 표시하는 것으로 인식됩니다.) 널 값 표시에 대한 자세한 정보는 널 값을 참조하십시오.

주: 이 조치는 데이터베이스와의 연결을 설정하지 않습니다. 나중에 x:updateRow를 수행하여 연결하고 갱신한 후 연결을 끊어야 합니다. 갱신을 수행할 때까지 이 행의 밖으로 이동할 수 없습니다.
사용 조건 | 피드백
(C) Copyright IBM Corporation 2000, 2005. All Rights Reserved.