为什么 mysql-connector-java 只需要在 runtime 作用范围中配置

在 Java 中，访问数据库通常依赖于 JDBC（Java Database Connectivity）技术。JDBC 定义了一套标准的 API，用于与数据库进行交互。为了访问数据库，我们编写的代码需要依赖于 JDBC 接口而不是具体的数据库实现（如 MySQL JDBC 驱动）。在这篇博客中，我们将展示如何使用 JDBC 接口来访问数据库，同时解释如何在 Maven 中配置这些依赖。

为什么使用 JDBC 接口而不是具体的 JDBC 实现？

JDBC 提供了一套标准的接口（如 Connection, Statement, ResultSet），这些接口定义了与数据库交互的基本操作。具体的 JDBC 驱动程序（如 MySQL JDBC 驱动）提供了这些接口的实际实现。使用 JDBC 接口而不是具体的实现有以下几个优点：

解耦：你的代码不直接依赖于具体的数据库实现，这样可以在不修改业务逻辑的情况下更换数据库或驱动程序。
灵活性：代码中只使用 JDBC 接口，不依赖于特定数据库的实现细节，使得应用程序可以更轻松地适应不同的数据库。
维护性：管理数据库连接的细节和实现的复杂性由 JDBC 驱动程序负责，简化了代码的维护和管理。

示例代码

以下是一个使用 JDBC 接口来访问 MySQL 数据库的示例代码。该代码演示了如何创建数据库连接、执行 SQL 查询并处理结果集。

java 复制代码

import java.sql.Connection;
import java.sql.DriverManager;
import java.sql.ResultSet;
import java.sql.SQLException;
import java.sql.Statement;

public class DatabaseExample {

    // 数据库连接 URL
    private static final String JDBC_URL = "jdbc:mysql://localhost:3306/mydatabase";
    // 数据库用户名
    private static final String JDBC_USER = "root";
    // 数据库密码
    private static final String JDBC_PASSWORD = "password";

    public static void main(String[] args) {
        // JDBC 驱动的类名
        String jdbcDriverClassName = "com.mysql.cj.jdbc.Driver";

        Connection connection = null;
        Statement statement = null;
        ResultSet resultSet = null;

        try {
            // 加载 JDBC 驱动
            Class.forName(jdbcDriverClassName);

            // 获取数据库连接
            connection = DriverManager.getConnection(JDBC_URL, JDBC_USER, JDBC_PASSWORD);

            // 创建 Statement 对象用于执行 SQL 查询
            statement = connection.createStatement();
            String sqlQuery = "SELECT * FROM users";
            
            // 执行 SQL 查询
            resultSet = statement.executeQuery(sqlQuery);

            // 处理结果集
            while (resultSet.next()) {
                int id = resultSet.getInt("id");
                String name = resultSet.getString("name");
                System.out.println("User ID: " + id + ", Name: " + name);
            }
        } catch (ClassNotFoundException e) {
            System.err.println("JDBC 驱动程序未找到: " + e.getMessage());
        } catch (SQLException e) {
            System.err.println("数据库操作错误: " + e.getMessage());
        } finally {
            // 关闭资源
            try {
                if (resultSet != null) resultSet.close();
                if (statement != null) statement.close();
                if (connection != null) connection.close();
            } catch (SQLException e) {
                System.err.println("关闭资源时出错: " + e.getMessage());
            }
        }
    }
}

Maven 依赖配置

在 Maven 项目中，你需要在 pom.xml 文件中添加 MySQL JDBC 驱动的依赖。尽管你的代码中只使用 JDBC 接口，但在运行时你仍然需要提供具体的 JDBC 实现。

xml 复制代码

<dependencies>
    <!-- JDBC 驱动程序 -->
    <dependency>
        <groupId>mysql</groupId>
        <artifactId>mysql-connector-java</artifactId>
        <version>8.0.26</version>
        <scope>runtime</scope> <!-- 仅在运行时需要 -->
    </dependency>
</dependencies>

说明

JDBC 接口 ：代码中使用了 Connection, Statement, ResultSet 等 JDBC 接口来进行数据库操作。这些接口定义了与数据库交互的基本方法。
驱动类名 ：使用 Class.forName(jdbcDriverClassName) 加载具体的 JDBC 驱动类。这个步骤将驱动程序的实现类加载到 JVM 中，以便能够处理数据库连接。
数据库连接 ：DriverManager.getConnection() 方法用于获取数据库连接。具体的连接细节由 JDBC 驱动程序处理，但代码中只涉及 JDBC 接口。

通过这种方式，你的代码与具体的 JDBC 驱动程序实现解耦，使得更换数据库或驱动程序时，仅需在 Maven 配置中进行调整，而无需修改业务逻辑代码。这种做法提高了代码的灵活性和维护性，使得应用程序更容易适应不同的数据库环境。