Criar um Aplicativo Java

Para criar um aplicativo Java que acesse um Autonomous Database, comece configurando seu sistema de desenvolvimento para oferecer suporte ao acesso ao banco de dados que possa aproveitar a disponibilidade contínua e os recursos de alto desempenho do Autonomous 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 opção de "testar" para ler os tópicos a seguir, você pode conferir oLab 5: Build Java Application Stacks no Oracle Autonomous 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 aproveitar a disponibilidade contínua e os recursos de alto desempenho de um Autonomous Database, execute estas etapas.

  1. Faça download do JDK (Java Development Kit) e instale-o.
  2. Faça download das credenciais do cliente para o seu Autonomous 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.

Faça Download das Credenciais do Cliente do Autonomous 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 de usuário do Oracle Cloud que permita acessar esta página, faça download das credenciais da seguinte forma. Se você não tiver essa conta, precisará obter o arquivo zip do administrador do banco de dados, juntamente com a senha que foi usada para proteger o arquivo zip.

    1. No seu navegador da Web, acesse o Oracle Cloud e navegue até a página Detalhes do Autonomous Database.

    2. Clique em Conexão do BD.

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

    4. Na caixa de diálogo Download da Wallet, digite uma senha no campo Senha e confirme a senha no campo Confirmar 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 deszip para salvar o arquivo zip de credenciais do cliente em um 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 nos Recursos Técnicos da Oracle. (Consulte a s Tecnologias Oracle na Home page do JDBC para ver vídeos relacionados e outros recursos.)

Para obter os drivers JDBC do 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 dos 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 seu Autonomous 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 o seu Autonomous Database.

    • ojdbc8.jar: o driver JDBC principal
    • oraclepki.jar, osdt_core.jar e osdt_cert.jar: para um Autonomous Database que usa autenticação baseada em 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

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

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: