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.Temas relacionados
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.
- Descargue e instale Java Development Kit (JDK).
- Descargue las credenciales de cliente para Autonomous Database.
- Obtenga los controladores de Oracle Java Database Connectivity (JDBC).
Antes de empezar
El sistema de desarrollo debe cumplir determinados criterios para configurarlo correctamente.
-
Debe tener acceso a Internet.
-
Debe tener acceso de red a Autonomous Database.
Consulte Configuración de un sistema de desarrollo para acceder a la base de datos para obtener más información sobre cómo asegurarse de que el sistema de desarrollo cumple este requisito.
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
-
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.
-
En el explorador web, inicie sesión en Oracle Cloud y desplácese a la página Detalles de Autonomous Database.
-
Haga clic en Conexión de base de datos.
-
En la página Conexión a base de datos, haga clic en Descargar.
-
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.
-
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.
-
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 comooraclepki.jar
,osdt_core.jar
yosdt_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.
-
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.
-
Descargue y descomprima este archivo en el directorio donde desea colocar el controlador JDBC:
ojdbc8-full.tar.gz
. -
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”;
-
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 principaloraclepki.jar
,osdt_core.jar
yosdt_cert.jar
: para una instancia de Autonomous Database que utiliza autenticación basada en carteraucp.jar
: para Universal Connection Pooling (UCP)ons.jar
ysimplefan.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:
- Utilice pools de conexiones.
- Active FAN (Fast Application Notification).
- Utilice el servicio de base de datos predefinido que mejor coincida con las operaciones que va a realizar. Para obtener información sobre los servicios de base de datos predefinidos, consulte Nombres de servicio de base de datos predefinidos para instancias de Autonomous Database.
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
- Introducción a JDBC en Oracle Database 19c JDBC Developer's Guide o Oracle Database 23ai JDBC Developer's Guide
- Referencia de API Java JDBC de Oracle Database en Oracle Database 19c JDBC Developer's Guide o Oracle Database 23ai JDBC Developer's Guide
- Introduction to UCP in Oracle Database 19c Universal Connection Pool Developer's Guide u Oracle Database 23ai Universal Connection Pool Developer's Guide
- Referencia de API de Oracle Universal Connection Pool en Referencia de API de Java de Oracle Database 19c Universal Connection Pool o Referencia de API de Java de Oracle Database 23ai Universal Connection Pool