Creación de una aplicación Java

Para crear una aplicación Java que acceda a una base de Datos de IA autónoma, debe empezar por configurar el sistema del desarrollo para que admita el acceso a bases de datos para que pueda beneficiarse de las funciones del servicio de disponibilidad continua y alto rendimiento de Autonomous AI Database.

Después de configurar el sistema de desarrollo de modo que soporte el acceso a la base de datos, puede codificar conexiones de base de datos y sentencias SQL en la aplicación para aprovechar las funciones de disponibilidad continua y alto rendimiento.

Consejo: si desea una alternativa de "prueba" a la lectura de los siguientes temas, puede realizar el laboratorio 5 sobre la generación de pilas de aplicaciones Java en el taller Oracle Autonomous AI Database Dedicated for Developers and Database Users.

Configuración del sistema de desarrollo Java

Para configurar el sistema a fin de que su aplicación Java pueda aprovechar las funciones de disponibilidad continua y alto rendimiento de una base de datos de IA autónoma, realice estos pasos.

  1. Descargue e instale Java Development Kit (JDK).

  2. Descargue las credenciales de cliente para su base de datos de IA autónoma.

  3. Obtenga los controladores de Oracle Java Database Connectivity (JDBC).

Antes de empezar

El sistema de desarrollo debe cumplir determinados criterios para configurarlo correctamente.

Descarga e instalación de JDK

Vaya a la página de descargas de Java SE. A continuación, descargue e instale JDK 8u221 o una versión posterior siguiendo las instrucciones de la página.

Descarga de credenciales de cliente para tu base de datos de IA autónoma

  1. Descargue el archivo zip que contiene las credenciales de cliente para la base de datos en un directorio seguro de la computadora.

    Este archivo zip está disponible para su descarga en la página Detalles de la base de datos en la consola de Oracle Cloud. If you have an Oracle Cloud user account that permits you to access this page, download the credentials as follows. Si no tiene una cuenta de este tipo, deberá obtener el archivo zip del administrador de la base de datos, junto con la contraseña que se ha utilizado para proteger el archivo zip.

    1. En su explorador web, conéctese a Oracle Cloud y desplácese a la página Detalles de la base de datos de IA autónoma.

    2. Haga clic en Conexión de base de datos.

    3. En la página Conexión a base de datos, haga clic en Descargar.

    4. En el recuadro de diálogo Descargar cartera, introduzca una contraseña en el campoContraseña y confirme la contraseña en el campoConfirmar Contraseña.

      La contraseña debe tener al menos 8 caracteres e incluir al menos 1 letra y 1 carácter numérico o 1 carácter especial.

    5. Haga clic en Download (Descargar) y descomprima el archivo zip para guardar las credenciales del cliente en un directorio seguro.

Obtención de controladores JDBC de Oracle

Obtenga los controladores JDBC de Oracle, versión 19.6.0.0 o posterior, de Maven Central o de la página Descargas de JDBC en Recursos Técnicos de Oracle. (Consulte la página inicial de JDBC de tecnologías de Oracle para ver vídeos y otros recursos relacionados).

Para obtener los controladores JDBC de Maven Central, siga estos pasos.

  1. Obtenga los controladores JDBC de Oracle del repositorio de Maven central.

    Proporcione el GAV (GroupID, ArtifactID, VersionID) de dependencia de Maven de controlador, para extraer ojdbc8.jar, junto con otros archivos .jar como oraclepki.jar, osdt_core.jar y osdt_cert.jar. Consulte la Guía central de Maven.

    Para ojdbc8.jar versión 19.6.0.0, proporcione este GAV:

     <groupId>com.oracle.database.jdbc</groupId>
     <artifactId>ojdbc8</artifactId>
     <version>19.7.0.0</version>
    

    Para ojdbc8.jar versión 19.7.0.0, proporcione este GAV:

     <groupId>com.oracle.database.jdbc</groupId>
     <artifactId>ojdbc8-production</artifactId>
     <version>19.7.0.0</version>
     <type>POM</type>
    

Para obtener los controladores JDBC de los recursos técnicos de Oracle, siga estos pasos.

  1. Vaya a la página Descargas de Oracle JDBC. A continuación, elija la versión más reciente de los controladores para ir a la página de descarga específica de la versión.

  2. Descargue y descomprima este archivo en el directorio donde desea colocar el controlador JDBC: ojdbc8-full.tar.gz.

  3. Apunte la URL de conexión a su base de datos de IA autónoma.

    Agregue TNS_ADMIN a la URL de conexión, definiendo su valor en la ruta completa del directorio donde ha descomprimido las credenciales de cliente. Por ejemplo:

     // 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. Agregue las rutas en los siguientes archivos JAR descomprimidos a la variable de entorno CLASSPATH que utiliza al compilar y ejecutar programas Java.

    Utilice DataSourceSample.java o UCPSample.java para verificar la conexión a la base de datos de IA autónoma.

    • ojdbc8.jar: controlador JDBC principal

    • oraclepki.jar, osdt_core.jar y osdt_cert.jar: para una base de datos de IA autónoma que utiliza autenticación basada en cartera

    • ucp.jar: para Universal Connection Pooling (UCP)

    • ons.jar y simplefan.jar: para el soporte de FAN (Fast Application Notification)

Codificación de conexiones de base de datos y sentencias SQL

Después de configurar el sistema de desarrollo de forma que soporte la conectividad de aplicaciones Java a una instancia de AI autónoma, siga estas directrices para lograr un alto rendimiento y la disponibilidad continua de sus conexiones de aplicación a la base datos:

Por ejemplo:

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();

Recursos adicionales

Para obtener información detallada sobre el controlador JDBC de la instancia de Oracle Database, consulte:

Para obtener información detallada sobre Universal Connection Pool, consulte:

Contenido relacionado