x:parameter 요소는 기본적으로 SQL 문에서 매개변수의 값을 제공하기 위해 사용되지만, 매개변수에 대한 추가 정보도 제공합니다. 이 요소는 x:select, x:modify 및 x: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 요소에는 다음과 같은 속성이 있습니다.
제공하는 값이 문자열이면, 이 조치는 이 문자열을 매개변수에 적절한 Java 오브젝트 유형으로 변환합니다. 대소문자는 입력한 대로 보존됩니다. 값이 다른 종류의 오브젝트인 경우, 매개변수에 올바른 유형이어야 하며, 그렇지 않으면 오류가 발생합니다.
이 속성을 설정하는 데 사용할 수 있는 두 가지의 특수 값을 제공합니다. 빈 문자열을 표시하는 &empty와 널(null) 오브젝트 참조를 표시하는 &null입니다. value=""를 지정하는 것은 value="<%=2.23 nullObj %>를 지정하는 것과 같습니다. 여기서, nullObj는 널(null) 오브젝트 참조입니다.
이 속성은 선택사항입니다. 이 속성을 생략하면 이를 포함하는 x:select, x:modify 또는 x:procedureCall 조치에서 동일 속성의 값이 사용됩니다. 두 곳에서 모두 속성을 생략하면, 기본값은 &empty입니다. (&empty는 HTML 문자 엔티티와 유사한 특수 값으로, 이 속성에서 빈 문자열을 표시하는 것으로 인식됩니다.) 널 값 표시에 대한 자세한 정보는 널 값을 참조하십시오.
<x:procedureCall>의 예제를 참조하십시오.