萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 資料庫 >> Oracle 教學

MySQL JDBC 驅動類別演進:org.gjt.mm.mysql.Driver vs com.mysql.jdbc.Driver 兼容性說明

一、歷史淵源

  • org.gjt.mm.mysql.Driver:Mark Matthews 早期開發 (MM.MySQL),專案託管於 org.gjt.mm 套件名稱空間。
  • com.mysql.jdbc.Driver:MySQL 官方接管後 (Connector/J 3.1+),遷移至 com.mysql 命名空間。

兩者**功能完全相同**,org.gjt.mm.mysql.Driver 保留至今**僅為向後相容**。

二、版本對應關係

Connector/J 版本推薦驅動類別舊類別支援
3.0.x 及之前org.gjt.mm.mysql.Driver唯一選擇
3.1.x - 5.1.xcom.mysql.jdbc.Driver保留相容
6.0.x - 8.0.xcom.mysql.cj.jdbc.Driver移除 org.gjt.mm 類別

三、程式碼遷移範例

// 舊寫法 (仍可工作,但不建議新專案使用)
Class.forName("org.gjt.mm.mysql.Driver");

// 新寫法 (Connector/J 5.1+ 標準)
Class.forName("com.mysql.jdbc.Driver");

// 最新寫法 (Connector/J 6.0+ / 8.0+ 標準,JDBC 4.0+ 可省略 Class.forName)
Class.forName("com.mysql.cj.jdbc.Driver");
// 或直接依賴 SPI 自動載入:無需 Class.forName

四、完整連線範例 (Connector/J 8.0+)

String url = "jdbc:mysql://localhost:3306/mydb?"
           + "useSSL=false&serverTimezone=Asia/Taipei&characterEncoding=UTF-8";
String user = "app_user";
String pwd  = "secure_password";

try (Connection conn = DriverManager.getConnection(url, user, pwd);
     PreparedStatement ps = conn.prepareStatement("SELECT * FROM users WHERE id = ?");
     ResultSet rs = ps.executeQuery()) {

    ps.setInt(1, 1001);
    while (rs.next()) {
        System.out.println("User: " + rs.getString("name"));
    }
} catch (SQLException e) {
    e.printStackTrace();
}

五、Maven 依賴座標

<dependency>
  <groupId>com.mysql</groupId>
  <artifactId>mysql-connector-j</artifactId>  <!-- 8.0+ 新 artifactId -->
  <version>8.0.33</version>
</dependency>


<dependency>
  <groupId>mysql</groupId>
  <artifactId>mysql-connector-java</artifactId>
  <version>5.1.49</version>
</dependency>

六、遷移檢查清單

  • [ ] 更新 Class.forName 字串常數。
  • [ ] 更新 Maven/Gradle 依賴座標。
  • [ ] 連線 URL 新增 useSSL=false、serverTimezone、characterEncoding 參數 (8.0+ 預設嚴格)。
  • [ ] 測試預備語句、事務、批次更新、大物件讀寫。
  • [ ] 確認應用伺服器 (Tomcat/WebLogic) 共享庫無舊版驅動殘留 (ClassLoader 衝突)。

新專案**直接使用 com.mysql.cj.jdbc.Driver (Connector/J 8.x)**,舊專案升級時同步更新驅動類別與依賴座標,徹底告別 org.gjt.mm 歷史包袱。

copyright © 萬盛學電腦網 all rights reserved