<x:parameter>

x:parameter 요소는 기본적으로 SQL 문에서 매개변수의 값을 제공하기 위해 사용되지만, 매개변수에 대한 추가 정보도 제공합니다. 이 요소는 x:select, x:modifyx:procedureCall 조치에서 사용됩니다. 매개변수마다 하나의 요소를 사용하십시오. 어떤 순서로도 표시될 수 있습니다.

SQL 문에 있는 매개변수에 대한 정보는 두 소스의 조합(x:sql 요소 및 x:parameter 요소)에서 제공됩니다.

SQL 문 자체의 매개변수와 x:parameter 요소 사이에는 일 대 일 대응이 있어야 합니다. names 또는 positions 매개변수를 사용하여 대응을 설정할 수 있습니다. 두 소스 사이에 서로 맞지 않는 정보가 있으면 오류 플래그가 표시됩니다.

구문

<x:parameter	parmName = "name"
			position = "number"
			value = "value"
			type = "sqlType"
			mode = "in|out|inout"
			nullToken = "string" />

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

parmName
매개변수의 이름을 지정합니다. 값은 대소문자를 구분합니다. SQL 문에서 매개변수 이름을 사용할 경우, 이 속성을 사용하여 대응을 설정해야 합니다. 그렇지 않으면, 이 속성을 생략하고 대신 position 속성을 지정해야 합니다.
position
SQL 문에서 매개변수 위치를 지정합니다. (x:parameter 요소는 어떤 순서로도 표시할 수 있습니다.) 첫 번째 매개변수의 위치는 1입니다. SQL 문에서 매개변수 이름을 사용할 경우 이 속성을 사용하여 대응을 설정해야 합니다. 그렇지 않으면, 이 속성을 생략하고 대신 name 속성을 지정해야 합니다.
value
매개변수의 값을 지정합니다. 제공하는 값은 Java™ 오브젝트로 평가되는 표현식이 될 수 있습니다. 이 값을 생략할 경우 SQL 문을 실행하기 전에 이 매개변수에 대해 어떤 값도 데이터베이스에 전달되지 않습니다. 매개변수 모드가 out일 경우에는 속성이 무시됩니다.

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

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

type
매개변수의 SQL 유형을 지정합니다. 유효한 값은 JDBC 클래스 java.sql.Types에 정의된 상수의 이름(예: VARCHAR)입니다.
mode
매개변수의 모드를 지정합니다. 이 속성은 선택사항입니다. 모드를 지정하지 않으면 기본값은 in입니다.
nullToken
데이터베이스 널 값으로 처리할 대소문자 구분 문자열 값을 지정합니다. value 속성에 이 문자열이 있으면, 열은 데이터베이스에서 널(null)로 설정됩니다.

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

예제

<x:procedureCall>의 예제를 참조하십시오.

사용 조건 | 피드백
(C) Copyright IBM Corporation 2000, 2005. All Rights Reserved.