x:modify 動作用來在關聯式資料庫中執行 insert、update 或 delete 陳述式。(您也可以執行其他 SQL 陳述式,但如果它們傳回結果集的話,您就無法存取它。)
使用這個動作會建立一個 DBModify Bean,您可以利用 id 屬性指定其名稱的變數來存取這個 Bean。
JSP 動作可利用 DBModify Bean 的基本功能。如果 SQL 陳述式有參數的話,您可以利用 x:getParameter 和 x:parameter 動作來存取它們。
DBModify Bean 的所有方法都可以利用 Scriptlet 來執行,且它的所有內容都可以利用標準 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 動作有下列屬性:
參照 DBModify Bean 的一個原因,是利用 jsp:getProperty 動作來取得其 updateCount 內容的更新計數。
所參照的動作會提供建立資料庫連線所需要的資訊。 如果動作是發生在 x:batch 動作的主體內,請略過這個屬性,這時會使用 x:batch 動作中所識別的 connectionSpec 動作。如果您在兩個位置中指定它,且其值不符,就會出現錯誤旗標。
您可以指定 connectionSpec 或 connectionSpecRef,但不能同時指定這兩者。
x:modify 動作的主體中可以有下列標示: