JDBC 4.0作為Java SE 6核心組件（2006發布），引入註解驅動SQL、泛型DataSet、分層異常體系、XML/SQLXML支持、RowId標準化、Wrapper接口解耦廠商擴展、Service Provider驅動自動加載七大現代化特性。雖JDBC 4.2/4.3後續增強，但4.0奠定的架構基石至今仍是數據訪問層設計的關鍵參考。本文深度剖析各特性原理、代碼模式與實戰價值。
BaseQuery — 根接口Query — 用戶定義接口，方法掛載@Select/@Update/@Delete/@Insert註解DataSet<T> extends List<T> — 參數化結果集，支持Iterator、流式操作
// 1. 實體類（JavaBean風格）
public class Employee {
private int employeeId;
private String firstName, lastName;
// Getter/Setter省略
}
// 2. 查詢接口
interface EmployeeQueries extends BaseQuery {
@Select(sql = "SELECT employeeId, firstName, lastName FROM employee")
DataSet getAllEmployees();
@Update(sql = "DELETE FROM employee")
int deleteAllEmployees();
@Insert(sql = "INSERT INTO employee (firstName, lastName) VALUES (?, ?)")
int insertEmployee(String firstName, String lastName); // 參數綁定
}
// 3. 使用
Connection con = dataSource.getConnection();
EmployeeQueries queries = con.createQueryObject(EmployeeQueries.class);
DataSet employees = queries.getAllEmployees();
for (Employee e : employees) { // DataSet實現Iterable
System.out.println(e.getFirstName() + " " + e.getLastName());
}
DataSet可實現為ResultSet（連接）或CachedRowSet（斷開）@Select、Spring Data JPA @Query、JDBI、jOOQ DSL均繼承此思想。
SQLException，只能通過getSQLState()/getErrorCode()區分，廠商差異大、脆弱。
SQLException
├── SQLTransientException // 瞬時錯誤：重試可能成功（死鎖、超時、連接失效）
│ ├── SQLTimeoutException
│ ├── SQLTransactionRollbackException
│ └── SQLTransientConnectionException
└── SQLNonTransientException // 非瞬時錯誤：不重試（語法錯、權限不足、數據完整性違反）
├── SQLSyntaxErrorException
├── SQLIntegrityConstraintViolationException
├── SQLInvalidAuthorizationSpecException
└── SQLFeatureNotSupportedException
SQLException構造函數接受cause，getCause()追溯根因Iterable<Throwable>，支持for (Throwable t : sqlEx)遍歷異常鏈
try {
queries.insertEmployee("John", "Doe");
} catch (SQLIntegrityConstraintViolationException e) {
log.warn("重複數據", e);
} catch (SQLTransientException e) {
retry(() -> queries.insertEmployee("John", "Doe"), 3); // 重試邏輯
} catch (SQLException e) {
for (Throwable t : e) log.error("異常鏈: {}", t.getMessage());
throw new DataAccessException(e);
}
XML類型，主流數據庫（Oracle、DB2、PostgreSQL、SQL Server、MySQL 8.0+）均支持。JDBC 4.0引入java.sql.SQLXML映射。
SQLXML sqlxml = con.createSQLXML();sqlxml.setString(xmlStr) 或 StreamResult result = sqlxml.setResult(StreamResult.class); // StAX/DOM/SAX寫入String xml = sqlxml.getString() 或 Source source = sqlxml.getSource(DOMSource.class);pset.setSQLXML(1, sqlxml)rs.getSQLXML(1) / cstmt.getSQLXML(1)sqlxml.free()（長事務中主動釋放資源）javax.xml.stream（JSR 173），拉式解析，內存效率高、支持大文檔、非阻塞。
| 方法 | 用途 | 場景 |
|---|---|---|
isValid(int timeout) | 檢查連接是否有效（執行輕量查詢如SELECT 1） | 連接池驗證、長連接心跳、故障快速切換 |
setClientInfo(String name, String value) | 設置客戶端元數據（應用名、用戶ID、模塊名） | 數據庫審計、監控、資源配額、多租戶標識 |
getClientInfo() | 獲取客戶端信息 | 診斷、審計 |
java.sql.RowId標準化接口ROWID_VALID_TRANSACTION/SESSION/FOREVER/OTHER/UNSUPPORTED（DatabaseMetaData.getRowIdLifetime()查詢）
// 獲取
RowId rid = rs.getRowId(1); // 或列名
RowId rid = cstmt.getRowId(1);
// 使用
ps.setRowId(1, rid); // 參數綁定
rs.updateRowId(1, newRid); // 可更新ResultSet修改RowId（極少用）
// 元數據
RowIdLifetime lifetime = meta.getRowIdLifetime();
OraclePreparedStatement批處理、PostgreSQLPGConnection複製API等需強轉，破壞可移植性。
public interface Wrapper {
T unwrap(Class iface); // 獲取廠商實現
boolean isWrapperFor(Class iface); // 判斷是否包裝
}
實現接口：Connection、Statement、PreparedStatement、CallableStatement、ResultSet、DataSource、DatabaseMetaData等17個。
if (conn.isWrapperFor(OracleConnection.class)) {
OracleConnection oraConn = conn.unwrap(OracleConnection.class);
// 使用Oracle專有API
}
META-INF/services/java.sql.Driver文件列出實現類全限定名。DriverManager啟動時掃描類路徑ServiceLoader自動發現註冊。
Class.forName("com.mysql.jdbc.Driver")，只要驅動JAR在類路徑，DriverManager.getConnection(url)即可工作。多驅動按發現順序嘗試。
DataSourceAutoConfiguration、HikariCP、Druid均依賴此機制實現零配置數據源初始化。
JDBC 4.0雖年代久遠，但其引入的註解驅動、分層異常、標準化XML/RowId、Wrapper解耦、SPI驅動發現六大架構決策，深刻影響了後續MyBatis、Spring Data、JDBI、jOOQ、HikariCP等主流數據訪問框架的設計。理解JDBC 4.0本質，能幫助開發者在選型、排錯、擴展時洞察底層邏輯，做出更專業的技術決策。
