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.Tópicos Relacionados
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.
- Faça download do JDK (Java Development Kit) e instale-o.
- Faça download das credenciais do cliente para o seu Autonomous Database.
- 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.
-
Deve ter acesso à Internet.
-
Ele deve ter acesso de rede ao Autonomous Database.
Consulte Configurar um Sistema de Desenvolvimento para Acessar o Banco de Dados para saber como garantir que seu sistema de desenvolvimento atenda a esse requisito.
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
-
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.
-
No seu navegador da Web, acesse o Oracle Cloud e navegue até a página Detalhes do Autonomous Database.
-
Clique em Conexão do BD.
-
Na página Conexão do Banco de Dados clique em Fazer Download.
-
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.
-
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.
-
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, comooraclepki.jar
,osdt_core.jar
eosdt_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.
-
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.
-
Faça download e descompacte esse arquivo compactado no diretório em que você deseja colocar o driver JDBC:
ojdbc8-full.tar.gz
. -
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”;
-
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 principaloraclepki.jar
,osdt_core.jar
eosdt_cert.jar
: para um Autonomous Database que usa autenticação baseada em walletucp.jar
: para UCP (Universal Connection Pooling)ons.jar
esimplefan.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:
- Use pools de conexão.
- Ative a FAN (Fast Application Notification).
- Use o serviço de banco de dados predefinido que melhor corresponda às operações que você executará. Para obter informações sobre os serviços de banco de dados predefinidos, consulte Nomes de Serviço de Banco de Dados Predefinidos para Autonomous Databases.
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
- Introdução ao JDBC no Oracle Database 19c JDBC Developer's Guide ou no Oracle Database 23ai JDBC Developer's Guide
- Oracle Database JDBC Java API Reference no Oracle Database 19c JDBC Developer's Guide ou no Oracle Database 23ai JDBC Developer's Guide
- Introduction to UCP no Oracle Database 19c Universal Connection Pool Developer's Guide ou no Oracle Database 23ai Universal Connection Pool Developer's Guide
- Oracle Universal Connection Pool API Reference no Oracle Database 19c Universal Connection Pool Java API Reference ou Oracle Database 23ai Universal Connection Pool Java API Reference