Creare un'applicazione Java
Per creare un'applicazione Java che acceda a un Autonomous Database, è innanzitutto necessario configurare il sistema di sviluppo per supportare l'accesso al database che può sfruttare la disponibilità continua e le funzioni ad alte prestazioni di Autonomous 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 alla lettura dei seguenti argomenti, è possibile consultare Lab 5: Build Java Application Stacks nel Workshop su Oracle Autonomous Database Dedicated for Developers and Database Users.Argomenti correlati
Configura sistema di sviluppo Java
Per configurare il sistema di sviluppo in modo che l'applicazione Java possa sfruttare la disponibilità continua e le funzioni ad alte prestazioni di un Autonomous Database, eseguire le operazioni riportate di seguito.
- Scaricare e installare il kit Java Development Kit (JDK).
- Scaricare le credenziali client per l'istanza di Autonomous Database in uso.
- Ottieni i driver Oracle Java Database Connectivity (JDBC).
Operazioni preliminari
Il sistema di sviluppo deve soddisfare determinati criteri per configurarlo correttamente.
-
Deve avere accesso a Internet.
-
Deve disporre dell'accesso di rete all'Autonomous Database.
Per informazioni su come garantire che il sistema di sviluppo soddisfi questo requisito, vedere Configura un sistema di sviluppo per l'accesso al database.
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.
Scaricare le credenziali client per l'istanza di Autonomous Database in uso in uso
-
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.
-
Nel browser Web, collegarsi a Oracle Cloud e andare alla pagina Dettagli per Autonomous Database.
-
Fare clic su Connessione DB.
-
Nella pagina Connessione al database fare clic su Scarica.
-
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.
-
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.
-
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 comeoraclepki.jar
,osdt_core.jar
eosdt_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.
-
Andare alla pagina Download di Oracle JDBC. Quindi, scegli l'ultima versione dei driver per andare alla sua pagina di download specifica della versione.
-
Scaricare ed estrarre questo archivio nella directory in cui si desidera posizionare il driver JDBC:
ojdbc8-full.tar.gz
. -
Puntare l'URL di connessione all'Autonomous Database.
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”;
-
Aggiungere i percorsi ai seguenti file JAR decompressi alla variabile di ambiente
CLASSPATH
utilizzata quando si compilano ed eseguono programmi Java.Utilizzare DataSourceSample.java o UCPSample.java per verificare la connessione ad Autonomous Database.
ojdbc8.jar
: il driver JDBC di baseoraclepki.jar
,osdt_core.jar
eosdt_cert.jar
: per un Autonomous Database che utilizza l'autenticazione basata su walletucp.jar
: per Universal Connection Pooling (UCP)ons.jar
esimplefan.jar
: per il supporto FAN (Fast Application Notification)
Connessioni al database di codice e istruzioni SQL
Dopo aver configurato il sistema di sviluppo per supportare la connettività delle applicazioni Java in un Autonomous Database, seguire le linee guida riportate di seguito per ottenere prestazioni elevate e disponibilità continua delle connessioni dell'applicazione al database.
- Usa connection pool.
- Abilitare FAN (Fast Application Notification).
- Utilizzare il servizio di database predefinito che corrisponde meglio alle operazioni che si eseguiranno. Per informazioni sui servizi di database predefiniti, vedere Nomi predefiniti dei servizi di database per i database autonomi.
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
- Introduzione a JDBC nel manuale Oracle Database 19c JDBC Developer's Guide o nel manuale Oracle Database 23ai JDBC Developer's Guide
- Oracle Database JDBC Java API Reference nella guida Oracle Database 19c JDBC Developer's Guide o Oracle Database 23ai JDBC Developer's Guide
- Introduzione a UCP nel manuale Oracle Database 19c Universal Connection Pool Developer's Guide o Oracle Database 23ai Universal Connection Pool Developer's Guide
- Riferimento all'API Oracle Universal Connection Pool in Oracle Database 19c Universal Connection Pool Java API Reference o Oracle Database 23ai Universal Connection Pool Java API Reference