建立 Java 應用程式

若要建置可存取自治式 AI 資料庫的 Java 應用程式,首先請設定開發系統以支援資料庫存取,以利用自治式 AI 資料庫的持續可用性和高效能功能。

將開發系統設定為支援資料庫存取之後,您就可以編寫應用程式中的資料庫連線和 SQL 敘述句,以利用持續可用性與高效能功能。

提示:如需閱讀下列主題的「試試看」替代方案,請瀏覽 Oracle Autonomous AI Database Dedicated for Developers and Database Users Workshop 中的 Lab 5:Build Java Application Stacks 。

設定您的 Java 開發系統

若要設定您的開發系統,讓 Java 應用程式能夠利用自治式 AI 資料庫的持續可用性和高效能功能,請執行下列步驟。

  1. 下載並安裝 Java Development Kit (JDK)。

  2. 下載自治式 AI 資料庫的從屬端證明資料。

  3. 取得 Oracle Java 資料庫連線 (JDBC) 驅動程式。

Before You Begin - 開始之前

您的開發系統必須符合特定條件,才能順利進行設定。

下載並安裝 JDK

前往 Java SE 下載頁面。然後依照本頁面的指示,下載和安裝 JDK 8u221 或更新版本。

下載 YourAutonomous AI Database 的用戶端憑證

  1. 將包含您資料庫之從屬端證明資料的壓縮檔下載至您電腦上的安全目錄。

    您可以從 Oracle Cloud 主控台中資料庫的「詳細資訊」頁面下載此壓縮檔。如果您有一個允許您存取此頁面的 Oracle Cloud 使用者帳戶,請下載下列證明資料。如果您沒有這樣的帳戶,您必須將 zip 檔案與資料庫管理員取得,以及用來保護 zip 檔案的密碼一起取得。

    1. 在 Web 瀏覽器中,登入 Oracle Cloud 並瀏覽至「自治式 AI 資料庫」的「詳細資訊」頁面。

    2. 按一下資料庫連線。

    3. 在資料庫連線頁面中,按一下下載。

    4. 在下載 Wallet 對話方塊中,輸入密碼欄位的密碼,然後在確定密碼欄位中確認該密碼。

      密碼長度至少必須包含 8 個字元,且必須包含至少 1 個字母及 1 個數字字元或 1 個特殊字元。

    5. 按一下下載並解壓縮,將從屬端證明資料壓縮檔儲存至安全目錄。

取得 Oracle JDBC 驅動程式

從 Oracle Technical Resources 的 Maven Central 或 JDBC 下載項目頁面取得 Oracle JDBC 驅動程式 (19.6.0.0 或更新版本)。(請參閱 Oracle 技術 JDBC 首頁,瞭解相關影片和其他資源。)

若要從 Maven Central 取得 JDBC 驅動程式,請遵循下列步驟。

  1. 從 Central Maven 儲存區域取得 Oracle JDBC 驅動程式。

    提供驅動程式 Maven 相依性 GAV (GroupID、ArtifactID、VersionID),以提取 ojdbc8.jar 以及其他 jar,例如 oraclepki.jar、osdt_core.jar 和 osdt_cert.jar。請參閱 Maven Central Guide 。

    對於 ojdbc8.jar 版本 19.6.0.0,請提供此 GAV:

    <groupId>com.oracle.database.jdbc</groupId>
    <artifactId>ojdbc8</artifactId>
    <version>19.7.0.0</version>

    對於 ojdbc8.jar 版本 19.7.0.0,請提供此 GAV:

    <groupId>com.oracle.database.jdbc</groupId>
    <artifactId>ojdbc8-production</artifactId>
    <version>19.7.0.0</version>
    <type>POM</type>

若要從「Oracle 技術資源」取得 JDBC 驅動程式,請遵循下列步驟。

  1. 移至 Oracle JDBC 下載頁面。然後,選擇驅動程式的最新版本,前往其版本特定的下載頁面。

  2. 下載此存檔並將其解壓縮至要放置 JDBC 驅動程式的目錄:ojdbc8-full.tar.gz。

  3. 將連線 URL 指向您的自治式 AI 資料庫。

    將 TNS_ADMIN 附加至連線 URL,將其值設為您解壓縮從屬端證明資料之目錄的完整路徑。舉例而言:

    // Use TNS alias name plus TNS_ADMIN with JDBC driver 18.3 or higher
    DB_URL="jdbc:oracle:thin:@wallet_dbname?
    TNS_ADMIN=/Users/test/wallet_dbname";
    
    // For Microsoft Windows, use this for TNS_ADMIN:
    // TNS_ADMIN=C:\\Users\\test\\wallet_dbname";
  4. 將下列解壓縮的 JAR 檔案路徑新增至編譯和執行 Java 程式時所使用的 CLASSPATH 環境變數。

    使用 DataSourceSample.java 或 UCPSample.java 來驗證自治式 AI 資料庫的連線。

    • ojdbc8.jar:核心 JDBC 驅動程式

    • oraclepki.jar、osdt_core.jar 和 osdt_cert.jar:適用於使用公事包式認證的自治式 AI 資料庫

    • ucp.jar:用於通用連線集區 (UCP)

    • ons.jar 和 simplefan.jar:支援 FAN (快速應用程式通知)

程式碼資料庫連線和 SQL 敘述句

將開發系統設定為支援與自治式 AI 資料庫的 Java 應用程式連線之後,請遵循下列指導方針,以實現應用程式與資料庫連線的高效能和持續可用性:

舉例而言:

import java.sql.Connection;
import javax.sql.PooledConnection;
import oracle.jdbc.OracleConnection;
import oracle.jdbc.replay.OracleDataSourceFactory;
import oracle.jdbc.replay.OracleDataSource;
import oracle.jdbc.replay.OracleConnectionPoolDataSource;
...
  PoolDataSource pds = PoolDataSourceFactory.getPoolDataSource();
  // Set the connection factory first before all other properties
  pds.setConnectionFactoryClassName(
    "oracle.jdbc.replay.OracleConnectionPoolDataSourceImpl");
  pds.setFastConnectionFailoverEnabled(true);
  pds.setURL("jdbc:oracle:thin:@tp_tls?TNS_ADMIN=/users/jdoe/adbcredentials");
  pds.setUser("appuser");
  pds.setPassword("<password>");
  pds.setConnectionPoolName("JDBC_UCP_POOL");

  Connection conn = pds.getConnection();

其他資源

如需「Oracle Database JDBC 驅動程式」的詳細資訊,請參閱:

如需「通用連線集區」的詳細資訊,請參閱: