Algumas Idéias » .NET

Usando o Castle ActiveRecord

Fabiano França — Fri, 28 Mar 2008 00:11:48 +0000

O Castle ActiveRecord é uma implementação do pattern Active Record desenvolvido em .NET em cima do NHibernate.

Ele faz parte do pacote de frameworks do projeto Castle Projet, e tem forte influencia da implementação do Active Record do framework Ruby On Rails.

Entre as muitas características dele vale destacar, a possibilidade de mapeamento de classes via atributos e não dos famigerados arquivos xml e um mecanismo de validação eficiente e flexível.

Criando o projeto

Acesse a página de download do projeto, baixe o arquivo Castle-net-2.0-release-2007-9-20.zip e descompacte em algum diretório da sua preferência.

Em seguida crie um novo projeto web e faça referência as assemblies abaixo:

Castle.ActiveRecord.dll
Castle.Core.dll
Castle.Components.Validator.dll
Castle.DynamicProxy.dll
NHibernate.dll
Iesi.Collections.dll
log4net.dll

Criando a tabela de Contatos

Crie uma base de dados chamada ContatosAR e em seguida crie uma tabela com a estrutura abaixo.

CREATE TABLE [dbo].[Contatos](
	[Id] [int] IDENTITY(1,1) NOT NULL,
	[Nome] [varchar](255) NOT NULL,
	[Email] [varchar](255) NOT NULL,
 CONSTRAINT [PK_Contatos] PRIMARY KEY CLUSTERED
(
	[Id] ASC
)WITH (PAD_INDEX  = OFF, STATISTICS_NORECOMPUTE  = OFF, IGNORE_DUP_KEY = OFF, ALLOW_ROW_LOCKS  = ON, ALLOW_PAGE_LOCKS  = ON) ON [PRIMARY]
) ON [PRIMARY]

Criando a classe Contato

Agora vamos criar a classe que vai representar a nossa tabela.

using System;

public class Contato
{
  private int id;
  private string nome;
  private string email;

  public int Id
  {
    get { return id; }
    set { id = value; }
  }

  public string Nome
  {
    get { return nome; }
    set { nome = value; }
  }

  public string Email
  {
    get { return email; }
    set { email = value; }
  }
}

Mapeando a classe Contato

Mapeando a nossa classe para o NHibernate. Só que em vez do xml entra em cena os atributos disponíveis no ActiveRecord.

[ActiveRecord("Contatos")]
public class Contato : ActiveRecordValidationBase
{
    private int id;
    private string nome;
    private string email;

    [PrimaryKey(PrimaryKeyType.Native, "Id")]
    public int Id
    {
      get { return id; }
      set { id = value; }
    }

    [Property("Nome")]
    [ValidateNonEmpty("Nome é requirido")]
    [ValidateLength(1, 255, "Nome deve ter no máximo 255 caracteres")]
    public string Nome
    {
      get { return nome; }
      set { nome = value; }
    }

    [Property("Email")]
    [ValidateNonEmpty("E-mail é requirido")]
    [ValidateLength(1, 255, "E-mail deve ter no máximo 255 caracteres")]
    [ValidateEmail("E-mail inválido")]
    public string Email
    {
      get { return email; }
      set { email = value; }
    }
}

Configurando o ActiveRecord

No arquivo Web.Config adicione o código abaixo e altere a chave hibernate.connection.connection_string para apontar para a sua instância do SQL Server.

E no arquivo Global.asax adicione o código abaixo.

<%@ Application Language="C#" %>

<%@ Import Namespace="Castle.ActiveRecord" %>
<%@ Import Namespace="Castle.ActiveRecord.Framework" %>
<%@ Import Namespace="Castle.ActiveRecord.Framework.Config" %>

Listando os contatos

Agora, com o ActiveRecord configurado, vamos criar uma página para listar todos os contatos cadastrados na base de dados (nenhum até o momento).

ListarContatos.aspx.cs

public partial class ListarContatos : System.Web.UI.Page
{
    protected void Page_Load(object sender, EventArgs e)
    {
        gvContatos.DataSource = Contato.FindAll();
        gvContatos.DataBind();
    }
}

Inserindo um contato

Montando o formulário de inserção. De propósito vou deixar para fazer a validação no servidor.

Novo contato

Nome:

E-mail:

ou Voltar

NovoContato.aspx.cs

public partial class NovoContato : System.Web.UI.Page
{
    protected void btnSalvar_Click(object sender, EventArgs e)
    {
        pnMensagem.Visible = true;
        lblMensagem.Text = "";

        Contato contato = new Contato();

        contato.Nome = txtNome.Text;
        contato.Email = txtEmail.Text;

        if (contato.IsValid())
        {
            contato.Create();

            lblMensagem.Text = "Contato criado com sucesso.";

            txtNome.Text = "";
            txtEmail.Text = "";
        }
        else
        {
            foreach (string s in contato.ValidationErrorMessages)
                lblMensagem.Text += s;
        }
    }
}

Editando um contato

Editar contato

Nome:

E-mail:

ou Voltar

EditarContato.aspx.cs

public partial class EditarContato : System.Web.UI.Page
{
    protected void Page_Load(object sender, EventArgs e)
    {
        if (!Page.IsPostBack)
        {
            Contato contato = Contato.Find(Convert.ToInt32(Request.QueryString["Id"]));

            txtNome.Text = contato.Nome;
            txtEmail.Text = contato.Email;
        }
    }

    protected void btnSalvar_Click(object sender, EventArgs e)
    {
        pnMensagem.Visible = true;
        lblMensagem.Text = "";

        Contato contato = Contato.Find(Convert.ToInt32(Request.QueryString["Id"]));

        contato.Nome = txtNome.Text;
        contato.Email = txtEmail.Text;

        if (contato.IsValid())
        {
            contato.Update();

            lblMensagem.Text = "Dados do contato atualizados com sucesso.";
        }
        else
        {
            foreach (string s in contato.ValidationErrorMessages)
                lblMensagem.Text += s;
        }
    }
}

Código do projeto

O código do projeto está disponivel para download.

Ele foi desenvolvido usando o Microsoft Visual Web Developer 2008 Express Edition com o SQL Server Express 2005.

Em breve

Depois dessa passada superficial vou tentar preparar uma série de posts detalhando mais as funcionalidades do framework.

Automatic Properties

Fabiano França — Thu, 27 Mar 2008 13:31:21 +0000

No post anterior acabei usando um recurso disponível no C# 3.0 que ficou sem explicação.

O Automatic Properties.

public class Pessoa {
  public string Nome { get; set; }
  public string Email { get; set; }
}

Agora ao encontrar a declaração { get; set; }, o compilador gera automaticamente a variável privada e a implementação necessária para a propriedade.

Também é possível declarar uma propriedade como somente leitura usando o accessor private.

public class Pessoa {
  public int Id { get; private set; }
  public string Nome { get; set; }
  public string Email { get; set; }
}

E caso você precise usar atributos é necessário fazer a declaração da propriedade do modo tradicional.

Object e Collection Initializers

Fabiano França — Thu, 27 Mar 2008 13:05:57 +0000

Mais uma novidade do C# 3.0 é a nova sintaxe para a inicialização de objetos e coleções.

Object Initializers

Agora podemos ao instanciar um objeto passar valores para as suas propriedades.

public class Pessoa {
  public string Nome { get; set; }
  public string Email { get; set; }
} 

Pessoa joao = new Pessoa() { Nome = "João", Email = "joao@gmail.com" };
Pessoa maria = new Pessoa() { Nome = "Maria", Email = "maria@gmail.com" };

No exemplo acima, são instanciados dois objetos do tipo Pessoa, chamando o construtor padrão, e em seguida setadas as propriedades Nome e Email.

Tudo em uma única linha de código.

Também é possível passar parâmetros para o construtor, conforme o exemplo a seguir:

public class Pessoa {
  public string Nome { get; set; }
  public string Email { get; set; }
  public int Idade { get; set; }

  public Pessoa(string nome)
  {
    this.Nome = nome;
  }
}

Pessoa pedro = new Pessoa("Pedro") {
  Email = "pedro@gmail.com",
  Idade = 20
};

Collection Initializers

Já nas coleções podemos passar um conjunto de objetos.

No exemplo abaixo a coleção pessoas é instanciada com os objetos joao, maria e pedro como os seus membros.

IList pessoas = new List() { joao, maria, pedro }

É aqui uma combinação das duas formas.

IList pessoas = new List() {
  joao, maria, pedro,
  new Pessoa() { Nome = "Jose", Email = "jose@gmail.com" }
}

Conclusão

Como vimos nesse segundo post, o C# 3.0 vem trazendo grandes melhorias para a implementação de um código mais legível e bonito.

Muitas dessas melhorias foram influenciadas por dois projetos da Microsoft Research, o F# e o Cω.

Nesse post, Tomas Petricek detalha as novidades incorporadas no C# 3.0 vindas desses dois projetos.

Extension Methods

Fabiano França — Thu, 27 Mar 2008 00:18:26 +0000

Umas das novidades do C# 3.0 é a possibilidade de adicionar comportamento a uma classe sem a necessidade da criação de uma subclasse ou da recompilação do código original.

Essa funcionalidade é chamada de Extension Methods.

Criando um Extension Method

Imagine que você precisa validar se uma string é um e-mail válido. A solução mais comum é a definição de um método de validação (estático) em uma classe utilitária (estática).

static class Program
{
  static void Main(string[] args)
  {
    string emailCliente = System.Console.ReadLine();

    if (!Utilidades.IsEmailValido(emailCliente))
      System.Console.WriteLine("E-mail informado inválido.");
  }
}

Usando um Extension Method a solução é parecida, mas a utilização é mais elegante.

if (!emailCliente.IsEmailValido())
  System.Console.WriteLine("E-mail informado inválido.");

A criação do Extension Method se resume a definição de uma classe estática com um método estático.

namespace Utilidades
  public static class Extensoes
  {
    public static bool IsEmailValido(this string email)
    {
      return Regex.IsMatch(email, @"^[\w-\.]+@([\w-]+\.)+[\w-]{2,4}$");
    }
  }
}

Notem o keyword this antes da declaração do primeiro parâmetro. Ele é responsável por passar ao compilador que o método IsEmailValido é aplicável a todos os objetos do tipo string.

E para utilizar o extension method basta importar o namespace que contém a classe estática usando o statement using. Sendo que não é necessária a importação caso as classes estejam dentro do mesmo namespace.

using Utilidades;

Passando parâmetros para o Extension Method

namespace Utilidades
  public static class Extensoes
  {
    public static bool IsMaiorQue(this string s, int tamanho)
    {
      return s.Length > tamanho;
    }
  }
}

string nome = "Joao da Silva";

if (nome.IsMaiorQue(10))
  System.Console.WriteLn("Nome só pode ter 10 caracteres");

Com essa introdução dá para ter uma pequena idéia das possibilidades. Vale lembrar que também é possível criar extension methods para interfaces e generics.

Abaixo três boas referências que valem à pena dar uma lida.