Criar um Aplicativo Java

Para criar um aplicativo Java que tenha acesso a um Autonomous AI Database, você começa configurando seu sistema de desenvolvimento para oferecer suporte ao acesso a banco de Dados que pode aproveitar os recursos contínuos de disponibilidade e alto desempenho do Autonomous AI Database.

Depois de configurar seu sistema de desenvolvimento para oferecer suporte ao acesso ao banco de dados, você codifica as conexões de banco de dados e as instruções SQL em seu aplicativo para aproveitar a disponibilidade contínua e os recursos de alto desempenho.

Dica: Para ter a alternativa de "testar" para ler os seguintes tópicos, você pode passar pelo Lab 5: Build Java Application Stacks no Oracle Autonomous AI Database Dedicated for Developers and Database Users Workshop.

Configurar o seu Sistema de Desenvolvimento Java

Para configurar seu sistema de desenvolvimento para que seu aplicativo Java possa se beneficiar da disponibilidade contínua e dos recursos de alto desempenho de um Banco de Dados de IA Autônomo, realize estas etapas.

  1. Faça download do JDK (Java Development Kit) e instale-o.

  2. Faça download das credenciais do cliente para seu Autonomous AI Database.

  3. Obtenha os drivers Oracle JDBC (Java Database Connectivity).

Antes de Começar

Seu sistema de desenvolvimento deve atender a determinados critérios para configurá-lo com sucesso.

Faça Download e Instale o JDK

Acesse a página Downloads do Java SE. Em seguida, faça download e instale o JDK 8u221 ou posterior, seguindo as instruções na página.

Fazer Download das Credenciais do Cliente do Seu Autonomous AI Database

  1. Faça download do arquivo zip que contém credenciais do cliente do seu banco de dados para um diretório seguro no seu computador.

    Esse arquivo zip está disponível para download da página Detalhes do banco de dados na console do Oracle Cloud. Se você tiver uma conta do usuário Oracle Cloud que lhe permita acessar esta página, faça download das credenciais da seguinte forma. Se você não tiver uma conta desse tipo, precisará obter o arquivo zip do administrador do banco de dados, juntamente com a senha que foi usada para proteger o arquivo zip.

    1. Em seu Web browser, acesse o Oracle Cloud e navegue até a página Detalhes do Autonomous AI Database.

    2. Clique em Conexão do BD.

    3. Na página Conexão de Banco de Dados, clique em Fazer Download.

    4. No diálogo Fazer Download da Wallet, informe uma senha no campoSenha e confirme a senha no campoConfirmar Senha.

      A senha deve ter pelo menos 8 caracteres e deve incluir pelo menos 1 letra e 1 número ou 1 caractere especial.

    5. Clique em Fazer Download e descompacte-o, para salvar o ficheiro zip de credenciais do cliente num diretório seguro.

Obter os Drivers Oracle JDBC

Obtenha os drivers Oracle JDBC, versão 19.6.0.0 ou posterior, no Maven Central ou na página Downloads do JDBC em Recursos Técnicos Oracle. (Consulte a s Tecnologias Oracle na Home page do JDBC para ver vídeos relacionados e outros recursos.)

Para obter os drivers JDBC da Maven Central, siga estas etapas.

  1. Obtenha os drivers Oracle JDBC do Repositório Central do Maven.

    Forneça o GAV (GroupID, ArtifactID, VersionID) de dependência Maven do driver para extrair o ojdbc8.jar, junto com outros jars, como oraclepki.jar, osdt_core.jar e osdt_cert.jar. Consulte o Guia do Maven Central.

    Para o ojdbc8.jar versão 19.6.0.0, forneça este GAV:

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

    Para o ojdbc8.jar versão 19.7.0.0, forneça este GAV:

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

Para obter os drivers JDBC de Recursos Técnicos da Oracle, siga estas etapas.

  1. Vá para a página Downloads do Oracle JDBC. Em seguida, escolha a versão mais recente dos drivers para ir para sua página de download específica da versão.

  2. Faça download e descompacte esse arquivo compactado no diretório em que você deseja colocar o driver JDBC: ojdbc8-full.tar.gz.

  3. Aponte o URL de conexão para o Autonomous AI Database.

    Inclua TNS_ADMIN no URL de conexão, definindo seu valor para o caminho completo do diretório no qual você descompactou as credenciais do cliente. Por exemplo:

     // 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. Adicione os caminhos para os seguintes arquivos JAR descompactados à variável de ambiente CLASSPATH que você usa ao compilar e executar programas Java.

    Use DataSourceSample.java ou UCPSample.java para verificar a conexão com seu Autonomous AI Database.

    • ojdbc8.jar: o driver JDBC principal

    • oraclepki.jar, osdt_core.jar e osdt_cert.jar: para um Autonomous AI Database que usa autenticação baseada na wallet

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

    • ons.jar e simplefan.jar: para suporte a FAN (Fast Application Notification)

Codificar Conexões do Banco de Dados e Instruções SQL

Após configurar seu sistema de desenvolvimento para oferecer suporte à conectividade de aplicativo Java com um Autonomous AI Database, siga estas diretrizes para obter alto desempenho e disponibilidade contínua das conexões do seu aplicativo com o banco:

Por exemplo:

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 Adicionais

Para obter informações detalhadas sobre o Driver JDBC do Oracle Database, consulte:

Para obter informações detalhadas sobre o Universal Connection Pool, consulte:

Conteúdo Relacionado