Creare un'applicazione Java

Per creare un'applicazione Java che acceda a un Autonomous AI Database, puoi iniziare configurando il tuo sistema di sviluppo per supportare l'accesso al database che può sfruttare la disponibilità continua e le funzioni ad alte prestazioni di Autonomous AI Database.

Dopo aver configurato il sistema di sviluppo per supportare l'accesso al database, è possibile codificare le connessioni al database e le istruzioni SQL nell'applicazione per sfruttare le funzioni di disponibilità continua e ad alte prestazioni.

Suggerimento

Per un'alternativa "prova" alla lettura dei seguenti argomenti, puoi partecipare al Lab 5: Build Java Application Stacks nel Workshop su Oracle Autonomous AI Database dedicato agli sviluppatori e agli utenti di database.

Configura sistema di sviluppo Java

Per configurare il tuo sistema di sviluppo in modo che la tua applicazione Java possa sfruttare la disponibilità continua e le funzioni ad alte prestazioni di un Autonomous AI Database, esegui questi passaggi.

  1. Scaricare e installare il kit Java Development Kit (JDK).
  2. Scarica le credenziali client per il tuo database AI autonomo.
  3. Ottieni i driver Oracle Java Database Connectivity (JDBC).

Operazioni preliminari

Il sistema di sviluppo deve soddisfare determinati criteri per configurarlo correttamente.

Scaricare e installare JDK

Vai alla pagina Download di Java SE. Quindi, scaricare e installare JDK 8u221 o versione successiva seguendo le istruzioni riportate nella pagina.

Scarica le credenziali client per il tuo database AI autonomo

  1. Scaricare il file zip contenente le credenziali client per il database in una directory sicura del computer.

    Questo file zip può essere scaricato dalla pagina Dettagli del database nella console di Oracle Cloud. Se si dispone di un account utente Oracle Cloud che consente di accedere a questa pagina, scaricare le credenziali come indicato di seguito. Se non si dispone di un account di questo tipo, è necessario ottenere il file zip dall'amministratore del database, insieme alla password utilizzata per proteggere il file zip.

    1. Nel tuo browser Web, accedi a Oracle Cloud e vai alla pagina Dettagli per Autonomous AI Database.

    2. Fare clic su Connessione DB.

    3. Nella pagina Connessione al database fare clic su Scarica.

    4. Nella finestra di dialogo Scarica wallet, immettere una password nel campo Password e confermare la password nel campo Conferma password.

      La password deve avere una lunghezza di almeno 8 caratteri e deve includere almeno 1 lettera e 1 carattere numerico o 1 carattere speciale.

    5. Fare clic su Download ed estrarre il file ZIP delle credenziali del client per salvarlo in una directory sicura.

Recupera i driver JDBC Oracle

Ottenere i driver Oracle JDBC, versione 19.6.0.0 o successiva, da o Maven Central o dalla pagina Download JDBC in Oracle Technical Resources. (Consulta la home page di JDBC di Oracle Technologies per video correlati e altre risorse.)

Per ottenere i driver JDBC da Maven Central, attenersi alla procedura riportata di seguito.

  1. Ottieni i driver JDBC Oracle dal repository Maven centrale.

    Fornire il GAV della dipendenza Maven del driver (GroupID, ArtifactID, VersionID) per estrarre ojdbc8.jar, insieme ad altri file jar come oraclepki.jar, osdt_core.jar e osdt_cert.jar. Vedere Maven Central Guide.

    Per ojdbc8.jar versione 19.6.0.0, fornire il seguente GAV:

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

    Per ojdbc8.jar versione 19.7.0.0, fornire il seguente GAV:

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

Per ottenere i driver JDBC dalle risorse tecniche Oracle, attenersi alla procedura riportata di seguito.

  1. Andare alla pagina Download di Oracle JDBC. Quindi, scegli l'ultima versione dei driver per andare alla sua pagina di download specifica della versione.

  2. Scaricare ed estrarre questo archivio nella directory in cui si desidera posizionare il driver JDBC: ojdbc8-full.tar.gz.

  3. Indicare l'URL di connessione al database AI autonomo.

    Aggiungere TNS_ADMIN all'URL di connessione, impostandone il valore sul percorso completo della directory in cui sono state decompresse le credenziali client. Ad esempio:

    // 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. Aggiungere i percorsi ai seguenti file JAR decompressi alla variabile di ambiente CLASSPATH utilizzata quando si compilano ed eseguono programmi Java.

    Utilizza DataSourceSample.java o UCPSample.java per verificare la connessione al tuo database AI autonomo.

    • ojdbc8.jar: il driver JDBC di base
    • oraclepki.jar, osdt_core.jar e osdt_cert.jar: per un Autonomous AI Database che utilizza l'autenticazione basata su wallet
    • ucp.jar: per Universal Connection Pooling (UCP)
    • ons.jar e simplefan.jar: per il supporto FAN (Fast Application Notification)

Connessioni al database di codice e istruzioni SQL

Dopo aver configurato il tuo sistema di sviluppo per supportare la connettività delle applicazioni Java a un Autonomous AI Database, segui queste linee guida per ottenere prestazioni elevate e disponibilità continua delle connessioni della tua applicazione al database:

Ad esempio:

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();

Risorse aggiuntive

Per informazioni dettagliate sul driver JDBC di Oracle Database, vedere: