網絡上充斥著錯誤、過時、未經驗證的「教程」。本文基於實戰踩坑,針對 **驅動加載方式選擇、LOB 正確存儲、可滾動游標陷阱、Statement Cache 配置** 四大核心領域,提供經得起生產環境考驗的最佳實踐。
| 方式 | 代碼 | 優點 | 缺點/避坑 | 推薦場景 |
|---|---|---|---|---|
| 1. Class.forName | `Class.forName("oracle.jdbc.driver.OracleDriver")` | 簡單、標準 JDBC | MS JVM (IE Applet) 無法正確初始化靜態塊註冊驅動 | 標準 Java SE/EE 應用 |
| 2. 系統屬性文件 | `System.getProperties().load(...)` `jdbc.drivers=oracle.jdbc.driver.OracleDriver` | 多驅動並存、無需改代碼切換 DB | 啟動較慢、鮮少使用 | 多數據源動態切換框架 |
| 3. 手動註冊 (最可靠) | `DriverManager.registerDriver(new oracle.jdbc.OracleDriver())` | 任何環境 (含 Applet、OSGi、模塊化) 均可靠工作 | 代碼耦合具體驅動類 | **生產環境首選**、Applet、特殊類加載器環境 |
建議:採用方式 3,或封裝工具類自動檢測環境選擇。
// 錯誤示範:會拋 IO Exception 而非 SQL Exception
pstmt.setBinaryStream(1, inputStream, fileLength); // 對 BLOB 無效!
CREATE TABLE legacy_files (name VARCHAR2(100), data LONG RAW);
-- Java
pstmt = conn.prepareStatement("INSERT INTO legacy_files VALUES (?, ?)");
pstmt.setString(1, "a.gif");
pstmt.setBinaryStream(2, new FileInputStream(file), (int)file.length());
pstmt.executeUpdate();
conn.setAutoCommit(false);
Statement stmt = conn.createStatement();
// 1. 插入空 BLOB 獲取定位器
stmt.executeUpdate("INSERT INTO files (name, data) VALUES ('a.gif', EMPTY_BLOB())");
ResultSet rs = stmt.executeQuery("SELECT data FROM files WHERE name='a.gif' FOR UPDATE");
rs.next();
BLOB blob = ((oracle.sql.BLOB) rs.getBlob(1));
// 2. 獲取二進制輸出流寫入
OutputStream out = blob.getBinaryOutputStream();
byte[] buffer = new byte[blob.getBufferSize()];
InputStream in = new FileInputStream(file);
int len;
while ((len = in.read(buffer)) != -1) out.write(buffer, 0, len);
in.close(); out.close();
conn.commit();
rs.close(); stmt.close();
Writer writer = clob.setCharacterStream(1); // 或 getCharacterOutputStream()
writer.write(largeTextContent);
writer.close();
// BLOB
Blob blob = rs.getBlob("data");
InputStream in = blob.getBinaryStream(); // 非 getBinaryInputStream()
// CLOB
Clob clob = rs.getClob("content");
Reader reader = clob.getCharacterStream(); // 關鍵:字符流保證中文正確
// 連接池配置 (HikariCP 範例)
dataSource.setPoolPreparedStatements(true);
dataSource.setMaxOpenPreparedStatements(200); // 每連線快取 200 個 PreparedStatement
// 代碼中:重複使用相同 SQL 文本的 PreparedStatement 將命中快取
PreparedStatement pstmt = conn.prepareStatement(sql); // 從快取獲取,無需再次解析
Oracle JDBC 開發看似簡單,暗藏 LOB 處理陷阱、可滾動游標記憶體陷阱、驅動加載環境陷阱。掌握上述四大核心領域的正確姿勢,配合連接池 Statement Cache 與規範化異常處理,才能構建高效、穩定、可維護的企業級數據訪問層。