< Anterior | Próximo >

Lição 4: Criar Partes para Acessar um Banco de Dados

Nessa lição, você criará as partes de dados e de lógica que permitem acessar o banco de dados de amostra.
O assistente do Aplicativo de Acesso aos Dados do EGL cria o código do EGL necessário para acessar um banco de dados. Embora seja possível customizar o código quando o assistente é executado, geralmente o assistente cria as seguintes partes do EGL:

Criar Partes a partir da Conexão com o Banco de Dados

Na lição anterior, você criou uma conexão com o banco de dados. Nessa conexão, o EGL pode criar as partes necessárias para acessar o banco de dados:

  1. Clique em Arquivo > Novo > Outro. A janela Novo é aberta.
  2. Expanda EGL e clique em Aplicativo de Acesso a Dados.
  3. Clique em Avançar.
  4. Na janela Definir Configurações do Projeto, certifique-se de que EGLWeb seja exibido na lista Nome do Projeto.
  5. Na lista Conexão com o Banco de Dados, selecione a conexão EGLDerbyDB criada na lição anterior. Pode ser solicitado um ID de usuário e uma senha para o banco de dados. Nesse caso, insira qualquer nome e senha; o banco de dados não exige uma senha, mas as ferramentas de dados do ambiente de trabalho podem esperar uma senha. Você estabeleceu uma conexão com o banco de dados. Todas as tabelas no banco de dados estão listadas em Nome da Tabela na parte inferior do assistente. Você não criará partes de dados para todas essas tabelas porque algumas contêm apenas metadados.
  6. Em Selecionar Tabelas, selecione as caixas de opção ao lado das seguintes tabelas apenas:
    • EGL.CUSTOMER
    • EGL.ITEM
    • EGL.ORDERITEM
    • EGL.ORDERS
    • EGL.SITEUSER
    • EGL.STATETABLE
    O assistente Aplicativo de Acesso aos Dados do EGL é semelhante a este:
    Imagem da janela Aplicativo de Acesso aos Dados do EGL com as seis tabelas selecionadas
  7. Certifique-se de que a caixa de seleção Criar Páginas da Web esteja desmarcada. Se essa caixa de opção estiver selecionada, o EGL cria páginas da Web diretamente a partir das tabelas de banco de dados. Este recurso pode economizar tempo criando um aplicativo de acesso a dados simples para você, mas isso iria contra o propósito deste tutorial.
    Nota: Não clique em Concluir ainda. Você deve alterar mais uma configuração neste assistente.
  8. Clique em Avançar para ir para a página Definir os Campos. Esta página permite incluir campos-chave nas tabelas de banco de dados. Não altere nenhuma configuração nesta página; o banco de dados já possui um campo-chave em cada tabela.
  9. Clique em Avançar novamente para ir para a página Definir Opções de Criação do Projeto.
  10. Na página Definir Opções de Criação do Projeto, selecione a caixa de opção Qualificar Nomes de Tabela com o Esquema.
  11. Clique em Concluir.

Ponto de Verificação da Lição

O assistente Aplicativo de Acesso a Dados criou diversos artefatos do EGL em seu projeto EGLWeb.

Em primeiro lugar, há diversos novos pacotes EGL na pasta EGLSource de seu projeto EGLWeb, incluindo eglderbydb.data, eglderbydb.access e eglderbydb.primitivetypes.data. Os pacotes funcionam exatamente como pastas: contêm seus arquivos de código-fonte e os organizam em grupos significantes. Nesse caso, o pacote eglderbydb.data armazena os registros, o pacote eglderbydb.access armazena as bibliotecas e o pacote eglderbydb.primitivetypes.data armazena os DataItems.

Eis alguns arquivos que serão úteis para este tutorial:
eglderbydb.primitivetypes.data.DataDefinitions.egl
Este arquivo lista todos os Itens de Dados que formam as partes de Registro nos outros arquivos. Por exemplo, o número do ID do cliente fornecido para cada registro de cliente no banco de dados é representado por um DataItem nomeado CUSTOMER_ID:
dataitem CustomerId INT end
Nesse caso, o campo do número do ID é baseado no tipo primitivo inteiro. O DataItem pode ter outras propriedades para especificar detalhes como seu intervalo válido de valores e como deve ser formatado na UI.
eglderbydb.data.Customer.egl
Este arquivo contém um dos registros criados a partir das tabelas de banco de dados, nesse caso, a tabela Cliente. Este registro contém campos para armazenar informações sobre um cliente, como o nome, sobrenome, endereço, número de telefone e número do ID do cliente. A definição do registro é semelhante a esta:
record Customer type sqlRecord { 
        tablenames=[["EGL.CUSTOMER"]],
        fieldsMatchColumns = yes,
        keyItems=[CUSTOMERID]
    }  

  CUSTOMERID CUSTOMERID {column="CUSTOMERID"};
  FIRSTNAME FIRSTNAME {column="FIRSTNAME", sqlVariableLen=yes, maxLen=30,
isSqlNullable=yes};
  LASTNAME LASTNAME {column="LASTNAME", sqlVariableLen=yes, maxLen=30,
isSqlNullable=yes};
  ...
end
eglderbydb.access.CustomerLib.egl
Este arquivo contém uma biblioteca gerada automaticamente de funções que podem ser usadas para acessar a tabela Clientes do banco de dados. Por exemplo, a primeira função é AddCustomer, que inclui um novo registro de cliente no banco de dados. Há outras funções nesta biblioteca que recuperam, atualizam e excluem registros do banco de dados, e cada tabela possui funções semelhantes em uma biblioteca separada. Você usará essas funções posteriormente no tutorial.
< Anterior | Próximo >

Feedback