JDBC系列教程
JDBC系列教程（一）---連接
2.1 概述
Connection 對象代表與數(shù)據(jù)庫的連接。連接過程包括所執(zhí)行的 SQL 語句和在該連接上所返回的結果。一個應用程序可與單個數(shù)據(jù)庫有一個或多個連接，或者可與許多數(shù)據(jù)庫有連接。
2.1.1 打開連接
與數(shù)據(jù)庫建立連接的標準方法是調用 DriverManager.getConnection 方法。該方法接受含有某個 URL 的字符串。DriverManager 類（即所謂的 JDBC 管理層）將嘗試找到可與那個 URL 所代表的數(shù)據(jù)庫進行連接的驅動程序。DriverManager 類存有已注冊的 Driver 類的清單。當調用方法 getConnection 時，它將檢查清單中的每個驅動程序，直到找到可與 URL 中指定的數(shù)據(jù)庫進行連接的驅動程序為止。Driver 的方法 connect 使用這個 URL 來建立實際的連接。
用戶可繞過 JDBC 管理層直接調用 Driver 方法。這在以下特殊情況下將很有用：當兩個驅動器可同時連接到數(shù)據(jù)庫中，而用戶需要明確地選用其中特定的驅動器。但一般情況下，讓 DriverManager 類處理打開連接這種事將更為簡單。
下述代碼顯示如何打開一個與位于 URL "jdbc:odbc:wombat" 的數(shù)據(jù)庫的連接。所用的用戶標識符為 "oboy" ，口令為 "12Java"：
String url = "jdbc:odbc:wombat";
Connection con = DriverManager.getConnection(url, "oboy", "12Java");
2.1.2 一般用法的 URL
由于 URL 常引起混淆，我們將先對一般 URL 作簡單說明，然后再討論 JDBC URL。
URL（統(tǒng)一資源定位符）提供在 Internet 上定位資源所需的信息?？蓪⑺胂鬄橐粋€地址。
URL 的第一部份指定了訪問信息所用的協(xié)議，后面總是跟著冒號。常用的協(xié)議有 "ftp"（代表“文件傳輸協(xié)議”）和 "http" （代表“超文本傳輸協(xié)議”）。如果協(xié)議是 "file"，表示資源是在某個本地文件系統(tǒng)上而非在 Internet 上（下例用于表示我們所描述的部分；它并非 URL 的組成部分）。
ftp://javasoft.com/docs/JDK-1_apidocs.zip
http://java.sun.com/products/jdk/CurrentRelease
file:/home/haroldw/docs/books/tutorial/summary.html
URL 的其余部份（冒號后面的）給出了數(shù)據(jù)資源所處位置的有關信息。如果協(xié)議是 file，則 URL 的其余部份是文件的路徑。對于 ftp 和 http 協(xié)議，URL 的其余部份標識了主機并可選地給出某個更詳盡的地址路徑。例如，以下是 JavaSoft 主頁的 URL。該 URL 只標識了主機：
http://java.sun.com
從該主頁開始瀏覽，就可以進到許多其它的網(wǎng)頁中，其中之一就是 JDBC 主頁。JDBC 主頁的 URL 更為具體，它看起來類似：
http://java.sun.com/products/jdbc
2.1.3 JDBC URL
JDBC URL 提供了一種標識數(shù)據(jù)庫的方法，可以使相應的驅動程序能識別該數(shù)據(jù)庫并與之建立連接。實際上，驅動程序編程員將決定用什么 JDBC URL 來標識特定的驅動程序。用戶不必關心如何來形成 JDBC URL；他們只須使用與所用的驅動程序一起提供的 URL 即可。JDBC 的作用是提供某些約定，驅動程序編程員在構造他們的 JDBC URL 時應該遵循這些約定。
由于 JDBC URL 要與各種不同的驅動程序一起使用，因此這些約定應非常靈活。首先，它們應允許不同的驅動程序使用不同的方案來命名數(shù)據(jù)庫。例如， odbc 子協(xié)議允許（但并不是要求） URL 含有屬性值。
第二，JDBC URL 應允許驅動程序編程員將一切所需的信息編入其中。這樣就可以讓要與給定數(shù)據(jù)庫對話的 applet 打開數(shù)據(jù)庫連接，而無須要求用戶去做任何系統(tǒng)管理工作。
第三， JDBC URL 應允許某種程度的間接性。也就是說，JDBC URL 可指向邏輯主機或數(shù)據(jù)庫名，而這種邏輯主機或數(shù)據(jù)庫名將由網(wǎng)絡命名系統(tǒng)動態(tài)地轉換為實際的名稱。這可以使系統(tǒng)管理員不必將特定主機聲明為 JDBC 名稱的一部份。網(wǎng)絡命名服務（例如 DNS、 NIS 和 DCE ）有多種,而對于使用哪種命名服務并無限制。
JDBC URL 的標準語法如下所示。它由三部分組成，各部分間用冒號分隔：
jdbc:< 子協(xié)議 >:< 子名稱 >
JDBC URL 的三個部分可分解如下：
jdbc ─ 協(xié)議。JDBC URL 中的協(xié)議總是 jdbc。
<子協(xié)議> ─ 驅動程序名或數(shù)據(jù)庫連接機制（這種機制可由一個或多個驅動程序支持）的名稱。子協(xié)議名的典型示例是 "odbc"，該名稱是為用于指定 ODBC 風格的數(shù)據(jù)資源名稱的 URL 專門保留的。例如，為了通過 JDBC-ODBC 橋來訪問某個數(shù)據(jù)庫，可以用如下所示的 URL：
jdbc:odbc:fred
本例中，子協(xié)議為 "odbc"，子名稱 "fred" 是本地
ODBC 數(shù)據(jù)資源。
如果要用網(wǎng)絡命名服務（這樣 JDBC URL 中的數(shù)據(jù)庫名稱不必是實際名稱），則命名服務可以作為子協(xié)議。例如，可用如下所示的 URL ：
jdbc:dcenaming:accounts-payable
本例中，該 URL 指定了本地 DCE 命名服務應該將
數(shù)據(jù)庫名稱 "accounts-payable" 解析為更為具體的
可用于連接真實數(shù)據(jù)庫的名稱。
<子名稱> ─ 一種標識數(shù)據(jù)庫的方法。子名稱可以依不同的子協(xié)議而變化。它還可以有子名稱的子名稱（含有驅動程序編程員所選的任何內部語法）。使用子名稱的目的是為定位數(shù)據(jù)庫提供足夠的信息。前例中，因為 ODBC 將提供其余部份的信息，因此用 "fred" 就已足夠。然而，位于遠程服務器上的數(shù)據(jù)庫需要更多的信息。例如，如果數(shù)據(jù)庫是通過 Internet 來訪問的，則在 JDBC URL 中應將網(wǎng)絡地址作為子名稱的一部份包括進去，且必須遵循如下所示的標準 URL 命名約定：
//主機名:端口/子協(xié)議
假設 "dbnet" 是個用于將某個主機連接到 Internet 上的協(xié)議，則 JDBC URL 類似：
jdbc:dbnet://wombat:356/fred
2.1.4 "odbc" 子協(xié)議
子協(xié)議 odbc 是一種特殊情況。它是為用于指定 ODBC 風格的數(shù)據(jù)資源名稱的 URL 而保留的，并具有下列特性：允許在子名稱（數(shù)據(jù)資源名稱）后面指定任意多個屬性值。odbc 子協(xié)議的完整語法為：
jdbc:odbc:< 數(shù)據(jù)資源名稱 >[;< 屬性名 >=< 屬性值 >]*
因此，以下都是合法的 jdbc:odbc 名稱：
jdbc:odbc:qeor7
jdbc:odbc:wombat
jdbc:odbc:wombat;CacheSize=20;ExtensionCase=LOWER
jdbc:odbc:qeora;UID=kgh;PWD=fooey
2.1.5 注冊子協(xié)議
驅動程序編程員可保留某個名稱以將之用作 JDBC URL 的子協(xié)議名。當 DriverManager 類將此名稱加到已注冊的驅動程序清單中時，為之保留該名稱的驅動程序應能識別該名稱并與它所標識的數(shù)據(jù)庫建立連接。例如，odbc 是為 JDBC- ODBC 橋而保留的。示例之二，假設有個 Miracle 公司，它可能會將 "miracle" 注冊為連接到其 Miracle DBMS 上的 JDBC 驅動程序的子協(xié)議，從而使其他人都無法使用這個名稱。
JavaSoft 目前作為非正式代理負責注冊 JDBC 子協(xié)議名稱。要注冊某個子協(xié)議名稱，請發(fā)送電子郵件到下述地址：
jdbc@wombat.eng.sun.com
2.1.6 發(fā)送 SQL 語句
連接一旦建立，就可用來向它所涉及的數(shù)據(jù)庫傳送 SQL 語句。JDBC 對可被發(fā)送的 SQL 語句類型不加任何限制。這就提供了很大的靈活性，即允許使用特定的數(shù)據(jù)庫語句或甚至于非 SQL 語句。然而，它要求用戶自己負責確保所涉及的數(shù)據(jù)庫可以處理所發(fā)送的 SQL 語句，否則將自食其果。例如，如果某個應用程序試圖向不支持儲存程序的 DBMS 發(fā)送儲存程序調用，就會失敗并將拋出異常。JDBC 要求驅動程序應至少能提供 ANSI SQL-2 Entry Level 功能才可算是符合 JDBC 標準TM 的。這意味著用戶至少可信賴這一標準級別的功能。
JDBC 提供了三個類，用于向數(shù)據(jù)庫發(fā)送 SQL 語句。Connection 接口中的三個方法可用于創(chuàng)建這些類的實例。下面列出這些類及其創(chuàng)建方法：
Statement ─ 由方法 createStatement 所創(chuàng)建。Statement 對象用于發(fā)送簡單的 SQL 語句?！?br />PreparedStatement ─ 由方法 prepareStatement 所創(chuàng)建。PreparedStatement 對象用于發(fā)送帶有一個或多個輸入?yún)?shù)（ IN 參數(shù)）的 SQL 語句。PreparedStatement 擁有一組方法，用于設置 IN 參數(shù)的值。執(zhí)行語句時，這些 IN 參數(shù)將被送到數(shù)據(jù)庫中。PreparedStatement 的實例擴展了 Statement ，因此它們都包括了 Statement 的方法。PreparedStatement 對象有可能比 Statement 對象的效率更高，因為它已被預編譯過并存放在那以供將來使用?！?br />CallableStatement ─ 由方法 prepareCall 所創(chuàng)建。CallableStatement 對象用于執(zhí)行 SQL 儲存程序 ─ 一組可通過名稱來調用（就象函數(shù)的調用那樣）的 SQL 語句。CallableStatement 對象從 PreparedStatement 中繼承了用于處理 IN 參數(shù)的方法，而且還增加了用于處理 OUT 參數(shù)和 INOUT 參數(shù)的方法。
以下所列提供的方法可以快速決定應用哪個 Connection 方法來創(chuàng)建不同類型的 SQL 語句：
createStatement 方法用于：
簡單的 SQL 語句（不帶參數(shù)）
prepareStatement 方法用于：
帶一個或多個 IN 參數(shù)的 SQL 語句
經(jīng)常被執(zhí)行的簡單 SQL 語句
prepareCall 方法用于：
調用已儲存過程
2.1.7 事務
事務由一個或多個這樣的語句組成：這些語句已被執(zhí)行、完成并被提交或還原。當調用方法 commit 或 rollback 時，當前事務即告就結束，另一個事務隨即開始。
缺省情況下，新連接將處于自動提交模式。也就是說，當執(zhí)行完語句后，將自動對那個語句調用 commit 方法。這種情況下，由于每個語句都是被單獨提交的，因此一個事務只由一個語句組成。如果禁用自動提交模式，事務將要等到 commit 或 rollback 方法被顯式調用時才結束，因此它將包括上一次調用 commit 或 rollback 方法以來所有執(zhí)行過的語句。對于第二種情況，事務中的所有語句將作為組來提交或還原。
方法 commit 使 SQL 語句對數(shù)據(jù)庫所做的任何更改成為永久性的，它還將釋放事務持有的全部鎖。而方法 rollback 將棄去那些更改。
有時用戶在另一個更改生效前不想讓此更改生效。這可通過禁用自動提交并將兩個更新組合在一個事務中來達到。如果兩個更新都是成功的，則調用 commit 方法，從而使兩個更新結果成為永久性的；如果其中之一或兩個更新都失敗了，則調用 rollback 方法，以將值恢復為進行更新之前的值。
大多數(shù) JDBC 驅動程序都支持事務。事實上，符合 JDBC 的驅動程序必須支持事務。DatabaseMetaData 給出的信息描述 DBMS 所提供的事務支持水平。
2.1.8 事務隔離級別
如果 DBMS 支持事務處理，它必須有某種途徑來管理兩個事務同時對一個數(shù)據(jù)庫進行操作時可能發(fā)生的沖突。用戶可指定事務隔離級別，以指明 DBMS 應該花多大精力來解決潛在沖突。例如，當事務更改了某個值而第二個事務卻在該更改被提交或還原前讀取該值時該怎么辦？ 假設第一個事務被還原后，第二個事務所讀取的更改值將是無效的，那么是否可允許這種沖突？ JDBC 用戶可用以下代碼來指示 DBMS 允許在值被提交前讀取該值（“dirty 讀取”），其中 con 是當前連接：
con.setTransactionIsolation(TRANSACTION_READ_UNCOMMITTED);
事務隔離級別越高，為避免沖突所花的精力也就越多。Connection 接口定義了五級，其中最低級別指定了根本就不支持事務，而最高級別則指定當事務在對某個數(shù)據(jù)庫進行操作時，任何其它事務不得對那個事務正在讀取的數(shù)據(jù)進行任何更改。通常，隔離級別越高，應用程序執(zhí)行的速度也就越慢（由于用于鎖定的資源耗費增加了，而用戶間的并發(fā)操作減少了）。在決定采用什么隔離級別時，開發(fā)人員必須在性能需求和數(shù)據(jù)一致性需求之間進行權衡。當然，實際所能支持的級別取決于所涉及的 DBMS 的功能。
當創(chuàng)建 Connection 對象時，其事務隔離級別取決于驅動程序，但通常是所涉及的數(shù)據(jù)庫的缺省值。用戶可通過調用 setIsolationLevel 方法來更改事務隔離級別。新的級別將在該連接過程的剩余時間內生效。要想只改變一個事務的事務隔離級別，必須在該事務開始前進行設置，并在該事務結束后進行復位。我們不提倡在事務的中途對事務隔離級別進行更改，因為這將立即觸發(fā) commit 方法的調用，使在此之前所作的任何更改變成永久性的。
--------------------------------------------------------------------------------------------------------
JDBC系列教程（二）---驅動設置
3.1 概述
DriverManager 類是 JDBC 的管理層，作用于用戶和驅動程序之間。它跟蹤可用的驅動程序，并在數(shù)據(jù)庫和相應驅動程序之間建立連接。另外，DriverManager 類也處理諸如驅動程序登錄時間限制及登錄和跟蹤消息的顯示等事務。
對于簡單的應用程序，一般程序員需要在此類中直接使用的唯一方法是 DriverManager.getConnection。正如名稱所示，該方法將建立與數(shù)據(jù)庫的連接。JDBC 允許用戶調用 DriverManager 的方法 getDriver、getDrivers 和 registerDriver 及 Driver 的方法 connect。但多數(shù)情況下，讓 DriverManager 類管理建立連接的細節(jié)為上策。
3.1.1 跟蹤可用驅動程序
DriverManager 類包含一列 Driver 類，它們已通過調用方法 DriverManager.registerDriver 對自己進行了注冊。所有 Driver 類都必須包含有一個靜態(tài)部分。它創(chuàng)建該類的實例，然后在加載該實例時 DriverManager 類進行注冊。這樣，用戶正常情況下將不會直接調用 DriverManager.registerDriver；而是在加載驅動程序時由驅動程序自動調用。加載 Driver 類，然后自動在 DriverManager 中注冊的方式有兩種：
通過調用方法 Class.forName。這將顯式地加載驅動程序類。由于這與外部設置無關，因此推薦使用這種加載驅動程序的方法。以下代碼加載類 acme.db.Driver：
Class.forName("acme.db.Driver");
如果將 acme.db.Driver 編寫為加載時創(chuàng)建實例，并調用以該實例為參數(shù)的 DriverManager.registerDriver（本該如此），則它在 DriverManager 的驅動程序列表中，并可用于創(chuàng)建連接。
通過將驅動程序添加到 java.lang.System 的屬性 jdbc.drivers 中。這是一個由 DriverManager 類加載的驅動程序類名的列表，由冒號分隔：初始化 DriverManager 類時，它搜索系統(tǒng)屬性 jdbc.drivers，如果用戶已輸入了一個或多個驅動程序，則 DriverManager 類將試圖加載它們。以下代碼說明程序員如何在 ~/.hotjava/properties 中輸入三個驅動程序類（啟動時，HotJava 將把它加載到系統(tǒng)屬性列表中）：
jdbc.drivers=foo.bah.Driver:wombat.sql.Driver:bad.test.ourDriver;
對 DriverManager 方法的第一次調用將自動加載這些驅動程序類。
注意：加載驅動程序的第二種方法需要持久的預設環(huán)境。如果對這一點不能保證，則調用方法 Class.forName 顯式地加載每個驅動程序就顯得更為安全。這也是引入特定驅動程序的方法，因為一旦 DriverManager 類被初始化，它將不再檢查 jdbc.drivers 屬性列表。
在以上兩種情況中，新加載的 Driver 類都要通過調用 DriverManager.registerDriver 類進行自我注冊。如上所述，加載類時將自動執(zhí)行這一過程。
由于安全方面的原因，JDBC 管理層將跟蹤哪個類加載器提供哪個驅動程序。這樣，當 DriverManager 類打開連接時，它僅使用本地文件系統(tǒng)或與發(fā)出連接請求的代碼相同的類加載器提供的驅動程序。
3.1.2 建立連接
加載 Driver 類并在 DriverManager 類中注冊后，它們即可用來與數(shù)據(jù)庫建立連接。當調用 DriverManager.getConnection 方法發(fā)出連接請求時，DriverManager 將檢查每個驅動程序，查看它是否可以建立連接。
有時可能有多個 JDBC 驅動程序可以與給定的 URL 連接。例如，與給定遠程數(shù)據(jù)庫連接時，可以使用 JDBC-ODBC 橋驅動程序、JDBC 到通用網(wǎng)絡協(xié)議驅動程序或數(shù)據(jù)庫廠商提供的驅動程序。在這種情況下，測試驅動程序的順序至關重要，因為 DriverManager 將使用它所找到的第一個可以成功連接到給定 URL 的驅動程序。
首先 DriverManager 試圖按注冊的順序使用每個驅動程序（jdbc.drivers 中列出的驅動程序總是先注冊）。它將跳過代碼不可信任的驅動程序，除非加載它們的源與試圖打開連接的代碼的源相同。
它通過輪流在每個驅動程序上調用方法 Driver.connect，并向它們傳遞用戶開始傳遞給方法 DriverManager.getConnection 的 URL 來對驅動程序進行測試，然后連接第一個認出該 URL 的驅動程序。
這種方法初看起來效率不高，但由于不可能同時加載數(shù)十個驅動程序，因此每次連接實際只需幾個過程調用和字符串比較。
以下代碼是通常情況下用驅動程序（例如 JDBC-ODBC 橋驅動程序）建立連接所需所有步驟的示例：
Class.forName("sun.jdbc.odbc.JdbcOdbcDriver"); //加載驅動程序
String url = "jdbc:odbc:fred";
DriverManager.getConnection(url, "userID", "passwd");
-----------------------------------------------------------------------------------------------
JDBC系列教程（三）---語句
4.1?概述?
Statement?對象用于將?SQL?語句發(fā)送到數(shù)據(jù)庫中。實際上有三種?Statement?對象，它們都作為在給定連接上執(zhí)行?SQL?語句的包容器：Statement、PreparedStatement（它從?Statement?繼承而來）和?CallableStatement（它從?PreparedStatement?繼承而來）。它們都專用于發(fā)送特定類型的?SQL?語句：?Statement?對象用于執(zhí)行不帶參數(shù)的簡單?SQL?語句；PreparedStatement?對象用于執(zhí)行帶或不帶?IN?參數(shù)的預編譯?SQL?語句；CallableStatement?對象用于執(zhí)行對數(shù)據(jù)庫已存儲過程的調用。?
Statement?接口提供了執(zhí)行語句和獲取結果的基本方法。PreparedStatement?接口添加了處理?IN?參數(shù)的方法；而?CallableStatement?添加了處理?OUT?參數(shù)的方法。?
4.1.1?創(chuàng)建?Statement?對象?
建立了到特定數(shù)據(jù)庫的連接之后，就可用該連接發(fā)送?SQL?語句。Statement?對象用?Connection?的方法?createStatement?創(chuàng)建，如下列代碼段中所示：
Connection?con?=?DriverManager.getConnection(url,?"sunny",?"");?
Statement?stmt?=?con.createStatement();?
為了執(zhí)行?Statement?對象，被發(fā)送到數(shù)據(jù)庫的?SQL?語句將被作為參數(shù)提供給?Statement?的方法：
ResultSet?rs?=?stmt.executeQuery("SELECT?a,?b,?c?FROM?Table2");?
4.1.2?使用?Statement?對象執(zhí)行語句?
Statement?接口提供了三種執(zhí)行?SQL?語句的方法：executeQuery、executeUpdate?和?execute。使用哪一個方法由?SQL?語句所產(chǎn)生的內容決定。?
方法?executeQuery?用于產(chǎn)生單個結果集的語句，例如?SELECT?語句。?
方法?executeUpdate?用于執(zhí)行?INSERT、UPDATE?或?DELETE?語句以及?SQL?DDL（數(shù)據(jù)定義語言）語句，例如?CREATE?TABLE?和?DROP?TABLE。INSERT、UPDATE?或?DELETE?語句的效果是修改表中零行或多行中的一列或多列。executeUpdate?的返回值是一個整數(shù)，指示受影響的行數(shù)（即更新計數(shù)）。對于?CREATE?TABLE?或?DROP?TABLE?等不操作行的語句，executeUpdate?的返回值總為零。?
方法?execute?用于執(zhí)行返回多個結果集、多個更新計數(shù)或二者組合的語句。因為多數(shù)程序員不會需要該高級功能，所以本概述后面將在單獨一節(jié)中對其進行介紹。?
執(zhí)行語句的所有方法都將關閉所調用的?Statement?對象的當前打開結果集（如果存在）。這意味著在重新執(zhí)行?Statement?對象之前，需要完成對當前?ResultSet?對象的處理。?
應注意，繼承了?Statement?接口中所有方法的?PreparedStatement?接口都有自己的?executeQuery、executeUpdate?和?execute?方法。Statement?對象本身不包含?SQL?語句，因而必須給?Statement.execute?方法提供?SQL?語句作為參數(shù)。PreparedStatement?對象并不將?SQL?語句作為參數(shù)提供給這些方法，因為它們已經(jīng)包含預編譯?SQL?語句。CallableStatement?對象繼承這些方法的?PreparedStatement?形式。對于這些方法的?PreparedStatement?或?CallableStatement?版本，使用查詢參數(shù)將拋出?SQLException。?
4.1.3?語句完成?
當連接處于自動提交模式時，其中所執(zhí)行的語句在完成時將自動提交或還原。語句在已執(zhí)行且所有結果返回時，即認為已完成。對于返回一個結果集的?executeQuery?方法，在檢索完?ResultSet?對象的所有行時該語句完成。對于方法?executeUpdate，當它執(zhí)行時語句即完成。但在少數(shù)調用方法?execute?的情況中，在檢索所有結果集或它生成的更新計數(shù)之后語句才完成。?
有些?DBMS?將已存儲過程中的每條語句視為獨立的語句；而另外一些則將整個過程視為一個復合語句。在啟用自動提交時，這種差別就變得非常重要，因為它影響什么時候調用?commit?方法。在前一種情況中，每條語句單獨提交；在后一種情況中，所有語句同時提交。?
4.1.4?關閉?Statement?對象?
Statement?對象將由?Java?垃圾收集程序自動關閉。而作為一種好的編程風格，應在不需要?Statement?對象時顯式地關閉它們。這將立即釋放?DBMS?資源，有助于避免潛在的內存問題。?
4.1.5?Statement?對象中的?SQL?轉義語法
Statement?可包含使用?SQL?轉義語法的?SQL?語句。轉義語法告訴驅動程序其中的代碼應該以不同方式處理。驅動程序將掃描任何轉義語法，并將它轉換成特定數(shù)據(jù)庫可理解的代碼。這使得轉義語法與?DBMS?無關，并允許程序員使用在沒有轉義語法時不可用的功能。?
轉義子句由花括號和關鍵字界定：
{keyword?.?.?.?parameters?.?.?.?}?
該關鍵字指示轉義子句的類型，如下所示。?
escape?表示?LIKE?轉義字符
字符“%”和“_”類似于?SQL?LIKE?子句中的通配符（“%”匹配零個或多個字符，而“_”則匹配一個字符）。為了正確解釋它們，應在其前面加上反斜杠（“/”），它是字符串中的特殊轉義字符。在查詢末尾包括如下語法即可指定用作轉義字符的字符：
{escape?'escape-character'}?
例如，下列查詢使用反斜杠字符作為轉義字符，查找以下劃線開頭的標識符名：
stmt.executeQuery("SELECT?name?FROM?Identifiers?
WHERE?Id?LIKE?`/_%'?{escape?`/'};?
fn?表示標量函數(shù)?
幾乎所有?DBMS?都具有標量值的數(shù)值、字符串、時間、日期、系統(tǒng)和轉換函數(shù)。要使用這些函數(shù)，可使用如下轉義語法：關鍵字?fn?后跟所需的函數(shù)名及其參數(shù)。例如，下列代碼調用函數(shù)?concat?將兩個參數(shù)連接在一起：
{fn?concat("Hot",?"Java")};?
可用下列語法獲得當前數(shù)據(jù)庫用戶名：
{fn?user()};?
標量函數(shù)可能由語法稍有不同的?DBMS?支持，而它們可能不被所有驅動程序支持。各種?DatabaseMetaData?方法將列出所支持的函數(shù)。例如，方法?getNumericFunctions?返回用逗號分隔的數(shù)值函數(shù)列表，而方法?getStringFunctions?將返回字符串函數(shù)，等等。?
驅動程序將轉義函數(shù)調用映射為相應的語法，或直接實現(xiàn)該函數(shù)。?
d、t?和?ts?表示日期和時間文字?
DBMS?用于日期、時間和時間標記文字的語法各不相同。JDBC?使用轉義子句支持這些文字的語法的?ISO?標準格式。驅動程序必須將轉義子句轉換成?DBMS?表示。?
例如，可用下列語法在?JDBC?SQL?語句中指定日期：
{d?`yyyy-mm-dd'}?
在該語法中，yyyy?為年代，mm?為月份，而?dd?則為日期。驅動程序將用等價的特定于?DBMS?的表示替換這個轉義子句。例如，如果?'28-?FEB-99'?符合基本數(shù)據(jù)庫的格式，則驅動程序將用它替換?{d?1999-02-28}。?
對于?TIME?和?TIMESTAMP?也有類似的轉義子句：
{t?`hh:mm:ss'}?
{ts?`yyyy-mm-dd?hh:mm:ss.f?.?.?.'}?
TIMESTAMP?中的小數(shù)點后的秒（.f?.?.?.）部分可忽略。?
call?或???=?call?表示已存儲過程?
如果數(shù)據(jù)庫支持已存儲過程，則可從?JDBC?中調用它們，語法為：
{call?procedure_name[(?,??,?.?.?.)]}?
或（其中過程返回結果參數(shù)）：
{??=?call?procedure_name[(?,??,?.?.?.)]}?
方括號指示其中的內容是可選的。它們不是語法的必要部分。?
輸入?yún)?shù)可以為文字或參數(shù)。有關詳細信息，參見?JDBC?指南中第?7?節(jié)，“CallableStatement”。?
可通過調用方法?DatabaseMetaData.supportsStoredProcedures?檢查數(shù)據(jù)庫是否支持已存儲過程。?
oj?表示外部連接?
外部連接的語法為
{oj?outer-join}?
其中?outer-join?形式為
table?LEFT?OUTER?JOIN?{table?/?outer-join}?ON?search-condition?
外部連接屬于高級功能。有關它們的解釋可參見?SQL?語法。JDBC?提供了三種?DatabaseMetaData?方法用于確定驅動程序支持哪些外部連接類型：supportsOuterJoins、supportsFullOuterJoins?和?supportsLimitedOuterJoins。?
方法?Statement.setEscapeProcessing?可打開或關閉轉義處理；缺省狀態(tài)為打開。當性能極為重要時，程序員可能想關閉它以減少處理時間。但通常它將出于打開狀態(tài)。應注意：?setEscapeProcessing?不適用于?PreparedStatement?對象，因為在調用該語句前它就可能已被發(fā)送到數(shù)據(jù)庫。有關預編譯的信息，參見?PreparedStatement。?
4.1.6?使用方法?execute?
execute?方法應該僅在語句能返回多個?ResultSet?對象、多個更新計數(shù)或?ResultSet?對象與更新計數(shù)的組合時使用。當執(zhí)行某個已存儲過程或動態(tài)執(zhí)行未知?SQL?字符串（即應用程序程序員在編譯時未知）時，有可能出現(xiàn)多個結果的情況，盡管這種情況很少見。例如，用戶可能執(zhí)行一個已存儲過程（使用?CallableStatement?對象?-?參見第?135?頁的?CallableStatement），并且該已存儲過程可執(zhí)行更新，然后執(zhí)行選擇，再進行更新，再進行選擇，等等。通常使用已存儲過程的人應知道它所返回的內容。?
因為方法?execute?處理非常規(guī)情況，所以獲取其結果需要一些特殊處理并不足為怪。例如，假定已知某個過程返回兩個結果集，則在使用方法?execute?執(zhí)行該過程后，必須調用方法?getResultSet?獲得第一個結果集，然后調用適當?shù)?getXXX?方法獲取其中的值。要獲得第二個結果集，需要先調用?getMoreResults?方法，然后再調用?getResultSet?方法。如果已知某個過程返回兩個更新計數(shù)，則首先調用方法?getUpdateCount，然后調用?getMoreResults，并再次調用?getUpdateCount。?
對于不知道返回內容，則情況更為復雜。如果結果是?ResultSet?對象，則方法?execute?返回?true；如果結果是?Java?int，則返回?false。如果返回?int，則意味著結果是更新計數(shù)或執(zhí)行的語句是?DDL?命令。在調用方法?execute?之后要做的第一件事情是調用?getResultSet?或?getUpdateCount。調用方法?getResultSet?可以獲得兩個或多個?ResultSet?對象中第一個對象；或調用方法?getUpdateCount?可以獲得兩個或多個更新計數(shù)中第一個更新計數(shù)的內容。?
當?SQL?語句的結果不是結果集時，則方法?getResultSet?將返回?null。這可能意味著結果是一個更新計數(shù)或沒有其它結果。在這種情況下，判斷?null?真正含義的唯一方法是調用方法?getUpdateCount，它將返回一個整數(shù)。這個整數(shù)為調用語句所影響的行數(shù)；如果為?-1?則表示結果是結果集或沒有結果。如果方法?getResultSet?已返回?null（表示結果不是?ResultSet?對象），則返回值?-1?表示沒有其它結果。也就是說，當下列條件為真時表示沒有結果（或沒有其它結果）：
((stmt.getResultSet()?==?null)?& ;& (stmt.getUpdateCount() == -1))
如果已經(jīng)調用方法 getResultSet 并處理了它返回的 ResultSet 對象，則有必要調用方法 getMoreResults 以確定是否有其它結果集或更新計數(shù)。如果 getMoreResults 返回 true，則需要再次調用 getResultSet 來檢索下一個結果集。如上所述，如果 getResultSet 返回 null，則需要調用 getUpdateCount 來檢查 null 是表示結果為更新計數(shù)還是表示沒有其它結果。
當 getMoreResults 返回 false 時，它表示該 SQL 語句返回一個更新計數(shù)或沒有其它結果。因此需要調用方法 getUpdateCount 來檢查它是哪一種情況。在這種情況下，當下列條件為真時表示沒有其它結果：
((stmt.getMoreResults() == false) && (stmt.getUpdateCount() == -1))
下面的代碼演示了一種方法用來確認已訪問調用方法 execute 所產(chǎn)生的全部結果集和更新計數(shù)：
stmt.execute(queryStringWithUnknownResults);
while (true) {
int rowCount = stmt.getUpdateCount();
if (rowCount > 0) { // 它是更新計數(shù)
System.out.println("Rows changed = " + count);
stmt.getMoreResults();
continue;
}
if (rowCount == 0) { // DDL 命令或 0 個更新
System.out.println(" No rows changed or statement was DDL
command");
stmt.getMoreResults();
continue;
}
// 執(zhí)行到這里，證明有一個結果集
// 或沒有其它結果
ResultSet rs = stmt.getResultSet;
if (rs != null) {
. . . // 使用元數(shù)據(jù)獲得關于結果集列的信息
while (rs.next()) {
. . . // 處理結果
stmt.getMoreResults();
continue;
}
break; // 沒有其它結果
-----------------------------------------------------------------------
JDBC系列教程（四）---結果設置
JDBC系列教程（四）---結果設置
www.firnow.com??? 時間 ： 2007-02-06? 作者：佚名?? 編輯：本站 點擊：?? [ 評論 ]
-
-
5.1 概述
ResultSet 包含符合 SQL 語句中條件的所有行，并且它通過一套 get 方法（這些 get 方法可以訪問當前行中的不同列）提供了對這些行中數(shù)據(jù)的訪問。ResultSet.next 方法用于移動到 ResultSet 中的下一行，使下一行成為當前行。
結果集一般是一個表，其中有查詢所返回的列標題及相應的值。例如，如果查詢?yōu)?SELECT a, b, c FROM Table1，則結果集將具有如下形式：
a b c
-------- --------- --------
12345 Cupertino CA
83472 Redmond WA
83492 Boston MA
下面的代碼段是執(zhí)行 SQL 語句的示例。該 SQL 語句將返回行集合，其中列 1 為 int，列 2 為 String，而列 3 則為字節(jié)數(shù)組：
java.sql.Statement stmt = conn.createStatement();
ResultSet r = stmt.executeQuery("SELECT a, b, c FROM Table1");
while (r.next())
{
// 打印當前行的值。
int i = r.getInt("a");
String s = r.getString("b");
float f = r.getFloat("c");
System.out.println("ROW = " + i + " " + s + " " + f);
}
5.1.1 行和光標
ResultSet 維護指向其當前數(shù)據(jù)行的光標。每調用一次 next 方法，光標向下移動一行。最初它位于第一行之前，因此第一次調用 next 將把光標置于第一行上，使它成為當前行。隨著每次調用 next 導致光標向下移動一行，按照從上至下的次序獲取 ResultSet 行。
在 ResultSet 對象或其父輩 Statement 對象關閉之前，光標一直保持有效。
在 SQL 中，結果表的光標是有名字的。如果數(shù)據(jù)庫允許定位更新或定位刪除，則需要將光標的名字作為參數(shù)提供給更新或刪除命令?？赏ㄟ^調用方法 getCursorName 獲得光標名。
注意：不是所有的 DBMS 都支持定位更新和刪除。可使用 DatabaseMetaData.supportsPositionedDelete 和 supportsPositionedUpdate 方法來檢查特定連接是否支持這些操作。當支持這些操作時，DBMS/驅動程序必須確保適當鎖定選定行，以使定位更新不會導致更新異?；蚱渌l(fā)問題。
5.1.2 列
方法 getXXX 提供了獲取當前行中某列值的途徑。在每一行內，可按任何次序獲取列值。但為了保證可移植性，應該從左至右獲取列值，并且一次性地讀取列值。
列名或列號可用于標識要從中獲取數(shù)據(jù)的列。例如，如果 ResultSet 對象 rs 的第二列名為“title”，并將值存儲為字符串，則下列任一代碼將獲取存儲在該列中的值：
String s = rs.getString("title");
String s = rs.getString(2);
注意列是從左至右編號的，并且從列 1 開始。同時，用作 getXXX 方法的輸入的列名不區(qū)分大小寫。
提供使用列名這個選項的目的是為了讓在查詢中指定列名的用戶可使用相同的名字作為 getXXX 方法的參數(shù)。另一方面，如果 select 語句未指定列名（例如在“select * from table1”中或列是導出的時），則應該使用列號。這些情況下，用戶將無法確切知道列名。
有些情況下，SQL 查詢返回的結果集中可能有多個列具有相同的名字。如果列名用作 getXXX 方法的參數(shù)，則 getXXX 將返回第一個匹配列名的值。因而，如果多個列具有相同的名字，則需要使用列索引來確保檢索了正確的列值。這時，使用列號效率要稍微高一些。
關于 ResultSet 中列的信息，可通過調用方法 ResultSet.getMetaData 得到。返回的 ResultSetMetaData 對象將給出其 ResultSet 對象各列的編號、類型和屬性。
如果列名已知，但不知其索引，則可用方法 findColumn 得到其列號。
5.1.3 數(shù)據(jù)類型和轉換
對于 getXXX 方法，JDBC 驅動程序試圖將基本數(shù)據(jù)轉換成指定 Java 類型，然后返回適合的 Java 值。例如，如果 getXXX 方法為 getString，而基本數(shù)據(jù)庫中數(shù)據(jù)類型為 VARCHAR，則 JDBC 驅動程序將把 VARCHAR 轉換成 Java String。getString 的返回值將為 Java String 對象。
下表顯示了允許用 getXXX 獲取的 JDBC 類型及推薦用它獲取的 JDBC 類型（通用 SQL 類型）。小寫的 x 表示允許 getXXX 方法獲取該數(shù)據(jù)類型；大寫的 X 表示對該數(shù)據(jù)類型推薦使用 getXXX 方法。例如，除了 getBytes 和 getBinaryStream 之外的任何 getXXX 方法都可用來獲取 LONGVARCHAR 值，但是推薦根據(jù)返回的數(shù)據(jù)類型使用 getAsciiStream 或 getUnicodeStream 方法。方法 getObject 將任何數(shù)據(jù)類型返回為 Java Object。當基本數(shù)據(jù)類型是特定于數(shù)據(jù)庫的抽象類型或當通用應用程序需要接受任何數(shù)據(jù)類型時，它是非常有用的。
可使用 ResultSet.getXXX 方法獲取常見的 JDBC 數(shù)據(jù)類型。
5.1.4 對非常大的行值使用流
ResultSet 可以獲取任意大的 LONGVARBINARY 或 LONGVARCHAR 數(shù)據(jù)。方法 getBytes 和 getString 將數(shù)據(jù)返回為大的塊（最大為 Statement.getMaxFieldSize 的返回值）。但是，以較小的固定塊獲取非常大的數(shù)據(jù)可能會更方便，而這可通過讓 ResultSet 類返回 java.io.Input 流來完成。從該流中可分塊讀取數(shù)據(jù)。注意：必須立即訪問這些流，因為在下一次對 ResultSet 調用 getXXX 時它們將自動關閉（這是由于基本實現(xiàn)對大塊數(shù)據(jù)訪問有限制）?！?/span>
JDBC API 具有三個獲取流的方法，分別具有不同的返回值：
getBinaryStream 返回只提供數(shù)據(jù)庫原字節(jié)而不進行任何轉換的流。
getAsciiStream 返回提供單字節(jié) ASCII 字符的流。
getUnicodeStream 返回提供雙字節(jié) Unicode 字符的流。
注意：它不同于 Java 流，后者返回無類型字節(jié)并可（例如）通用于 ASCII 和 Unicode 字符。
下列代碼演示了 getAsciiStream 的用法：
java.sql.Statement stmt = con.createStatement();
ResultSet r = stmt.executeQuery("SELECT x FROM Table2");
// 現(xiàn)在以 4K 塊大小獲取列 1 結果：
byte buff = new byte[4096];
while (r.next()) {
Java.io.InputStream fin = r.getAsciiStream(1);
for (;;) {
int size = fin.read(buff);
if (size == -1) { // 到達流末尾
break;
}
// 將新填充的緩沖區(qū)發(fā)送到 ASCII 輸出流：
output.write(buff, 0, size);
}
}
5.1.5 NULL 結果值
要確定給定結果值是否是 JDBC NULL，必須先讀取該列，然后使用 ResultSet.wasNull 方法檢查該次讀取是否返回 JDBC NULL。
當使用 ResultSet.getXXX 方法讀取 JDBC NULL 時，方法 wasNull 將返回下列值之一：
Java null 值：對于返回 Java 對象的 getXXX 方法（例如 getString、getBigDecimal、getBytes、getDate、getTime、getTimestamp、getAsciiStream、getUnicodeStream、getBinaryStream、getObject 等）。
零值：對于 getByte、getShort、getInt、getLong、getFloat 和 getDouble。
false 值：對于 getBoolean。
5.1.6 可選結果集或多結果集
通常使用 executeQuery（它返回單個 ResultSet）或 executeUpdate（它可用于任何數(shù)據(jù)庫修改語句，并返回更新行數(shù)）可執(zhí)行 SQL 語句。但有些情況下，應用程序在執(zhí)行語句之前不知道該語句是否返回結果集。此外，有些已存儲過程可能返回幾個不同的結果集和/或更新計數(shù)。
為了適應這些情況，JDBC 提供了一種機制，允許應用程序執(zhí)行語句，然后處理由結果集和更新計數(shù)組成的任意集合。這種機制的原理是首先調用一個完全通用的 execute 方法，然后調用另外三個方法，getResultSet、getUpdateCount 和 getMoreResults。這些方法允許應用程序一次一個地研究語句結果，并確定給定結果是 ResultSet 還是更新計數(shù)。
用戶不必關閉 ResultSet；當產(chǎn)生它的 Statement 關閉、重新執(zhí)行或用于從多結果序列中獲取下一個結果時，該 ResultSet 將被 Statement 自動關閉。
------------------------------------------------------------
JDBC系列教程（五）---準備語句
6.1 概述
該 PreparedStatement 接口繼承 Statement，并與之在兩方面有所不同：
PreparedStatement 實例包含已編譯的 SQL 語句。這就是使語句“準備好”。
包含于 PreparedStatement 對象中的 SQL 語句可具有一個或多個 IN 參數(shù)。IN 參數(shù)的值在 SQL 語句創(chuàng)建時未被指定。相反的，該語句為每個 IN 參數(shù)保留一個問號（“？”）作為占位符。每個問號的值必須在該語句執(zhí)行之前，通過適當?shù)?setXXX 方法來提供。
由于 PreparedStatement 對象已預編譯過，所以其執(zhí)行速度要快于 Statement 對象。因此，多次執(zhí)行的 SQL 語句經(jīng)常創(chuàng)建為 PreparedStatement 對象，以提高效率。
作為 Statement 的子類，PreparedStatement 繼承了 Statement 的所有功能。另外它還添加了一整套方法，用于設置發(fā)送給數(shù)據(jù)庫以取代 IN 參數(shù)占位符的值。同時，三種方法 execute、 executeQuery 和 executeUpdate 已被更改以使之不再需要參數(shù)。這些方法的 Statement 形式（接受 SQL 語句參數(shù)的形式）不應該用于 PreparedStatement 對象。
6.1.1 創(chuàng)建 PreparedStatement 對象
以下的代碼段（其中 con 是 Connection 對象）創(chuàng)建包含帶兩個 IN 參數(shù)占位符的 SQL 語句的 PreparedStatement 對象：
PreparedStatement pstmt = con.prepareStatement(
"UPDATE table4 SET m = ? WHERE x = ?");
pstmt 對象包含語句 "UPDATE table4 SET m = ? WHERE x = ?"，它已發(fā)送給 DBMS，并為執(zhí)行作好了準備。
6.1.2 傳遞 IN 參數(shù)
在執(zhí)行 PreparedStatement 對象之前，必須設置每個 ? 參數(shù)的值。這可通過調用 setXXX 方法來完成，其中 XXX 是與該參數(shù)相應的類型。例如，如果參數(shù)具有 Java 類型 long，則使用的方法就是 setLong。setXXX 方法的第一個參數(shù)是要設置的參數(shù)的序數(shù)位置，第二個參數(shù)是設置給該參數(shù)的值。例如，以下代碼將第一個參數(shù)設為 123456789，第二個參數(shù)設為 100000000：
pstmt.setLong(1, 123456789);
pstmt.setLong(2, 100000000);
一旦設置了給定語句的參數(shù)值，就可用它多次執(zhí)行該語句，直到調用 clearParameters 方法清除它為止。
在連接的缺省模式下（啟用自動提交），當語句完成時將自動提交或還原該語句。
如果基本數(shù)據(jù)庫和驅動程序在語句提交之后仍保持這些語句的打開狀態(tài)，則同一個 PreparedStatement 可執(zhí)行多次。如果這一點不成立，那么試圖通過使用 PreparedStatement 對象代替 Statement 對象來提高性能是沒有意義的。
利用 pstmt（前面創(chuàng)建的 PreparedStatement 對象），以下代碼例示了如何設置兩個參數(shù)占位符的值并執(zhí)行 pstmt 10 次。如上所述，為做到這一點，數(shù)據(jù)庫不能關閉 pstmt。在該示例中，第一個參數(shù)被設置為 "Hi"并保持為常數(shù)。在 for 循環(huán)中，每次都將第二個參數(shù)設置為不同的值：從 0 開始，到 9 結束。
pstmt.setString(1, "Hi");
for (int i = 0; i < 10; i++) {
pstmt.setInt(2, i);
int rowCount = pstmt.executeUpdate();
}
6.1.3 IN 參數(shù)中數(shù)據(jù)類型的一致性
setXXX 方法中的 XXX 是 Java 類型。它是一種隱含的 JDBC 類型（一般 SQL 類型），因為驅動程序將把 Java 類型映射為相應的 JDBC 類型（遵循該 JDBC Guide中§8.6.2 “映射 Java 和 JDBC 類型”表中所指定的映射），并將該 JDBC 類型發(fā)送給數(shù)據(jù)庫。例如，以下代碼段將 PreparedStatement 對象 pstmt 的第二個參數(shù)設置為 44，Java 類型為 short：
pstmt.setShort(2, 44);
驅動程序將 44 作為 JDBC SMALLINT 發(fā)送給數(shù)據(jù)庫，它是 Java short 類型的標準映射。
程序員的責任是確保將每個 IN 參數(shù)的 Java 類型映射為與數(shù)據(jù)庫所需的 JDBC 數(shù)據(jù)類型兼容的 JDBC 類型。不妨考慮數(shù)據(jù)庫需要 JDBC SMALLINT 的情況。如果使用方法 setByte ，則驅動程序將 JDBC TINYINT 發(fā)送給數(shù)據(jù)庫。這是可行的，因為許多數(shù)據(jù)庫可從一種相關的類型轉換為另一種類型，并且通常 TINYINT 可用于 SMALLINT 適用的任何地方。然而，對于要適用于盡可能多的數(shù)據(jù)庫的應用程序，最好使用與數(shù)據(jù)庫所需的確切的 JDBC 類型相應的 Java 類型。如果所需的 JDBC 類型是 SMALLINT，則使用 setShort 代替 setByte 將使應用程序的可移植性更好。
6.1.4 使用 setObject
程序員可使用 setObject 方法顯式地將輸入?yún)?shù)轉換為特定的 JDBC 類型。該方法可以接受第三個參數(shù)，用來指定目標 JDBC 類型。將 Java Object 發(fā)送給數(shù)據(jù)庫之前，驅動程序將把它轉換為指定的 JDBC 類型。
如果沒有指定 JDBC 類型，驅動程序就會將 Java Object 映射到其缺省的 JDBC 類型（參見第 8.6.4 節(jié)中的表格），然后將它發(fā)送到數(shù)據(jù)庫。這與常規(guī)的 setXXX 方法類似；在這兩種情況下，驅動程序在將值發(fā)送到數(shù)據(jù)庫之前，會將該值的 Java 類型映射為適當?shù)?JDBC 類型。二者的差別在于 setXXX 方法使用從 Java 類型到 JDBC 類型的標準映射（參見第 8.6.2 節(jié)中的表格），而 setObject 方法使用從 Java Object 類型到 JDBC 類型的映射（參見第 8.6.4 節(jié)中的表格）。
方法 setObject 允許接受所有 Java 對象的能力使應用程序更為通用，并可在運行時接受參數(shù)的輸入。這種情況下，應用程序在編譯時并不清楚輸入類型。通過使用 setObject，應用程序可接受所有 Java 對象類型作為輸入，并將其轉換為數(shù)據(jù)庫所需的 JDBC 類型。第 8.6.5 節(jié)中的表格顯示了 setObject 可執(zhí)行的所有可能轉換。
6.1.5 將 JDBC NULL 作為 IN 參數(shù)發(fā)送
setNull 方法允許程序員將 JDBC NULL 值作為 IN 參數(shù)發(fā)送給數(shù)據(jù)庫。但要注意，仍然必須指定參數(shù)的 JDBC 類型。
當把 Java null 值傳遞給 setXXX 方法時（如果它接受 Java 對象作為參數(shù)），也將同樣把 JDBC NULL 發(fā)送到數(shù)據(jù)庫。但僅當指定 JDBC 類型時，方法 setObject 才能接受 null 值。
6.1.6 發(fā)送大的 IN 參數(shù)
setBytes 和 setString 方法能夠發(fā)送無限量的數(shù)據(jù)。但是，有時程序員更喜歡用較小的塊傳遞大型的數(shù)據(jù)。這可通過將 IN 參數(shù)設置為 Java 輸入流來完成。當語句執(zhí)行時，JDBC 驅動程序將重復調用該輸入流，讀取其內容并將它們當作實際參數(shù)數(shù)據(jù)傳輸。
JDBC 提供了三種將 IN 參數(shù)設置為輸入流的方法：setBinaryStream 用于含有未說明字節(jié)的流， setAsciiStream 用于含有 ASCII 字符的流，而 setUnicodeStream 用于含有 Unicode 字符的流。因為必須指定流的總長度，所以這些方法所采用的參數(shù)比其它的 setXXX 方法要多一個。這很有必要，因為一些數(shù)據(jù)庫在發(fā)送數(shù)據(jù)之前需要知道其總的傳送大小。
以下代碼例示了使用流作為 IN 參數(shù)來發(fā)送文件內容：
java.io.File file = new java.io.File("/tmp/data");
int fileLength = file.length();
java.io.InputStream fin = new java.io.FileInputStream(file);
java.sql.PreparedStatement pstmt = con.prepareStatement(
"UPDATE Table5 SET stuff = ? WHERE index = 4");
pstmt.setBinaryStream (1, fin, fileLength);
pstmt.executeUpdate();
當語句執(zhí)行時，將反復調用輸入流 fin 以傳遞其數(shù)據(jù)。
------------------------------------------------------------------
JDBC系列教程（六）---可調用語句
7.1 概述
CallableStatement 對象為所有的 DBMS 提供了一種以標準形式調用已儲存過程的方法。已儲存過程儲存在數(shù)據(jù)庫中。對已儲存過程的調用是 CallableStatement 對象所含的內容。這種調用是用一種換碼語法來寫的，有兩種形式：一種形式帶結果參數(shù)，另一種形式不帶結果參數(shù)（有關換碼語法的信息，參見第 4 節(jié)“語句”）。結果參數(shù)是一種輸出 (OUT) 參數(shù)，是已儲存過程的返回值。兩種形式都可帶有數(shù)量可變的輸入（IN 參數(shù)）、輸出（OUT 參數(shù)）或輸入和輸出（INOUT 參數(shù)）的參數(shù)。問號將用作參數(shù)的占位符。
在 JDBC 中調用已儲存過程的語法如下所示。注意，方括號表示其間的內容是可選項；方括號本身并不是語法的組成部份。
{call 過程名[(?, ?, ...)]}
返回結果參數(shù)的過程的語法為：
{? = call 過程名[(?, ?, ...)]}
不帶參數(shù)的已儲存過程的語法類似：
{call 過程名}
通常，創(chuàng)建 CallableStatement 對象的人應當知道所用的 DBMS 是支持已儲存過程的，并且知道這些過程都是些什么。然而，如果需要檢查，多種 DatabaseMetaData 方法都可以提供這樣的信息。例如，如果 DBMS 支持已儲存過程的調用，則 supportsStoredProcedures 方法將返回 true，而 getProcedures 方法將返回對已儲存過程的描述。
CallableStatement 繼承 Statement 的方法（它們用于處理一般的 SQL 語句），還繼承了 PreparedStatement 的方法（它們用于處理 IN 參數(shù)）。CallableStatement 中定義的所有方法都用于處理 OUT 參數(shù)或 INOUT 參數(shù)的輸出部分：注冊 OUT 參數(shù)的 JDBC 類型（一般 SQL 類型）、從這些參數(shù)中檢索結果，或者檢查所返回的值是否為 JDBC NULL。
7.1.1 創(chuàng)建 CallableStatement 對象
CallableStatement 對象是用 Connection 方法 prepareCall 創(chuàng)建的。下例創(chuàng)建 CallableStatement 的實例，其中含有對已儲存過程 getTestData 調用。該過程有兩個變量，但不含結果參數(shù)：
CallableStatement cstmt = con.prepareCall(
"{call getTestData(?, ?)}");
其中 ? 占位符為 IN、 OUT 還是 INOUT 參數(shù)，取決于已儲存過程 getTestData。
7.1.2 IN 和 OUT 參數(shù)
將 IN 參數(shù)傳給 CallableStatement 對象是通過 setXXX 方法完成的。該方法繼承自 PreparedStatement。所傳入?yún)?shù)的類型決定了所用的 setXXX 方法（例如，用 setFloat 來傳入 float 值等）。
如果已儲存過程返回 OUT 參數(shù)，則在執(zhí)行 CallableStatement 對象以前必須先注冊每個 OUT 參數(shù)的 JDBC 類型（這是必需的，因為某些 DBMS 要求 JDBC 類型）。注冊 JDBC 類型是用 registerOutParameter 方法來完成的。語句執(zhí)行完后，CallableStatement 的 getXXX 方法將取回參數(shù)值。正確的 getXXX 方法是為各參數(shù)所注冊的 JDBC 類型所對應的 Java 類型（從 JDBC 類型到 Java 類型的標準映射見 8.6.1 節(jié)中的表）。換言之， registerOutParameter 使用的是 JDBC 類型（因此它與數(shù)據(jù)庫返回的 JDBC 類型匹配），而 getXXX 將之轉換為 Java 類型。
作為示例，下述代碼先注冊 OUT 參數(shù)，執(zhí)行由 cstmt 所調用的已儲存過程，然后檢索在 OUT 參數(shù)中返回的值。方法 getByte 從第一個 OUT 參數(shù)中取出一個 Java 字節(jié)，而 getBigDecimal 從第二個 OUT 參數(shù)中取出一個 BigDecimal 對象（小數(shù)點后面帶三位數(shù)）：
CallableStatement cstmt = con.prepareCall(
"{call getTestData(?, ?)}");
cstmt.registerOutParameter(1, java.sql.Types.TINYINT);
cstmt.registerOutParameter(2, java.sql.Types.DECIMAL, 3);
cstmt.executeQuery();
byte x = cstmt.getByte(1);
java.math.BigDecimal n = cstmt.getBigDecimal(2, 3);
CallableStatement 與 ResultSet 不同，它不提供用增量方式檢索大 OUT 值的特殊機制。
7.1.3 INOUT 參數(shù)
既支持輸入又接受輸出的參數(shù)（INOUT 參數(shù)）除了調用 registerOutParameter 方法外，還要求調用適當?shù)?setXXX 方法（該方法是從 PreparedStatement 繼承來的）。setXXX 方法將參數(shù)值設置為輸入?yún)?shù)，而 registerOutParameter 方法將它的 JDBC 類型注冊為輸出參數(shù)。setXXX 方法提供一個 Java 值，而驅動程序先把這個值轉換為 JDBC 值，然后將它送到數(shù)據(jù)庫中。
這種 IN 值的 JDBC 類型和提供給 registerOutParameter 方法的 JDBC 類型應該相同。然后，要檢索輸出值，就要用對應的 getXXX 方法。例如，Java 類型為 byte 的參數(shù)應該使用方法 setByte 來賦輸入值。應該給 registerOutParameter 提供類型為 TINYINT 的 JDBC 類型，同時應使用 getByte 來檢索輸出值 （第 8 節(jié)“JDBC 和 Java 類型之間的映射”將給出詳細信息和類型映射表）。
下例假設有一個已儲存過程 reviseTotal，其唯一參數(shù)是 INOUT 參數(shù)。方法 setByte 把此參數(shù)設為 25，驅動程序將把它作為 JDBC TINYINT 類型送到數(shù)據(jù)庫中。接著，registerOutParameter 將該參數(shù)注冊為 JDBC TINYINT。執(zhí)行完該已儲存過程后，將返回一個新的 JDBC TINYINT 值。方法 getByte 將把這個新值作為 Java byte 類型檢索。
CallableStatement cstmt = con.prepareCall(
"{call reviseTotal(?)}");
cstmt.setByte(1, 25);
cstmt.registerOutParameter(1, java.sql.Types.TINYINT);
cstmt.executeUpdate();
byte x = cstmt.getByte(1);
7.1.4 先檢索結果，再檢索 OUT 參數(shù)
由于某些 DBMS 的限制，為了實現(xiàn)最大的可移植性，建議先檢索由執(zhí)行 CallableStatement 對象所產(chǎn)生的結果，然后再用 CallableStatement.getXXX 方法來檢索 OUT 參數(shù)。
如果 CallableStatement 對象返回多個 ResultSet 對象（通過調用 execute 方法），在檢索 OUT 參數(shù)前應先檢索所有的結果。這種情況下，為確保對所有的結果都進行了訪問，必須對 Statement 方法 getResultSet、getUpdateCount 和 getMoreResults 進行調用，直到不再有結果為止。
檢索完所有的結果后，就可用 CallableStatement.getXXX 方法來檢索 OUT 參數(shù)中的值。
7.1.5 檢索作為 OUT 參數(shù)的 NULL 值
返回到 OUT 參數(shù)中的值可能會是 JDBC NULL。當出現(xiàn)這種情形時，將對 JDBC NULL 值進行轉換以使 getXXX 方法所返回的值為 null、0 或 false，這取決于 getXXX 方法類型。對于 ResultSet 對象，要知道 0 或 false 是否源于 JDBC NULL 的唯一方法，是用方法 wasNull 進行檢測。如果 getXXX 方法讀取的最后一個值是 JDBC NULL，則該方法返回 true，否則返回 flase。第 5 節(jié)“ResultSet”將給出詳細信息。
文章出處：飛諾網(wǎng)(www.firnow.com):http://dev.firnow.com/course/3_program/java/javaxl/200726/10227.html
總結
- 上一篇： 仿起点中文网的小说网站——JavaEE大
- 下一篇： 龙贝格方法计算椭圆周长