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.
-
Descargue e instale Java Development Kit (JDK).
-
Descargue las credenciales de cliente para su base de datos de IA autónoma.
-
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 la base de datos de IA autónoma.
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 tu base de datos de IA autónoma
-
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.
-
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.
-
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 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.
-
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.
-
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.jaryosdt_cert.jar. Consulte la Guía central de Maven.Para
ojdbc8.jarversió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.jarversió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 su base de datos de IA autónoma.
Agregue
TNS_ADMINa 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
CLASSPATHque 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.jaryosdt_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.jarysimplefan.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:
-
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 a la base de datos predefinidos, consulte Nombres de servicio a la base de datos predefinidos para bases de datos de IA autónomas.
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:
-
Introducción a JDBC en Oracle Database 19c JDBC Developer's Guide u Oracle Database 26ai JDBC Developer's Guide
-
Referencia de API de Java JDBC de Oracle Database en Oracle Database 19c JDBC Developer's Guide u Oracle Database 26ai JDBC Developer's Guide
Para obtener información detallada sobre Universal Connection Pool, consulte:
-
Introducción a UCP en Oracle Database 19c Universal Connection Pool Developer's Guide o Oracle Database 26ai 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 26ai Universal Connection Pool