Fuçando no wiki descobri que a versão 3.0.4 da gem RedCloth, utilizada pelo helper, tem um bug que não identifica corretamente as quebras de linha como parágrafos.

Como solução, é indicado o downgrade/atualização para as versões 3.0.3 ou 4.0 da gem (ainda em desenvolvimento) ou a utilização do patch abaixo no environment.rb.

class RedCloth
  # Patch for RedCloth.  Fixed in RedCloth r128 but _why hasn't released it yet.
  # http://code.whytheluckystiff.net/redcloth/changeset/128
  def hard_break( text )
    text.gsub!( /(.)\n(?!\n|\Z| *([#*=]+(\s|$)|[{|]))/, "\\1" ) if hard_breaks
  end
end

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<Contato>
{
    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.

<?xml version="1.0"?>

<configuration>
  <configSections>
    <section name="activerecord"
                   type="Castle.ActiveRecord.Framework.Config.ActiveRecordSectionHandler, Castle.ActiveRecord" />
  </configSections>

  <activerecord isWeb="true">
    <config>
      <add key="hibernate.connection.driver_class"
                 value="NHibernate.Driver.SqlClientDriver" />
      <add key="hibernate.dialect"
                 value="NHibernate.Dialect.MsSql2005Dialect" />
      <add key="hibernate.connection.provider"
                 value="NHibernate.Connection.DriverConnectionProvider" />
      <add key="hibernate.connection.connection_string"
                 value="Data Source=.;Initial Catalog=ContatosAR;Integrated Security=True" />
    </config>
  </activerecord>
</configuration>

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" %>

<script runat="server">
    void Application_Start(object sender, EventArgs e)
    {
        IConfigurationSource source = ActiveRecordSectionHandler.Instance;
        ActiveRecordStarter.Initialize(source, typeof(Contato));
    }
</script>

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).

<asp:GridView ID="gvContatos" AutoGenerateColumns="false" runat="server">
    <Columns>
        <asp:HyperLinkField DataNavigateUrlFields="Id"
                DataNavigateUrlFormatString="EditarContato.aspx?Id={0}"
		DataTextField="Nome" HeaderText="Nome" />

	    <asp:BoundField DataField="Email" HeaderText="E-mail" />
    </Columns>
</asp:GridView>

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.

<h3>Novo contato</h3>

<asp:Panel ID="pnMensagem" runat="server" Visible="false">
    <asp:Label ID="lblMensagem" runat="server" />
</asp:Panel>

<p>
    <asp:Label ID="lblNome" runat="server" AssociatedControlID="txtNome">Nome:</asp:Label>
    <asp:TextBox ID="txtNome" runat="server" Columns="40" MaxLength="255"></asp:TextBox>
</p>

<p>
    <asp:Label ID="lblEmail" runat="server" AssociatedControlID="txtEmail">E-mail:</asp:Label>
    <asp:TextBox ID="txtEmail" runat="server" Columns="40" MaxLength="255"></asp:TextBox>
</p>				

<asp:Button ID="btnSalvar" runat="server" OnClick="btnSalvar_Click" Text="Salvar" />
ou <a href="ListarContatos.aspx">Voltar</a>

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

<h3>Editar contato</h3>

<asp:Panel ID="pnMensagem" runat="server" Visible="false">
    <asp:Label ID="lblMensagem" runat="server" />
</asp:Panel>

<p>
    <asp:Label ID="lblNome" runat="server" AssociatedControlID="txtNome">Nome:</asp:Label>
    <asp:TextBox ID="txtNome" runat="server" Columns="40" MaxLength="255"></asp:TextBox>
</p>

<p>
    <asp:Label ID="lblEmail" runat="server" AssociatedControlID="txtEmail">E-mail:</asp:Label>
    <asp:TextBox ID="txtEmail" runat="server" Columns="40" MaxLength="255"></asp:TextBox>
</p>				

<asp:Button ID="btnSalvar" runat="server" OnClick="btnSalvar_Click" Text="Salvar" />
ou <a href="ListarContatos.aspx">Voltar</a>

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.

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 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<Pessoa> pessoas = new List<Pessoa>() { joao, maria, pedro }

É aqui uma combinação das duas formas.

IList<Pessoa> pessoas = new List<Pessoa>() {
  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.

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.

• http://weblogs.asp.net/scottgu/archive/2007/03/13/new-orcas-language-feature-extension-methods.aspx
• http://msdn2.microsoft.com/en-us/library/bb308966.aspx#csharp3.0overview_topic3
• http://blogs.msdn.com/vbteam/pages/articles-about-extension-methods.aspx

“A gem Magic Models estende o ActiveRecord permitindo que ele consiga gerar os relacionamentos (belongs e has_many) e validações (presence, length, numericality, inclusion e uniqueless) dos modelos automáticamente a partir da estrutura da base de dados.”

Você pode ver o código no Pastie ou baixar o projeto.

Uso o Windows XP Professional English com a localidade e configurações regionais definidas para as brasileiras mas a interface do NetBeans sempre ficou em inglês.

Mas depois de ter atualizado ele ontem algumas opções começaram a aparecer em português. De menus até a estrutura do projeto Rails na aba Projects.

Como prefiro a IDE em inglês isso começou a me irritar. Por sorte a solução é bem simples.

Basta editar o arquivo “netbeans.conf”, por padrão em C:\Program Files\NetBeans 6.0.1\etc, e na opção “netbeans_default_options” adicionar ao final da string os parâmetros abaixo:

-J-Duser.language=en -J-Duser.region=US

Referência: http://blogs.sun.com/tao/entry/set_netbeans_user_interface_language

Como queria testar a idéia e estava com preguiça de instalar o Ubuntu em uma máquina virtual acabei reescrevendo um pedaço do código e mudando do thin para a dupla Mongrel / WEBrick.

Aproveitei o embalo e montei um “SQLite3 resource scaffold”.

Como ainda não configurei direito o Wordpress para postagem de código, coloquei os scripts no Pastie.

http://pastie.caboo.se/155367

UPDATE: Onde tudo começou: Single file Rails Application