Création d'une application Java
Pour créer une application Java qui accède à une instance Autonomous Database, commencez par configurer votre système de développement afin de prendre en charge l'accès à la base de données qui peut tirer parti de la disponibilité continue et des fonctionnalités hautes performances d'Autonomous Database.
Après avoir configuré votre système de développement de sorte qu'il prenne en charge l'accès à la base de données, codez les connexions de base de données et les instructions SQL dans votre application pour tirer parti des fonctionnalités de hautes performances et de disponibilité continue.
Conseil :
Pour commencer par tester les éléments abordés ensuite, vous pouvez suivre l'exercice 5 sur la création de piles d'applications Java dans l'atelier Oracle Autonomous Database Dedicated pour les développeurs et les utilisateurs de base de données.Rubriques connexes
Configuration de votre système de développement Java
Pour configurer votre système de développement afin que votre application Java puisse tirer parti de la disponibilité continue et des fonctionnalités hautes performances d'une instance Autonomous Database, procédez comme suit.
- Téléchargez et installez Java Development Kit (JDK).
- Téléchargez les informations d'identification client pour la base de données autonome.
- Obtenez les pilotes JDBC (Oracle Java Database Connectivity).
Avant de commencer
Votre système de développement doit répondre à certains critères pour sa configuration.
-
Il doit disposer d'un accès à Internet.
-
Il doit disposer d'un accès réseau à l'instance Autonomous Database.
Pour savoir comment vous assurer que votre système de développement répond à cette exigence, reportez-vous à Configuration d'un système de développement pour accéder à la base de données.
Téléchargement et installation de JDK
Accédez à la page Téléchargements de Java SE. Téléchargez et installez ensuite JDK 8u221 ou version ultérieure en suivant les instructions de la page.
Téléchargement des informations d'identification client pour la base de données autonome
-
Téléchargez le fichier ZIP contenant les informations d'identification client pour la base de données vers un répertoire sécurisé de l'ordinateur.
Ce fichier ZIP peut être téléchargé à partir de la page Détails de la base de données dans la console Oracle Cloud. Si vous disposez d'un compte utilisateur Oracle Cloud vous permettant d'accéder à cette page, téléchargez les informations d'identification comme suit. Si vous ne disposez pas d'un tel compte, vous devez obtenir le fichier ZIP auprès de l'administrateur de la base de données, ainsi que le mot de passe qui protège le fichier ZIP.
-
Dans votre navigateur Web, connectez-vous à Oracle Cloud et accédez à la page Détails de l'instance Autonomous Database.
-
Cliquez sur Connexion à une base de données.
-
Sur la page Connexion à la base de données, cliquez sur Télécharger.
-
Dans la boîte de dialogue Download Wallet, entrez un mot de passe dans le champ Password et confirmez-le dans le champ Confirm Password.
Le mot de passe doit comporter au minimum 8 caractères, dont au moins 1 lettre et 1 caractère numérique ou caractère spécial.
-
Cliquez sur Télécharger et décompressez le fichier ZIP d'informations d'identification client pour l'enregistrer dans un répertoire sécurisé.
-
Obtention des pilotes JDBC Oracle
Obtenez les pilotes JDBC Oracle version 19.6.0.0 ou ultérieure, à partir soit de Maven Central, soit de la page Téléchargements JDBC des ressources techniques Oracle. (Reportez-vous à la page d'accueil JDBC des technologies Oracle pour visualiser les vidéos associées et d'autres ressources.)
Pour obtenir les pilotes JDBC à partir de Maven Central, procédez comme suit :
-
Obtenez les pilotes JDBC Oracle à partir du référentiel Maven Central.
Indiquez la combinaison GAV (GroupID, ArtifactID, VersionID) de dépendance Maven du pilote, pour extraire
ojdbc8.jar
, ainsi que d'autres fichiers JAR tels queoraclepki.jar
,osdt_core.jar
etosdt_cert.jar
. Reportez-vous au guide Maven Central.Pour
ojdbc8.jar
version 19.6.0.0, indiquez la combinaison GAV suivante :<groupId>com.oracle.database.jdbc</groupId> <artifactId>ojdbc8</artifactId> <version>19.7.0.0</version>
Pour
ojdbc8.jar
version 19.7.0.0, indiquez la combinaison GAV suivante :<groupId>com.oracle.database.jdbc</groupId> <artifactId>ojdbc8-production</artifactId> <version>19.7.0.0</version> <type>POM</type>
Pour obtenir les pilotes JDBC à partir des ressources techniques Oracle, procédez comme suit :
-
Accédez à la page Téléchargements Oracle JDBC. Choisissez ensuite la dernière version des pilotes pour accéder à sa page de téléchargement spécifique.
-
Téléchargez et décompressez l'archive suivante dans le répertoire dans lequel vous souhaitez placer le pilote JDBC :
ojdbc8-full.tar.gz
. -
Faites pointer l'URL de connexion vers la base de données autonome.
Ajoutez
TNS_ADMIN
à la fin de l'URL de connexion, en définissant sa valeur sur le chemin complet du répertoire dans lequel vous avez décompressé les informations d'identification client. Exemple :// 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”;
-
Ajoutez les chemins aux fichiers JAR décompressés suivants à la variable d'environnement
CLASSPATH
que vous utilisez lorsque vous compilez et exécutez des programmes Java.Utilisez DataSourceSample.java ou UCPSample.java pour vérifier la connexion à la base de données autonome.
ojdbc8.jar
: pilote JDBC de baseoraclepki.jar
,osdt_core.jar
etosdt_cert.jar
: pour une base de données autonome qui utilise l'authentification basée sur un portefeuilleucp.jar
: pour Universal Connection Pool (UCP)ons.jar
etsimplefan.jar
: pour la prise en charge de la fonction FAN (Fast Application Notification)
Codage des connexions de base de données et des instructions SQL
Après avoir configuré votre système de développement de manière à ce qu'il prenne en charge la connectivité des applications Java à une instance Autonomous Database, suivez les instructions ci-après pour obtenir des performances élevées et une disponibilité continue des connexions de votre application à la base de données :
- Utilisez des pools de connexions.
- Activez la fonction FAN (Fast Application Notification).
- Utilisez le service de base de données prédéfini qui correspond le mieux aux opérations que vous allez effectuer. Pour plus d'informations sur les services de base de données prédéfinis, reportez-vous à Noms de service de base de données prédéfinis pour les bases de données autonomes.
Exemple :
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();
Ressources supplémentaires
- Présentation de JDBC dans le Guide du développeur Oracle Database 19c JDBC ou le Guide du développeur Oracle Database 23ai JDBC
- Oracle Database JDBC Java API Reference dans le Guide du développeur Oracle Database 19c JDBC ou le Guide du développeur Oracle Database 23ai JDBC
- Introduction à UCP dans le Guide du développeur Oracle Database 19c Universal Connection Pool ou le Guide du développeur Oracle Database 23ai Universal Connection Pool
- Référence d'API Oracle Universal Connection Pool dans Référence d'API Java du pool de connexions Oracle Database 19c Universal ou Référence d'API Java du pool de connexions Oracle Database 23ai Universal