Revista The Club Megazine - 02/2004

A utilizao, reproduo, apropriao, armazenamento em banco de dados,

sob qualquer forma ou meio, de textos, fotos e outras criaes intelectuais
em cada publicao da revista The Club so terminantemente proibidos
sem autorizao escrita dos titulares dos direitos autorais.
Copyright The Club 2004
 EDITORIAL

Editorial
Ol amigos,

THE CLUB
Av. Celso Ferreira da Silva, 190
Jd. Europa - Avar - SP - CEP 18.707-150
Informaes: (0xx14) 3732-3689
Suporte: (0xx14) 3733-1588 - Fax: (0xx14) 3732-0987
Internet
http://www.theclub.com.br
Cadastro: cadastro@theclub.com.br
Suporte: suporte@theclub.com.br
Informaes: info@theclub.com.br
Dvidas
Correspondncia ou fax com dvidas devem ser
enviados ao - THE CLUB, indicando "Suporte".
Opinio
Se voc quer dar a sua opinio sobre o clube em
geral, mande a sua correspondncia para a seo
"Tire sua dvida".
Reproduo
A utilizao, reproduo, apropriao,
armazenamento em banco de dados, sob qualquer
forma ou meio, de textos, fotos e outras criaes
intelectuais em cada publicao da Revista
The Club so terminantemente proibidos sem
autorizao escrita dos titulares dos direitos
autorais.
Estamos aqui com mais uma edio da The Club Megazine e como sempre,
trazendo dicas e informaes teis ao seu dia-a-dia. Para comear, algumas dicas sobre
o Delphi 8 (Delphi For .Net), o qual estamos testando e trilhando novamente o caminho
das pedras!
Continuando, um artigo sobre a apresentao de relatrios na web, mesclando
Intraweb com Rave Reports, obtendo um resultado bastante interessante. Por falar em
web, apresentamos uma prvia do Delphi 8, para que voc possa conhecer a nova IDE,
componentes, etc, enfim, realmente um novo Delphi!
Nosso amigo Facunte, traz a segunda parte do artigo demonstrando como criar
uma aplicao web com o polmico Intraweb, demonstrando que nem tudo est perdido
e que possvel extrair muita coisa boa dessa ferramenta. Continuando, demonstramos
uma funcionalidade bastante interessante no Rave Reports, onde possvel efetuar
conexes com banco de dados, sem utilizar as engines de conexo do Delphi, com
certeza, esta ferramenta ainda tem muito ser explorada. Devido a muitas solicitaes,
estamos publicando a primeira parte de um tutorial sobre dbExpress, explicando seu
funcionamento e apresentando dicas de como portar aplicaes BDE para dbExpress.
E para encerrar, nossa sesso Perguntas e Respostas, na qual selecionamos
algumas das perguntas que chegaram aos nossos tcnicos, procurando fazer um
intercmbio de informaes entre os associados The Club.
Boa leitura e um timo carnaval todos!

Copyright The Club 2004 Celso Jefferson Paganelli

Presidente - The Club
Impresso e acabamento:
Impressos Gril - Gril Grfica e Repr. Ind. Ltda.
Tel.: (0xx14) 3762.1345 - Fax: (0xx14) 3762.1259
Rua So Paulo, 447 - Cep 18.740-000
Taquarituba - SP
Tiragem: 5.000 exemplares
Editorial ............................................................................ 03
Diretor - Presidente
Dicas & Truques ................................................................. 04
Celso Jefferson M. Paganelli Rave Report com Intraweb ................................................. 05
Uma viso geral do Delphi 8 for .NET................................. 10
Diretor Tcnico
Mauro SantAnna
Retrospectiva .................................................................... 16
Cadastro de Clientes com Intraweb - Parte II ..................... 18
Colaboradores
Emerson Facunte
Rave Report - Conectando banco de dados via Rave .......... 21
Delphi marca registrada da Borland International, as
demais marcas citadas so registradas pelos seus
Migrando aplicaes BDE para dbExpress .......................... 24
respectivos proprietrios.
Perguntas & Respostas ...................................................... 30

MeGAZINE 3
 Dicas & TTruques
ruques

Delphi 8 (For .Net) Como chamar Delphi 8 (For .Net) Requisitos

uma pgina em um nova janela mnimos para rodar...

Neste simples exemplo demonstramos como chamar uma Para voc que deseja instalar o Delphi 8 (For .Net), segue
pgina, porm, abrindo em uma nova janela do browser, abaixo os requisitos mnimos para poder rod-lo:
lembrando que aqui estamos nos referindo a um Asp.Net - Microsoft Windows 2000 (SP2 ou superior recomendado)
Application. - Microsoft Windows XP Professional
- Microsoft Windows Server 2003
Uses -Microsoft Internet Explorer 6.0 SP1 ou superior
Borland.Vcl.SysUtils; -Delphi 8 for .NET requer aproximadamente 225 MB de
procedure TWebForm1.Page_Load( espao em disco para a instalao completa.
sender: System.Object; e: System.EventArgs); -O .NET Framework verso 1.1 requer aproximadamente
var 150 MB de espao em disco.
URL, Opt: String; -O .NET Framework SDK verso 1.1 requer
begin aproximadamente 850 MB de espao em disco.
if not IsPostBack then -Pentium 233 MHz Intel ou superior (recomendado P3,
begin 1Ghz)
URL := QuotedStr(http://www.theclub.com.br); -128 MB RAM (recomendado 512)
Opt := QuotedStr(_new);
btnTheClub.Attributes.Add(
onClick, window.open(+URL+,+Opt+)); Delphi 8 Erro: Unable to attach to
end; ASP.NET worker process (typically aspnet_
end; wp.exe or w3wp.exe)
Caso voc instale o IIS aps a instalao do .Net Framework, e
Para chamar uma pgina sem abrir uma nova janela, utilize tente rodar uma aplicao Asp.Net, ir receber o erro acima, e
o seguinte: para solucionar, basta executar o seguinte comando: c:\windows\
Response.Redirect(index.aspx); microsoft.net\framework\v1.1.4322\aspnet_regiis.exe -i

4 MeGAZINE

Rave Report com IntraWeb
Por Andr Colavite
Neste artigo iremos criar um pequeno projeto IntraWeb onde
geramos alguns relatrios atravs do Rave Report. A
apresentao dos relatrios na Web consiste na possibilidade do
Rave Report gerar arquivos no formato HTML e PDF, pois
iremos utilizar esses recursos para gerar esses arquivos, do
relatrio solicitado, e depois mostr-lo ao usurio no Browse.
Iniciando os trabalhos
Como o assunto principal dessa matria criar o projeto
Intraweb com Rave Report, ento no entrarei nos detalhes da
criao do relatrio. Caso tenha alguma dvida veja matria Application Wizard e clique em Ok.
Figura 1: Criando um novo projeto Intraweb.
MeGAZINE
Delphi
publicada em nossa revista de Janeiro de 2003.
O projeto do Rave utilizado nesta matria estar disponvel
para download atravs do link no final da matria.
Como primeiro passo do projeto, vamos criar um novo projeto
Intraweb no Delphi7.
Para isso selecione o menu File / New e a opo Other.
Selecione a aba IntraWeb e depois escolha a opo Intraweb
Um detalhe importante: Essa opo de criao do
projeto Intraweb, est disponvel no delphi ao qual o
IntraWeb j foi atualizado.
Na prxima janela iremos selecionar a opo
StandAlone Application e no Options iremos
selecionar a opo Create Datamodule, conforme
figura 2.
Neste momento temos um projeto contendo um
IWForm e um DataModule, ambos em branco.
Informaes importantes sobre o projeto do Rave
Report
O projeto do Rave Report que criei foi gerado
utilizando o arquivo Employee.GDB, que vem como
exemplo no Delphi, e para visualizar os dados dentro
do projeto do Rave utilizei um componente do tipo
TRvDataSetConnection chamado
RvDataSetConnection1.
5
 Delphi
Figura 2
Conectando o banco de dados
Mediante essas informaes vamos criar a conexo ao banco
de dados, para isso coloque no Datamodule o componente
SQLConnection e crie a conexo ao GDB. O arquivo
Employee.gdb normalmente fica no seguinte diretrio:
C:\Program Files\Common Files\Borland
Shared\Data\Employee.GDB
As configuraes do SQLConnection ficaro idnticas as
mostradas na figura3.
Figura 3
6 MeGAZINE
O passo seguinte criar a instruo de Select ao
qual nos dar acesso aos dados da tabela Customer.
Sendo assim coloque no Datamodule um componente
SQLQuery e ligue em sua propriedade
SQLConnection o componente SQLConnection1.
Em seguida coloque no datamodule um
componente DataSetProvider, ligue a sua
propriedade DataSet ao componente SQLQuery1 e
em sua propriedade Options altere a opo
poAllowCommandText para True.
Como ltima opo desse acesso aos dados,
coloque no datamodule um componente
ClientDataSet1 e indique na sua propriedade
ProviderName o componente DataSetProvider1 e na
sua propriedade CommandText coloque a seguinte
instruo de Select.
SELECT CUST_NO, CUSTOMER,
CONTACT_FIRST, CONTACT_LAST
FROM CUSTOMER WHERE CUSTOMER LIKE :Letra
Acessando o projeto do Rave Report
Estando com a conexo ao banco de dados criada, iremos
agora fazer as ligaes dos componente do Rave Report. Para isso
coloque no datamodule os componentes RvProject1, RvSystem1 e
RvDataSetConnection1.
No componente RVDataSetConnection1 iremos ligar a sua
propriedade DataSet ao componente ClientDataSet1.
No componente RVSystem iremos alterar as suas
propriedades SystemSetup e
SystemOptions onde desligaremos todas as
opes e na sua propriedade DefaultDest
iremos indicar a opo rdFile.
No componente RvProject no iremos
fazer configuraes neste momento, pois as
suas propriedades sero configuradas via
programao.
Como o nosso projeto ir gerar
arquivos .HTM e .PDF a partir do
resultado do relatrio, ento devemos
incluir tambm no datamodule os
componentes RvRenderHtml1,
RvRenderPDF1 e RvNDRWriter1.
No componente RvNDRWriter1, altere
 Delphi
a sua propriedade StreamMode para o valor smUser.

Neste momento o nosso datamodule est pronto, contendo No IWEdit1 apague o texto da sua propriedade Text.
todos os componentes que iremos utilizar, conforme podemos
observar na figura 4. No IWButton1 iremos configurar a sua propriedade Caption
com o texto: Filtrar
D duplo click sobre o componente IWButton1 e no seu evento
onclick escreva a seguinte instruo:

procedure TIWForm1.IWButton1Click(Sender: TObject);

begin
DataModule1.ClientDataSet1.Close;
Datamodule1.ClientDataSet1.Params.ParamByName(Letra).
AsString := IWEdit1.Text+%;
DataModule1.ClientDataSet1.Open
end;

Neste momento o nosso form ficar igual a figura 5.

Figura 4

Criando o form de chamada do

relatrio
Neste momento iniciaremos a criao do form
onde o usurio visualizar os dados e tambm
poder chamar os relatrios.

Sendo assim visualize o IWForm e dentro dele

coloque os seguintes componentes:
DataSource1
IWDBGrid1
IWLabel1
IWEdit1
IWButton1

Para podermos selecionar na propriedade

DataSet do DataSource1 o componente
ClientDataSet1 que est no datamodule, temos
que declarar na seo implementation da unit a
instruo Uses DatamoduleUnit;
Em seguida visualize novamente o
componente DataSource1 e selecione o
DataModule1.ClientDataSet1 na sua propriedade DataSet.
Figura 5
O prximo componente ser o IWDBGrid onde selecionaremos
Arquivo Relatorio.rav
em sua propriedade DataSource o componente DataSource1.
Uma informao importante, o arquivo Relatrio.rav, que
contem a estrutura do relatrio, foi colocado num subdiretrio
No componente IWLabel1 iremos configurar a sua
chamado files e est sendo indicado na propriedade ProjectFile, do
propriedade Caption com o seguinte texto: Filtrar os Clientes
componente RvProject1, via programao, conforme poder ser
iniciados com:
observado na instrues que iremos criar a seguir.

MeGAZINE 7
 Delphi
Visualizando os relatrios RvProject1.Execute
Nos passos seguintes iremos montar a visualizao do finally
relatrio no formato HTML e PDF. Sendo assim coloque no form RvProject1.Close;
os componentes IWRadioGroup1, IWLabel2, IWButton2 e end;
IWButton3, para assim podermos mostrar na tela a opo para o end;
usurio selecionar em qual formato ser apresentado o relatrio. { Apresenta uma nova janela com o arquivo gerado }
Nesses componentes faremos as seguintes configuraes: AddToInitProc(window.open(/files/
+sArquivo+,,););
IWRadioGroup1, indique na propriedade Items os valores, end;
HTML e PDF.
O prximo exemplo que iremos criar far o mesmo resultado,
IWLabel2, coloque na propriedade Caption o texto, Gerar isso , criar os arquivos .HTML e .PDF mas utilizando para isso
Relatrio em: os componentes RvNDRWriter1, RvRenderHTML1 e
RvRenderPDF1.
IWButton2, coloque na propriedade Caption o texto,
Gerar atravs do RvSystem A seguir poderemos ver as instrues no evento onclick do
IWButton3:
No evento onclick deste componente IWButton2, iremos
incluir as instrues responsveis pela criao e apresentao do procedure TIWForm1.IWButton3Click(Sender: TObject);
relatrio no formato selecionado. var
A criao dos arquivos .HTML e .PDF ser realizada pelos stream: TMemoryStream;
componentes RvSystem1, RvRenderHTML1 e RvRenderPDF1. sArquivo: string;
begin
A seguir poderemos ver as instrues no evento onclick do With DataModule1 do
IWButton2: begin
RvProject1.Engine := RvNDRWriter1;
procedure TIWForm1.IWButton2Click(Sender: TObject); stream:=TMemoryStream.create;
var try
sArquivo: string; RvProject1.ProjectFile:=WebApplication.
begin ApplicationPath+files\Relatorio.rav;
With DataModule1 do RvNDRWriter1.Stream := stream;
begin RvProject1.Open;
if IWRadioGroup1.ItemIndex = 0 then // HTML RvProject1.Execute;
begin sArquivo:=WebApplication.AppID;
sArquivo := WebApplication.AppID+.html; if IWRadioGroup1.ItemIndex = 0 then // HTML
RvSystem1.RenderObject := RvRenderHTML1; begin
end RvRenderHTML1.PrintRender(stream,WebApplication.
else // Formato PDF ApplicationPath+ files\+sArquivo+.html);
begin sArquivo := sArquivo+1.html;
sArquivo := WebApplication.AppID+.pdf; end
RvSystem1.RenderObject := RvRenderPDF1; else // Formato PDF
end; begin
RvProject1.Engine := DataModule1.RvSystem1; sArquivo := sArquivo+.pdf;
RvSystem1.DoNativeOutput := False; RvRenderPDF1.PrintRender(stream,WebApplication.
RvSystem1.OutputFileName := WebApplication. ApplicationPath+files\+sArquivo);
ApplicationPath+files\+sArquivo; end;
RvProject1.ProjectFile :=WebApplication. finally
ApplicationPath+files\Relatorio.rav; RvProject1.Close;
try stream.free;
RvProject1.Open; end;

8 MeGAZINE
 Delphi
end;
{ Apresenta uma nova janela
com o arquivo gerado }
AddToInitProc(window.open(
/files/+sArquivo+
,,););
end;

Observao: Eu recomendo que em

seus projetos utilize apenas uma das
duas formas para trabalhar, pois neste
projeto aps executar essa segunda
forma de criao do arquivo .PDF se
tentarmos executar a primeira forma
novamente ocorre um erro de Access
Violation.

E at o momento no consegui
identificar como resolver este erro, mas
usando apenas uma das duas formas
esse erro no ser gerado.

Aps colocarmos todos os

componentes no form e configura-los o
nosso IWForm ficar parecido com a
figura 6.

Dica importante sobre o Rave

Report
Essa dica bastante importante, pois para o Rave Report
funcionar num projeto chamado por vrias mquinas ao mesmo
tempo, necessrio indicar um DataID para cada projeto, pois
assim no ocorrer conflitos entre as suas execues.
Esse DataID ser definido no arquivo ServerController do
nosso projeto e para isso declare na lista de Uses as units:
RPDefine
Depois dentro do Constructor TUserSession.Create
inclua a seguinte instruo:
Figura 6: IWForm contendo todos os componentes do projeto.
desse projeto, devido a facilidade com que o Rave Report exporta o
relatrio para os formatos desejados. Lembrando que podemos
fazer essas exportaes mesmo em projetos simples que no sero
executados na Web.
Um grande abrao a todos e at a prxima.
Download
O projeto de exemplo deste artigo est disponvel para
download em:

RPDefine.DataID := WebApplication.AppID; http://www.theclub.com.br/revista/download/IWRave.zip

Concluso:
Neste momento estamos com o nosso projeto pronto, basta Sobre o autor
executa-lo para podermos visualizar os relatrios em nosso
navegador atravs dos arquivos .HTML ou .PDF. Andr Colavite
Consultor Tcnico do The Club
Podemos observar que foi bastante simples a montagem colavite@theclub.com.br

MeGAZINE 9
 Delphi

Uma viso geral do Delphi 8 for .NET

Por Claudinei Rodrigues nei@theclub.com.br

O objetivo deste artigo dar-lhe uma viso geral do que voc
encontrar no Delphi 8 for .NET. Mostrar-lhe as novidades desta
nova verso e comentar sobre a migrao de suas aplicaes
desenvolvidas em verso anteriores para o Delphi 8 for .NET.
Uma nova IDE
A caracterstica mais bvia do Delphi 8 for .NET a sua IDE,
como voc pode ver na figura 1. Quem teve a oportunidade de ver
o C# Builder poder notar que ambas as IDEs so iguais e que
so similares a IDE do Microsoft Visual Studio .NET.
Na minha opinio a IDE do Delphi ficou melhor, pois tem um
layout mais limpo e altamente configurvel dando a voc
inmeras opes com respeito a sua configurao.

Figura 1: IDE do
Delphi 8 for .NET

10 MeGAZINE

Qualquer um que j tenha trabalho com o Delphi 7 no ter
dificuldades em trabalhar com esta nova verso. As ferramentas,
opes e as caixas de dilogo so encontradas geralmente com o
mesmo nome ou selees similares do menu.
O editor de cdigo outro local onde voc encontrar o Code
Insight, code templates, o todo list como na verso anterior do
Delphi. Outra similaridade a combinao de teclas e itens do
menu relacionados ao editor de cdigo que continuam as
mesmas. Por exemplo, ao pressionar a tecla F5 possvel incluir
um breakpoint, F9 para rodar a aplicao, F7 para Trace Into e
etc.
Mas existem algumas diferenas. A modificao mais notvel
pode ser encontrada na barra de ferramentas como mostrada na
figura 2, que diferente da palheta de componentes do Delphi 7.
Figura 2: Barra de ferramentas
Os objetos podem ser adicionados ao seu projeto clicando e
arrastando para o seu formulrio. Um recurso interessante a
pesquisa de objetos. Voc pode digitar na caixa de dilogo <Search
Tools> o nome do componente que quer localizar. Este tipo
pesquisa funciona igual ao Component List presente no Delphi 7.
Os objetos so organizados por categoria e podem ser
MeGAZINE
Delphi
expandidos ou ocultados bastando para isto clicar sobre o titulo de
cada categoria. Alm disto, voc pode ir diretamente a uma
determinada categoria clicando sobre o boto Categories e
selecionar a categoria desejada.
A barra de ferramentas sensvel ao contexto, ou seja, ela vai
mostrar apenas aqueles componentes que so apropriados ao tipo
de objeto que voc est trabalhando no momento. Por exemplo, se
voc est trabalhando em um Windows Forms, a barra de
ferramentas mostrar os componentes que voc poder utilizar
neste tipo de formulrio, se voc estiver em um ASP.NET Web
Form, voc ter acesso aos componentes compatveis com este
form.
Inicialmente a barra de ferramentas contm um pequeno,
mas bem escolhida, coleo de objetos que podem ser
configuradas dentro da IDE. Por exemplo, ainda que a verso 1.1
do .NET Framework inclua aproximadamente 4.500 classes
diferentes, a barra de ferramentas tem menos de 100
componentes.
Voc pode adicionar ou remover componentes a partir da
barra de ferramentas. Para isto v at o menu do Delphi e clique
em Components | Installed .NET Components ou clique com o
boto direito sobre a barra de ferramentas e selecione Installed
.NET Components... Isto ir lhe mostrar a caixa de dilogo .NET
Components, como mostrada na figura 3.
Se voc quiser que um determinado componente listado nesta
caixa de dilogo seja includo na barra de ferramentas, basta que
voc clique no checkbox do lado esquerdo ao nome do componente
que ele aparecer dentro da sua categoria. Caso queira remover o
componente basta desmarcar o checkbox.
Como voc deve ter notado aqui tambm que voc instala os
objetos no gerenciados COM e ActiveX que voc quer utilizar em
sua aplicao e tambm os componentes da VCL.NET ( a
biblioteca de componentes visuais para .NET. Mas veremos isto
mais adiante).
Os cdigos no gerenciados em DLLs tambm podem ser
utilizados no Delphi 8 para aplicaes .NET, mas eles so
acessados utilizando uma tcnica diferente.
Outro aspecto da IDE que est um pouco diferente so as
vrias opes de caixas de dilogo, incluindo as caixas de dilogo
Options e Project Options.
Neste caso a interface est um pouco diferente, um treeview
do lado esquerdo da caixa de dilogo mostra as categorias ao
11
 Delphi

Figura 3:
Componentes
.NET instalados

Figura 4: Caixa de
dilogo Options

invs da interface utilizando o tabbed notebook das verses

anteriores. Os vrios itens dentro destas caixas de dilogo Outra nova caixa de dilogo o Data Explorer, como voc
tambm so familiares. pode ver na figura 5. Esta caixa de dilogo fornece a voc um
excelente visualizador para verificar as conexes disponveis
Veja a caixa de dilogo Options na figura 4. usando o Borland Data Providers ou BDP.NET. A partir desta

12 MeGAZINE

caixa de dilogo voc pode arrastar as tabelas, views ou stored
procedures para qualquer WinForm ou WebForm.
Figura 5: Data Explorer
O interessante desta nova verso do Delphi que ele permite
que voc desenvolva em WebForm de forma muito similar ao
trabalho com WinForms e VCL.NET, permitindo assim construir
pginas Web com uma interface visual. Veja a seguir como criar
aplicaes Windows Forms, ASP.NET Web Forms e VCL Forms.
Windows Forms
Use Windows Forms para criar aplicaes nativas Windows
que rodem em ambientes gerenciados. Voc usa classes .NET
para construir clientes Windows que oferecem duas grandes
vantagens. Ele permite que voc utilize caractersticas no
disponveis para clientes do browser.
O Windows Forms combina o melhor dos dois mundos,
apresentando um modelo de programao que tira vantagens de
um unificado .NET Framework e do rico GUI do Windows. Voc
usa controles do Windows como botes, listbox, caixas de texto
para criar suas aplicaes. Para acessar Windows Forms, v at
o menu do Delphi 8 for .NET e clique em File | New | Windows
Forms Application.
MeGAZINE
Delphi
ASP.NET Web Forms
Use o ASP.NET Web Forms para criar aplicaes que podem
ser acessadas por qualquer Web browser em qualquer
plataforma. Voc usa as classes .NET para criar uma aplicao
ASP.NET. O form consiste de uma representao visual de um
HTML e um arquivo de cdigo. Para acessar ASP.NET Web
Forms, v at o menu do Delphi 8 for .NET e clique em File |
New | ASP.NET Web Application.
VCL Forms
Use VCL Forms para criar aplicaes que usam componentes
VCL.NET para rodar no .NET Framework. Voc usa o Borland
Visual Component Library for .NET para criar uma aplicao
VCL Form. Os VCL Forms so especialmente teis se voc quer
passar uma aplicao j existente contendo controles VCL para o
ambiente .NET ou se voc j est familiar com o VCL e prefere
us-lo.
Para acessar VCL Forms, v at o menu do Delphi 8 for
.NET e clique em File | New | VCL Forms Application.
Facilidade no desenvolvimento Web
Quando voc arrasta um componente para um WebForm o
Delphi gera o cdigo HTML correspondente, inserindo-o a um
arquivo com a extenso .ASPX associado com o WebForm.
Igualmente se o componente um que tem controle de eventos
como por exemplo, um Button, o Delphi adiciona a classe
referente classe WebForm no editor de cdigo, que o arquivo
que contm as instrues Delphi que sero executadas no
servidor. Veja na figura 6 um exemplo de WebForm em tempo de
design.
Suporte total ao .NET
Diferente do Borland C# Builder, o qual usa o compilador
Microsoft C# sob licena, o Borland Delphi 8 for .NET utiliza um
novo compilador .NET da Borland.
Quando voc compila um projeto feito em Delphi 8 for .NET,
este novo compilador usa o Microsoft Intermediate Language
(MSIL), uma CPU independente de instrues que so
convertidas para o cdigo nativo, normalmente por um
compilador em tempo de execuo (Just-in-Time). Este MSIL
equivalente ao qual gerado por qualquer compilador Microsoft
incluindo aqueles para o C# e o Visual Basic .NET.
Por causa do Delphi 8 incluir uma linguagem completa
.NET, ele tem acesso ao .NET Framework Class Library (FCL),
uma abrangente classe de bibliotecas, tipos e smbolos que
constituem o .NET equivalente a VCL do Delphi. As classes do
FCL fornecem um extensivo suporte para acesso a dados
(ADO.NET), WebForms (ASP.NET e Web Services), WinForms
13
 Delphi
Figura 6: WebForm em tempo de design
(desenvolvimento GUI Windows), desenvolvimento XML e muito
mais.
Alm disso, os desenvolvedores que utilizam o Delphi 8 .for
NET tem acesso transparente a qualquer classe pblica
declarada em legtimo ambiente .NET. Isto significa que todos os
componentes de terceiros .NET sero facilmente acessados pelo
Delphi 8 for .NET sem levar em considerao a linguagem a qual
ele foi desenvolvido.
Para acomodar muitas das caractersticas do .NET, a
Borland introduziu um significativo aprimoramento a linguagem
Delphi. Isto inclui a edio de atributos (declaraes descritivas
que so usadas para identificar as caractersticas dos elementos
programticos), unit namespaces, overloading de operadores, e
nova visibilidade de identificadores. Por exemplo, declaraes de
classes agora suportam visibilidade private e protected.
O que nos chama a ateno sobre este aprimoramento na
linguagem que, segundo a Borland, estas novas caractersticas
14 MeGAZINE
tambm sero adicionadas em futuras verses do compilador
Delphi Win32. Isto ser feito para assegurar que o seu cdigo
continue compatvel com os vrios compiladores da linguagem
Delphi.
Indo alm do .NET FCL
Ainda que o Delphi 8 for .NET fornea total suporte para o
FCL, ele vai bem mais alm, tornando a linguagem Delphi uma
soluo atrativa para o desenvolvimento .NET. A Borland incluiu
no Delphi 8 for .NET um numero de tecnologias que estendem e/
ou complementam o FCL. A Borland refere-se a estas tecnologias
como Borland Data Providers (BDP.NET), RTL.NET, VCL.NET,
dbExpress.NET, IBX.NET, DataSnap.NET e BDE.NET.
Estas duas primeiras tecnologias, BDP.NET e RTL.NET,
podem ser usadas em padres WinForms, WebForms e aplicaes
console .NET que empregam o FCL. O BDP.NET um conjunto
de classes concretas que implementam o ADO.NET usado para
acesso a dados. Estas classes diferem de suas correspondentes no
FCL porque elas fornecem uma soluo portvel para acesso a

uma variedade de bancos de dados diferentes incluindo o MSSQL
Server, Interbase, Oracle e DB2. Note que o BDP.NET est
disponvel apenas nas verses Enterprise e Architect do Delphi 8
for .NET.
O RTL.NET uma verso da biblioteca de runtime do Delphi,
uma coleo de funes e procedures puras (e suas constantes,
variveis e tipos associadas) que voc pode usar a partir do seu
cdigo. O RTL.NET mantm uma estreita compatibilidade com o
cdigo fonte das verses Win32 do Delphi, tornando mais fcil o
caminho de migrao do seu cdigo existente Win32 para o .NET,
e tambm permitindo a voc escrever rotinas que so facilmente
compiladas sob a plataforma de sua escolha.
Na minha opinio, a presena do RTL.NET fornece um
argumento convincente para usar o Delphi como sua linguagem
preferida para o .NET. O RTL.NET inclui literalmente centenas
de rotinas proveitosas incluindo aquelas das units
Borland.VCL.SysUtils, Borland.VCL.StrUtils,
Borland.VCL.DateUtils e Borland.VCL.Math.
Outra tecnologia da Borland, o DB Web
Controls for ASP.NET, est disponvel para voc
usar na construo de WebForms. Eles so
componentes visuais Web data-aware que voc
pode usar com o ADO.NET ou BDP.NET para
criar aplicaes Web de forma rpida e simples.
As tecnologias que foram mencionadas
anteriormente nesta seo foram desenvolvidas
para facilitar o processo de migrao de aplicaes
Win32 para .NET. Estas tecnologias podem ser de
um modo geral comentada como VCL.NET, com
dbExpress .NET, IBX.NET, DataSnap .NET e
BDE.NET sendo subconjuntos da tecnologia
VCL.NET.
VCL.NET um conjunto de componentes que
fornece um extensivo cdigo de compatibilidade entre o Delphi
Win32 e o Delphi for .NET. As classes e tipos disponveis na
VCL.NET representam um rico sub-conjunto da VCL Win32.
Alm disto, estes tipos e classes ostentam interfaces que so
essencialmente idnticas as contidas na VCL, permitindo a voc
criar facilmente simples projetos que podem ser compilados tanto
na plataforma .NET quanto na Win32, alm de fornecer uma
enorme simplicidade na migrao para o .NET. Se uma de suas
aplicaes j existentes usa componentes comuns da VCL do
Delphi como Edits, Labels, DBGrids, Menus, voc pode
simplesmente abrir o seu projeto no Delphi 8 for .NET e compil-
lo.
MeGAZINE
Delphi
Por exemplo, se voc tiver instalado o Delphi 8.NET e o Delphi
7 na mesma mquina, use o Delphi 8 para abrir o projeto
ConvertIt que est localizado ..\Demos\ConverIt no Delphi 7.
Pressione F9 para compilar e rodar o projeto. O projeto ser
compilado sem nenhum problema.
Quanto ao dbExpress.NET, IBX.NET, DataSnap.NET e o
BDE.NET estes so implementaes .NET associadas as classes
VCL para acesso a dados. Como qualquer outra parte da VCL,
estas classes fornecem um caminho de atualizao para o .NET
para a maioria da aplicaes com acesso a dados existentes. Aqui
voc encontrar classes como TSqlDataSet, TIBConnection,
TClientDataSet, TDataSetProvider, TDCOMConnection,
TDataSource e at TTable.
Veja a figura 7. Ela mostra o projeto FishFact.dpr que pode
ser encontrado em ..\Demos\DB\FishFact localizado no Delphi
7. Ao compilar no Delphi 8 este projeto ser uma aplicao
VCL.NET que utiliza o BDE.NET para acessar a tabela Paradox.
Igual ao projeto ConverIt, basta abrir o projeto e compil-lo.
Figura 7: Projeto Fish Facts
Concluso
Espero ter concludo o objetivo deste artigo que era dar uma
viso geral sobre o Delphi 8 for .NET. claro que existe muita
coisa nova e pretendo descrev-las nas prximas edies de nossa
revista. Ento at l.
Sobre o autor
Claudinei Rodrigues,
Consultor Tcnico do The Club
nei@theclub.com.br
15
 Retrospectiva

Retrospectiva

Na nossa retrospectiva, estamos no ano de 1997. Um ano de

expectativas, com o amadurecimento do Delphi j na sua terceira
verso.

Na revista de Setembro de 1997, destaca-se entre outros

assuntos o artigo sobre como criar e exportar mtodos do Delphi
para uma DLL, um artigo bem detalhado que no deixava dvidas
para quem necessitava usar este recurso.

Tambm tivemos um artigo sobre OLE, onde ensinamos como

controlar um aplicativo a partir de uma aplicao Delphi.

Em 1997 o Clipper ainda caminhava com fora total, e tivemos

alguns artigos em nossa revista, como a quinta parte de uma srie
onde estvamos ensinando os programadores a fazer suas
aplicaes funcionando em rede, que sempre foium desafio para
alguns programadores.

No ms que vem estaremos em 1996. Nossa restrospectiva ir

aumentar de tamanho e tambm relembrar mais assuntos, pois
este foi um ano mgico para todos ns. Aguardem!
16 MeGAZINE
 Delphi

Cadastro de Clientes com Intraweb

Parte II
Por Emerson Facunte

Salve, salve Delphi People!
Chegamos na segunda parte de nossa trilogia. Neste artigo
iremos desenvolver o formulrio de alterao de clientes, e de
quebra vocs iro aprender algumas tcnicas interessantes da
tecnologia IW.
Altere a propriedade Name do formulrio para FmAltera e
BackGroundColor para $00DDFFFF. .
Grave a unit com o nome un_alteracao.
Insira os componentes que seguem no FmAltera..

Recentemente publiquei um artigo sobre a saudvel disputa

entre as tecnologias WebBroker e Intraweb. Alguns entenderam
minha mensagem: utilizem Intraweb com moderao!. Sugiro
que aplicaes baseadas em IW sejam direcionadas para
pequenos e mdios grupos de usurios; algo em torno de 20, ou
at 30 no mximo. Pensem nisso!

Continuando com o nosso artigo, vamos criar o formulrio de

alterao.

Criando o Formulrio de Alterao

Atravs das opes File/New/Other..., selecione a seo
Intraweb e escolha o modelo Application Form (figura 1).

Figura 1 Criando um novo formulrio

18 MeGAZINE
 Delphi

Agora vamos codificar o formulrio.

Insira a unit DataModuleUnit (criada no primeiro artigo) na clusula

uses do formulrio.

uses
ServerController, DatamoduleUnit;

No evento OnClick do objeto btDesiste insira o cdigo que segue:

Hide;

Para que possamos retornar ao formulrio de origem,

utilizamos o mtodo Hide do formulrio.

Agora vamos codificar o evento OnClick do objeto btConfirma.

try

{Altera Cliente}
with DataModule1.SQLAltera do
begin
ParamByName(pcodigo).Value:=StrtoInt(lbCodigo.Text);
ParamByName(prazao).Value:=edRazao.Text;
ParamByName(pendereco).Value:=edEndereco.Text;
ParamByName(pcidade).Value:=edCidade.Text;
ParamByName(pestado).Value:=edUf.Items[edUf.ItemIndex];
ParamByName(pcep).Value:=edCep.Text;
ParamByName(pemail).Value:=edEmail.Text;
ExecSQL;
end;

WebApplication.ShowMessage(Cliente alterado com

sucesso,smSameWindow);

except
WebApplication.ShowMessage(Houve um problema na

MeGAZINE 19
 Delphi
alterao do cliente, smSameWindow);
end;
Hide;
Vamos analisar o cdigo.
Nesta primeira parte, iniciamos um bloco protegido.
try
Em seguida, estamos atribuindo parmetros ao objeto
SQLAltera do DataModule1.
{Inclui Cliente}
with DataModule1.SQLAltera do
begin
ParamByName(pcodigo).Value:=StrtoInt(lbCodigo.Text);
ParamByName(prazao).Value:=edRazao.Text;
ParamByName(pendereco).Value:=edEndereco.Text;
ParamByName(pcidade).Value:=edCidade.Text;
ParamByName(pestado).Value:=edUf.Items[edUf.ItemIndex];
ParamByName(pcep).Value:=edCep.Text;
ParamByName(pemail).Value:=edEmail.Text;
E finalmente executando a operao e apresentando a
mensagem de sucesso na operao.
ExecSQL;
WebApplication.ShowMessage(Cliente incluido com
sucesso,smSameWindow);
figura 2 Formulrio alterao de clientes
20 MeGAZINE
Em caso de erro, estamos criando o bloco except.
except
WebApplication.ShowMessage(Houve um problema na
incluso do cliente, smSameWindow);
end;
E apresentando a mensagem do problema.
Embora o Intraweb forneca o objeto com conexo direta a
DataSets, estamos utilizando os objetos convencionais, sem
nenhum vnculo com DataSet. Quando trabalhamos com Internet,
complicado disponibilizar objeto de conexo direta com DataSets,
justamente porque no sabemos o que poder ocorrer com a
conexo.
Sugiro adotar este modelo de desenvolvimento pela
segurana.
Ento, para que nossos campos sejam preenchidos
automaticamente com as informaes do banco de dados, vamos
utilizar o TDataSource e TSQLDataSet.
Pronto, agora conclumos o nosso
formulrio de alterao de clientes.
A figura 2 ilustra o nosso formulrio.
Sobre o autor
Emerson Facunte Consultor de
Tecnologia com diversos livros
publicados, especialista em
desenvolvimento de aplicaes e-
business utilizando a ferramenta
Delphi, baseado em webSnap,
dataSnap, BizSnap e ISAPI/Apache
Modules.
Emersonf@livrariasaraiva.com.br
 Delphi

Rave Report
Conectando banco de dados via Rave

Por Alessandro Ferreira (alessandro@theclub.com.br)

Introduo

O Rave Report um poderoso

gerador de relatrios baseado em
projetos de relatrio que alm de
inmeros recursos interessantes,
possui objetos de acesso a banco de
dados independentes dos objetos do
Delphi, inclusive com gerador de
consultas SQL.

Provendo acesso a dados

Primeiro, adicione um componente

RvProject ao seu formulrio e d um
duplo clique no mesmo para acessar o
Rave Visual Designer (Figura 1).

Agora clique no boto New Data

Object e selecione Database
Connection e clique em Next (Figura
2)
Figura 1
Agora escolha a tecnologia de acesso atravs da qual o acesso
ser feito ao seu banco de dados, podendo optar por:

ADO
BDE
DBX (dbExpress)

No nosso exemplo iremos utilizar BDE, e clique em Finish Figura 2

MeGAZINE 21
 Delphi
para finalizar. Aps isso, lhe ser apresentado o Query Advanced
Designer, atravs do qual poder selecionar a(s) tabela(s) e
O prximo passo ser escolhar um Alias existente no BDE campos serem impressos, bastando selecionar a tabela na lista
para o acesso nossas tabelas, como mostra a figura 3 e clicar e arrastar a tabela a aba layout. (Figura 6)
em OK para finalizar.

Figura 3
Observe no Treeview de objetos (lado direito do rave visual
designer) que um novo objeto foi adicionado, com o nome de
Database1. (Figura 4)
Figura 6
Aps selecionar a(s) tabela(s) e campos desejados, clique em
OK para finalizar.
Bem, agora j temos nosso DriverDataView com os campos
que selecionamos, como mostra a Figura 7.

Figura 4
Bem, com isso j temos a nossa conexo estabelecida com o
banco de dados.
Figura 7
Agora faremos o acesso a(s) tabela(s) referente nosso Alias.
Mais uma vez, Para concluir o relatrio, adicione um componente Region
clique no boto (aba Report) e sobre ele um DataBand (tambm da aba Report)
New Data ajustando sua propriedade DataView para DriverDataView1.
Object e Para adicionar os campos banda, bastar pressionar a tecla
selecione CTRL, clicar e arrastar o campo sobre a banda.
Driver Data
View, conforme Salve o projeto Rave (menu File | Save).
mostra a figura
5 e clique em Chamando o Relatrio via Delphi
Next...
selecione o Selecione o componente RvProject e selecione o projeto Rave
Database1 e na propriedade ProjectFile do mesmo.
Finish para
finalizar. Figura 5 Para executar, poder utilizar:

22 MeGAZINE

RvProject1.ExecuteReport(Report1);
IMPORTANTE: Para que a conexo com o banco de dados seja
estabelecida sem a necessidade de componentes do Delphi, declare a seguinte unit
na lista de uses de sua unit:
Delphi
bastante flexibilidade ao desenvolvedor. Aos poucos iremos
explorando todos os recursos disponveis nesta boa ferramenta,
contudo, a verso que acompanha o Delphi no disponbiliza este
tipo de funcionalidades ao usurio final, isso est disponvel
apenas nas verses compradas do Rave.

rvDlbde = conexo BDE Sade e sucesso todos,

rvdldbx = conexo dbExpress []s,
rvDlAdo = conexo ADO Alessandro Ferreira

Na pasta \Delphi7\Rave5\DataLinks encontrar trs Download

arquivos correspondentes as units acima, que devero ser
copiados para uma pasta em path (exemplo \Windows\System) O projeto de exemplo demonstrado neste artigo est
conforme a conexo utilizada, sendo eles: disponvel para download em: http://www.theclub.com.br/revista/
download/RaveConnection.zip
DataLinkBDE.rvd = conexo BDE
DataLinkDBX.rvd = conexo dbExpress Sobre o autor
DataLinkADO.rvd = conexo ADO
Alessandro Ferreira,
Concluso Consultor Tcnico do The Club
O Rave Report um poderoso gerador de relatrios e oferece alessandro@theclub.com.br

MeGAZINE 23
 Delphi
Migrando aplicaes BDE para dbExpress
Parte 1
Recursos & Arquitetura Provider/Resolver
Alessandro Ferreira, alessandro@theclub.com.br
Borland dbExpress Conectividade e
Simplicidade
Muitas tentativas j foram feitas em relao a se criar um
conjunto de APIs comuns para acesso a mltiplos bancos de
dados. Grandes progressos foram realizados, contudo, alguns
mecnismos reduziam a performance, eram difceis de utilizar,
complexos na implementao de drivers ou apresentavam bugs.
Pensando nisso, a Borland desenvolveu a arquitetura
dbExpress, a qual combina vrias funcionalidades baseadas em
interfaces que permitem transparncia ao programador final e
ao mesmo tempo certa facilidade aos desenvolvedores de drivers
para comunicao com os mais diversos banco de dados.
A dbExpress baseada na consagrada arquitetura
Provider/Resolver da Borland, a qual permite timo desempenho
e escalabilidade no acesso e manuteno de dados e sobre essa
arquitetura que iremos tratar neste artigo, focando
principalmente o processo de migrao do BDE para dbExpress.
A arquitetura dbExpress
A princpio, o dbExpress foi projetado com seis metas
principais:
Minimizar o consumo de recursos de sistema
Maximizar a performance
Suporte cross-plataform
Simplificar o desenvolvimento
Facilitar o desenvolvimento de novos drivers
Permitir ao programador otimizar o consumo de memria e
trfego em rede
24 MeGAZINE
Os drivers dbExpress conseguem ser pequenos e rpidos
porque eles provem apenas as funcionalidades que realmente
so necessrias e nada a mais! Cada driver consiste em apenas
uma DLL (plataforma Windows) e um shared object library
(plataforma Linux). Basicamente, podemos resumir os
mecnimos em cinco interfaces que possibilitam extrair
metadatas, executar instrues SQL e stored procedures, e
retornar conjunto de dados (cursores) uni-direcionais do tipo
somente leitura. Porm, se trabalharmos em conjunto com os
componentes DataSetProvider e ClientDataSet, os quais
permitem implementar a estratgia Provider/Resolver da
Borland, a dbExpress constitui-se em um poderoso mecnismo de
obteno e manuteno de dados onde destacam-se a alta-
performance e um excelente sistema de concorrncia para se
trabalhar com SGDBs.
Como funciona o mecnismo Provider/Resolver
O mecnismo Provider/Resolver na dbExpress composta
pelo trabalho conjunto de alguns componentes, sendo o primeiro o
SQLConnection, o qual responsvel em prover a conexo ao
driver dbExpress e este por sua vez conversar com o banco de
dados que voc est utilizando. O prximo componente um
TDataSet dbExpress, como exemplo o SQLDataSet, sendo este
responsvel em prover os dados mediante uma instruo SQL ou
executando um Stored Procedure disponvel no banco de dados. O
terceiro componente o DataSetProvider e o quarto componente
um ClientDataSet. Quando voc ativa o ClientDataSet, este
requisita os dados ao DataSetProvider. O DataSetProvider por

sua vez, abre a consulta ou stored procedure, recupera os
registros e fecha a consulta ou stored procedure e armazena este
resultado no ClientDataSet que solicitou a mesma.
O ClientDataSet armazena os registros em um cache local,
atravs do qual iremos adicionar, alterar e excluir registros.
Assim sendo, todas as operaes que efetuamos ficam
armazenadas neste cache local e para que possamos envi-las
ao banco de dados teremos que chamar o mtodo ApplyUpdates, o
qual envia o change log ao DataSetProvider. O provedor
(DataSetProvider) inicia ento uma transao e dentro da
mesma cria e executa instrues SQL para aplicar as mudanas
ao banco de dados. Se todas as instrues forem executadas sem
erros, o provedor efetua um commit na transao, caso
contrrio, efetua um rollback. Alguns exemplos de erros que
podero ocorrer durante este processamento seriam a violao de
chaves estrangeiras, violao de regras de negcio definidas em
triggers, campos obrigatrios que no foram preenchidos, ou
mesmo, registros (campos) diferentes desde a ltima leitura
efetuada pelo DataSetProvider. No caso de erros, alm da
transao sofrer um rollback, automaticamente ser acionado o
evento OnReconcileError do ClientDataSet, atravs do qual possvel
implementar o tratamento e apresentao dos erros ao usurio.
Um detalhe importante que os erros somente sero reportados
este evento e se voc no possui nenhuma linha de cdigo no
mesmo, nenhuma mensagem de erro ser apresentada, mesmo
que a atualizao no tenha sido efetuada com sucesso.
Benefcios do mecnismo Provider/Resolver
Transaes com vida curta
Transaes abertas por muito tempo foram o servidor de
banco de dados a manter registros travados o que reduz a
concorrncia e consome recursos do servidor de banco de dados.
J com o mecnismo Provider/Resolver, as transaes so
exigidas apenas no momento em que as atualizaes forem
realmente aplicadas, ou seja, quando chamarmos o mtodo
ApplyUpdates. Isso reduz drasticamente a utilizao de recursos
e melhora a concorrncia em um servidor de banco de dados, o
qual normalmente j trabalha no limite.
Editando dados de qualquer fonte
Por padro, no podemos editar diretamente registros
retornados por instrues SQL que contenham joins, unions e
stored procedures, pois estas normalmente vm como somente
leitura.
Contudo, trabalhando dentro do mecnismo Provider/
Resolver isso perfeitamente possvel e simples de ser feito, claro
que, com alguns pequenos ajustes.
MeGAZINE
Delphi
Ordenao e Pesquisas instantneas
Como o ClientDataSet trabalha com os registros em
memria, possvel fazer ordenaes por qualquer um dos
campos disponveis no mesmo, isso de forma rpida. Contudo, se
uma ordenao estiver um pouco lenta, voc poder criar ndices
em modo de design ou mesmo em run-time. Estes ndices in-
memory permite a ordenao e localizao de registros de forma
instantnea sem que haja necessidade de efetuar chamadas ao
servidor de banco de dados.
Sumarizao automtica de dados
ClientDataSets possibilitam criar complexos sumrios de
dados automaticamente, como por exemplo a totalizao de
campos, permitindo o uso das funes Sum(), Count(), Avg(),
Min() e Max(). Voc pode agrupar sumrios por qualquer campo
ou combinao de campos, provendo assim totalizaes por grupo,
tudo em conjunto com as funes acima e os ndices mencionados
anteriormente.
Filtrar sub-conjuntos de dados
O ClientDataSet possibilita utilizar como expresses em
filtros a mesma sntaxe SQL WHERE que utilizamos em
instrues SQL, contudo, esta filtragem feito em cima da
visualizao local dos dados, sem fazer requisio ao servidor de
banco de dados. Com isso, podemos dizer que possvel efetuar
um Select em cima de outro Select.
Visualizaes mltiplas de dados
Podemos literamente clonar os dados de um ClientDataSet e
dessa forma apresentar visualizaes diferentes dos mesmos
dados simultneamente.
Campos calculados locais
Voc pode criar campos calculados em um ClientDataSet em
modo de design, utilizando os mesmos para computar conjntos de
dados em memria, conseguindo dessa forma resultados bem
mais complexos do que se estivesse utilizando instrues SQL,
alm do que, estas estariam fazendo chamadas ao servidor de
banco de dados e poderiam ser mais lentas, alm de consumirem
recursos do servidor.
Com quantos registros posso trabalhar no cache?
A princpio no existe uma limitao, ficando esta a cargo dos
recursos disponveis na mquina. Como sabemos, no
aconselhvel trazer um grande volume de registros em ambiente
Client/Server devido ao trfego gerado na rede, sem contar na
performance que no ser nada agradvel. Contudo, o
25
 Delphi
DataSetProvider e o ClientDataSet possuem mecnimos que
possibilitam trazer registros retornados por uma consulta SQL
em pacotes de N registros, utiliz-los, descart-los e trazer um
novo pacote de registros, permitindo assim trabalhar com um
grande volume de dados balanceando o trfego em rede e
otimizando a performance.
Desenvolvimento Simplificado
Uma aplicao que utiliza dbEpxress requer apenas duas
DLLs para rodar. A primeira o driver do dbExpress, o qual ir
fazer acesso ao SGDB, como por exemplo a DBEXPINT.DLL no
caso do Interbase/Firebird. A segunda a MIDAS.DLL, sendo
esta ltima a responsvel pelo ClientDataSet. Juntas estas DLLs
somam 1,5 MB de tamanho! Com certeza, isso minimiza o
tamanho da aplicao e simplifica sua distribuio e instalao.
Se voc preferir no distribuir estas DLLs, voc poder
compilar diretamente suas units correspondentes e com isso tudo
ficar embutido no prprio executvel. Utilizando o Kylix/Linux,
o desenvolvimento idntico, exceto pelo fato de no utilizarmos
DLLs e sim dois shared object libraries.
Facilidade na criao de novos drivers
Basicamente, a implementao de um drive para a
arquitetura dbExpress consiste na implementao de cinco
interfaces que esto documentadas no help do prprio Delphi.
Para facilitar, a Borland disponibilizou gratuitamente o cdigo
fonte do driver MySQL para ser utilizado como modelo. Assim,
torna-se ainda mais fcil para desenvolvedores de bancos de
dados implementarem drivers que ofeream alto-desempenho e
confiabilidade. Contudo, caso o banco de dados que voc utilize
no possua nenhum driver no mercado, voc poder se
aventurar no desenvolvimento de seu prprio driver.
Prova disso o projeto Open-Source Unified Interbase, o
qual disponibiliza drivers para dbExpress escritos em Delphi
para conexo com os bancos: Firebird 1.0.2, Firebird 1.0.3,
Firebird 1.5, Interbase 6, Interbase 6.5, Interbase 7, Interbase
7.1 e Yafill (uma variante do Interbase), e o melhor, tudo
gratuto e com cdigo fonte aberto, maiores informaes em:
http://www.progdigy.com/UIB/.
Desenvolvendo uma aplicao utilizando
dbExpress
Antes que voc comece a migrar suas aplicaes BDE para
dbExpress, voc precisa primeiramente estar familiarizado com
os componentes que compe a dbExpress e o mais importante,
como utiliz-los. Neste tpico iremos criar passo a passo uma
pequena aplicao utilizando dbExpress, descrevendo cada
26 MeGAZINE
componente e como utiliz-lo. Iremos implementar o exemplo
utilizando o Delphi 7, contudo, os passos aqui utilizados sero
idnticos para quem trabalha com Kylix na plataforma Linux.
Nesta aplicao exemplo iremos utilizar banco de dados
Interbase/Firebird, aproveitando o banco EMPLOYEE.GDB que
disponibilizado aps a instalao do IB/FB, onde poderemos
encontrar tabelas demonstrando relacionamentos, e outras
situaes triviais em um banco de dados. A aplicao exemplo ir
abordar as seguintes situaes na dbExpress:
NestedDataSets, tabela detalhe contida em um campo da
tabela master
Editando dados com SQLQuery/SQLDataSet,
DataSetProvider e ClientDataSet
Aplicando as atualizaes guardadas em cache do
ClientDataSet ao banco de dados
Interceptando erros que podero ocorrer ao aplicar os dados
ao banco de dados
O componente SQLConnection
A criao de uma aplicao utilizando dbExpress bem
simples.
Vamos comear por configurar a conexo e a este ponto e pelo
nome sugestivo voc j sabe que iremos utilizar o componente
SQLConnection para isso, seguindo os seguintes passos:
1. Crie uma nova aplicao, File | New | Application e
adicione um DataModule mesma, ajustando seu nome para
MainDm.
2. Acesse o menu Project | Options e ajuste na lista Auto-
Create Forms deixe como primeiro objeto ser criado o nosso
MainDm.
3. Adicione um componente SQLConnection (palheta
dbExpress) ao MainDm;
4. Configure o nome do SQLConnection para
EmployeeConnection, e a propriedade DriverName para
Interbase;
5. Agora o editor de propriedades referente a propriedade
Params e configure os seguintes parmetros: Database: com o path
e o nome do arquivo GDB.
6. Altere os parmetros UserName e Password caso estejam
diferentes do que est configurado em seu servidor IB/FB;
7. Configure a propriedade LoginPrompt para False para que
no seja solicitado novamente usurio e senha;
8. E finalmente, ative alterando a propriedade Connected para
True;

Voc poder utilizar um nico componente SQLConnection
independente do nmeros de componentes datasets que venha
utilizar. Poder ainda, caso haja necessidade ter vrios
componentes SQLConnection para conectar-se a bancos
diferentes simultneamente sem problemas! Para definir a
conexo, poder ter as configuraes definidas atravs da
propriedade Params, conforme mencionado anteriormente,
efetuar as configuraes todas em run-time, ou ainda,
armazenar as configuraes em um arquivo INI e carreg-las
dinmicamente.
O Editor de Conexes dbExpress
Para criar uma nova conexo, bastar dar um duplo-clique
no componente SQLConnection para abrir o editor de conexes,
onde sero apresentadas todas as conexes disponveis, alm
claro da possibilidade da criao de uma nova conexo. Todas as
conexes criadas atravs deste editor ficam armazenadas em um
arquivo chamado dbxConnections.ini.
Vale ressaltar, que quando criamos conexes
nomeadas podemos defin-las atravs da propriedade
ConnectionName do SQLConnection e com isso precisamos
distribuir o arquivo INI (contendo as informaes sobre nossa
conexo) junto com a aplicao.
Algumas funcionalidades do SQLConnection
O componente SQLConnection prov vrias funcionalidades,
entre as quais destacamos o controle de transaes atravs dos
mtodos StartTransaction, Commit e RollBack explcitos. Se voc
necessitar executar instrues SQL que no devolvam um
conjunto de dados (ResultSet), voc poder trabalhar diretamente
com o mtodo ExecuteDirect ou Execute, os quais facilitam bastante a
execuo dessas instrues. Caso necessite extrair informaes
(metadata) do banco de dados que est trabalhando, isso tambm
bastante simples, bastando para isso utilizar os mtodos
GetTableNames, GetFieldNames e GetIndexNames do SQLConnection.
Os componentes DataSet
A dbExpress disponibiliza basicamente quatro componentes
DataSet, sendo: SQLDataSet, SQLQuery, SQLStoredProc e SQLTable.
Recomendamos que para qualquer nova aplicao que voc
venha a desenvolver, utilizar o componente SQLDataSet, pois, este
componente j encapsula os outros trs componentes existentes
na dbExpress, ou seja, bastando configurar a propriedade
CommandType para ctQuery, ctStoredProc ou ctTable, assumindo
assim as mesmas funcionalidades dos outros componentes. Os
outros componentes (SQLQuerym SQLTable e SQLStoredProc) foram
mantidos por uma questo de analogia ao BDE, porm, so
MeGAZINE
Delphi
dispensveis.
O SQLQuery
As propriedades e mtodos do componente SQLQuery so
muito parecidas com a Query existente no BDE, contudo, existe
uma diferena bastante significativa, visto o SQLQuery ser
unidirecional e a Query do BDE no. Voc poder utilizar o
SQLQuery para execuo de instrues SQL DML e instrues
DDL. Para instrues que resultem em um conjunto de dados
(ResultSet), utitize o mtodo Open ou Active = True e para
instrues que no retornem conjunto de dados, chame o mtodo
ExecSQL. Vamos continuar no desenvolvimento de nosso
aplicativo de exemplo.
1. Adicione trs componentes SQLQuery ao nosso
datamodule;
2. Aponte a propriedade SQLConnection para
EmployeeConnection;
3. Nomeia a primeira SQLQuery para EmployeeQry, a
segunda para HistoryQry, e a ltima para DeptQry.
4. Configure a propriedade SQL do EmployeeQry para:
SELECT * FROM EMPLOYEE
WHERE DEPT_NO = :DEPT_NO
ORDER BY LAST_NAME
5. Configure a propriedade SQL do HistoryQry para:
SELECT * FROM SALARY_HISTORY
WHERE EMP_NO = :EMP_NO
6. E finalmente, a propriedade SQL do DeptQry para:
SELECT DEPT_NO, DEPARTMENT FROM
DEPARTMENT
ORDER BY DEPARTMENT
7. Adicione um componente DataSource, nomeie como
EmpLinkSrc, e aponte a propriedade DataSet para EmployeeQry;
8. Configure a propriedade DataSource do componente
HistoryQry para EmpLinkSrc (com isso estaremos relacionando as duas
SQLQuerys);
9. Volte ao EmployeeQry, acesse a propriedade Params e
configure o valor do parmetro DEPTO_NO para um valor que
voc saiba que no existir na tabela, como exemplo XXX, com
isso, nenhum registro ser retornado at que informemos um
valor vlido para departamento;
27
 Delphi
10. D um duplo-clique no EmployeeQry e adicione os TFields
ao Fields Editor.
11. Selecione o campo EMP_NO e configure a propriedade
ProviderFlags para pfInKey = True. Fazendo esta configurao,
voc est determinando que este campo faz parte da PrimaryKey,
dessa forma, o DataSetProvider (que iremos ver mais adiante)
ir necessitar dessa informao para construir a instruo SQL
de atualizao dos registros;
12. Agora, selecione o campo FULL_NAME, v a propriedade
ProviderFlags e configure pfInUpdate e pfInWhere = False.
FULL_NAME um campo computado (pelo banco de dados) e
no devemos atualizar diretamente este campo visto isto ser feito
automaticamente pelo banco de dados e dessa forma o
DataSetProvider no dever fazer referncia ao mesmo quando
construir as instrues SQL de atualizao;
13. Ative o EmployeeQry alterando a propriedade Active =
True;
14. Agora, d um duplo clique no componente HistoryQry, e
adicione todos os campos ao Fields Editor do mesmo;
15. Selecione o campo EMP_NO e configure ProviderFlags
pfInkey = True e repita o mesmo para os campos
CHANGE_DATE e UPDATER_ID, pois, todos compe a
PrimaryKey;
16. O campo NEW_SALARY um campo computado
(lembra?!) e devemos configurar ProviderFlags pfInUpdate e
pfInWhere = False.
17. Altere a propriedade Active do EmployeeQry e HistoryQry
para False;
18. Configure a propriedade Connected do
EmployeeConnection para False;
O SQLTable
O componente SQLTable se assemelha ao Table que j
conhecemos do BDE, e como j sabemos, ele no recomendado
dentro do ambiente Client/Server devido sua arquitetura de
trabalho. Caso necessite utiliz-lo, bastar apontar sua
propriedade SQLConnection um SQLConnection e selecionar a
tabela por meio da propriedade TableName. Contudo, este existe
basicamente por analogia ao Table do BDE e por isso no iremos
abord-lo neste artigo.
O SQLStoredProc
Este componente tem finalidade de conectar stored
procedures existentes no banco de dados, basicamente tem o
mesmo papel do StoredProc disponibilizado pelo BDE. Contudo,
na dbExpress tambm podemos nos referenciar a stored
procedures atravs do componente SQLDataSet, bastando para
28 MeGAZINE
isso ajustar sua propriedade CommandType para ctStoredProc.
Mais uma vez, o SQLStoredProc existe por uma questo de
analogia ao BDE, porm, caso necessite utiliz-lo, bastar
apontar sua propriedade SQLConnection um SQLConnection, e
atravs da propriedade StoredProcName fazer referncia a uma
stored procedure existente em seu banco de dados, e chamar o
mtodo Open ou ExecProc, dependendo da finalidade de sua sp.
O SQLDataSet
Para utilizar este componente, assim como os outros
anteriormente mencionados, o primeiro passo setar a
propriedade SQLConnection um SQLConnection disponvel em
sua aplicao. Feito isso, voc dever escolher para qual
finalidade o SQLDataSet ser utilizado, configurando para isso a
propriedade CommadType, podendo ser: ctQuery, ctStoredProc,
ou ctTable. Frequentemente voc usar o valor padro ctQuery.
A configurao desta propriedade implica na funcionalidade da
propriedade CommandText. Se for ctQuery, CommandText
estar configurado com um editor SQL, se for ctStoredProc,
CommantText ir receber apenas o nome de stored procedures
existentes em seu banco e finalmente se for ctTable,
CommantText ir listar as tabelas existentes no banco, bastando
selecionar uma delas.
A propriedade Params prov a configurao de parmetros
para execuo de uma query parametrizada. A propriedade
DataSource utilizada para ligar um componente a outro
provendo um relacionamento master/detail. Vale lembrar, se o
SQLDataSet retornar um conjunto de dados (ResultSet) voc
dever chamar o mtodo Open ou Ative = True, caso contrrio,
ExecSQL.
Conforme mencionei anteriormente, o SQLDataSet trabalha
em modo unidirecional e assim sendo, voc poder ir registro a
registro apenas para frente, no havendo possibilidade de
retroceder o ponteiro de registros, apresentando sempre um por
vez. Caso v construir um relatrio onde a ferramenta utilizada
no necessite fazer cache de registros, bastar voc ligar um
DataSource ao SQLDataSet e este ao seu gerador de relatrios.
Contudo, caso necessite prover navegao entre registros, como
por exemplo a apresentao em uma grade qualquer, adicione
um componente DataSetProvider, ligando sua propriedade
DataSet ao SQLDataSet e um ClientDataSet, ligando sua
propriedade ProviderName ao DataSetProvider ou ainda, utilize
um componente SimpleDataSet (iremos abordar este componente
mais adiante).
Se voc necessitar obter informaes de metadata mais
detalhadas do que o componente SQLConnection oferece, voc
poder faz-lo via componente SQLDataSet, fazendo uso do

mtodo SetSchemaInfo. Este mtodo recebe trs parmetros,
sendo SchemaType, SchemaObject e SchemaPattern.
SchemaType pode receber os seguintes valores stNone, stTables,
stSysTables, stProcedures, stColumns, stProcedureParams, ou
stIndexes. Este parmetro indica o tipo de informao que o
SQLDataSet conter quando for aberto, trazendo
automaticamente as informaes solicitadas, como exemplo, se
configurar como stTables, ao abrir o SQLDataSet todas as
tabelas e informaes sobre as mesmas sero obtidas facilmente.
Por padro, SchemaType configurado como stNone. Vale
ressaltar que, se voc adicionar alguma instruo propriedade
CommandText, automaticamente SchemaType ser setado para
stNone. Cada combinao de configurao destes parmetros, ir
trazer resultados diferentes. Se por exemplo, voc configurar
SchemaType = stTables e SchemaPattern para EMP%, o
conjunto de dados conter somente as tabelas com nome iniciado
por EMP.
O SimpleDataSet
Para visualizar e editar dados no BDE, tudo que
necessitvamos era adicionar um componente TQuery, ajustar
algumas propriedades e pronto! Contudo, como vimos
anteriormente, dentro do dbExpress necessitamos combinar trs
componentes, sendo um SQLDataSet ou SQLQuery, um
DataSetProvider e um ClientDataSet e configur-los a fim de
conseguir o mesmo resultado. Contudo, a partir do Delphi 7
contamos com um componente que possibilita economizar tempo,
ele o SimpleDataSet. Na realidade, o TSimpleDataSet combina
os trs componentes mencionados acima e dessa forma possibilita
visualizar e editar dados diretamente sem a necessidade de
componentes adicionais, porm, apesar da facilidade, existem
algumas restries a respeito deste componente as quais listamos
a seguir:
No possvel utilizar este componente em aplicaes multi-
camadas. Se voc pensa futuramente converter sua aplicao
Client/Server para N-Tier, utilize os trs componentes
(SqlDataSet, DataSetProvider e ClientDataSet) separadamente;
No possvel vincular tabelas detalhes via nested dataset
field (TDataSetField);
Nenhum dos eventos do DataSetProvider interno ficam
expostos;
Nenhuma das propriedades Options do DataSetProvider
podem ser alteradas, nem em modo de design e nem em modo
run-time;
No possvel adicionar os TFields para o DataSet interno
ao SimpleDataSet e com isso, no existe possibilidade de
MeGAZINE
Delphi
configurao da propriedade ProviderFlags;
Se voc necessita trabalhar com MyBase (xml ou cds), a
utilizao somente do ClientDataSet reduz o consumo de recursos
em relao a utilizao do SimpleDataSet;
As propriedades e mtodos do SqlDataSet interno no tem a
mesma funcionalidade de uma Query BDE, assim sendo, se
estiver convertendo uma aplicao BDE dbExpress vrias
alteraes sero necessrias;
Em resumo, se voc necessitar de maior flexibilidade, o
SimpleDataSet no o componente mais indicado.
Particularmente, no utilizo este componente em nenhuma
situao nos projetos que desenvolvo, pois, apesar dele parecer
simples, esta simplicidade pode acabar saindo caro! Mas, se
mesmo assim voc estiver achando complicado a todo momento
ter que adicionar os trs componentes em seu DataModule, voc
poder criar um template para isso. Bastando adicionar,
configurar e selecionar os trs componentes, depois, acessar o
menu Component | Create Component Template que um novo
componente ser criado, geralmente disponibilizado na palheta
Template, dessa forma, quando adicionar este novo
componente, os trs sero automaticamente adicionados.
SQLMonitor
O ltimo componente da dbExpress o SQLMonitor. Este
componente bastante til para que possamos fazer ajustes e
melhorar a performance de nossos aplicativos. Atravs deste,
podemos monitorar todas as instrues e requisies feitas ao
banco de dados, gerando um log o qual nos dar uma idia
completa se o que mandamos executar realmente a melhor
abordagem.
Concluso
No prximo ms irei abordar a palheta Data Access, falando
principalmente sobre os componentes DataSetProvider e
ClientDataSet, dando assim continuidade a nossa implementao
com dbExpress. Em caso de dvidas, estamos a disposio para
maiores esclarecimentos, basta nos contatar.
Forte abrao todos,
Sobre o autor
Alessandro Ferreira,
Consultor Tcnico do The Club
alessandro@theclub.com.br
29
 Perguntas & Respostas
Pergunta: Estou utilizando dbExpress para acesso a banco
de dados e gostaria de saber onde posso encontrar drivers para
Firebird 1.5 e Progress para o Delphi6.
Resposta: Para Firebird, felizmente est disponibilizado um
driver open-source e que nos simples testes que realizamos,
funcionou perfeitamente. Poder baixar diretamente no site do
fabricante:
http://www.progdigy.com/UIB/
Quanto ao Progress, infelizmente sabemos que existe driver
para Kylix/dbExpress, porm, para Delphi no temos
conhecimento at o momento.
Dvida enviada por Ana Abrantes, So Paulo/SP.
Pergunta: Como fao para alterar um campo de uma
tabela Firebird 1.0
para NOT NULL, sem perder os dados constantes da
mesma?
Resposta: Poder utilizar a seguinte instruo:
update RDB$RELATION_FIELDS set
RDB$NULL_FLAG = 1
where (RDB$FIELD_NAME = CAMPO) and
(RDB$RELATION_NAME = TABELA)
Dvida enviada por Megasoftware Informtica Ltda,
Salvador/BA.
30 MeGAZINE
Pergunta: Sempre que eu usava a instruo
IBTransaction.StartTransaction para executar a gravao de
meus dados ocorria um erro avisando que o objeto IBTransaction
est ativo, mesmo depois de um IBTransaction.Commit ou
CommitRetaining ao final da operao. O problema que se eu
desativar o objeto IBTransaction todos os grids so esvaziados
(trabalho com janelas mltiplas, Ex: Cadastro de Clientes pode
estar em segundo plano ao lado de Cadastro de Fornecedores que
est sendo editado).
O cdigo abaixo resolveu o meu problema de gravao de
dados sem desativar o IBTransaction:
IBSQL1.Transaction :=
IBDatabase1.InternalTransaction;
IBSQL1.Close;
IBSQL1.SQL.Clear;
IBSQL1.SQL.Add(INSERT INTO ALUNOS
(CODIGO, NOME, SEXO, NASCIMENTO));
IBSQL1.SQL.Add(VALUES
(:PCODIGO, :PNOME, :PSEXO, :PNASCIMENTO));
if not IBDatabase1.InternalTransaction.
InTransaction then
IBDatabase1.InternalTransaction.
StartTransaction;
IBSQL1.Prepare;
IBSQL1.ParamByName(PCODIGO).
AsString:= Edit1.Text;
IBSQL1.ParamByName(PNOME).AsString:= Edit2.Text;
IBSQL1.ParamByName(PSEXO).AsString:= Edit3.Text;
IBSQL1.ParamByName(PNASCIMENTO).

AsString:= Edit4.Text;
IBSQL1.ExecQuery;
try
IBDatabase1.InternalTransaction.Commit;
except
IBDatabase1.InternalTransaction.Rollback;
end;
IBTable1.Refresh;
A dvida se esse cdigo realmente eficaz como se estivesse
utilizando o IBTransaction.StartTransaction diretamente no
objeto de transao?
Resposta: A mensagem de que a transao j est ativa,
geralmente ocorre se tentarmos efetuar um StartTransaction
em um IBTransaction que j esteja ativado, ou seja, se voc
deixar um componente IBTransaction ativo (para que suas
tabelas possam permanecer abertas), voc no dever chamar o
mtodo StartTransaction, visto uma transao permanente
ficar ativa enquanto o IBTransaction estiver conectado, bastando
neste caso apenas chamar o mtodo CommitRetaining ou
RollBackRetaining para consolidar ou desfazer o que foi postado
ao banco de dados.
A cada chamada destes mtodos, as pendncias so
eliminadas e como se estivesse aberto uma nova transao.
Assim sendo, no recomendamos trabalhar com o objeto de
transao interna embutida no IBDatabase, visto o mesmo ser de
uso interno do IBDatabase, conforme mencionado na prpria
documentao:
Used internally by InterBase transactions.
property InternalTransaction: TIBTransaction;
Description
Do not use InternalTransaction directly. It is for internal use
only.
Dvida enviada por Nilton Carlos da Silva, Monte Aprazvel/
SP.
Pergunta: Gostaria de saber como apago vrios registros de
uma vez (Ex. Quero apagar todos os registros com o cdigo 10)
em uma tabela, utilizando o componente TClientDataSet da
paleta Data Access.
Resposta: Poder utilizar um componente sqlDataSet para
MeGAZINE
Perguntas & Respostas
isso aplicando uma instruo delete DML:
With sdsClientes do
Begin
Close;
CommandText := Format(Delete From
Clientes where ID = %s, [EdCodigo.Text]);
ExecSQL(True);
End;
Depois, apenas efetue um Refresh em seu ClientDataSet
para que a visualizao seja atualizada.
* A instruo acima tambm pode ser executada via
propriedade CommandText do ClientDataSet.
Dvida enviada por Intime Sistemas Ltda, Ararangua/SC.
Pergunta: Tenho uma instruo SQL semelhante a esta:
SELECT Codigo,
Nome FROM tabela
ORDER BY 2 DESCENDING
No componente do BDE funciona sem problemas, porm,
quando troquei para o conjunto do dbExpress (SQLDataSet,
DataSetProvider e ClienteDataSet), aonde a instruo vai para o
CommandText, aparentemente ignora o DESCENDING.
O interessante que se eu trocar o 2 pelo nome do campo,
ou seja, NOME, funciona corretamente.
Se for um BUG, por favor me de uma sugesto para o
seguinte caso, eu tenho um SQL em que preciso usar UNION e
no final como sero tabelas diferentes a unificar, no posso usar
o nome do campo precisaria me referenciar a coluna, o que fazer?
Resposta: Isso ocorre devido ao mecnismo de trabalho do
DataSetProvider.
Para resolver, altere a propriedade Options |
poRetainServerOrder no DataSetProvider para True, com isso,
o ClientDataSet ir respeitar a ordenao definida pelo provedor
de dados.
Dvida enviada por Financial Informatica Ltda, Campo
Grande/MS.
31