artigo SQL Magazine 02 - Conectando Delphi, VB .Net e Java Com o Oracle

Natal DevMedia: Assine hoje e ganhe 3 meses gr�tis

Antes de entrarmos nas particularidades de cada ferramenta, veremos a configura��o do client do Oracle para que seja efetuada a conex�o com o servidor de banco de dados. Esses procedimentos n�o s�o necess�rios para o exemplo em Java pois utilizaremos um driver Classe 4 e, como mostrado no primeiro artigo desta s�rie, esse tipo de driver realiza a conex�o diretamente com o servidor.

A configura��o do client � armazenada no arquivo tnsnames.ora. Esse arquivo pode ser editado manualmente ou configurado atrav�s do assistente Net Easy Config. O assistente � acess�vel, geralmente, no menu �Network Administration� do Oracle e o arquivo de instala��o pode ser encontrado na pasta C:\OraHomeX\NETWORK\ADMIN, onde X � a vers�o do Oracle. Neste artigo, utilizamos o Oracle 8i Personal.

Ao abrir o assistente os �servi�os de rede� j� criados s�o exibidos. Cada servi�o de rede � um Alias local para uma inst�ncia criada no servidor. No Oracle, uma inst�ncia representa um conjunto de processos em mem�ria que gerencia e centraliza o acesso a um ou mais banco de dados.

Na caixa A��es do assistente selecione a op��o Criar e na caixa Novo Nome de Servi�o de Rede digite SQLMAGAZINE. Este nome ser� nosso Alias para conex�o do client com o servidor.

O segundo passo consiste na defini��o do protocolo de comunica��o que ser� utilizado. Para conex�o com um banco de dados na pr�pria m�quina de desenvolvimento, podemos selecionar IPC (Banco de Dados Local). Neste exemplo, utilizaremos TCP/IP, que pode ser utilizado localmente ou em rede.

Em seguida, devemos configurar o protocolo selecionado. Para o TCP/IP � necess�rio informar o Nome do Host, ou seja, a m�quina onde est� localizado o servidor de banco de dados, e o n�mero da porta do Listener. Host pode ser o nome da m�quina ou o endere�o IP da mesma. Para conex�o local, podemos utilizar a palavra LOCALHOST. O valor default para a porta do Listener � 1521 (figura 1).

NOTA: Consulte o administrador do banco de dados para saber o endere�o IP e o endere�o de porta do Listener do servidor.

figura 1 -porta doListener

Na pr�xima tela indicamos o nome da inst�ncia que desejamos conectar (chamada no assistente de �Nome do servi�o�). A inst�ncia previamente criada no servidor para este exemplo se chama SQLM. Na instala��o do Oracle, a inst�ncia criada se chama, por default, ORCL.

Nota: Consulte o administrador para saber o nome de Inst�ncia do banco de dados.

A �ltima tela do assistente fornece uma interface para teste de conex�o. Este teste, por default, utiliza o usu�rio Scott, criado na instala��o do Oracle. Para realizar o teste com outro usu�rio, basta clicar no bot�o �Alterar Login�.

Nesse ponto o client est� configurado e � poss�vel realizar a conex�o de uma aplica��o � inst�ncia SQLM. Toda a configura��o fica gravada no arquivo tnsnames.ora que pode ser editado manualmente para altera��o, exclus�o ou inclus�o de novos aliases. Na listagem 1 � mostrado o conte�do desse arquivo ap�s a execu��o do Net Easy Config. Os itens referentes ao protocol, servidor, porta e inst�ncia aparecem, nesta ordem, destacados em vermelho.

# C:\ORAHOME8\NETWORK\ADMIN\TNSNAMES.ORA Configuration File:c:\OraHome8\NETWORK\ADMIN\tnsnames.ora
 # Generated by Oracle Net8 Assistant
  
 SQLMAGAZINE =
   (DESCRIPTION =
     (ADDRESS_LIST =
       (ADDRESS = (PROTOCOL = TCP)(HOST = LOCALHOST)(PORT = 1521))
     )
     (CONNECT_DATA =
       (SERVICE_NAME = SQLM)
     )
   )

listagem 1 -arquivotnsnames.ora

Como exemplo, a listagem 2 exibe a inclus�o manual de um novo servi�o de rede, apontando para a inst�ncia ISQL no host SVR_SQLMAGAZINE.

# C:\ORAHOME8\NETWORK\ADMIN\TNSNAMES.ORA Configuration File:c:\OraHome8\NETWORK\ADMIN\tnsnames.ora
 # Generated by Oracle Net8 Assistant
  
 SQLMAGAZINE =
   (DESCRIPTION =
     (ADDRESS_LIST =
       (ADDRESS = (PROTOCOL = TCP)(HOST = LOCALHOST)(PORT = 1521))
     )
     (CONNECT_DATA =
       (SERVICE_NAME = SQLM)
     )
   )
  
 SQLMAGAZINE_REDE =
   (DESCRIPTION =
     (ADDRESS_LIST =
       (ADDRESS = (PROTOCOL = TCP)(HOST = SVR_SQLMAGAZINE)(PORT = 1521))
     )
     (CONNECT_DATA =
       (SERVICE_NAME = ISQL)
     )
   )

listagem 2 -inclus�o manual de um novo servi�o de rede

Conectando com Delphi utilizando DbExpress e ADO

Como vimos na edi��o anterior, o Delphi disponibiliza v�rios componentes para conex�o com bancos de dados, diretamente vinculados a um engine ou uma API que faz o trabalho de interface entre a aplica��o e o client do banco. Como primeiro exemplo, veremos a conex�o com a DbExpress.

A implementa��o do driver dbExpress para conex�o com Oracle, dbexpora, faz chamada direta � API OCI (Oracle Call Interface), implementada pelo client para conex�o com o servidor.

Na edi��o anterior conhecemos todo o processo de configura��o e conex�o da dbExpress com o SQL Server. Basicamente, para fazer uma aplica��o dbExpress acessar o Oracle, devemos modificar as propriedades do objeto SQLConnection.

Insira um SQLConnection no formul�rio, clique com o bot�o inverso do mouse e selecione �Edit Connection Properties�. Ser� exibida uma janela mostrando todas as conex�es criadas, permitindo alterar, excluir ou incluir uma nova conex�o.

Clique no bot�o �+� para incluir uma nova conex�o. Na caixa de di�logo, especifique Driver Name como Oracle e Connection Name como SQLMagazine-Oracle. Connection Name � o nome que ser� usado pela DBExpress para referenciar a conex�o. Clique em OK para voltar.

Em seguida, devemos configurar os par�metros da nova conex�o:

DataBase � Nome do Alias configurado no arquivo tnsnames.ora, realizado no in�cio da mat�ria, para conex�o com o banco de dados.
User_Name � Nome do usu�rio para conex�o com o banco.
Password � Senha do usu�rio.

Clique em ok para fechar o editor de conex�o. A configura��o dos objetos para manipula��o dos dados deve ser efetuada da mesma forma como mostrado na edi��o anterior. A aplica��o completa est� dispon�vel para download.

Outra forma de conex�o � atrav�s do ADO (Activex Data Objects) da Microsoft. Como vimos na edi��o anterior, o Delphi disponibiliza um conjunto de componentes para conex�o, acesso e manipula��o de dados utilizando esta API. O componente respons�vel pela conex�o com o banco � o ADOConnection. Assim como na DBExpress, precisamos apenas alterar as propriedades deste objeto, referenciando-o ao client do Oracle. Para isso, clique com o bot�o inverso sobre o AdoConnection e selecione �Edit Connection String�. Na caixa de di�logo, marque a op��o �Use Connection String� e clique em Build.

Na primeira tela do assistente selecione �Microsoft Ole Db provider for Oracle�. Clique em avan�ar e configure os par�metros conforme a listagem:

�Nome do Servidor� - Nome do Alias criado no arquivo tnsnames.ora para conex�o com o banco de dados.
�Nome de usu�rio e senha� - Informa��es de login.
�Permitir Salvamento de Senha� � Para fazer com que a janela de login do ADO n�o seja exibida, marque esta op��o e configure o valor da propriedade LoginPrompt, do AdoConnection, para FALSE.

A configura��o pode ser testada atrav�s do bot�o �Testar Conex�o� ou atrav�s da propriedade Connected do ADOConnection. A Connection String resultante ser�:

Provider=MSDAORA.1;Password=TIGER;User ID=SCOTT;Data Source=SQLMAGAZINE

Ap�s a configura��o do AdoConnection, os passos a serem seguidos s�o os mesmos efetuados na conex�o com o SQL Server. A aplica��o completa est� dispon�vel para download.

Conectando com VB .NET

Vamos explorar duas formas de implementar esta conex�o. A primeira utiliza um driver do tipo OleDB e a segunda utiliza o .NET Provider para Oracle. Ambas precisam do client do Oracle instalado e configurado, como mostrado no in�cio do artigo. A diferen�a entre elas � que o .NET Provider faz acesso direto � OCI.DLL, sendo apenas uma �interface� que traduz as chamadas da aplica��o, garantindo assim maior performance. A OleDb se caracteriza como mais uma camada de procedimentos entre o sistema cliente e a OCI. A vantagem da OleDb � que o c�digo e os componentes utilizados podem ser reaproveitados para a conex�o com outro banco de dados, bastando apenas alterar a refer�ncia ao driver OleDb utilizado. No caso do .NET Provider para Oracle, os componentes s�o espec�ficos, dificultando o reaproveitamento do c�digo para acesso a outros bancos de dados.

Vejamos um exemplo de conex�o OleDb. Para criar esta aplica��o, acesse o menu File\New\Project (figura 2) da IDE do Visual Studio .Net e selecione, na pasta Visual Basic Project, o �cone Windows Application.

Figura 2 � Iniciando um novo Projeto

Uma vez criada a aplica��o utilizaremos os componentes da se��o DATA da ToolBox (figura 3). O componente OleDb de conex�o com o banco de dados � o OleDbConnection (na edi��o anterior utilizamos um SqlConnection). Adicione este componente e, na propriedade Connection String, selecione �New Connection�. A janela de configura��o do ADO que ser� exibida � a mesma apresentada no uso de ADO com Delphi, mostrado na se��o anterior.

Figura 3 � ToolBox

Analogamente aos passos para conex�o com o SQL Server, devemos agora inserir um objeto OleDbDataAdapter (na edi��o anterior utilizamos o SqlDataAdapter). O OleDbDataAdapter � respons�vel pelo gerenciamento das requisi��es e execu��o de comandos INSERT, DELETE e UPDATE. Quando inserimos o componente no formul�rio, um assistente � exibido, de forma semelhante ao componente SqlDataAdapter. A configura��o do assistente deve ser feita da mesma forma como mostrado na edi��o anterior. Na defini��o do comando SELECT, consulte o administrador do banco de dados para saber o nome das tabelas dispon�veis. Um exemplo pode ser visualizado na figura 4.

Figura 4 � Defini��o da Frase SQL que ir� resultar nos dados para o DataSet associado ao DataAdapter

Em seguida, devemos criar um DataSet. Clique com o bot�o direito do mouse no OleDbDataAdapter e selecione a op��o �Generate DataSet�. Na caixa de di�logo, d� um nome para o DataSet e selecione a origem dos dados a serem exibidos, como mostra a figura 5.

Figura 5 � Caixa de Di�logo �Generate DataSet�

Atrav�s do DataSet criado � poss�vel conect�-lo a propriedade DataSource de um componente DataGrid. Para abrir a conex�o com o banco de dados utilizaremos o m�todo Open do OleDbConnection e o m�todo fill do OleDbDataAdapter para �preencher� o DataSet passado como par�metro. Este procedimento foi feito no evento �Form Load�, para garantir que os dados sejam visualizados assim que o form for exibido (figura 6).

Figura 6 � Implementa��o do Evento FormLoad

Utilizando o .NET Framework Data Provider for Oracle (System.Data.Oracleclient)

Outra op��o para acesso � o novo .NET Framework Data Provider for Oracle, lan�ado em Junho de 2002. Por implementar acesso em managed code .NET e utilizar recursos espec�ficos do Oracle atrav�s da OCI, esse provider � mais leve, r�pido e flex�vel do que as classes da OleDbProvider.

As classes do Provider .NET para Oracle est�o dispon�veis no namespace System.Data.Oracleclient, de forma semelhante ao Provider .NET para SQL Server, que est� dispon�vel em System.Data.SqlClient. O Provider pode ser obtido em http://www.microsoft.com/downloads. Uma vez baixado e instalado, este provider deve ser referenciado no VB.NET atrav�s da caixa de di�logo "Add reference", dispon�vel no menu Project->Add Reference.

Veja um exemplo de uso deste provider na listagem 3.

Imports System.Data
 Imports System.Data.OracleClient
  
 Sub Main()
      Dim conn as New OracleConnection() 
      conn.ConnectionString ="data source=SQLM;user id=scott;password=tiger"
      Try
           conn.Open()
           Console.WriteLine("Conectado com sucesso!")
      Catch e as Exception
           Console.WriteLine("N�o foi poss�vel conectar com o Oracle > " & e.Message)
      Finally 
           If conn.State = ConnectionState.Open Then
               conn.Close()
           End If
           conn.Dispose()
      End Try
 End Sub

Listagem 3 � Conectando com o Oracle utilizando o OracleClient Data Provider da Microsoft

O uso do bloco Try..Catch..finally, garante o fechamento da conex�o mesmo se houver algum erro no processamento. Se a conex�o gerar algum erro, a mensagem �n�o foi poss�vel conectar com o Oracle� ser� exibida. O componente utilizado para conex�o � o OracleConnection.

A execu��o de uma instru��o SELECT e a manipula��o do seu resultado � efetuada atrav�s dos componentes OracleCommand e OracleDataReader. A listagem 4mostra um exemplo de uso destes componentes.

Sub UseDataReader()
      Dim conn as New OracleConnection() 
      conn.ConnectionString = "data source=SQLM;user id=scott;password=tiger"
      Dim cmd As New OracleCommand("select * from emp", conn)
      Dim rdr As OracleDataReader
  
      Try
           conn.Open()
           rdr = cmd.ExecuteReader()
           While rdr.Read = True
               Console.WriteLine("empno = {0}, ename = {1}", rdr("empno"), rdr("ename"))
           End While
      Catch e As Exception
           Console.WriteLine(e.Message)
      Finally
           If conn.State = ConnectionState.Open Then
               conn.Close()
           End If
           
           cmd.Dispose()
           conn.Dispose()
      End Try
 End Sub

Listagem 4 � Executando um select no banco de dados

De forma semelhante ao OleDbDataAdapter, o OracleDataAdapter retorna os dados para um �DataSet desconectado� e gerencia as atualiza��es deste DataSet atrav�s do OracleCommandBuilder. O OracleCommandBuilder utiliza os metadados retornados pela instru��o SELECT para montar de forma apropriada os comandos que ir�o aplicar as altera��es no banco de dados. Vide listagem 5.

Sub UseDataSet()
  
 Dim ds As New DataSet()
 Dim da As New OracleDataAdapter("select * from emp", _
           "data source=SQLM;user id=tiger;password=tiger")
 Dim bld As New OracleCommandBuilder(da)
  
 Try
      da.Fill(ds, "emp")
      Dim r As DataRow
      For Each r In ds.Tables(0).Rows
           Console.WriteLine("empno = {0}, ename = {1}", r("empno"), r("ename"))
      Next
  
      ' Altera a linha e executa o update no banco de dados
      ds.Tables(0).Rows(0)(2) = "JONES"
      da.Update(ds, "emp")
  
 Catch e As Exception
      Console.WriteLine(e.Message)
 End Try
 End Sub

Listagem 5 � Executando altera��es no banco de dados

Conectando com Java utilizando JDBC

A Oracle fornece quatro tipos de drivers JDBC: JDBC Thin Driver, JDBC OCI Based Driver, JDBC Server-Side Thin Driver e JDBC Server-Side Internal Driver. Todos utilizam as mesmas APIs, proporcionando flexibilidade e reusabilidade no desenvolvimento de aplica��es com JDBC. Confira as diferen�as entre cada implementa��o:

JDBC Thin Driver: Driver nativo Java, do tipo IV. Utilizado em aplica��es que necessitam ser 100% Java e precisam da combina��o performance + portabilidade. Por ser do tipo IV, n�o necessita da presen�a do client do banco. � o �nico driver dispon�vel para acesso a banco de dados Oracle atrav�s de Applets. Em termos de performance � ligeiramente mais lento do que o OCI Based.
JDBC OCI Based Driver: Baseado no tipo II, este driver utiliza a OCI (Oracle Call Interface), � dependente de plataforma e necessita do client do banco. Se a aplica��o precisa do m�ximo de performance e pode abrir m�o da portabilidade, este � o driver recomendado.
JDBC Server-Side Thin Driver: Possui a mesma funcionalidade do JDBC Thin Driver, com a diferen�a de ser executado dentro do servidor de banco de dados, permitindo o acesso a um servidor Oracle remoto. Quanto o Oracle estiver funcionando como um um middle-tier, acessando um banco de dados em outra m�quina, este driver deve ser utilizado.
JDBC Server-Side Internal Driver: Utilize-o para realizar a conex�o de classes Java, escritas no servidor Oracle, com o pr�prio banco de dados. Um bom exemplo � o uso deste driver em Java Stored Procedures que acessam os dados. Como estes drivers sabem que o c�digo est� no banco eles n�o necessitam abrir explicitamente uma conex�o. Eles tamb�m evitam completamente a lat�ncia devido � rede ou � comunica��o entre processos.

Todos os quatro drivers utilizam a mesma API. Na pr�tica, isso significa reaproveitamento de c�digo se precisarmos modificar o tipo de driver utilizado. Por exemplo, digamos que uma aplica��o cliente-servidor utilize um driver JDBC OCI Based. Caso o desenvolvedor decida migrar parte da aplica��o para dentro do banco de dados, precisar� apenas modificar as linhas que estabelecem a conex�o:

Connection conn = new oracle.jdbc.driver.OracleDriver().defaultConnection();

Da mesma forma, o desenvolvedor poderia decidir migrar a aplica��o para uma applet Java. Neste caso, a �nica modifica��o JDBC necess�ria seria a especifica��o do driver thin em vez do driver OCI-based no string de conex�o.

Um pequeno exemplo

Vejamos um pequeno exemplo que utiliza o JDBC Thin Driver:

import java.sql.*;
 class JDBCExample
 { 
   public static void main(String args[]) throws SQLException
   { 
     DriverManager.registerDriver(new
     oracle.jdbc.driver.OracleDriver());
     Connection conn = DriverManager.getConnection
        ("jdbc:oracle:thin:@sbd:1521:SQLM", "scott","tiger");
     // @nome_do_host:porta:nome_da_inst�ncia
  
     Statement stmt = conn.createStatement();
     ResultSet rs = stmt.executeQuery(�SELECT ENAME, EMPNO, SAL FROM EMP�);
     while (rs.next())
     { 
       String nome = rs.getString(1);
       int numero = rs.getInt(2);
       double salario = rs.getDouble(3);
       System.out.println(nome + � � + numero + � � +salario);
     }
     
     rs.close();
     conn.close();
   }
 }

Na primeira linha indicamos que iremos utilizar o driver da Oracle:

DriverManager.registerDriver(new oracle.jdbc.driver.OracleDriver());

Para maiores informa��es sobre o DriverManager, confira a primeira parte deste artigo.

A pr�xima linha �:

Connection conn = DriverManager.getConnection("jdbc:oracle:thin:@sbd:1521:SQLM", "scott", "tiger");

Esta chamada cria uma objeto que representa uma conex�o com o banco de dados. A string de conex�o � interpretada da seguinte forma:

 �jdbc:oracle:thin� - Indica que utilizaremos um JDBC Thin Driver.

�@sbd:1521:SQLM� - Especifica que a conex�o dever� ser efetuada com a inst�ncia SQLM na m�quina sbd, cujo listener est� na porta 1521. O login ser� efetuado com o usu�rio scott e senha tiger. Como o driver � do tipo IV, devemos passar as configura��es de conex�o atrav�s da aplica��o.

Agora que a conex�o foi estabelecida podemos emitir comandos SQL para o banco de dados:

Statement stmt = conn.createStatement();
 ResultSet rs = stmt.executeQuery(�SELECT ENAME, EMPNO, SAL FROM EMP�);

As �ltimas linhas, rs.close() e conn.close(), encerram a conex�o e a sess�o com o banco.

Conclus�o

Como vimos, a mudan�a do SGBD utilizado n�o afeta muito a forma como a aplica��o ir� manipular os dados, se restringindo a altera��es na implementa��o de conex�o com o banco. � claro que, na vida real, a quantidade de adapta��es na aplica��o pode ser maior, pois os tipos de campos utilizados, o uso de caracter�sticas propriet�rias do banco e o pr�prio comportamento do driver de conex�o podem influenciar na compatibilidade do sistema. No pr�ximo n�mero finalizaremos a s�rie mostrando a conex�o com o MySQL. At� l�!