JDBC连接Oracle，参数如何正确配置？

核心连接参数（必须提供）

这些是建立任何连接所必需的基本信息。

URL 格式详解

jdbc:oracle:thin: 是 Oracle JDBC 驱动的固定标识,后面的地址部分有几种常见的格式：

Thin 模式（最常用）

Thin 模式是纯 Java 实现，无需客户端库,是现代应用的首选。

格式：jdbc:oracle:thin:@<host>:<port>:<service_name_or_sid>

• <host>: 数据库服务器的 IP 地址或主机名。
  • 示例: localhost, 168.1.100, mydb.example.com
• <port>: 数据库监听器的端口号，默认为 1521。
  • 示例: 1521
• <service_name_or_sid>: 服务名 或 SID。
  • SID: Oracle 数据库的旧标识符，一个数据库实例只有一个 SID。
    • 示例: ORCL, ORCLCDB
  • Service Name (服务名): Oracle 9i 之后引入的概念，更灵活，一个数据库可以有多个服务名，并且可以跨实例。
    • 示例: ORCLPDB1, sales_db

示例:

// 使用 SID
String url1 = "jdbc:oracle:thin:@localhost:1521:ORCL";
// 使用 Service Name (推荐)
String url2 = "jdbc:oracle:thin:@localhost:1521/ORCLPDB1";

EZConnect 格式（简化版）

这是 Thin 模式的一种简化写法，在 Oracle 10g 及更高版本中推荐使用,语法更清晰。

格式：jdbc:oracle:thin:@//<host>:<port>/<service_name_or_sid>

示例:

// 使用 EZConnect 格式 (推荐)
String url = "jdbc:oracle:thin:@//localhost:1521/ORCLPDB1";

TNSNames 格式

这种方式需要客户端配置 tnsnames.ora 文件，驱动会从该文件中查找连接信息,在配置复杂的网络环境时很有用。

tnsnames.ora 文件示例:

ORCL =
  (DESCRIPTION =
    (ADDRESS = (PROTOCOL = TCP)(HOST = localhost)(PORT = 1521))
    (CONNECT_DATA =
      (SERVER = DEDICATED)
      (SERVICE_NAME = ORCLPDB1)
    )
  )

Java 代码中的 URL:

String url = "jdbc:oracle:thin:@ORCL";

JDBC 驱动会在客户端的 tnsnames.ora 文件中查找 ORCL 这个条目。

高级连接参数（通过 Properties 对象设置）

这些参数不是必须的，但对于优化连接池性能、处理特定场景非常重要，它们通常作为 java.util.Properties 对象传递给 DriverManager.getConnection() 方法。

Java 代码示例

下面是一个完整的示例,展示了如何使用上述参数建立连接。

添加 Maven 依赖

确保你的项目中包含了 Oracle JDBC 驱动，推荐使用 Oracle 官方发布的 Maven 仓库。

<!-- pom.xml -->
<dependency>
    <groupId>com.oracle.database.jdbc</groupId>
    <artifactId>ojdbc8</artifactId>
    <version>19.3.0.0</version> <!-- 根据你的 Oracle 数据库版本选择合适的驱动版本 -->
</dependency>

连接代码示例

import java.sql.Connection;
import java.sql.DriverManager;
import java.sql.PreparedStatement;
import java.sql.ResultSet;
import java.sql.SQLException;
import java.util.Properties;
public class OracleJdbcExample {
    // 数据库连接信息
    private static final String DB_URL = "jdbc:oracle:thin:@//localhost:1521/ORCLPDB1";
    private static final String DB_USER = "scott";
    private static final String DB_PASSWORD = "tiger";
    public static void main(String[] args) {
        // 使用 try-with-resources 确保连接和资源被正确关闭
        try (Connection connection = getOracleConnection()) {
            System.out.println("成功连接到 Oracle 数据库！");
            // 示例：执行一个查询
            String sql = "SELECT * FROM emp WHERE empno = ?";
            try (PreparedStatement pstmt = connection.prepareStatement(sql)) {
                pstmt.setInt(1, 7788); // 查询员工编号为 7788 的员工
                ResultSet rs = pstmt.executeQuery();
                if (rs.next()) {
                    System.out.println("员工姓名: " + rs.getString("ENAME"));
                    System.out.println("员工职位: " + rs.getString("JOB"));
                } else {
                    System.out.println("未找到该员工。");
                }
            }
        } catch (SQLException e) {
            System.err.println("连接数据库失败！");
            e.printStackTrace();
        }
    }
    /**
     * 获取一个带有高级参数的 Oracle 数据库连接
     */
    public static Connection getOracleConnection() throws SQLException {
        // 1. 创建 Properties 对象来存储高级参数
        Properties props = new Properties();
        props.setProperty("user", DB_USER);
        props.setProperty("password", DB_PASSWORD);
        // 2. 设置高级连接参数
        props.setProperty("v$session.program", "MyJavaApp"); // 设置应用名
        props.setProperty("v$session.client_identifier", "user_123"); // 设置客户端标识
        props.setProperty("defaultRowPrefetch", "100"); // 设置预取行数，提升查询性能
        // 3. 使用 DriverManager 获取连接
        // 注意：URL 和 Properties 都需要传递
        return DriverManager.getConnection(DB_URL, props);
    }
}

重要注意事项

1. 驱动版本：务必使用与你的 Oracle 数据库版本兼容或更高的 JDBC 驱动版本，Oracle 19c 数据库最好使用 ojdbc8 或 ojdbc10,使用不兼容的驱动可能会导致功能异常或性能问题。
2. 连接池：在生产环境中，绝对不要在每次请求时都创建和销毁连接，必须使用连接池（如 HikariCP, DBCP, C3P0）来管理数据库连接,这是提升应用性能和稳定性的关键。
3. 密码安全：不要将硬编码的密码写在代码中，应使用配置文件、环境变量或密钥管理服务来管理敏感信息。
4. 字符集：如果应用使用非英文字符（如中文），确保数据库服务器的字符集、客户端环境的字符集（NLS_LANG）和 JDBC 驱动的字符集设置保持一致，以避免乱码问题，在 URL 中可以添加 ?charset=UTF-8 来指定字符集（jdbc:oracle:thin:@//localhost:1521/ORCLPDB1?charset=UTF-8）。