Creación de una aplicación Java

Para crear una aplicación Java que acceda a una instancia de Autonomous Database, debe empezar por configurar un sistema de desarrollo que soporte el acceso de base de datos para que pueda beneficiarse de las funciones de disponibilidad continua y alto rendimiento de Autonomous 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.

Sugerencia:

Si desea una alternativa de "prueba" a la lectura de los siguientes temas, puede realizar el laboratorio 5 sobre la creación de pilas de aplicación Java en el taller Oracle Autonomous Database Dedicated for Developers and Database Users.

Configuración del sistema de desarrollo Java

Para configurar el sistema de desarrollo de modo que la aplicación Java pueda utilizar las funciones de disponibilidad continua y alto rendimiento de una instancia de Autonomous Database, realice estos pasos.

  1. Descargue e instale Java Development Kit (JDK).
  2. Descargue las credenciales de cliente para Autonomous Database.
  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 Autonomous Database

  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. Si tiene una cuenta de usuario de Oracle Cloud que le permite acceder a esta página, descargue las credenciales de la siguiente forma. Si no tiene dicha cuenta, debe 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 el explorador web, inicie sesión en Oracle Cloud y desplácese a la página Detalles de Autonomous Database.

    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 cuadro de diálogo Download Wallet (Descargar cartera), introduzca una contraseña en el campo Password (Contraseña) y confirme la contraseña en el campo Confirm Password (Confirmar 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 Descargar y descomprima el archivo zip para guardar las credenciales de 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 Autonomous Database.

    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 Autonomous Database.

    • ojdbc8.jar: controlador JDBC principal
    • oraclepki.jar, osdt_core.jar y osdt_cert.jar: para una instancia de Autonomous Database 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 modo que soporte la conectividad de la aplicación Java a Autonomous Database, siga estas directrices para lograr un alto rendimiento y una disponibilidad continua de las conexiones de la aplicación a la base de 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 Oracle Database, consulte: