使用 Java 开发人员工具访问 Oracle Database Exadata Express 云服务 (EECS) UCP

使用 JDeveloper、NetBeans、Eclipse 和 Intellij 等 Java 开发人员工具访问 Oracle Database Exadata Express 云服务。本页面介绍如何更改 JDK 路径，传递 tnsnames.ora 的位置以及将 JKS 文件的位置和密码作为系统属性传递给每个开发工具。本页面介绍在使用 JDeveloper、NetBeans、Eclipse 和 Intellij 时如何建立成功的连接。 

1.先决条件

  • 下载并安装新的 JDK8（JDK8u71 或更高版本）或 JDK 7（JDK7u80 或更高版本）。

  • 按照第 1 步“下载并安装 JDBC 瘦驱动程序和 UCP”中所述，下载并安装 JCE 策略文件

  • 将 12.2.0.1 JDBC 瘦驱动程序 (ojdbc8.jar) 和 12.2.0.1 ucp.jar
    或     12.1.0.2 JDBC 瘦驱动程序 (ojdbc7.jar) 和 12.1.0.2 UCP (ucp.jar) 下载到某个位置，并将该位置添加到类路径。

  • 按照第 2 步“启用 Oracle 网络连接并下载 JKS 文件”中所述，下载安全和网络配置文件

  • 连接所需的系统属性：

    [Linux]
    -Doracle.net.tns_admin=/home/myuser/cloud 
    -Doracle.net.ssl_server_dn_match=true 
    -Doracle.net.ssl_version=1.2     （仅适用于 12.1.0.2 JDBC 驱动程序）
    -Djavax.net.ssl.trustStore=/home/myuser/cloud/truststore.jks 
    -Djavax.net.ssl.trustStorePassword=welcome1 
    -Djavax.net.ssl.keyStore=/home/    myuser/cloud/keystore.jks
    -Djavax.net.ssl.keyStorePassword=welcome1 
    -Doracle.net.ssl_cipher_suites=(TLS_RSA_WITH_AES_256_CBC_SHA256)    （仅适用于 JDK7）
    [Windows]
    -Doracle.net.tns_admin=c:\home\myuser\cloud
    -Doracle.net.ssl_server_dn_match=true
    -Doracle.net.ssl_version=1.2     （仅适用于 12.1.0.2 JDBC 驱动程序）
    -Djavax.net.ssl.trustStore=C:\home\    myuser\cloud\truststore.jks
    -Djavax.net.ssl.trustStorePassword=welcome1
    -Djavax.net.ssl.keyStore=C:\home\    myuser\cloud\keystore.jks
    -Djavax.net.ssl.keyStorePassword=welcome1
    -Doracle.net.ssl_cipher_suites=(TLS_RSA_WITH_AES_256_CBC_SHA256) （仅适用于 JDK7）

2.Oracle JDeveloper Java 版 12.2.1.1

  • 将 JDK 路径更改为包含所需 JCE 文件的新路径。
    • [Linux] 找到 product.conf 文件。该文件应当位于 $HOME/.jdeveloper/12.2.1.1.0
      编辑 product.conf 并用所需的 JDK 路径更新以下内容。 
      SetJavaHome /usr/jdk_1.8.0_91
    • [Windows] 找到 product.conf 文件。该文件应当位于 %USERPROFILE%\AppData\Roaming\JDeveloper\<产品版本>\
      编辑 product.conf 并用所需的 JDK 路径更新以下内容。
      SetJavaHome D:\java\jdk1.8.0_91
  • 创建一个数据库连接并测试连接
    • 创建一个数据库连接
      File --> New --> Application --> 选择 Database Tier --> Database Connection，并按照所有步骤创建一个“数据库连接”
    • 输入 DB 详细信息并测试连接
      (a) 选中"Enter Custom JDBC URL"并添加连接 URL。将 tnsnames.ora 的内容添加到连接 URL 末尾。tnsnames.ora 包含在从服务控制台下载的网络配置文件中。
      (b) 点击"JDBC parameters"，添加必要的连接属性。
      (c) 点击"Test Connection"，确保连接已建立。
    • 创建并运行一个新的 Java 应用
      • 创建一个新的 Java 项目并创建一个新的 Java 类
        签出 UCPSample.java。更新代码，使用特定于 Oracle Database Exadata Express 云的连接 URL、用户名和密码。添加几条 SQL 语句来测试连接。
      • 编译新的 Java 类
        Application --> Project Properties --> Add JAR/Directory --> 选择安装了补丁的 12.1.0.2 JDBC 瘦驱动程序 (ojdbc7.jar) 和 ucp.jar。
        检查 JAVA SE Version，确保它指向正确的 JDK。
      • 将 JKS 文件路径和密码作为 VM 参数传递
        Run --> Choose Active Run Configuration --> Manage Run Configurations；点击"Choose Custom Settings" --> Customize Settings 
        Run Configurations --> 点击“Add”按钮 --> 创建一个运行配置 --> 选择配置名称
        Run Configurations --> 点击“Edit”按钮 --> Java Options --> 传递所有系统属性
      • 运行应用

3.NetBeans IDE 8.2

  • 将 JDK 路径更改为包含所需 JCE 文件的新路径。
    • [Unix] 找到 netbeans.conf 文件。该文件应当位于 /etc/netbeans.conf
    • [Unix] 编辑 netbeans.conf 并用所需的 JDK 路径更新以下内容。
       netbeans_jdkhome="/usr/jdk_1.8.0_91"
  • 创建并运行一个新的 Java 应用
    • 在新 Java 应用中创建一个新的 Java 类。
      签出 UCPSample.java。更新代码，使用特定于 Oracle Database Exadata Express 云的连接 URL、用户名和密码。添加几条 SQL 语句来测试连接。
    • 编译新的 Java 类
      Libraries --> Add JAR/Folder --> 选择安装了补丁的 12.1.0.2 JDBC 瘦驱动程序 (ojdbc7.jar) 和 ucp.jar。
      Libraries --> Properties --> 检查 Java Platform，确保它指向正确的 JDK。
    • 将 JKS 文件路径和密码设置为 VM 参数
      Run --> Set Project Configuration --> Customize --> VM Options --> 传递所需的属性 
    • 运行应用

4.Eclipse Neon

  • 将 JDK 路径更改为包含所需 JCE 文件的新路径。
    •  打开窗口 --> Preferences --> Installed JREs --> Add。  添加一个包含所需 JCE 文件的新 JDK 主目录。 
  • 创建并运行一个新的 Java 应用
    • 创建一个新的 Java 项目并创建一个新的 Java 类
      签出 UCPSample.java。更新代码，使用特定于 Oracle Database Exadata Express 云的连接 URL、用户名和密码。添加几条 SQL 语句来测试连接。
    • 编译新的 Java 类
      右键点击 Project --> Properties --> Libraries -->       选择安装了补丁的 12.1.0.2 JDBC 瘦驱动程序 (ojdbc7.jar) 和 ucp.jar。
    • 将 JKS 文件路径和密码设置为 VM 参数
      Run --> Run Configurations --> Main --> 检查 UCPSample.java 是否是主类。
      转到“Arguments”选项卡 --> VM arguments --> 传递所需的属性
    • 运行应用

5.IntelliJ IDEA 社区版 2016.2.4

  • 将 JDK 路径更改为包含所需 JCE 文件的新路径。
    • 创建新项目时，选择包含所需 JCE 文件的新 JDK 主目录
  • 创建并运行一个新的 Java 应用
    • 创建一个新的 Java 项目并创建一个新的 Java 类
      签出 UCPSample.java。更新代码，使用特定于 Oracle Database Exadata Express 云的连接 URL、用户名和密码。添加几条 SQL 语句来测试连接。
    • 编译新的 Java 类
      External Libraries --> 选择 JDK 1.8 --> 打开 Library Settings --> Global Libraries（位于 Platform Settings 下） --> 点击 + -->       选择安装了补丁的 12.1.0.2 JDBC 瘦驱动程序 (ojdbc7.jar) 和 ucp.jar。
    • 将 JKS 文件路径和密码设置为 VM 参数
      Run --> Run Configurations --> Configuration --> 检查 UCPSample.java 是否是主类。
      在“VM Options”下 --> 传递所需的属性
    • 运行应用