萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> 程式語言綜合

Java 連接主流資料庫完整指南:Oracle、MySQL、SQL Server、PostgreSQL 等 8 大資料庫 JDBC 範本

前言

Java 透過 JDBC (Java Database Connectivity) 統一存取各類關聯式資料庫。不同資料庫的 Driver 類別、URL 格式、連線參數各異,開發者常需在專案切換資料庫時快速調整設定。本文整理 8 種主流資料庫的標準連線範本,涵蓋 Driver 載入、URL 組裝、帳密設定、連線建立,並針對常見坑點補充說明。

通用連線步驟

  1. 載入 Driver:Class.forName(driverClass).newInstance()
  2. 定義 URL、帳號、密碼
  3. 取得連線:DriverManager.getConnection(url, user, password)
  4. (可選) 設定連線池、自動提交、隔離等級等

八大資料庫連線範本

1. Oracle 8/8i/9i/10g/11g/12c/19c (Thin 模式,無需 Client)

Class.forName("oracle.jdbc.driver.OracleDriver").newInstance();
String url = "jdbc:oracle:thin:@localhost:1521:ORCL"; // SID
// 或服務名稱: jdbc:oracle:thin:@localhost:1521/myservice
String user = "scott";
String password = "tiger";
Connection conn = DriverManager.getConnection(url, user, password);

備註:Oracle 12c+ 建議使用服務名稱而非 SID;若使用 OCI 模式需安裝 Instant Client。

2. IBM DB2 (Universal JDBC Driver)

Class.forName("com.ibm.db2.jcc.DB2Driver").newInstance(); // 建議使用 JCC Driver
String url = "jdbc:db2://localhost:50000/SAMPLE"; // 資料庫名
String user = "db2admin";
String password = "password";
Connection conn = DriverManager.getConnection(url, user, password);

備註:舊版 COM.ibm.db2.jdbc.app.DB2Driver (Type 2) 已淘汰,請改用 Type 4 jcc Driver。

3. Microsoft SQL Server 7.0 / 2000 / 2005 / 2008 / 2012 / 2016 / 2019

// Microsoft 官方 JDBC Driver (建議 10.2+)
Class.forName("com.microsoft.sqlserver.jdbc.SQLServerDriver").newInstance();
String url = "jdbc:sqlserver://localhost:1433;databaseName=MyDB;encrypt=true;trustServerCertificate=true";
String user = "sa";
String password = "StrongPassword";
Connection conn = DriverManager.getConnection(url, user, password);

備註:舊版 com.microsoft.jdbc.sqlserver.SQLServerDriver (SQL Server 2000 時代) 已不支援新版本。JDBC 10.2+ 預設啟用 TLS 加密,需在 URL 加入 encrypt=true;trustServerCertificate=true (開發環境) 或配置信任憑證 (生產環境)。

4. Sybase ASE / SQL Anywhere

// jConnect (Type 4)
Class.forName("com.sybase.jdbc4.jdbc.SybDriver").newInstance();
String url = "jdbc:sybase:Tds:localhost:5000/MyDB";
Properties props = new Properties();
props.put("user", "userid");
props.put("password", "user_password");
// 可選: props.put("CHARSET", "utf8");
Connection conn = DriverManager.getConnection(url, props);

5. Informix Dynamic Server

Class.forName("com.informix.jdbc.IfxDriver").newInstance();
String url = "jdbc:informix-sqli://123.45.67.89:1533/myDB:INFORMIXSERVER=myserver;user=testuser;password=testpassword";
Connection conn = DriverManager.getConnection(url);

6. MySQL / MariaDB (Connector/J 8.0+)

Class.forName("com.mysql.cj.jdbc.Driver").newInstance(); // 5.1 版用 com.mysql.jdbc.Driver
String url = "jdbc:mysql://localhost:3306/myDB?" +
             "useUnicode=true&characterEncoding=UTF-8&" +
             "useSSL=false&serverTimezone=Asia/Taipei&" +
             "allowPublicKeyRetrieval=true";
String user = "root";
String password = "password";
Connection conn = DriverManager.getConnection(url, user, password);

關鍵參數說明:

  • useUnicode=true&characterEncoding=UTF-8:確保中文正確
  • useSSL=false:開發環境關閉 SSL;生產請啟用並配置憑證
  • serverTimezone:避免時區警告
  • allowPublicKeyRetrieval=true:配合 caching_sha2_password 認證

7. PostgreSQL (JDBC 42.2+)

Class.forName("org.postgresql.Driver").newInstance();
String url = "jdbc:postgresql://localhost:5432/myDB";
String user = "postgres";
String password = "password";
Connection conn = DriverManager.getConnection(url, user, password);

進階參數:?currentSchema=myschema&ApplicationName=MyApp

8. Microsoft Access (UCanAccess / Jackcess,建議替代 JDBC-ODBC Bridge)

⚠ JDBC-ODBC Bridge (sun.jdbc.odbc.JdbcOdbcDriver) 已在 Java 8 移除,請改用純 Java 驅動:

// UCanAccess (支援 .accdb/.mdb)
Class.forName("net.ucanaccess.jdbc.UcanaccessDriver").newInstance();
String url = "jdbc:ucanaccess://C:/Data/ReportDemo.accdb";
Connection conn = DriverManager.getConnection(url);

Maven 依賴:org.jackcess:jackcess:3.0.1, com.healthmarketscience.jackcess:jackcess-encrypt:3.0.1, net.sf.ucanaccess:ucanaccess:5.0.1

最佳實務:連線池與資源管理

// HikariCP 範例 (高效能連線池)
HikariConfig config = new HikariConfig();
config.setJdbcUrl(url);
config.setUsername(user);
config.setPassword(password);
config.setMaximumPoolSize(20);
config.setConnectionTimeout(30000);
DataSource ds = new HikariDataSource(config);

// 使用 try-with-resources 自動關閉
try (Connection conn = ds.getConnection();
     PreparedStatement stmt = conn.prepareStatement("SELECT * FROM users WHERE id = ?")) {
    stmt.setInt(1, 100);
    try (ResultSet rs = stmt.executeQuery()) {
        while (rs.next()) { /* 處理資料 */ }
    }
}

常見問題速查表

現象可能原因解決方向
ClassNotFoundExceptionDriver JAR 未加入 classpathMaven/Gradle 引入正確 dependency
Communications link failureIP/Port 錯誤、防火牆、資料庫未啟用 TCPtelnet 測試、檢查 my.cnf/pg_hba.conf/listener.ora
中文亂碼字元集不匹配URL 加字元集參數、資料庫/表/欄位統一 UTF-8
Public Key Retrieval is not allowedMySQL 8 新認證機制URL 加 allowPublicKeyRetrieval=true
No suitable driverURL 格式錯誤或 Driver 未註冊檢查 Driver 類別名、URL 前綴 (jdbc:subprotocol:...)

結語

掌握各資料庫的 JDBC 連線範本是 Java 後端開發的基本功。建議將連線參數外部化至設定檔 (YAML/Properties/環境變數),搭配連線池 (HikariCP) 與 try-with-resources,即可構建健壯、可維護的資料存取層。隨著雲端資料庫普及,亦請留意 SSL/TLS、IAM 認證、Proxy 連線等新式連線方式。

copyright © 萬盛學電腦網 all rights reserved