Revista The Club Megazine - 12/2002

A utilização, reprodução, apropriação, armazenamento em

banco de dados, sob qualquer forma ou meio, de textos, fotos e
outras criações intelectuais em cada publicação da revista “The
Club” são terminantemente proibidos sem autorização escrita
dos titulares dos direitos autorais.
Copyright© The Club® 2002
 EDITORIAL

THE CLUB
Rua Acre, 950 - Avaré - SP - CEP 18.700-260
Informações: (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
Informações: info@theclub.com.br
Dúvidas
Correspondência ou fax com dúvidas devem ser
enviados ao - THE CLUB, indicando "Suporte".
Opinião
Se você quer dar a sua opinião sobre o clube em
geral, mande a sua correspondência para a seção
"Tire sua dúvida".
Editorial
Enquanto isso, aproveite a revista desde mês, onde temos vários
artigos interessantes! Iniciamos uma série sobre UML, uma linguagem
de modelagem estruturada que esta se tornando um padrâo mundial na
metodologia da Engenharia de Software. Temos também, um ótimo
artigo sobre WebServices, pois hoje, não dá para falar em internet sem
falar em WebServices...
Na série DataSnap, é demonstrado de forma bastante simples o
temido Master/Detail, provando não ser tão difícil assim!
E finalizando, temos dois artigos sobre banco de dados, um sobre
Oracle e outro demonstrando a facilidade na utilização dos Domains no
Firebird.
Aproveite!
Feliz Natal e próspero ano novo!

Reprodução
A utilização, reprodução, apropriação,
armazenamento em banco de dados, sob qualquer
forma ou meio, de textos, fotos e outras criações
intelectuais em cada publicação da Revista
“The Club” são terminantemente proibidos sem
autorização escrita dos titulares dos direitos
autorais.

Copyright© The Club® 2002 Celso Jefferson Paganelli

Presidente - The Club
Impressão e acabamento:
Impressos Gril - Gril Gráfica e Repr. Ind. Ltda.
Tel.: (0xx14) 3762.1345 - Fax: (0xx14) 3762.1259
Rua São Paulo, 447 - Cep 18.740-000
Taquarituba - SP
Tiragem: 5.000 exemplares

Editorial ...................................................................................... 03
Diretor - Presidente

Celso Jefferson M. Paganelli News ......................................................................................... 04

UML - Linguagem de Modelagem Unificada .......................... 05
Diretor Técnico
WebServices ............................................................................... 07
Mauro Sant’Anna
Colaboradores Criando um Banco de Dados (instance) no Oracle 9i (2) ...... 14
Marcelo Nogueira, Alexandre Magno, Anderson H.
Rodrigues, Emerson Facunte, Mario C. Bohm
DataSnap - O Cliente COM+ - Master/Detail - Parte IIV ....... 16
Delphi é marca registrada da Borland
International, as demais marcas citadas são
Tudo Sobre Domínios................................................................ 27
registradas pelos seus respectivos proprietários.
Perguntas & Respostas .............................................................. 30

MeGAZINE 3
 NEWS
Sistemas Multicamadas com Delphi -
dbExpress e DataSnap
Rodrigues, Anderson Haertel
ISBN: 85-7502-105-2
Editora: Visual Books
www.visualbooks.com.br
Aprender sobre o Desenvolvimento de Sistemas utilizando a
tecnologia multicamadas é uma tarefa possível, basta um
pouco de esforço e perseverança e, é claro, um bom livro para
seguir.
Este livro se propõe a ir além de apenas mostrar como
construir os cadastros e explicar como são usados os
componentes. Isso, com certeza, você aprende no Help da
ferramenta Delphi. Esta publicação explica o conceito e tenta
quebrar o paradigma do leitor que está acostumado com a
tecnologia Client/Server.
São explicados todos os protocolos que o DataSnap suporta
na versão 7.0 do Delphi, mas, enfatiza o seu desenvolvimento
no protocolo COM+.
Veremos, também, os conceitos envolvidos no uso das
ferramentas de acesso a Banco de Dados que acompanham o
Delphi 6.0/7.0 (dbExpress) e a explicação em detalhes do uso
dos componentes ClientDataSet e DataSetProvider, além dos
seus conceitos.
Conheça esses componentes e os benefícios que os mesmos
oferecem e aplique-os em seus projetos.
O livro inicia mostrando o que é uma aplicação Cliente/
Servidor, o que é uma aplicação 3 Camadas e quais as
vantagens das Aplicações 03 Camadas em relação as
HOTShow - www.mlsoftware.com.br
Sistema de Apresentações Multimídia
Agora você pode criar e distribuir em arquivos EXE, em
poucos minutos, as mais incríveis aplicações interativas
multimídia, sem ter que gastar meses aprendendo uma
linguagem de programação. HOTShow é um sistema de
apresentações multimídia que possui um ambiente bastante
intuitivo e amigável. Permite combinar objetos como textos,
shapes, imagens, botões, sons, músicas, animações, filmes, links
e variáveis. Você poderá construir, com qualidade, rapidez e
facilidade, aplicações interativas multimídia em CD-ROM,
apresentações diversas, albuns de fotografias e slide-shows,
proteção de telas (screen savers), quiosques de informações,
tutoriais, programas de treinamento, catálogos de produtos,
cartões digitais, histórias, desenhos animados, arquivamento
digital de imagens, vídeos e documentos e projetos de apoio para
áreas de educação e RH, dentre outras utilidades. Fácil de usar,
HOTShow não requer nenhuma programação! É a solução
4 MeGAZINE
Aplicações Cliente/Servidor.
Também aborta o que é e quando usar as palavras/
tecnologias que vimos no dia a dia: COM, OLE , DCOM, MTS,
COM+, ActiveX, MSTDC, Sockets, CORBA, ORB, Stub,
Skelleton, SOAP, DSOM, Interface, Stateless, Statefull, DCE,
RPC, Stack, GUID, CLSID, IID, Early Binding, Late Binding,
Regra de negócios, etc.
São explicados (e exemplos de como usar) todos os
componentes (suas propriedades, métodos e eventos) da Guia
DataSnap do Delphi 6 e do Delphi 7.
Além de ensinar detalhadamente (conceitos, implementação e
macetes) o desenvolvimento de um sistema MultiCamadas em
Delphi usando o Protocolo COM+ (da família DCOM), o livro
ensina o que é e como usar as Interfaces, a dbExpress
(SQLConnection, SQLDataSet, SQLQuery, SQLStoredProc,
SQLTable, SQLMonitor, SQLClientDataSet e SimpleDataSet,
suas propriedades, métodos e
eventos) do Delphi 6 e Delphi 7, mostra as principais classes
envolvendo a dbExpress e ainda mostra as Interfaces envolvidas
na construção da
dbExpress) estuda e mostra o que é e como usar o
componente ClientDataSet (suas propriedades, métodos e eventos
e como usar e criar MyBase e XML envolvendo o componente
ClientDataSet) e o componente DataSetProvider (Providing,
Resolving, Transações, Regras de Negócios e suas propriedades,
métodos e eventos)
O Livro se destina a usuários iniciantes, intermediários e
avançados.
O Livro ainda contempla os eleitores com Cases de Sucesso no
uso da tecnologia DataSnap. As cases de Sucesso são descritas/
faladas por ilustres/prestigiados amigos da Comunidade Delphi
Nacional.
perfeita para aplicações nos mais diversos segmentos:
publicitário, marketing, fotográfico, médico, odontológico, perícia,
imobiliário, organizadores de eventos, agências de modelos,
artístico, decoradores e acabamentos em geral.
• Ambiente intuitivo e amigável
• Apresentações interativas
• Suporte aos formatos comuns de imagem: BMP, JPG,
WMF, EMF e ICO
• Suporte à filmes digitais nos formatos AVI e MPEG
• Adicione som e música para sua apresentação (WAVE /
MP3 / MIDI)
• Assistente de Criação de Botões
• Assistente de Criação de Animações
• Inspetor de Ações
• Assistente de Transporte
• Ferramenta de Procura e Substituição
• Mega clipart (apenas para versão CD-ROM), com imagens,
filmes, sons e músicas
E muito mais !!!

UML
Linguagem de Modelagem Unificada
Orientação à Objeto na Modelagem
Autor: Marcelo Nogueira
As empresas cada vez mais estão voltadas às
informações.Com isso, o volume de informações vem crescendo
exageradamente e nem sempre podemos retirar vantagens
competitivas devido à falta de uniformidade com que elas são
postadas.
O desenvolvimento de sistemas deve acompanhar a mutação
constante das informações e para isso, devemos construir
aplicações mais flexíveis e com menor taxa de manutenção.
Para que isso ocorra, é necessário adotar uma metodologia de
trabalho que se aproxime mais da realidade da empresa, que
consiga descrever seus fluxos operacionais e trâmite dos negócios,
retratando de fato toda a sua concepção.
É percebível por todos que os métodos de modelagem
tradicionais, especificamente o modelo estruturado, tornam o
desenvolvimento mais demorado, custos de manutenção maiores
e em casos mais caóticos, levam o projeto a naufragar.
Isso porque existe uma dificuldade enorme em extrair do
cliente a verdadeira necessidade da empresa e principalmente as
expectativas que estão focadas encima daquele desenvolvimento.
Por este motivo, o contato humano e habilidade de entrevistar
o cliente, já não é mais eficiente, necessitando de apoio de uma
ferramenta que possa de alguma forma, colaborar
metodicamente para que as informações venham condizer com a
empresa e os requisitos que o analista de sistemas necessita para
o desenvolvimento, bem como atender as necessidades do cliente e
resultar em algo mais nas estratégias de negócios.
Onde entra a UML ?
A UML é uma linguagem de modelagem, totalmente
orientada à objetos, que une as melhores práticas e metodologias
da Engenharia de Software.
É considerada a sintaxe geral para criar um modelo lógico de
um sistema.
MeGAZINE
Delphi
Ela é utilizada para descrever pontos de um sistema e da
forma como ele é percebido de várias visões durante a análise e
sua arquitetura.
É uma linguagem que visa capturar conhecimento e
expressar esse conhecimento.
Seu propósito é a modelagem de sistemas, documentar de
maneira interativa e visual, proporcionar melhor compreensão e
sinergia entre o analista e o cliente envolvido no processo de
desenvolvimento.
Devemos adotar a UML?
Além da sua alta e rápida adesão no mercado mundial, aqui
no Brasil, sempre tivemos a grande necessidade da adoção de um
modelo mais eficiente e que resultasse maior produtividade,
menos erros no desenvolvimento, encurtamento dos prazos de
entrega, menor custo de manutenção do software.
Falando assim, parece a solução que todos esperaram por
anos, mas também não é bem assim.Os resultados aparecem, se
bem utilizados os recursos disponíveis e a perfeita compreensão
dos conceitos da orientação à objetos que se pretende
sensibilizar.Caso contrário será mais um método que tentaremos
utilizar e os resultados não virão.Abandonar os atuais métodos
que você utiliza pode ser catastrófico.Afinal, muitos projetos
foram bem sucedidos, apesar das estatísticas serem bastante
assustadoras, quando institutos americanos respeitados,
afirmam que 60% dos sistemas começados, não chegam a ser
finalizados, e muito menos a serem utilizados.
Desenvolvemos sistemas que enfocam demandas e requisitos
de clientes.
Requisitos são considerados os problemas.Os sistemas são
considerados a solução.O problema e a solução ocorrem dentro de
um mesmo contexto.
Para ser desenvolvida uma boa solução, primeiramente deve
5
 Delphi

existir compreensão do problema.A solução deve ser entendida Adotando a UML para os novos projetos, explorando e
para que possa ser criada e utilizada. utilizando todos os seus recursos e juntamente com uma
Partindo deste princípio, a solução deve ser arquitetada, a fim ferramenta para modelar os dados é o primeiro grande passo.
de aderir às restrições de suas necessidades. A ferramenta mais conhecida para a utilização da UML é da
Para adotarmos a solução apropriada ao problema, precisamos empresa Rational, e chama-se Rational Rose.A Borland,
modelar, organizar, e representar através de diagramas, onde percebendo a evolução global da UML, incluiu somente na versão
permitirão comunicação e disseminação dos conhecimentos Enterprise do Delphi 7, o ModelMaker, ferramenta muito similar
extraídos ao Rational Rose, capaz de modelar o projeto utilizando UML e já
. gerar código no Delphi.
Que tipos de diagramas são utilizados? Utilizar metodologias de modelagem de sistemas que de
Na UML podemos utilizar vários diagramas para melhor alguma forma vão melhorar nosso desempenho e resultados, o
compreender a complexidade de nosso problema explorando ao desafio é grande, no entanto o objetivo, é atenuar ao máximo os
máximo todo o conceito de orientação a objeto.Entre eles podemos desperdícios de tempo e de recursos financeiros empregados em
destacar: projetos de sistemas.
• Diagramas de casos de uso A cada artigo mensal, demonstraremos a utilização de cada
• Diagramas de objeto diagrama e posteriormente a sua utilização na ferramenta de
• Diagramas de classe modelagem UML. Acompanhe!
• Diagramas de seqüência Sobre o autor
• Diagramas de colaboração
• Diagramas de estado Marcelo Nogueira é Analista de Sistemas,
• Diagramas de atividade Instrutor e Desenvolvedor Delphi, na SoftWay
• Diagramas de componentes Informática, Santos - SP.
• Diagramas de Implantação e-mail: softway@iron.com.br

6 MeGAZINE
 Delphi

WebServices Autor: Emerson Facunte

Para explicar de maneira adequada o significado da Tecnologias do nosso cenário exemplo

tecnologia WebServices, é interessante fazer uma breve
introdução aos problemas atuais no mundo da tecnologia.
Banco S.O. Banco Dados Terminais
Com o grande avanço de sistemas operacionais, bancos de Facunte Unix DB2 Terminais Linux
dados, hardware, software, enfim, todo o tipo de tecnologia que
envolve o mundo dos negócios, vêm surgindo a necessidade de X NT SQL Server Windows
compartilhamento de informações entre parceiros comerciais, Y Solaris Oracle Terminais Linux
governo e sociedade, e até mesmo entre departamentos de uma
empresa.
Integrar informações de diferentes plataformas não é
Acontece que interligar diferentes plataformas, bancos de
novidade, e como já foi mencionado é possível, mas muito
dados, operações, entre outros conceitos, é uma tarefa muito
trabalhoso.
complicada e trabalhosa.
A proposta da tecnologia WebServices neste cenário, é a de
Para concluir o conceito de WebServices, vamos imaginar um
facilitar a troca de informações, fazendo o Banco Facunte
cenário simples, onde precisamos integrar informações de
entender e tratar as informações dos Bancos X e Y, independente
diferentes departamentos e filiais, que foram desenvolvidos em
do banco de dados, sistema operacional, ou outro fator não citado.
plataformas diferentes. Um bom exemplo para isso, são os bancos
que estão adquirindo outros bancos em todo o mundo, e que
Com algumas linhas de programação e um bom
utilizam conceitos e plataformas diferentes de trabalho.
planejamento, as informações essenciais serão interligadas
A figura 1 ilustra o Banco Facunte, adquirindo outros dois
facilmente.
bancos com diferentes tecnologias.
Meus amigos, isso é WebServices!

Em resumo, WebServices, é um padrão não-proprietário, que

possibilita o processamento distribuído em sistemas heterogêneos.

E acredito que muitos de vocês neste ponto estão ansiosos

para produzir o seu primeiro WebService.

Antes, devemos conhecer os padrões que fazem parte da

tecnologia.

WebService Exemplo

Vamos criar nosso primeiro WebService para aprender melhor

seu conceito.

Através das opções File/New..., seção WebServices, selecione a

Figura 1: Banco com diferentes plataformas opção SOAP Server Application (figura 2).

MeGAZINE 7
 Delphi

Com isso estamos criando uma Interface com o nome wsexemplo, e

gravando a unit com o mesmo nome.

Em Code generation selecione as opções Generate Comments e

Generate Sample Methods. Com isso estamos gerando exemplos de
métodos e comentários.

Figura: 5 Identificação do serviço

Figura 2: Nova aplicação WebService
Clique em OK para finalizar.
Em seguida selecione a opção CGI para o tipo da aplicação
servidora SOAP (figura 3). Vamos gravar nossa aplicação.

Unit WebModule un_ws1.pas

Unit Implementação WsExemplo wsexemploImpl.pas

Unit Interface WsExemplo wsexemploIntf.pas

Projeto ws1.dpr

Vamos analisar o que o nosso amigo Delphi criou.

Figura 3: Tipo da aplicação servidora

Em seguida o Delphi pergunta se deseja criar uma Interface

SOAP padrão (figura 4). Em nosso exemplo, vamos criar a tal
Interface, a fim de conhecer sua implementação

Figura: 6 WebModule1

A figura 6 ilustra nosso WebModule com três componentes no

padrão WebService (HTTPSoapDispatcher,
Figura 4: Criação da Interface HTTPSoapPascalInvoker,WSDLHTMLPublish).

Em seguida (figura 5) devemos informar os dados da nova Vejamos sua implementação.

Interface.
procedure
Nos campos Service Name e Unit identifier coloque wsexemplo. TWebModule1.WebModule1DefaultHandlerAction(Sender:

8 MeGAZINE
 Delphi

TObject; function echoEnum(const Value: TEnumTest):

Request: TWebRequest; Response: TWebResponse; var TEnumTest; stdcall;
Handled: Boolean); function echoDoubleArray(const Value:
begin TDoubleArray): TDoubleArray; stdcall;
WSDLHTMLPublish1.ServiceInfo(Sender, Request, function echoMyEmployee(const Value:
Response, Handled); TMyEmployee): TMyEmployee; stdcall;
end; function echoDouble(const Value: Double):
Double; stdcall;
A única função do nosso WebModule1,é a criação de um handler end;
para o WebService e publicação do documento WSDL.
implementation
Na unit wsexemploIntf estamos definindo a Interface de nossa
aplicação. initialization
{ Invokable interfaces must be registered }
{Invokable interface Iwsexemplo } InvRegistry.RegisterInterface(TypeInfo(Iwsexemplo));

unit wsexemploIntf; end.

interface Esta unit na realidade está seguindo as regras da O.O.

(Orientação a Objeto), onde definimos uma Interface como base,
uses InvokeRegistry, Types, XSBuiltIns; para que possamos implementar nossas classes. Além disso
estamos registrando a Interface no modelo SOAP.
type
Repare que os métodos criados são apenas exemplos de
TEnumTest = (etNone, etAFew, etSome, etAlot); implementação, que solicitamos previamente, justamente para
estudar e analisar.
TDoubleArray = array of Double;
Na unit wsexemploImpl, temos a implementação da Interface
TMyEmployee = class(TRemotable) que vimos anteriormente.
private
FLastName: AnsiString; Acredito que deu pra perceber, que os métodos apenas
FFirstName: AnsiString; retornam os mesmos valores informados.
FSalary: Double;
published Para compreender melhor, vamos fazer uma pequena
property LastName: AnsiString read alteração no método echoDouble. Substitua a linha de retorno,
FLastName write FLastName; pelo código que segue em negrito:
property FirstName: AnsiString read
FFirstName write FFirstName; function Twsexemplo.echoDouble(const Value: Double):
property Salary: Double read FSalary Double; stdcall;
write FSalary;
end; begin
{ TODO : Implement method echoDouble }
{ Invokable interfaces must derive from Result := Value * 3;
IInvokable } end;
Iwsexemplo = interface(IInvokable)
[‘{A391DC0F-CDA7-4929-97B8-DAECA7C2CF18}’] Perceba que estamos multiplicando por 3, só para quebrar o
gelo (Double = Dobro)
{ Methods of Invokable interface must
not use the default } Antes de compilar vamos definir o diretório para geração do
{ calling convention; stdcall is recommended } nosso WebService.

MeGAZINE 9
 Delphi

Através das opções Project/Options.../Directories_Conditionals,

configure a opção Output Directory, apontando para o o seu diretório
cgi-bin (figura 7).

Figura 8: Aplicação ws1

- <types>
Figura 7: Configuração do diretório
- <xs:schema targetNamespace=”urn:wsexemploIntf”
xmlns=”urn:wsexemploIntf”>
Grave novamente a aplicação.
- <xs:simpleType name=”TEnumTest”>
- <xs:restriction base=”xs:string”>
Agora vamos compilar a aplicação.
<xs:enumeration value=”etNone” />
<xs:enumeration value=”etAFew” />
Vamos executar a aplicação no browser para analisar o seu
<xs:enumeration value=”etSome” />
conteúdo. Lembre-se que para isso você deverá configurar um
<xs:enumeration value=”etAlot” />
servidor web, como o Apache, IIS, Xitami, etc.
</xs:restriction>

Digite: http://localhost/cgi-bin/ws1.exe/
Passando pelo bloco das definições inicias (<?xml
version=”1.0"...), chegamos no bloco de definições de tipos e
A figura 8 ilustra o resultado da primeira fase de nossa
métodos.
aplicação.
Neste bloco são definidos todos os métodos da nossa Interface,
com o descritivo completo. Repare que a classe TEnumTest é
Repare que temos todos os métodos listados na Interface
descrita com perfeição.
Iwsexemplo (echoEnum, echoDoubleArray, echoMyEmployee,
echoDouble).
No bloco que segue, são descritos os métodos Request e Response
da Interface em questão.
O documento gerado está de acordo com o padrão estabelecido
pelo W3C-UDDI (órgão responsável pelo padrão WebService).
- <message name=”echoEnum0Request”>
<part name=”Value” type=”ns1:TEnumTest” />
Clicando no link WSDL da Interface Iwexemplo será apresentado
</message>
um documento WSDL.
- <message name=”echoEnum0Response”>
<part name=”return” type=”ns1:TEnumTest” />
Vamos analisar algumas partes do documento para
</message>
compreender melhor seu funcionamento.

10 MeGAZINE
 Delphi

A seguir, temos o bloco que define o nome da porta (Port), e Unit un_teste_ws1.PAS
as operações Request e Response, descritas no bloco anterior.
Projeto teste_ws1.DPR
- <portType name=”Iwsexemplo”>
- <operation name=”echoEnum”> Agora vamos importar a Interface em nossa aplicação. Através
<input message=”tns:echoEnum0Request” /> das opções File/New.../WebServices (figura 9), selecione a opção WSDL
<output message=”tns:echoEnum0Response” /> Importer.
</operation>

Em seguida temos o bloco que “envelopa” e define a camada de

transporte dos métodos.

- <binding name=”Iwsexemplobinding”
type=”tns:Iwsexemplo”>
<soap:binding style=”rpc” transport=
”http://schemas.xmlsoap.org/soap/http” />
- <operation name=”echoEnum”>
<soap:operation soapAction=
”urn:wsexemploIntf-Iwsexemplo#echoEnum”
style=”rpc” />
- <input message=”tns:echoEnum0Request”>
<soap:body use=”encoded” encodingStyle=
”http://schemas.xmlsoap.org/soap/encoding/”
namespace=”urn:wsexemploIntf-Iwsexemplo” />
</input> Figura 9: WSDL importer
- <output message=”tns:echoEnum0Response”>
<soap:body use=”encoded” Em seguida, como ilustra a figura 10 , digite endereço que
encodingStyle= segue.
”http://schemas.xmlsoap.org/soap/
encoding/”namespace= http://localhost/cgi-bin/ws1.exe/wsdl/Iwsexemplo
”urn:wsexemploIntf-Iwsexemplo” />
</output> Este endereço faz a chamada ao documento WSDL da Interface
Iwsexemplo.
O último bloco finaliza o documento, declarando o nome do
serviço, bem como o nome da porta e a sua camada de transporte.

- <service name=”Iwsexemploservice”>
- <port name=”IwsexemploPort”
binding=”tns:Iwsexemplobinding”>
<soap:address location=”http://localhost/delphi/
cgi-bin/ws1.exe/soap/Iwsexemplo” />
</port>
</service>
</definitions>

Agora vamos criar uma aplicação cliente para testar nosso

primeiro WebService.

Através das opções File/New Application cria uma nova

aplicação, e grave os arquivos como segue: Figura: 10 Importação da Interface através do WSDL

MeGAZINE 11
 Delphi

Este procedimento está importando toda a Interface para a

nossa aplicação.

Com isso teremos acesso aos métodos definidos.

É interessante destacar que um WebService poderá ter

inúmeras Interfaces, onde poderemos importar apenas as que
condizem com a nossa necessidade.

Aperte o botão Next para avançar à próxima fase.

A figura 11 ilustra a Interface gerada pelo assistente.
Com isto configuramos o objeto de acesso à Interface,
informando a localização do documento WSDL (WSDLLocation), o
serviço (Service), e a porta (Port).
Agora insira os objetos que seguem, configurando suas
respectivas propriedades.

Figura: 11 Interface gerada pelo assistente

Para concluir aperte a tecla Finish.

O assistente gerou uma Unit com toda a Interface

implementada.

Grave a Unit com o nome Iwsexemplo1.pas.

O que acabamos de fazer, na realidade, foi a importação de

uma Interface para facilitar o uso do WebService.

Agora com o foco na unit un_teste_ws1, insira a unit

Iwexemplo1.pas gerada pelo assistente.
A figura 12 ilustra o formulário da nossa aplicação.

implementation
uses Iwsexemplo1;

Neste ponto iremos configurar o acesso para este formulário.

Insira um objeto do tipo THTTPRIO, e configure as

propriedades que seguem, respeitando a seqüência apresentada,
caso contrário, uma exceção ocorrerá. Figura 12: Formulário da aplicação

12 MeGAZINE

Agora vamos codificar a aplicação. Insira o código que segue
no evento OnClick do objeto Button1.
var
Iexemplo: Iwsexemplo;
begin
Iexemplo:= HR1 as Iwsexemplo;
lbResultado.Caption:=FloattoStr(Iexemplo.echoDouble
(StrtoFloat(edValor.Text)));
end;
O código é bastante simples, onde estamos definindo um
objeto do tipo Iwsexemplo. Em seguida estamos instanciando o
objeto a partir do nosso HTTPRio (HR1), adotando o modelo
Iwsexemplo. E por fim, apresentamos o resultado em nosso objeto
lbResultado, através da função IExemplo.echoDouble.
O mais importante até aqui, é justamente a compreensão de
como conseguimos implementar o WebService em nossa aplicação.
Vamos testar nossa aplicação.
Compile e execute a aplicação, informando um número no
campo e pressionando o botão. A figura 13 ilustra nossa aplicação
em tempo de execução.
MeGAZINE
Delphi
Figura 13: Aplicação em tempo de execução
Perceba que a primeira vez que pressionamos o botão, existe
um delay, que é justamente o tempo de conexão com o WebService.
Repita a operação, e repare que já não existe mais o delay.
Amigos isto é apenas o começo. Em meu livro Delphi 7
Internet e Banco de Dados, explico através de exemplos práticos
todo o poder dos WebServices. Temos WebServices utilizando banco de
dados como serviço, e também conexões concorrentes utilizando o
protocolo SOAP.
Forte abraço e imenso sucesso a todos !!!
Sobre o autor
Emerson Facunte é Consultor de Tecnologia com diversos
livros publicados, especialista em desenvolvimento de
aplicações e-Business utilizando a ferramenta Delphi, baseado
em WebSnap, DataSnap, BizSnap e ISAPI/Apache Modules.
13
 Delphi
Criando um banco de dados (instance)
no Oracle 9i... (Parte 2)
Autor: Mário Camilo Bohm - Bohm,Interal
Vamos lá então, continuar nossa instalação de uma instance
Oracle !
Nesta próxima fase da instalação, teremos que definir
aspectos importantes de nossa instalação. (ver figura 1)
Um primeiro aspecto é a maneira como a instance irá tratar
o gerenciamento de memória, principalmente para a SGA
(System Global Área), uma alocação de memória onde
praticamente todas as tarefas do banco são executadas.
A partir do Oracle 9i essa configuração, que antes era
obrigatoriamente manual através de parâmetros configurados no
init.ora, pode ser definida como automática, bastando para isso
você escolher a opção “Típico” e definir qual percentual da
memória do servidor irá ser disponibilizada para o Oracle.
É importante considerar que nem toda memória pode ser
disponibilizada, mesmo que no servidor rode apenas o banco de
dados (o que é altamente recomendável), pois existem processos
importantes do sistema operacional que precisam ser
considerados.
Se você precisar instalar outras funcionalidades corporativas,
como servidor de Internet, servidor de email, firewall, servidor de
anti-vírus, etc, tenha em mente prioritariamente utilizar
servidores separados para cada função, em grau a ser definido
segundo o porte da empresa e das aplicações que irão rodar. O
importante é que no servidor Oracle não tenhamos mais
aplicações rodando! Se a sua empresa tiver uma base muito
pequena, talvez você consiga obter resultados satisfatórios com
“tudo instalado no mesmo servidor”.
É importante ainda ressaltar que esse conceito não vale
apenas para Oracle, mas para qualquer banco de dados
relacional competente (Oracle, SQL Server, Sybase, Informix)
14 MeGAZINE
que for utilizado.
Recomendamos, para instalações típicas, utilizar 70% da
memória disponível no servidor.
Com essa opção pelo gerenciamento automático, a própria
instance “resolverá” necessidades de alocação para
shared_pool_size, db_block_buffers, etc, limitada obviamente à
quantidade física de memória. O desempenho da instance sobe
consideravelmente com a opção pelo gerenciamento automático
de memória.
A partir do 9i você pode utilizar até 4GB de RAM para
ambientes Windows. (ver figura 2)
Uma outra definição importante se refere ao conjunto de
caracteres que você vai utilizar na instance. Prefira, para o
Brasil, o conjunto WE8ISO8859P1, que oferece total
compatibilidade com instalações típicas de versões anteriores e
com conjunto de caracteres “asc ii”, que contém acentuação,
cedilha, etc...(ver figura 3)
Para o parâmetro sort_área_size, chamado dimensionamento
para área de classificação, o número padrão de 524288 bytes é
uma excelente escolha para a maioria das instalações.
Vale lembrar que essa alocação não faz parte da SGA, e será
multiplicada pelo número de usuários conectados à instance, isto
é, para cada conexão neste caso a instance reservará 524288
bytes.
Esse parâmetro, que define o quanto de memória cada sessão
terá disponível para efetivar tarefas como “sort”, é fundamental
para o desempenho. Alocações baixas serão sentidas
sensivelmente pelos usuários. (ver figura 4)
Em localização dos arquivos, defina sempre como necessária
a criação de arquivo de parâmetros (SPFILE), que é uma
 Delphi

Figura 1 Figura 4

Figura 2 Figura 5

Aliás um comentário: esse recurso é fundamental num banco

de dados, já veio tarde ! (ver figura 5)
A última definição desta fase da instalação diz respeito ao
arquivamento automático, para backups “a quente”.

Na instalação, não defina esta opção, porque vamos falar dela

futuramente e porque você pode fazê-lo a qualquer momento
depois de criada a instance.

Bem, continuamos na próxima. Feliz Natal a todos !!!

E um bom 2003, 2004, 2005, 2006...

Figura 3

Sobre o autor
evolução do init.ora, do qual falaremos no futuro. Com essa
opção, o init.ora perde muito de sua importância e, o que é Mário Camilo Bohm - Bohm,Interal
melhor, para praticamente todos os parâmetros de inicialização Fone (011) 4223.9911
não será mais necessário re-iniciar a instance em casos de mario@bohminteral.com.br
alteração. Em outras palavras, você modifica os parâmetros da http://www.bohminteral.com.br
instance sem tirar a instance do ar !

MeGAZINE 15
 Delphi

DataSnap
Parte VII - O Cliente COM+ - Master/Detail

Autor: Anderson Haertel Rodrigues

Introdução dbExpress), 03 DataSources (Guia Data Access) e 01 (Um)

No artigo anterior vimos como funciona o SharedConnection DataSetProvider (Guia Data Access). O 1o SQLDataSet devemos
e criamos nossa aplicação COM+ com manutenção a base de colocar o name = SQLDtStTAB_PARCEIROS, o 2o o name deve ser
dados simplificada, uma tabela e uma nova regra de negócios, o = SQLDtStTAB_PARCEIROS_CONT, o 3o igual a:
AutoIncremento. SQLDtStTAB_PARCEIROS_REFER_B e o 4 igual a:
SQLDtStTAB_PARCEIROS_REFER_C. O 1o DataSource a
Nesse artigo, reforço de forma reduzida a criação de um RDM propriedade name deve ser = DtSrcTAB_PARCEIROS_CONT, o 2o
com ligação ao nosso RDM de Conexão e criaremos um exemplo deve ser = DtSrcTAB_PARCEIROS_REFER_C e o 3o deve ser =
com atualizações e manutenções Master-Detail. DtSrcTAB_PARCEIROS_REFER_B. O name do DataSetProvider
deve ser = DtStPrvdrParceiros.
Mãos a Obra. Vamos abrir o Delphi!
Já que estamos com o DataSetProvider selecionado, devemos
RDM Master/Detail - SharedConnection. alterar as seguintes propriedades:
Vamos abrir o BPG (Borland Package Group - Project UpdateMode = upWhereKeyOnly, DataSet =
Manager) que se encontra no diretório C:\DataSnap e escolher SQLDtStTAB_PARCEIROS, Options = [poCascadeDeletes,
nosso servidor de aplicação como o projeto de trabalho. Vamos poPropogateChanges,poAllowCommandText], devemos ter a
agora em: File|New|Other|MultiTier| Transaction Data seguinte tela, Figura (1):
Module e indicar os seguintes
parâmetros e escolher as
seguintes opções:
CoClass = RDMParceiros,
Threading Model=Both e
Transaction Model=Requires
a new transaction, temos
novamente um RDM novinho
em folha na nossa frente.
Vamos salvar o mesmo com o
nome de
RDMCadParceiros.pas, no
diretório do Servidor:
C:\DataSnap\Servidor. No
RDM, vamos mudar a
Propriedade Pooled=True. Figura 1: O Object Inspector com os parâmetros do
Devemos colocar 04 (Quatro) SQLDataSets (Guia DataSetProvider.

16 MeGAZINE
 Delphi

Antes de prosseguirmos, necessitamos ligar (unir) dois

RDM´s. ALT+F11 e devemos escolher: RDMConexao. Salve Tudo!
A opção diferenciada de Options do DataSetProvider é:
poCascadeDeletes, onde, se o Servidor de Banco de Dados que
usamos der suporte a deleção em Cascata, a mesma será
executada. Para o nosso exemplo, implementamos a deleção em
Cascata através das seguintes declarações:
ALTER TABLE TAB_PARCEIROS_REFER ADD
CONSTRAINT FK_1015_1013 FOREIGN KEY (ID_PARC)
REFERENCES TAB_PARCEIROS (ID_PARC) ON DELETE
CASCADE;
Iremos fazer o teste de deleção em cascata quando iniciarmos
os nossos testes de manutenção na Tabela Master/Detail.

ALTER TABLE TAB_PARCEIROS_CONT ADD Com a união (uses) dos dois RDMs podemos enxergar o
CONSTRAINT FK_1014_1013 FOREIGN KEY (ID_PARC) SQLConnection que se encontra no RDMConexao, e ligar a
REFERENCES TAB_PARCEIROS (ID_PARC) ON DELETE propriedade SQLConnection de todos os SQLDataSet´s igual a:
CASCADE; Server_COMPlus.SQLCnctnBASE. Ok.

Vamos selecionar os três

DataSources e colocar a propriedade
DataSet=SQLDtStTAB_PARCEIROS.
Vamos selecionar o
SQLDtStTAB_PARCEIROS, a
propriedade CommandText deve ser a
seguinte:
SELECT CNPJ,ID_PARC,
INSC_EST,NOME FROM
TAB_PARCEIROS, (Duplo Click na
propriedade para abrir o CommandText
Editor), Figura (2).

Figura 2 (ao lado): A Propriedade

CommandText de
SQLDtStTAB_PARCEIROS.

Vamos selecionar o SQLDtStTAB_

PARCEIROS_CONT, a propriedade
CommandText deve ser a
seguinte:
SELECT
EMAIL_CONTATO, ID,
ID_PARC,
NOME_CONTATO,
TEL_CONTATO FROM
TAB_PARCEIROS_CONT
WHERE ID_PARC =
:ID_PARC, Figura (3):

Figura 3 (ao lado): A

Propriedade
CommandText de
SQLDtStTAB_
PARCEIROS_CONT.

MeGAZINE 17
 Delphi

Vamos selecionar o SQLDtStTAB_PARCEIROS_REFER_C, a Vamos selecionar o SQLDtStTAB_PARCEIROS_REFER_B, a

propriedade CommandText deve ser a seguinte: SELECT
BCO_AGENCIA, BCO_CHEQUE_ESP,
BCO_DT_ABERT_CONTA, COM_DT_ULT_COMPRA,
COM_DT_VCTO_ULT_PARC, COM_VL_PRESTACAO,
COM_VL_TT_COMPRA, ID, ID_PARC, NOME_REF, TP_REF
FROM TAB_PARCEIROS_REFER WHERE ID_PARC =
:ID_PARC AND TP_REF = ‘C’, Figura (4):
propriedade CommandText deve ser a seguinte: SELECT
BCO_AGENCIA, BCO_CHEQUE_ESP,
BCO_DT_ABERT_CONTA, COM_DT_ULT_COMPRA,
COM_DT_VCTO_ULT_PARC, COM_VL_PRESTACAO,
COM_VL_TT_COMPRA, ID, ID_PARC, NOME_REF, TP_REF
FROM TAB_PARCEIROS_REFER WHERE ID_PARC =
:ID_PARC AND TP_REF = ‘B’, Figura (5):

Figura 4: A Propriedade CommandText de SQLDtStTAB_PARCEIROS_REFER_C.

Figura 5: A Propriedade CommandText de SQLDtStTAB_PARCEIROS_REFER_B.

18 MeGAZINE
 Delphi

Nos falta ligarmos os DataSources aos seus respectivos
SQLDataSets para criarmos os relacionamentos. O Componente
SQLDtStTAB_PARCEIROS_CONT deve ter sua propriedade
DataSource igual a: DtSrcTAB_PARCEIROS_CONT, o
Componente SQLDtStTAB_PARCEIROS_REFER_C deve ter sua
propriedade DataSource igual a:
DtSrcTAB_PARCEIROS_REFER_C e o Componente
SQLDtStTAB_PARCEIROS_REFER_B deve ter sua propriedade
DataSource igual a: DtSrcTAB_PARCEIROS_REFER_B. Agora,
temos o relacionamento completo.
O RDM que acabamos de criar deve o seguinte Layout,
Figura (6):
O RDM que acabamos de criar está pronto (nos falta uma
regra que escreveremos mais adiante para a manutenção correta
dos registros Master/Detail).
Devemos Salvar tudo!
Devemos abrir o nosso RDMConexao, ALT+F11 e devemos
escolher: RDMCadParceiros.
Vamos agora, fazer a ligação das Interfaces de RDMParceiros
com o RDMConexao e vice-versa, através da Type Library (TLB).
View|Type Library, devemos ter a seguinte TLB inicial, Figura
(7):

Figura 6: O Remote Data

Module RDMCadParceiros.pas -
RDMParceiros.

Figura 7: A
Type Library
atual.

MeGAZINE 19
 Delphi
Devemos criar uma nova Interface com o name de:
IChildCadParceiros, vamos criar duas propriedades, uma Read-
Only e outra Write-Only, com o name de: RDMCadParceiros, a
propriedade Read-Only deve ter o seu Type igual a:
IServer_COMPlus*, ficando igual a: struct tag IServer_COMPlus
*. IChildCadParceiros deve ter seu Parent Interface igual a:
IAppServer. A Interface IRDMParceiros deve ter o seu Parent
Interface igual a: IChildCadParceiros.
Vamos agora criar uma nova propriedade Read-Only na
Interface IServer_COMPlus, com o name igual a:
RDMCadParceiros, seu Type deve ser igual a: IRDMParceiros*,
ficando igual a: struct tag IRDMParceiros *. Antes de fecharmos
a Type Library, vamos escolher todas as CoClass ( ), ir até a
Guia COM+, colocar os seguintes valores e parâmetros: Marcar
Object Pooling, Creation Timeout=10000, Call
Syncronatization=Required e Transaction Model=Requires a
new transaction, devendo todas as CoClass ficarem com os
seguintes parâmetros, Figura (8):
Figura 8: Mostrando como deve ficar os parâmetros de todas as CoClass.
20 MeGAZINE
RDMCadParceiros tem uma nova function e uma nova
procedure.
Antes vamos criar a variável: FIServer_COMPlus:
IServer_COMPlus, na seção private.
A function Get_RDMCadParceiros: IServer_COMPlus;
safecall; deve ter a seguinte codificação: Result :=
FIServer_COMPlus, é claro entre o begin e end;, a procedure
Set_RDMCadParceiros(const Value: IServer_COMPlus); safecall;,
deve ter a seguinte codificação: FIServer_COMPlus := Value;, a
seção initialization, deve-se ter o seguinte código:
RDMCadParceirosFactory :=
TComponentFactory.Create(ComServer,
TRDMParceiros,Class_RDMParceiros, ciMultiInstance,
tmBoth);. Em RDMConexao devemos ter o seguinte código na
function Get_RDMCadParceiros: IRDMParceiros; safecall;
Result := RDMCadParceirosFactory.CreateCOMObject(nil)
as IRDMParceiros;

Result.RDMCadParceiros := Self;
Para quem perdeu a Parte VI, eu expliquei detalhadamente
como se trabalha com SharedConnection. Aqui, como citado na
introdução, foi apenas um pequeno exemplo de como fazer para
os dois RDM´s (Objetos COM) se conversarem. Após isso tudo,
salve e vá até o menu: Run|Register ActiveX Server, dessa
forma registramos as alterações na nossa DLL COM+. Clique em
Ok.
Cliente COM+
CTRL+ALT+F11 e vamos escolher o projeto
ClienteCOMPlus.exe para trabalharmos.
Necessitamos criar o nosso Formulário para dar manutenção
no nosso Cadastro Master/Detail.
Vou nesse momento explicar a intenção do cadastro de
Parceiros. Temos a tabela principal TAB_PARCEIROS, a tabela
de Contatos do Parceiro - TAB_PARCEIROS_CONT, a tabela de
Referências Comerciais e Bancárias na tabela
TAB_PARCEIROS_REFER, o que diferencia cada referência uma
da outra é a coluna: TP_REF. Por isso se você olhar, existe um
TP_REF = ‘?’ no CommandText da tabela
TAB_PARCEIROS_REFER. Ok, agora que já expliquei a
estrutura do nosso exemplo, vamos passar a parte de montagem
do formulário.
Você verá que, o Delphi trata quase tudo internamente para
nós, não necessitamos de quase nenhuma linha de programação
para montar o nosso Master/Detail.
E afirmo que você pode confiar no mecanismo do Delphi para
tal tarefa, até o momento não tive problemas com essa estrutura,
e já criei alguns Master´s/Detail´s dentro do meu sistema.
Mãos a Obra!
Vamos criar um novo FORM no Delphi. Já vamos salvar o
mesmo com o seguinte nome: uFrmParceiros.pas no diretório do
projeto Cliente, isto é, em: C:\DataSnap\Cliente.
O name do nosso Formulário deve ser igual: FrmParceiros, e
seu Caption igual a: Cadastro de Parceiros. Já temos o nosso
FORM pronto para colocarmos os componentes necessários para
criarmos o nosso cadastro Master/Detail. ALT+F11 e devemos
escolher: uDMConexao, Salve Tudo ( )!
Vamos colocar os seguintes componentes no formulário:
MeGAZINE
Delphi
01 (Um) DBNavigator - Align=alBottom;
01 (Um) PageControl - (Guia Win32), seu name deve ser
igual a: PgCntrlParceiros, coloque a sua propriedade Align igual
a: alClient. Logo após vamos criar duas TabSheets, clique com o
botão direito do Mouse no PageControl e escolha New Page duas
vezes. TabSheet1 o seu name deve ser igual: TbShtFormulario e
seu Caption igual a: Formulario, TabSheet2 o seu name deve ser
igual a: TbShtCont_Refer e seu Caption igual a: Contatos e
Referências. Pronto, temos o básico do FORM pronto.
Necessitamos agora, colocar os componentes de acesso ao
Servidor de Aplicação e os Data-awares para manutenção dos
dados.
04 (Quatro) ClientDataSet´s (Guia Data Access);
04 (Quatro) DataSource´s (Guia Data Access);
01 (Um) ConnectionBroker (Guia DataSnap);
01 (Um) SharedConnection (Guia DataSnap);
Na Guia Formulário do PageControl:
02 (Dois) Buttons;
Na Guia Contatos e Referências:
03 (Três) DBGrids;
Antes de iniciar os testes, devemos fazer as seguintes
ligações, até para que possamos utilizar os TFields da Tabela
Principal e deixar o mesmo criar para nós os Data-Awares.
A propriedade Name do SharedConnection deve ser igual a:
ShrdCnctnParceiros, e seu ChildName igual a:
RDMCadParceiros.
Se a mesma não aparecer na lista, reveja as ligações feitas na
Type Library, ParentConnection deve ser igual a:
DMConexao.DCOMCnctnConexao.
A propriedade Name do ConnectionBroker deve ser igual a:
CnctnBrkrParceiros, Connection deve ser igual a:
ShrdCnctnParceiros (O SharedConnection que se encontra no
Formulário).
A propriedade Name do ClientDataSet1 deve ser igual a:
ClntDtStTAB_PARC, ConnectionBroker deve ser igual a:
CnctnBrkrParceiros (O ConnectionBroker que se encontra no
Formulário) e ProviderName deve ser igual a:
DtStPrvdrParceiros, o mesmo deve aparecer na lista se todas as
ligações feitas na Type Library estão corretas.
Duplo click para editar os TFields, e peça para incluir todos os
campos, após isso devemos ter a seguinte Figura (9):
21
 Delphi
Figura 9: TFields de ClntDtStTAB_PARC.
As três últimas colunas são colunas DataSetFields. As
mesmas não existem na Base de Dados, mas, fazem parte do
esquema de Ligação Master/Detail do Delphi.
DataSetField não é um conceito novo, já existia antes da
chegada da dbExpress, mas, está se tornando quase que
obrigatório o uso do mesmo.
Quando criamos um relacionamento em DataSet´s no
Servidor de Aplicação e exportamos o DataSet através do
DataSetProvider, o Delphi cria este novo tipo de Coluna, para
facilitar a nossa vida.
Esta nova Coluna é criada no DataSet Master e representa
todas as linhas do Detalhe para apenas uma linha do Master.
É através dos DataSetFields que ligaremos os
ClientDataSet´s que se encontram no Formulário.
Para colocarmos os DBEdits, devemos executar um Duplo
Click no ClientDataSet- ClntDtStTAB_PARC e arrastar os
TFields criados, mas, deixaremos de fora as Colunas
DataSetField.
DataSource1 deve ter o seu name alterado para:
22
DtSrcTAB_PARC e seu DataSet ligado a: ClntDtStTAB_PARC.
ClientDataSet2 deve ter seu name igual a:
ClntDtStTAB_PARC_CONT e, seu DataSetField igual a:
ClntDtStTAB_PARCSQLDtStTAB_PARCEIROS_CONT.
DataSource2 deve ter o seu name alterado para:
DtSrcTAB_PARC_CONT e seu DataSet ligado a:
ClntDtStTAB_PARC_CONT.
ClientDataSet3 deve ter seu name igual a:
ClntDtStTAB_PARC_REF_C e, seu DataSetField igual a:
ClntDtStTAB_PARCSQLDtStTAB_PARCEIROS_REFER_C.
DataSource3 deve ter o seu name alterado para:
DtSrcTAB_PARC_REFER_C e seu DataSet ligado a:
ClntDtStTAB_PARC_REF_C.
ClientDataSet4 deve ter seu name igual a:
ClntDtStTAB_PARC_REF_B e, seu DataSetField igual a:
ClntDtStTAB_PARC_REF_B.
DataSource4 deve ter o seu name alterado para:
DtSrcTAB_PARC_REFER_B e seu DataSet ligado a:
ClntDtStTAB_PARC_REF_B.
Com as ligações feitas acima, ligamos o Master ao seus
Details.
Devemos apenas ligar os Grids aos seus respectivos
DataSources:
DBGrid1 seu name= DBGrdTAB_PARC_CONT e seu
DataSource= DtSrcTAB_PARC_CONT - DBGrid2 seu name=
DBGrdTAB_PARC_REFER_C e seu DataSource=
DtSrcTAB_PARC_REFER_C - DBGrid3 seu name=
DBGrdTAB_PARC_REFER_B e seu DataSource=
DtSrcTAB_PARC_REFER_B.
Também vamos colocar o name do DBNavigator1=
DBNvgtrTAB_PARC e seu DataSource= DtSrcTAB_PARC.
E por último, ligar os DBEdits ao DataSource:
DtSrcTAB_PARC e ligar os mesmos as suas respectivas colunas.
Após tudo isso, nos falta apenas modificar os names dos
Buttons:
Button1 = BtnAtualizar;
Button2 = BtnCancelar;
Devemos ter a seguinte tela, Figura (10) e Figura (11):
MeGAZINE
 Delphi

Figura 10: A Guia Formulário - Layout Sugerido.

Figura 10: A Guia Formulário - Layout Sugerido.

Figura 11: A Guia Contatos e Referências - Layout Sugerido.

MeGAZINE 23
 Delphi

Vamos implementar nesse momento a unit. No evento procedure TFrmParceiros.BtnCancelarClick

OnCreate() do Formulário, devemos ter o seguinte código, (Sender: TObject);
Listagem 1: begin
if ClntDtStTAB_PARC.ChangeCount > 0 then
procedure TFrmParceiros.FormCreate(Sender: TObject); ClntDtStTAB_PARC.CancelUpdates;
begin end;
ClntDtStTAB_PARC.Open;
end; Listagem 5: O método responsável por desfazer as alterações
locais.
Listagem 1: O Evento OnCreate() do Form e a abertura
da Tabela. A Listagem 5 mostra o método que cancela as alterações
locais. É necessário apenas uma chamada a CancelUpdates para
O Evento OnClose() deve ter o seguinte código, Listagem 2: que todas as alterações, inclusive as dos Detalhes sejam desfeitas.
Se quisermos desfazer apenas as alterações de um determinado
procedure TFrmParceiros.FormClose(Sender: TObject; Detalhe, devemos ter o mesmo método ligado ao ClientDataSet
var Action: TCloseAction); em específico.
begin
ClntDtStTAB_PARC.Close; Agora precisamos definir as “quatros linhas” que “auxiliam”
Action := caFree; o Delphi na tarefa de gravação.

end; No Evento BeforePost() do ClntDtStTAB_PARC, devemos ter

o seguinte código, Listagem 6:
Listagem 2: O Evento OnClose() do Form, o fechamento da
tabela e a liberação dos recursos utilizados pelo formulário. procedure TFrmParceiros.ClntDtStTAB_PARCBeforePost
(DataSet: TDataSet);
O Evento OnDestroy() deve ter o seguinte código, Listagem 3: begin
if DataSet.FieldByName(‘ID_PARC’).IsNull then
procedure TFrmParceiros.FormDestroy(Sender: DataSet.FieldByName(‘ID_PARC’).AsInteger := 0;
TObject); end;
begin
FrmParceiros := nil; Listagem 6: A “Ajuda” para o Delphi gravar sem erros a
end; atualização Local.

Listagem 3: Indicando a referência do formulário para A ajuda na gravação dos dados no Delta. O por que dessa
nil. ajuda eu expliquei na Parte VI.

Devemos ter o seguinte código para o botão - Atualizar - Da mesma forma, devemos proceder para os outros três
Enviar para o Servidor, Listagem 4: ClientDataSets. Como eu utilizei o mesmo nome de Coluna para
a Chave Primária (como sempre faço, PK tem o nome da coluna
procedure TFrmParceiros.BtnAtualizarClick sempre de “ID”, salvo alguns casos, onde necessito de Master/
(Sender: TObject); Detail), posso implementar apenas um evento para os três
begin ClientDataSets. No Evento BeforePost() do
ClntDtStTAB_PARC.ApplyUpdates(0); ClntDtStTAB_PARC_CONT devemos ter o seguinte código,
end; Listagem 7:

Listagem 4: O método responsável por enviar o Delta para o procedure

Servidor de Aplicação. TFrmParceiros.ClntDtStTAB_PARC_CONTBeforePost
(DataSet: TDataSet);
Devemos ter o seguinte código para o botão - Desfazer Dados begin
Locais, Listagem 5: if DataSet.FieldByName(‘ID’).IsNull then

24 MeGAZINE

DataSet.FieldByName(‘ID’).AsInteger := 0;
end;
Listagem 7: Novamente a “Ajuda” para o Delphi gravar sem
erros a atualização Local, neste caso, para os Detalhes.
Agora devemos ligar o evento BeforePost() de
ClntDtStTAB_PARC_REF_C e ClntDtStTAB_PARC_REF_B,
para o mesmo evento de ClntDtStTAB_PARC_CONT.
É necessário apenas uma chamada do ApplyUpdates() para
as tabelas envolvidas em Master/Detail e ligadas através de
DataSetFields.
Server COM+
Mais uma vez o vai e volta de “lados”. Necessitamos apenas
programar o evento BeforeUpdateRecord do DataSetProvider que
se encontra em: RDMParceiros, Listagem 8:
procedure
TRDMParceiros.DtStPrvdrParceirosBeforeUpdateRecord
(Sender: TObject; SourceDS: TDataSet; DeltaDS:
TCustomClientDataSet; UpdateKind: TUpdateKind; var
Applied: Boolean);
begin
if UpdateKind = ukInsert then
begin
if SourceDS = SQLDtStTAB_PARCEIROS then
begin
DeltaDS.FieldByName(‘ID_PARC’).NewValue :=
FIServer_COMPlus.AutoIncremento(‘TAB_PARCEIROS’,’ID_PARC’);
end
else if SourceDS = SQLDtStTAB_PARCEIROS_CONT
then
begin
DeltaDS.FieldByName(‘ID_PARC’).NewValue :=
DeltaDS.DataSetField.DataSet.FieldByName(‘ID_PARC’).AsInteger;
DeltaDS.FieldByName(‘ID’).NewValue :=
FIServer_COMPlus.AutoIncremento(‘TAB_PARCEIROS_CONT’,’ID’);
end
else if SourceDS = SQLDtStTAB_PARCEIROS_REFER_C
then
begin
DeltaDS.FieldByName(‘ID_PARC’).NewValue :=
DeltaDS.DataSetField.DataSet.FieldByName(‘ID_PARC’).AsInteger;
MeGAZINE
Delphi
DeltaDS.FieldByName(‘ID’).NewValue :=
FIServer_COMPlus.AutoIncremento(‘TAB_PARCEIROS_REFER’,’ID’);
DeltaDS.FieldByName(‘TP_REF’).NewValue := ‘C’
end
else if SourceDS = SQLDtStTAB_PARCEIROS_REFER_B
then
begin
DeltaDS.FieldByName(‘ID_PARC’).NewValue :=
DeltaDS.DataSetField.DataSet.FieldByName(‘ID_PARC’).AsInteger;
DeltaDS.FieldByName(‘ID’).NewValue :=
FIServer_COMPlus.AutoIncremento(‘TAB_PARCEIROS_REFER’,’ID’);
DeltaDS.FieldByName(‘TP_REF’).NewValue := ‘B’;
end;
end;
end;
Listagem 8: A regra de negócios Master/Detail.
Vamos analisar a regra:
Estamos verificando apenas se é Inclusão (if UpdateKind =
ukInsert then), após verificamos qual tabela está sendo
atualizada (if SourceDS = SQLDtStTAB_PARCEIROS then... e
demais else ifs...), se for SQLDtStTAB_PARCEIROS, geramos o
AutoIncremento() para a coluna ID_PARC
( DeltaDS.FieldByName(‘ID_PARC’).NewValue :=
FIServer_COMPlus.AutoIncremento(‘TAB_PARCEIROS’,’ID_PARC’);
), se for SQLDtStTAB_PARCEIROS_CONT, passamos a coluna
ID_PARC o relacionamento e criamos o AutoIncremento() para a
coluna ID, fizemos a mesma coisa para as tabelas
SQLDtStTAB_PARCEIROS_REFER_C e
SQLDtStTAB_PARCEIROS_REFER_B, apenas com a diferença
de passarmos o tipo de referência:
(DeltaDS.FieldByName(‘TP_REF’).NewValue := ‘C’ e ou
DeltaDS.FieldByName(‘TP_REF’).NewValue := ‘B’ ), para suas
respectivas tabelas.
Salve Tudo e registre a DLL!
Agora, nos resta apenas testar o exemplo Master/ Detail que
criamos.
Fiz questão de usar colunas e situações que usamos no dia-a-
dia, para, uma melhor compreensão e visualização de como
funciona e como é fácil de criarmos Master/Detail.
A forma que exemplifiquei para a criação de Master/Detail,
não funciona apenas para 3 Camadas, pode ser usada em
Cliente/Servidor e não funciona apenas para a dbExpress,
também pode ser usada com a BDE, IBX, etc.
25
 Delphi
Teste todas as opções do Lado Cliente, inclusive a Exclusão
em Cascata.
Veremos agora, uma figura que representa o Cliente, o
DataSnap(MIDAS) e COM+, Figura (12):
Figura 12: O Esquema de Camadas em aplicações COM+.
26 MeGAZINE
Conclusão
Neste artigo implementamos o “temido” Master/Detail em
aplicações 3 Camadas. Vimos que não é um bicho de sete cabeças
como pensávamos. Criamos também a regra de negócios para a
atualização correta das tabelas envolvidas no Master/Detail.
No Próximo artigo (Parte final), veremos como distribuir
nossos aplicativos usando COM+.
Usaremos para a distribuição a independência total de
localização!
Qualquer dúvida que surja estou a disposição. Também estou
a disposição para troca de idéias.
Sucesso e Saúde a todos! Um Abraço.
Sobre o autor
Anderson Haertel Rodrigues
Consultor em desenvolvimento de Sistemas
Client/Server- MultiCamadas/DataSnap.
Oferece treinamentos para empresas em: InterBase,
SQL-Server, Delphi e COM+.
anderson.hr@bol.com.br anderson.hr@zipmail.com.br
Florianópolis - Santa Catarina - Brasil.

Tudo Sobre Domínios
Autor: Alexandre Magno
O que são domínios?
Um domínio é um template de definições de colunas. Quando
você define uma tabela, você pode especificar o tipo de dado, valor
“default”, character set, null constraints e check constraints para
cada coluna individualmente, ou você pode informar que esta
coluna deve ser definida por um domínio previamente criado com
todas as informações necessárias. Domínios são usualmente
definidos antes da criação das tabelas, para que você possa
utilizá-los na definição destas tabelas.
Use domínio para tipos de colunas que estejam presentes em
várias tabelas do seu banco de dados para tornar fácil a
passagem de parâmetros para estas colunas. Por exemplo, em
um sistema comercial, você deve definir um domínio “CEP” que
será utilizado nos seguintes lugares:
• CEP do Cliente;
• CEP do Fabricante;
• CEP da Filial;
• CEP do Vendedor;
• entre outras...
A instrução CREATE DOMAIN
Use esta instrução para criar um novo domínio. Sua sintaxe
básica é a seguinte:
CREATE DOMAIN domain_name AS datatype;
MeGAZINE
Coluna do Alexandre Magno
Veja no Capítulo 5 do manual Data Definition Guide a sintaxe
completa da instrução CREATE DOMAIN.
O nome do domínio deve ser único em todo o banco de dados e
o tipo de dado deve ser um dos que foram vistos na seção
anterior. Por exemplo:
CREATE DOMAIN Cidade AS VARCHAR(15);
Em adicional, você pode especificar as seguintes opções –
nesta ordem – na parte de definição do domínio:
• O parâmetro DEFAULT
O parâmetro DEFAULT especifica um valor “padrão” para
ser usado se nenhum valor for aplicado. O valor “padrão”
somente é aplicado quando o registro é inserido pela primeira vez
no banco de dados, se você depois remover o valor original, o
DEFAULT não será inserido. A sintaxe da opção default é:
nome_col DEFAULT [valor_default | NULL | USER]
Colocando USER como valor “default” o Firebird adicionará o
nome do usuário que está conectado em cada nova inserção.
DEFAULT geralmente é utilizado nas seguintes situações:
• Para colunas caractere, você pode precisar indicar um valor
“default” explicitamente, ou use NULL para especificar um valor
nulo, ou use USER para especificar o valor do USER NAME
27
 Coluna do Alexandre Magno

corrente. uma coluna diretamente na tabela, a restrição CHECK possui

• Para colunas numéricas, você pode precisar indicar um
valor “default” explicitamente, ou use NULL para especificar um
valor nulo.
• Para colunas data, você pode precisar indicar um valor
“default” explicitamente, ou utilizar uma das seguintes palavras
reservadas: YESTERDAY, TODAY, NOW, TOMORROW, ou
NULL.
• Default não é válido para colunas BLOB.
A seguir alguns exemplos de criação de domínios:
CREATE DOMAIN UltimoAtualizador AS VARCHAR(31)
DEFAULT USER;
opções adicionais. A sintaxe para a restrição CHECK em
definições de domínio é:
CHECK(VALUE expression)
Na definição CHECK, a palavra reservada VALUE
representa o valor da coluna definida neste domínio.
A tabela a seguir mostra os operadores suportados pelo
Firebird para trabalharem juntamente com o parâmetro
VALUE, tabela abaixo.

Expressão Descrição
CREATE DOMAIN DataCadastro AS DATE
DEFAULT ‘Today’;
= value Igual a

CREATE DOMAIN Desconto AS SMALLINT < value Menor que

DEFAULT 0;
> value Maior que
CREATE DOMAIN NumCartaoCredito AS CHAR(19)
DEFAULT NULL; <= value Menor ou igual a

Quando você usa um domínio na definição de uma tabela, o >= value Maior ou igual a
valor DEFAULT pode ser sobrescrito por uma nova condição.
!< value Não menor que

• O parâmetro NOT NULL !> value Não maior que

Este parâmetro força que um valor seja armazenado na <> value Diferente de
coluna. Ele é muito similar à opção REQUIRED encontrada em
alguns bancos de dados de PC, como o Paradox. != value Não igual a

O parâmetro NOT NULL é testado sempre que o registro é BETWEEN value AND value Entre a faixa de valores passada
gravado no banco de dados, e também nas operações de inserção
e atualização. LIKE value Use '%' para 0 ou mais caracteres
Use '_' para 1 único caractere

Não use ambos DEFAULT NULL e NOT NULL na mesma

IN (value,value,...value) Um dos elementos da lista
definição de domínio.

IS NULL Testa se o valor é nulo(ausência

• A restrição CHECK do valor)

CHECK testa o valor inserido dentro da coluna definida pelo IS NOT NULL Testa se o valor é não nulo
domínio para verificar se este valor satisfaz as condições da
expressão. Para definições de domínio, restrições CHECK são CONTAINING value Procura em string case insensitive
limitadas à comparação com um valor ou uma lista de valores, e
somente uma restrição CHECK é permitida. Quando você define STARTING WITH value Procura em string case sensitive

28 MeGAZINE
 Coluna do Alexandre Magno

Por exemplo: A sintaxe do ALTER DOMAIN é como mostramos a seguir:

CHECK(VALUE <= 5) ALTER DOMAIN domain_name

CHECK(VALUE BETWEEN 0 and 10) TYPE novo_tipo(tamanho);
CHECK(VALUE STARTING WITH ‘(091)’)
CHECK(VALUE LIKE ‘%SEN%’) ALTER DOMAIN domain_name
CHECK(VALUE NOT IN(PA, AM, SP)) DROP DEFAULT;
CHECK((VALUE >= ‘YESTERDAY’) AND (VALUE <=
‘TODAY’)) ALTER DOMAIN domain_name
CHECK((VALUE IS NULL) OR (VALUE < 60)) SET DEFAULT default_value | NULL | USER;

• A cláusula COLLATE ALTER DOMAIN domain_name

Somente para colunas CHAR e VARCHAR, você pode DROP CONSTRAINT;
especificar um seqüência de coleção(COLLATE) válida para o ALTER DOMAIN domain_name
character set utilizado. O character set é definido como parte da ADD CHECK(value_expression);
definição do banco de dados, ou com o tipo de dados. Por exemplo,
assumiremos que o character set definido em nosso banco de A instrução DROP DOMAIN
dados foi o ISO8859_1.
O Firebird fornece a instrução DROP DOMAIN para remover
A seguinte definição de domínio seleciona uma das definições um domínio de um banco de dados. Esta instrução só será
de COLLATE deste character set: permitida se nenhuma tabela estiver utilizando o domínio
naquele momento. A sintaxe é:
CREATE DOMAIN Cidade VARCHAR(20)
COLLATE PT_PT; DROP DOMAIN domain_name;

A instrução ALTER DOMAIN Sobre o autor

O Firebird fornece uma instrução ALTER DOMAIN para
mudar o valor default, uma restrição CHECK e/ou o tipo e Alexandre Magno é diretor da Argos Tecnologia em
tamanho do domínio. Esta alteração é aplicada imediatamente Belém do Pará.
em todas as colunas que utilizem aquele domínio. amagno@argostecnologia.com

Windows ou Linux? Ambos!

CLXpert: O mais novo produto Argos já está no mercado
O CLXpert Wizard, é um aplicativo desenvolvido pela Argos
Tecnologia, que porta com extrema desenvoltura e facilidade seu
projeto Delphi, para um projeto nativo Kylix.Saiba mais sobre o
produto e solicite logo o seu!

Argos Tecnologia Ltda - Av. Almte. Wandenkolk, nº 811, sala 1003, Umarizal - Belém / PA
Fones: (91) 222-6578 - http://www.argostecnologia.com/clxpert/

MeGAZINE 29
 Perguntas & Respostas

Perguntas &
Respostas
Pergunta: Como fazer o componente SQLConection receber Pergunta: Criei uma aplicação usando o IntraWeb e preciso
as configurações de um arquivo INI que eu criei? Eu vi que que ao ser executado seja carregado um arquivo INI que
existe uma propriedade LoadFromFileIni mas como usá-la? configura o acesso ao Oracle. Este arquivo INI está junto a
aplicação no servidor.
Resposta: Para passar as configurações para o Tentei:
sqlConnection, primeiro crie um arquivo INI contendo os WebApplication.GetNamePath;
parâmetros necessários para a conexão: WebApplication.UrlBase;
WebApplication.IP;
[MINHA_CONEXAO]
DriverName=Interbase Nenhum funcionou a contento. A forma que consegui foi usando
BlobSize=-1 o caminho dentro da aplicação:
CommitRetain=False vCaminho := ‘c:\inetpub\wwwroot\Isapi\MeuArq.INI’;
Database=192.168.0.1:C:\PASTA\ARQUIVO.GDB Mas preciso de algo dinâmico. Vocês tem alguma solução para o
ErrorResourceFile= problema?
LocaleCode=0000 Resposta: Existe uma variável de ambiente no Intraweb que
Password=masterkey retorna o path físico onde a aplicação está rodando, veja o código
RoleName=RoleName abaixo:
ServerCharSet=
SQLDialect=3 uses
Interbase TransIsolation=ReadCommited SWSystem;
User_Name=sysdba procedure TformMain.IWButton1Click(Sender: TObject);
WaitOnLocks=True begin
IWEdit1.Text := gsAppPath; // retorna o path
A propriedade “LoadParamsOnConnect” deve estar “False”; end;

Importante: As propriedades abaixo devem estar Dúvida enviada Nirlan E. Fundão, São Mateus/ES.
preenchidas:
Pergunta: Estou precisando mudar a propriedade
GetDriverFunc = getSQLDriverINTERBASE DisplayFormat dos TFields de um componente TIBQuery em
LibraryName = dbexpint.dll tempo de execução, para que em uma consulta os dados
VendorLib = GDS32.DLL aparecam formatados. Sendo que a propriedade referida
é somente leitura, gostaria de saber de que forma eu conseguiria
Após isso, para carregar os parâmetros e ativar o realizar esta formatação.
sqlConnection utilize o método abaixo: Resposta: Para fazer este processo basta utilizar a seguinte
instrução:
sqlConnection.LoadParamsFromIniFile(
ExtractFilePath(ParamStr(0)+’Config.Ini’); TFloatField(IBQuery.FieldByName(
sqlConnection.Open; ‘NomeCampo’)).DisplayFormat := ‘###,##0.00’;

Dúvida enviada por Editora Alto Astral, Bauru/SP. Dúvida enviada por Edson Murilo Maestri, Blumenal/SC

30 MeGAZINE