作為 Statement 的子類,PreparedStatement 繼承了 Statement 的所有功能。另外它還添加了一整套方法,用于設定發送給資料庫以取代 IN 參數占位符的值。同時,三種方法 execute、 executeQuery 和 executeUpdate 已被更改以使之不再需要參數。這些方法的 Statement 形式(接受 SQL 語句參數的形式)不應該用于 PreparedStatement 對象。
以下的代碼段(其中 con 是 Connection 對象)建立包含帶兩個 IN 參數占位符的 SQL 語句的 PreparedStatement 對象:
PreparedStatement pstmt = con.prepareStatement("UPDATE table4 SET m = ? WHERE x = ?");
pstmt 對象包含語句 "UPDATE table4 SET m = ? WHERE x = ?",它已發送給DBMS,并為執行作好了準備。
在執行 PreparedStatement 對象之前,必須設定每個 ? 參數的值。這可通過調用 setXXX 方法來完成,其中 XXX 是與該參數相應的類型。例如,如果參數具有Java 類型 long,則使用的方法就是 setLong。setXXX 方法的第一個參數是要設定的參數的序數位置,第二個參數是設定給該參數的值。例如,以下代碼将第一個參數設為 123456789,第二個參數設為 100000000:
pstmt.setLong(1, 123456789);
pstmt.setLong(2, 100000000);
一旦設定了給定語句的參數值,就可用它多次執行該語句,直到調用clearParameters 方法清除它為止。在連接配接的預設模式下(啟用自動送出),當語句完成時将自動送出或還原該語句。