<x:modify>

x:modify 조치는 관계형 데이터베이스에서 삽입, 갱신 또는 삭제 명령문을 실행하기 위해 사용됩니다. (다른 SQL 문도 실행할 수 있지만 SQL 문이 결과 세트를 리턴할 경우 액세스할 수 없습니다.)

이 조치를 사용하면 id 속성에 이름을 지정한 변수를 사용하여 액세스할 수 있는 DBModify Bean이 작성됩니다.

DBModify Bean의 기본 기능을 사용할 수 있도록 JSP 조치가 제공됩니다. SQL 문에 매개변수가 있으면 x:getParameterx:parameter 조치를 사용하여 액세스할 수 있습니다.

DBModify Bean의 모든 메소드도 scriptlet을 사용하여 실행할 수 있고 해당되는 모든 특성은 표준 jsp:getPropertyjsp:setProperty 조치를 사용하여 액세스할 수 있습니다.

구문

<x:modify 	id = "name"
		scope = "page|request"	
		connectionSpec = "connectionSpec_id"
		connectionSpecRef = "connectionSpecRef"	
		timeOut = "seconds"
		nullToken = "string"
		trace = "true|false" >
 <x:sql>
	</x:sql>
	<x:parameter	
		parmName = "name" 
		position = "number" 
		type = "sqltype"
		mode = "in|out|inout" 
		value = "parmValue" />
	
</x:modify>

x:modify 조치에는 다음과 같은 속성이 있습니다.

id
페이지 이름 공간에서 DBModify Bean을 식별하기 위해 사용되는 이름으로, 해당되는 스크립팅 변수 이름이기도 합니다. 지정된 이름은 대소문자가 구분되며 현재 스크립팅 언어 변수 이름 지정 규칙을 준수해야 합니다.

DBModify Bean을 참조하는 한 가지 이유는 jsp:getProperty 조치를 사용하여 updateCount 특성에서 갱신 횟수를 확보하기 위해서입니다.

scope
오브젝트가 정의되는 범위를 지정합니다. 기본값은 page입니다.
connectionSpec
x:dataSourceSpec 또는 x:driverManagerSpec 조치의 ID를 지정합니다. 값은 대소문자가 구분되며 범위 내에 있는 connectionSpec 조치와 일치해야 합니다.

참조된 조치는 데이터베이스와의 연결을 작성하는 데 필요한 정보를 제공합니다. x:batch 조치에서 식별된 connectionSpec 조치를 사용하는, x:batch 조치 본문 내에서 조치가 발생할 경우 이 속성을 생략하십시오. 두 위치 모두에 지정했는데 값이 일치하지 않으면 오류 플래그가 표시됩니다.

connectionSpecRef
연결을 작성하는 데 필요한 정보를 확보하기 위해 사용할 DBConnectionSpec 오브젝트에 대한 참조를 지정합니다.

connectionSpec 또는 connectionSpecRef 중 하나를 지정할 수 있으며 둘 다 지정할 수는 없습니다.

timeOut
명령문을 실행할 수 있는 최대 시간(초)을 지정합니다. 기본값은 0이며 이는 최대값이 없음을 의미합니다.
nullToken
데이터베이스 널 값을 표시하기 위해 사용할 대소문자 구분 문자열 값을 지정합니다. 이 속성은 선택사항입니다. 이는 Modify에서 매개변수 값을 가져오거나 설정하는 조치의 동일 속성에 대해 기본값으로 사용됩니다. 두 위치 모두에서 속성을 생략하면 기본값 &empty가 사용됩니다. (&empty는 HTML 문자 엔티티와 유사한 특수 값으로, 이 속성에서 빈 문자열을 표시하는 것으로 인식됩니다.) 널 값 표시에 대한 자세한 정보는 널 값을 참조하십시오.
trace
데이터베이스 조치 추적의 사용 여부를 지정합니다. 기본값은 False입니다.

x:modify 조치 본문에는 다음과 같은 태그가 올 수 있습니다.

<x:sql>
실행할 SQL 문을 지정합니다.
<x:parameter>
SQL 문에서 매개변수에 대한 값 및 메타데이터를 지정합니다. SQL 문에서 x:parameter 태그 및 매개변수 사이에는 일 대 일 대응이 있어야 합니다.
사용 조건 | 피드백
(C) Copyright IBM Corporation 2000, 2005. All Rights Reserved.