兼容性
第6章 兼容性
這一章描述了JDBC類庫實(shí)現(xiàn)在各個(gè)兼容級(jí)別要支持的特性。一個(gè)JDBC類庫實(shí)現(xiàn)包含了一個(gè)JDBC驅(qū)動(dòng)和底層數(shù)據(jù)源。兼容性定義了在驅(qū)動(dòng)層之上要實(shí)現(xiàn)的特性。
任何沒有提到的特性都是可選的。通常，如果底層數(shù)據(jù)源不支持，驅(qū)動(dòng)不需要實(shí)現(xiàn)這個(gè)特性。
6.1 定義
為了避免混淆，我們將在兼容性的討論中使用以下術(shù)語：
- JDBC類庫實(shí)現(xiàn) --- 一個(gè)JDBC驅(qū)動(dòng)和它的底層數(shù)據(jù)源。驅(qū)動(dòng)可能提供對(duì)底層數(shù)據(jù)源沒有實(shí)現(xiàn)的特性的支持。它也可能提供標(biāo)準(zhǔn)語法/語義到數(shù)據(jù)源本地類庫的映射。
- 相關(guān)規(guī)范 --- 這個(gè)類庫規(guī)范以及其他相關(guān)的SQL規(guī)范。如果一個(gè)特性在多個(gè)文檔里被描述，我們應(yīng)該考慮被排在最前面的文檔。對(duì)于JDBC 1.0類庫來說，相關(guān)的SQL規(guī)范包括SQL92和X/Open SQL CLI。對(duì)于JDBC2.0和3.0類庫，它包括SQL92加上SQL99和X/Open SQL CLI的相關(guān)部分。對(duì)于JDBC 4.0類庫，它包括SQL92以及SQL2003和X/Open SQL CLI的相關(guān)部分。
- 支持特性 --- 在相關(guān)規(guī)范中定義了特性的標(biāo)準(zhǔn)語法和語義，JDBC類庫實(shí)現(xiàn)要按照語法和語義的規(guī)定支持這些特性。
- 擴(kuò)展 --- 一個(gè)沒有被相關(guān)規(guī)范定義的特性，或者是，相關(guān)規(guī)范中特性的非標(biāo)準(zhǔn)實(shí)現(xiàn)。
- 完整實(shí)現(xiàn) --- 一個(gè)接口的所有方法都被實(shí)現(xiàn)。
- 需要的接口 --- 要支持的接口，但不一定要完整實(shí)現(xiàn)。接口里沒有實(shí)現(xiàn)的方法應(yīng)拋出SQLException，說明不支持該特性。
6.2 指導(dǎo)原則和要求
下列指導(dǎo)原則適合所有級(jí)別的兼容性：
- 一個(gè)JDBC類庫實(shí)現(xiàn)必須支持入門級(jí)別SQL92（Entry Level SQL92）和“Drop Table”SQL命令（請(qǐng)參照注意事項(xiàng)）。
入門級(jí)別SQL92（Entry Level SQL92）是JDBC類庫實(shí)現(xiàn)要支持的最低SQL級(jí)別。對(duì)SQL99或SQL2003中特性的訪問應(yīng)該與SQL99或SQL2003規(guī)范的相關(guān)部分一致。
- 驅(qū)動(dòng)必須支持轉(zhuǎn)義語法。轉(zhuǎn)義語法將在第13章“語句”中講述。
- 驅(qū)動(dòng)必須支持事務(wù)。詳見第9章“事務(wù)”。
- 驅(qū)動(dòng)應(yīng)該提供對(duì)底層數(shù)據(jù)源所有特性的訪問，包括擴(kuò)展了JDBC類庫的特性。如果一個(gè)特性沒有被支持，特性對(duì)應(yīng)的方 法應(yīng)該拋出SQLException。這樣使得JDBC程序可以訪問與本地應(yīng)用相同的特性集。
- 如果從DatabaseMetaData的方法得知驅(qū)動(dòng)支持給定的特性，則驅(qū)動(dòng)要保證特性的語法和語義應(yīng)該跟相關(guān)規(guī)范一致。這意味著，如果數(shù)據(jù)源的本地類庫或語法與標(biāo)準(zhǔn)不一致，驅(qū)動(dòng)要提供相應(yīng)的映射。
- 支持一個(gè)特性，還必須實(shí)現(xiàn)相關(guān)的元數(shù)據(jù)方法。例如，一個(gè)驅(qū)動(dòng)支持RowSet接口，它還要實(shí)現(xiàn)RowSetMetaData接口。
- 不支持一個(gè)特性，則對(duì)應(yīng)的DatabaseMetaData方法要“拒絕訪問”：對(duì)不支持特性的方法的訪問要拋出SQLException。
注意 ：JDBC類庫實(shí)現(xiàn)要支持“SQL92 - 過渡級(jí)別”中定義的DROP TABLE命令，但對(duì)CASCADE和RESTRICT選項(xiàng)的支持 是可選的。而且，當(dāng)要被刪除的表有視圖（views）和完整性約束時(shí)，DROP TABLE的行為也是實(shí)現(xiàn)類庫的廠商自己定義的。
6.3 JDBC 1.0 類庫兼容性
與JDBC 1.0 類庫兼容的驅(qū)動(dòng)應(yīng)滿足以下條件：
- 遵守前述指導(dǎo)原則和要求
- 完整實(shí)現(xiàn)下列接口：
- java.sql.Driver
- java.sql.DatabaseMetaData（除了在高版本中引入的方法）
- java.sql.ResultSetMetaData（除了在高版本中引入的方法）
包含下列需要的接口（“需要的接口”的定義見6.1）
- java.sql.CallableStatement
- java.sql.Connection
- java.sql.PreparedStatement
- java.sql.ResultSet
- java.sql.Statement
6.4 JDBC 2.0 類庫兼容性
與JDBC 2.0 類庫兼容的驅(qū)動(dòng)應(yīng)滿足以下條件：
- 遵守JDBC 1.0 類庫需求
- 在DatabaseMetaData中增加下列方法的實(shí)現(xiàn)：
- deletesAreDetected
- getConnection
- getUDTs
- insertsAreDetected
- othersDeletesAreVisible
- othersInsertsAreVisible
- othersUpdateAreVisible
- ownDeletesAreVisible
- ownInsertsAreVisible
- ownUpdatesAreVisible
- supportsBatchUpdates
- supportsResultSetConcurrency
- supportsResultSetType
- updatesAreDetected
- 在ResultSetMetaData里增加下列方法的實(shí)現(xiàn)：
- getColumnClassName
- getColumnType
- getColumnTypeName
6.5 JDBC 3.0 類庫的兼容性
與JDBC 3.0 類庫兼容的驅(qū)動(dòng)應(yīng)滿足以下條件：
- 遵守JDBC 1.0 類庫需求
- 包含下列需要的接口：
- java.sql.ParameterMetaData
- java.sql.Savepoint
在DatabaseMetaData中增加下列方法的實(shí)現(xiàn)：
- supportsSavepoints
- supportsNamedParameters
- supportsMultipleOpenResults
- supportsGetGeneratedKeys
- getSuperTypes
- getSuperTables
- getAttributes
- getResultSetHoldability
- supportsResultSetHoldability
- getSQLStateType
- getDatabaseMajorVersion
- getDatabaseMinorVersion
- getJDBCMajorVersion
- getJDBCMinorVersion
6.6 JDBC 4.0 類庫的兼容性
與JDBC 4.0 類庫兼容的驅(qū)動(dòng)應(yīng)滿足以下條件：
- 遵守JDBC 3.0 類庫需求
- 包含下列需要的接口：
- java.sql.RowId
- java.sql.QueryObjectGenerator
- java.sql.DataSet
- 在DatabaseMetaData里增加下列方法的實(shí)現(xiàn)：
- getRowIdLifetime
- supportsStoredFunctionsUsingCallSyntax
- providesQueryObjectGenerator
注意 ：這一段將在下一版草案更新
6.7 決定兼容級(jí)別
JDBC 類庫是Java平臺(tái)不可或缺的一部分。與JDBC類庫規(guī)范兼容是與整個(gè)平臺(tái)兼容的一個(gè)子集。
注意 ：在編寫這個(gè)文檔之際，還沒有獨(dú)立于平臺(tái)檢查JDBC類庫兼容級(jí)別的。
6.8 不贊成使用的類庫
不贊成使用是針對(duì)類、接口、構(gòu)造器、方法或字段來說的，即不再被推薦使用，而且可能在將來某個(gè)版本不復(fù)存在。
JDBC 2.0類庫中不贊成使用的構(gòu)造器和方法： java.sql.CallableStatement.getBigDecimal(int, int)
java.sql.Date(int, int, int)
java.sql.Date.getHours()
java.sql.Date.getMinutes()
java.sql.Date.getSeconds()
java.sql.Date.setHours(int)
java.sql.Date.setMinutes(int)
java.sql.Date.setSeconds(int)
java.sql.DriverManager.getLogStream()
java.sql.DriverManager.setLogStream(PrintStream?)
java.sql.PreparedStatement.setUnicodeStream(int, InputStream?, int)
java.sql.ResultSet.getBigDecimal(int, int)
java.sql.ResultSet.getBigDecimal(String, int)
java.sql.ResultSet.getUnicodeStream(int)
java.sql.ResultSet.getUnicodeStream(String)
java.sql.Time(int, int, int)
java.sql.Time.getDate()
java.sql.Time.getDay()
java.sql.Time.getMonth()
java.sql.Time.getYear()
java.sql.Time.setDate(int)
java.sql.Time.setMonth(int)
java.sql.Time.setYear(int)
java.sql.Timestamp(int, int, int, int, int, int, int)
也可參考http://www.pgsqldb.org/twiki/bin/view/PgSQL/兼容性