<x:modify>

x:modify アクションは、リレーショナル・データベースの中の挿入、更新、 または削除ステートメントを実行するために使用されるものです。 (その他の SQL ステートメントも実行することができますが、 結果セットが戻された場合はそのデータベースにアクセスすることはできません。)

このアクションを使用して DBModify Bean を作成します。 この Bean には、名前が id 属性の中に指定されている変数を使用してアクセスすることができます。

JSP アクションは、DBModify Bean の基本関数を利用するために提供されているものです。 SQL ステートメントにパラメーターがある場合は、x:getParameter および x:parameter アクションを使用してパラメーターにアクセスすることができます。

DBModify Bean のメソッドは全部、スクリプトレットを使用して実行することもでき、 そのプロパティーの全部に標準の jsp:getProperty および jsp: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 を参照する 1 つの理由は、jsp:getProperty アクションを使用してその updateCount プロパティーから更新カウントを得るためです。

scope
スコープであり、この範囲内でオブジェクトが定義されます。デフォルト値は page です。
connectionSpec
x:dataSourceSpec または x:driverManagerSpec アクションの ID。 値には大/小文字の区別があり、値はスコープ内にある connectionSpec アクションと一致させる必要があります。

参照アクションにより、データベースへの接続に必要な情報が提供されます。 このアクションが x:batch アクションの本体内部で発生する場合は、この属性を省略してください。 その場合は x:batch アクションの中で識別された connectionSpec アクションが使用されます。 この属性を両方の場所で指定し、しかも値が一致していない場合、この属性にはエラーのフラグが付けられます。

connectionSpecRef
接続に必要な情報を得るために使用される DBConnectionSpec オブジェクトへの参照。

connectionSpec または connectionSpecRef のいずれかを指定することができますが、両方を指定することはできません。

timeOut
実行するステートメントに許容される最大秒数。デフォルト値は 0 です。この値は最大秒数を指定しないことを意味します。
nullToken
大/小文字が区別されるストリング値を指定します。この値はデータベースの NULL 値を表すために使用されます。 この属性はオプションです。この属性は、この Modify 上のパラメーター値の取得と設定を行う任意のアクション上の同じ属性のデフォルト値として使用されます。 両方の場所でこの属性が省略された場合のデフォルトは &empty です。 (&empty は HTML 文字エンティティーに類似した特殊値であり、この属性では空ストリングを表すものとして認識されます。) NULL 値の表記の詳細については、『NULL 値』を参照してください。
trace
データベース・アクションのトレースが行えるようにするかどうかを指定します。デフォルト値は False です。

x:modify アクションは、その本体内に以下のタグをもつことができます。

<x:sql>
実行する SQL ステートメントを指定します。
<x:parameter>
SQL ステートメントの中のパラメーターに値とメタデータを指定します。 x:parameter タグと SQL ステートメントの中のパラメーターとの間には 1 対 1 の対応が必要です。

フィードバック