Créer une application Java
Pour créer une application Java qui accède à une base de données autonome d'IA, vous 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 fonctions haute performance de la base de données autonome d'IA.
Après avoir configuré votre système de développement pour la prise en charge de l'accès à la base de données, vous codez les connexions à la base de données et les énoncés SQL dans votre application afin de tirer parti des fonctions de disponibilité continue et de haute performance.
Conseil : Pour une autre option que la lecture des rubriques suivantes, vous pouvez consulter Laboratoire 5 : Créer des piles d'applications Java dans l'atelier Oracle Autonomous AI Database Dedicated for Developers and Database Users.
Configurer 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 fonctions haute performance d'une base de données autonome d'IA, procédez comme suit.
-
Téléchargez et installez la trousse SDK Java (JDK).
-
Téléchargez les données d'identification de client pour votre base de données d'intelligence artificielle autonome.
-
Obtenez les pilotes Oracle Java Database Connectivity (JDBC).
Avant de commencer
Pour pouvoir être configuré, votre système de développement doit répondre à certains critères.
-
Il doit avoir un accès à Internet.
-
Il doit avoir un accès réseau à la base de données IA autonome.
Voir Configurer un système de développement pour accéder à la base de données pour savoir comment vérifier que votre système de développement respecte cette exigence.
Télécharger et installer la trousse JDK
Accédez à la page Téléchargements Java SE. Téléchargez et installez la trousse JDK version 8u221 ou ultérieure en suivant les instructions fournies sur la page.
Télécharger les données d'identification de client pour votre base de données Autonomous AI Database
-
Téléchargez le fichier zip contenant les données d'identification du client pour votre base de données dans un répertoire sécurisé sur votre ordinateur.
Ce fichier zip est disponible pour téléchargement à partir de la page Détails de la base de données dans la console Oracle Cloud. Si vous disposez d'un compte d'utilisateur Oracle Cloud qui vous permet d'accéder à cette page, téléchargez les données 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 utilisé pour protéger le fichier zip.
-
Dans votre navigateur Web, connectez-vous à Oracle Cloud et naviguez jusqu'à la page Détails de la base de données d'IA autonome.
-
Cliquez sur Connexion à la base de données.
-
Dans la page Connexion à la base de données, cliquez sur Télécharger.
-
Dans la boîte de dialogue Télécharger le portefeuille, entrez un mot de passe dans le champ Mot de passe et confirmez le mot de passe dans le champ Confirmer le mot de passe.
Le mot de passe doit comporter au moins 8 caractères et doit comprendre au moins 1 lettre et 1 caractère numérique ou 1 caractère spécial.
-
Cliquez sur Télécharger et décompressez pour enregistrer le fichier zip des données d'identification du client dans un répertoire sécurisé.
-
Obtenir les pilotes Oracle JDBC
Obtenez les pilotes JDBC Oracle, version 19.6.0.0 ou ultérieure, à partir de Maven Central ou de la page Téléchargements JDBC dans les ressources techniques d'Oracle. (Voir la page d'accueil JDBC dans la présentation des technologies Oracle pour des vidéos et d'autres ressources connexes.)
Pour obtenir les pilotes JDBC à partir de Maven Central, procédez comme suit.
-
Obtenez les pilotes Oracle JDBC à partir du référentiel Maven Central.
Indiquez les informations GAV (GroupID, ArtifactID, VersionID) de dépendance Maven pour extraire
ojdbc8.jar, ainsi que d'autres fichiers jar tels queoraclepki.jar,osdt_core.jaretosdt_cert.jar. Voir le Guide sur Maven Central.Pour
ojdbc8.jarversion 19.6.0.0, fournissez les informations GAV suivantes :<groupId>com.oracle.database.jdbc</groupId> <artifactId>ojdbc8</artifactId> <version>19.7.0.0</version>Pour
ojdbc8.jarversion 19.7.0.0, fournissez les informations GAV suivantes :<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 d'Oracle, suivez ces étapes.
-
Allez à la page Téléchargements d'Oracle JDBC. Sélectionnez ensuite la dernière version des pilotes pour accéder à la page de téléchargement correspondante.
-
Téléchargez et décompressez cette archive dans le répertoire où vous souhaitez placer le pilote JDBC :
ojdbc8-full.tar.gz. -
Pointez l'URL de connexion vers votre base de données d'intelligence artificielle autonome.
Ajoutez
TNS_ADMINà l'URL de connexion, en réglant sa valeur au chemin complet du répertoire où vous avez décompressé les données d'identification du client. Par 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 des fichiers JAR non compressés suivants à la variable d'environnement
CLASSPATHutilisée lors de la compilation et de l'exécution de programmes Java.Utilisez DataSourceSample.java ou UCPSample.java pour vérifier la connexion à votre base de données IA autonome.
-
ojdbc8.jar: Pilote JDBC principal -
oraclepki.jar,osdt_core.jaretosdt_cert.jar: Pour une base de données d'intelligence artificielle autonome qui utilise l'authentification basée sur un portefeuille -
ucp.jar: Pour les réserves de connexions universelles (UCP) -
ons.jaretsimplefan.jar: Pour la prise en charge de l'avis rapide des applications
-
Coder les connexions aux bases de données et les énoncés SQL
Après avoir configuré votre système de développement pour prendre en charge la connectivité d'application Java à une base de données Autonomous AI Database, suivez ces directives pour atteindre la haute performance et la disponibilité continue des connexions de votre application à la base de données :
-
Utilisez des réserves de connexions.
-
Activez l'avis rapide des applications.
-
Utilisez le service de base de données prédéfini qui correspond le mieux aux opérations que vous allez effectuer. Pour des informations sur les services de base de données prédéfinis, voir Nom des services de base de données prédéfinis pour les bases de données intelligentes autonomes.
Par 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
Pour plus d'informations sur le pilote JDBC pour Oracle Database, voir :
-
Présentation de JDBC dans le guide du développeur JDBC pour Oracle Database 19c ou le guide du développeur JDBC pour Oracle Database 26ai
-
Informations de référence sur les API Java pour Oracle Database JDBC dans le guide du développeur JDBC pour Oracle Database 19c ou le guide du développeur JDBC pour Oracle Database 26ai
Pour plus d'informations sur la réserve de connexions universelle, voir :
-
Présentation d'UCP dans le guide du développeur d'Oracle Database 19c Universal Connection Pool ou le guide du développeur d'Oracle Database 26ai Universal Connection Pool
-
Informations de référence sur l'API Oracle Universal Connection Pool dans Informations de référence sur l'API Java pour Oracle Database 19c Universal Connection Pool ou Informations de référence sur l'API Java pour Oracle Database 26ai Universal Connection Pool