Créer une application Java

Pour créer une application Java qui accède à une base de données Autonomous Database, 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 d'Autonomous Database.

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 mettre en pratique les instructions décrites dans les rubriques qui suivent, exécutez l'étape Exercice 5 : Créer des piles d'applications Java dans l'atelier sur l'utilisation des bases de données autonomes Oracle dédiées pour développeurs et utilisateurs de base de données.

Rubriques connexes

Configurer votre système de développement Java

Pour configurer votre système de développement afin que votre application Java puisse tirer parti des fonctions de disponibilité continue et de haute performance d'une base de données Autonomous Database, procédez comme suit.

  1. Téléchargez et installez la trousse SDK Java (JDK).
  2. Téléchargez les données d'identification du client pour la base de données autonome.
  3. Obtenez les pilotes Oracle Java Database Connectivity (JDBC).

Étapes préliminaires

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 du client pour votre base de données autonome

  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 avez 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, avec 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 pour Autonomous Database.

    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 Download Wallet (Télécharger le portefeuille), entrez un mot de passe dans le champ Password et confirmez le mot de passe dans le champ Confirm Password (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, décompressez le fichier zip des données d'identification du client et enregistrez-le dans un répertoire sécurisé.

Obtenir les pilotes Oracle JDBC

Obtenez les pilotes Oracle JDBC 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, suivez ces étapes.

  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, procédez de la façon suivante :

  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. Indiquez l'URL de connexion à la base de données 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 autonome.

    • ojdbc8.jar : Pilote JDBC principal
    • oraclepki.jar, osdt_core.jar et osdt_cert.jar : Pour une base de données 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é des applications Java à une base de données Autonomous Database, suivez ces directives pour atteindre une haute performance et une 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 des informations détaillées sur le pilote JDBC pour Oracle Database, voir :
Pour plus d'informations sur la réserve de connexions universelle, voir :