.NET - Usando Data Access Application Blocks III

No artigo anterior iniciei o nosso exemplo para usar o  Data Access Application Blocks - DAAB criando a base de dados, a tabela, as stored procedures e preparando o ambiente para referenciar a Enterprise Library.

Vamos continuar criando uma classe onde iremos definir os métodos de acesso aos dados usando a DAAB. Clique com o botão direito do mouse sobre o nome do projeto e selecione a opção Add ->  New Item;

Na janela Add New Item selecione o template Class e informe o nome contatosDAL;

Agora vamos criar 5 métodos relacionados com as stored procedures que já criamos e que irão realizar as seguintes operações:

1. Incluir dados na tabela Contatos :
2. Alterar Dados da tabela Contatos;
3. Excluir Dados da tabela Contatos;
4. Selecionar todos os dados da tabela Contatos;
5. Selecionar um contato especifico por nome;

A primeira coisa a fazer é definir os namespaces para as classes que vamos usar. Portanto no início da classe declare os seguintes imports:

Nota: No VB .NET  o comando Imports deve ser colocado no topo do código antes de todo e qualquer comando, exceto a declaração Option;

Imports Microsoft.Practices.EnterpriseLibrary.Data
Imports System.Data.SqlClient
Imports System.Data.Common

1- O primeiro método eu vou nomear como selecionaTodosContatos, e irá retornar todos os contatos; desta forma vamos usar a stored procedure sp_SelecionaContatos para retornar todos os contatos, preencher um DataTable e retorná-lo. O código é dado a seguir:

Notou como temos um código mais limpo e fácil de ler e manter. Estamos usando os métodos do DAAB definidos na Enterprise Library.

2- O segundo método , chamado incluirContatos, irá incluir novos contatos na tabela Contatos e vai usar a stored procedure sp_IncluiContatos. Teremos que passar dois parâmetros : nome e email e obter a data do sistema usando a função . O código completo do método é o seguinte:

Veja que com apenas  6 linhas de código criamos a rotina de inclusão.

3- O terceiro , chamado excluiContatos, irá excluir contatos já cadastrados na tabela Contatos e vai usar a stored procedure sp_ExcluiContato. Não há parâmetros nesta rotina. O código completo do método é o seguinte:

4- O quarto método , chamado selecionaContatoPorCodigo, irá selecionar um contato pelo código informado como parâmetro. Aqui estamos usando a stored procedure sp_SelecionaContatoPorCodigo e passando o parâmetro codigo. Será retornado um dataset com os dados obtidos. Veja o código a seguir:

5- O último método , chamado atualizaContatos, irá atualizar os contatos da tabela Contatos. Aqui estamos usando 3 parâmetros : codigo, nome e email e a stored procedure sp_AlteraContatos. Veja o código abaixo:

Com isso terminamos de definir os métodos que iremos usar em nossa aplicação em todos eles usamos os métodos das classes presentes no DAAB.

A classe abstrata DataBase fornece diversos métodos que podemos usar conforme o nosso interesse. A seguir relaciono alguns deles:

• ExcuteDataSet
• ExecuteNonQuery
• ExecuteReader
• ExecuteScalar
• GetSqlStringCommand
• GetStoredProcCommand
• LoadDataSet
• UpdateDataSet
• AddInParameter
• AddOutParameter

O método CreateDataBase da classe DataBaseFactory irá retornar uma instância de um banco de dados a partir das configurações que forem definidas no arquivo de configuração. No nosso exemplo o arquivo App.Config.

Podemos então ter vários banco de dados definidos no arquivo de configuração. Veja abaixo um arquivo de configuração com mais dois bancos de dados definidos: 1 banco de dados Access(Teste) e outro SQL Server Compact(Vendas) , além do nosso banco de dados Agenda.mdf:

Eles são diferenciados pelo nome dado a string de conexão através da propriedade name. Podemos definir então qual banco de dados iremos usar definindo o <dataConfiguration defaultDataBase>.

O método CreateDataBase aceita um argumento que representa uma entrada de uma instância de um DataBase no arquivo de configuração. Alterando esta instância podemos alterar o tipo de objeto de banco de dados que o método irá retornar. Percebeu que não precisamos declarar objetos SQLDataBase , pois estou usando a classe base , DataBase, abstraindo assim o meu código do provedor. Tudo isso é feito usando o padrão Factory.

Como a classe DataBaseFactory é NotInheritable (Sealed) ela não pode ser herdada, e o seu construtor é privado de modo que ela não pode também ser instanciada diretamente. Com isso podemos chamar o método estático CreateDataBase sem ter que criar uma instância da sua classe.

Como estamos usando stored procedures estou usando o método GetStoredProcCommand para executar cada uma das stored procedures definidas. Se eu quiser comandos SQL temos o método GetSqlStringCommand.

Vamos agora criar um formulário para centralizar estas operações.

Clique com o botão direito do mouse sobre o nome do projeto e selecione a opção Add -> New  Item; e a seguir selecione Windows Forms e informe o nome frmContatos.vb.

Defina neste formulário o leiaute conforme a figura abaixo. Nela temos os seguintes componentes:

DataGridView - dgvContatos 4 controles Buttons: - btnIncluir - btnAlterar - btnExcluir - btnConsultar - btnSair

No próximo artigo irei mostrar como implementar o código de cada um dos botões para realizar as operações básicas de manutenção de dados usando os métodos da nossa classe contatosDAL.

Veja continuação no artiigo... Usando Data Access Application Blocks IV

Eu sei , é apenas VB .NET , mas eu gosto..

referências:

• Usando Data Access Application Blocks I
•  .NET  - Usando Data Access Application Block
•  .NET  - Apresentando a Enterprise Library - Application Blocks

• Factories de Provedores

• ADO.NET Novos recursos

José Carlos Macoratti