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.

  1. Téléchargez et installez la trousse SDK Java (JDK).

  2. Téléchargez les données d'identification de client pour votre base de données d'intelligence artificielle autonome.

  3. 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.

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

  1. 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.

    1. Dans votre navigateur Web, connectez-vous à Oracle Cloud et naviguez jusqu'à la page Détails de la base de données d'IA autonome.

    2. Cliquez sur Connexion à la base de données.

    3. Dans la page Connexion à la base de données, cliquez sur Télécharger.

    4. 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.

    5. 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.

  1. 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 que oraclepki.jar, osdt_core.jar et osdt_cert.jar. Voir le Guide sur Maven Central.

    Pour ojdbc8.jar version 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.jar version 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.

  1. 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.

  2. Téléchargez et décompressez cette archive dans le répertoire où vous souhaitez placer le pilote JDBC : ojdbc8-full.tar.gz.

  3. 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";
    
  4. Ajoutez les chemins des fichiers JAR non compressés suivants à la variable d'environnement CLASSPATH utilisé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.jar et osdt_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.jar et simplefan.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 :

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 :

Pour plus d'informations sur la réserve de connexions universelle, voir :

Contenu connexe