Eduardo Silva

Problemas com Repository e ORM

2014-08-04T22:30:00.000-07:00

Em um post anterior eu evidenciei uma tendência de se encapsular frameworks em classes da própria aplicação. Dei uma atenção especial ao padrão Repository utilizado com ORM’s, e nesse post resolvi destacar outros problemas que podem ocorrer com esse padrão.

Nem sempre é fácil identificar a responsabilidade

Quando estamos definindo os métodos do repositório os métodos básicos são fáceis de definir:

GetById;
Save (InsertOrUpdate);
Delete;
GetBy(Filter filters);

Vamos pegar um cenário onde você tenha um classe Customer e a classe Sale tendo cada uma delas a sua devida implementação do Repository.
Agora imagine um item do seu dashboard onde você exibe o total de vendas dos clientes:

Em qual repository você colocaria a implementação dessa consulta? Customer ou Sale?

Funcionalidades que requerem consultas e escritas no banco de dados que cruzam as fronteiras estabelecidas pelo padrão é algo muito comum. Quando surgem cenários desse tipo alguns utilizam estrategias que podem degradar a performance da aplicação como o Select N+1.

Dificuldade para resolver problemas de Performance

O Select N + 1 significa que você foi mais de uma vez no banco de dados para obter dados, no exemplo acima tivemos as seguintes requisições no banco de dados.

Obtém todos os clientes;
Quando acionada a propridade Sales de o sistema foi no banco para obter as respectivas vendas, ou seja, se tivermos 10 clientes o sistema irá 10 vezes no banco buscar as vendas de dos clientes;

Até aqui esses problemas reportados não é culpa do padrão + ORM mas só do padrão. Com os repositories nós não conseguimos customizar o retorno do banco de dados para necessidades especificas, até por que isso foge um pouco das responsabilidades do padrão.

Como uma solução pra esses tipos de problemas muitos preferem expor recursos do ORM pelo Repository, como exemplo:

Enable/Disable Lazy Loading;
Multi Queries;
Operações em Batch;

O problema que isso se torna um “vazamento” da abstração que o Repository se propõe a fazer, se chegamos nesse ponto por que precisamos do padrão?

Organização e reaproveitamento de código

Alguns programadores ainda defendem a utilização do Repository por questões de organização e reaproveitamento de código e realmente processos de escrita e leituras duplicados não é legal. Pra resolver esses problemas já existem outros padrões bem interessantes pra ser utilizado (QueryObjects e CQRS).

Conclusão

Encapsular frameworks não é uma boa idéia, isso não significa que você não possa criar "facilitadores" para melhorar ou até mesmo contextualizar os frameworks para sua necessidade. Acredito que o ideal é sempre permitir que esses frameworks sejam utilizados diretamentes se necessário, assim todo o potencial dessas ferramentas sempre estará disponível.

Validando datas para envio ao banco de dados SQL Server

2014-03-06T23:00:00.000-08:00

É muito comum achar validação de dados para envio ao banco de dados da seguinte forma:

O problema de validar desta forma é que o DateTime.MinValue retorna 00:00:00.0000000, January 1, 0001 enquanto a data minima aceita pelo SQL Server é 1/1/1753.

Para que a validação seja valida para o envio a um banco de dados SQL Server você pode fazer como abaixo:

Ícones Sprite, só usar!

2014-01-24T22:00:00.000-08:00

Ícones sprite com o css prontinho, só chegar e usar!

https://github.com/eduardosilva/icons-silk-sprite
https://github.com/eduardosilva/icons-fugue-sprite
https://github.com/eduardosilva/icons-farm-fresh-sprite

Carregando dinamicamente as configurações do Entity Framework Code First

2014-01-14T22:00:00.000-08:00

Abaixo um exemplo de como carregar as configurações customizadas de mapeamentos para o Entity Framework Code First.

Postmon - API para consultar CEP

2013-12-12T22:00:00.000-08:00

O Postmon é uma api REST construída em Python e MongoDB para consulta de CEP e encomendas.
Nessa apresentação do InfoQ Alê Borba conta a história da criação da API.

Site da API: http://postmon.com.br/

Templates free para o Bootstrap

2013-12-10T22:00:00.000-08:00

Pra quem ainda não conhece o Bootstrap, ele é um dos mais famosos frameworks de interface web.
Amplamente difundido entre designers e programadores, sua utilização tem sido cada vez mais utilizadas principalmente devido a recursos bem interessantes como recurso de layout reponsive.

Um dos sites mais famosos de vendas de layout, o ThemeForest tem em vários de seus produtos o Bootstrap como base. Mas pra quem não esta afim de gastar em torno U$30,00 (em média) para ter um layout pronto com o Bootstrap, você pode baixar layouts free (bem mais simples) no Start Bootstrap ele tem alguns templates prontos como:

Shop Homepage: http://startbootstrap.com/shop-homepage;
Admin: http://startbootstrap.com/sb-admin;
Blog: http://startbootstrap.com/blog-home;
E vários outros para Business: http://startbootstrap.com/home-page-templates

WCF com Log4Net

2013-12-09T22:00:00.000-08:00

Galera,

Pra quem precisa utilizar o Log4Net com o WCF disponibilizei uma biblioteca bem simples de integração entre os dois:
http://eduardosilva.github.io/Trinity.Wcf.Log4Net/

Endereço do NuGet:
https://www.nuget.org/packages/TrinityWcfLog4Net/

ASP.Net MVC: Muito código nas Controllers

2012-12-23T15:00:00.000-08:00

Eu tenho utilizado muito o ASP.Net MVC e sem dúvida é uma grande tecnologia, mas resolvi colocar nesse post alguns problemas que eu passei e como resolvi.

Com o ASP.Net Web Forms, por padrão, temos um code behind (*.aspx.cs) por página (*.aspx) isso significa que temos tem uma classe, que podemos de certa forma caracterizar como uma controller, responsável por uma View. Já no ASP.Net MVC podemos ter um Controller responsável por varias views. Ex.: ProdutoController responsável pelas view Pesquisar, Detalhe, Edicao. Nesta mesma controller podemos potencializar a sua aplicação deixando-a responsável por responder chamadas de json.

Bom com isso acabamos tendo muito código nas nossas controllers (consultas, escritas, conversões de tipos etc). E isso não é culpa da tecnologia é apenas uma questão de como organizar as idéias e responsabilidades.

Com essa quantidade de código nas Controller fica dificil de dar manutenção, mesmo refatorando em métodos você acaba vendo um código muito extenso na sua controller o que de cara parece ser um mal sinal (ou um mal cheiro).

Não precisamos "reinventar a roda" para resolver esses problemas, grandes mentes já tem várias sugestões sobre isso e quero apenas apresentar algumas delas que eu estou utilizando e tem me agradado.

CQRS (Command Query Responsibility Segregation) é um padrão que tenho utilizado para organizar esse tipo de coisa, não vou entrar em detalhes sobre o padrão, isso vai ficar para outro post, vou focar apenas em como estou aplicando nos meus projetos.

Consultas

O primeiro problema que eu resolvi foi referente a consultas. Se você utiliza um OR/M como o Entity Framework ou NHibernate com o ASP.Net MVC você pode acabar tendo muito código de consulta dentro da sua controller.

OBS.: Eu não costumo encapsular os frameworks de OR/M com DAOs ou Repositories. Se estiver interessando no motivo leia o artigo abstração da abstração. Só pra reforçar que isso também não é coisa da minha cabeça, Ayende Rahien é um grande defensor da idéia de que abstrair OR/M é um erro.

Eu utilizo para as consultas o Query Object Pattern (link), com isso consigo encapsular as consultas nessas classes. Isso também evita a questão de trazer todas as propriedades das entidades relacionadas na consulta, eu consigo criar consultas espeficidas para fins específicos de uma View, o que traz um grande ganho de performance. (uma coleção de uma determinada entidade para popular um combobox pode te dar muito dor de cabeça. Acredite!).

Escritas

Para as escritas estou utilizando o Command Pattern, com ele eu consigo refatorar o processo de escrita em várias blocos de comando, afinal nem sempre nossas telas só precisamos executar um salvar correto? Como utilizo muito o Entity Framework, também fica fácil seperar esses comandos utilizando uma única instancia de context e controle de transação quando necessário.

Se você pesquisar sobre esse padrão verá outros padrões relacionados como o Tasks e Events, porém os meus projetos até o momento não precisou desse potencial todo.

Basicamente estou organizando os meus projetos da seguinte forma:

Entities
Commands
QueryObjects
Controllers
Views
Models

É claro que isso pode variar de projeto a projeto, mas no geral os projetos que tenho trabalhado esse tipo de organização tem atendido muito bem, sendo bastante produtivo mas sem perder a organização e flexibilidade do código.

Até a próxima!

Extensions Methods e Namespaces

2011-08-13T06:00:00.000-07:00

Eu utilizo Extensions Methods para praticamente duas finalidades:

Implementar uma funcionalidade não existente para um objeto;
Dar uma maior coesão a um trecho de código;

Como exemplo de coesão, veja o trecho de código abaixo:

Para deixar o código um pouco mais coeso pode implementado da seguinte forma:

Para criar uma classe que implemente o código que queremos é muito simples:

Agora pra utiliza-lo basta fazer o seguinte:

Pois é, o Visual Studio já me avisou que não encontrou o meu método de extensão. Isso se dá por que esqueci de fazer o using para o namespace onde esta a extensão, e isso aconteceu por que o intellisense não me deu essa opção.
Quando criamos um extension method dentro de uma namespace precisamos lembrar de fazer o using manualmente toda vez que queremos utiliza-lo, o que nem sempre é legal.

O que podemos fazer nesse caso?

Duas opções:

Não definir uma namespace para a sua classe que contém os métodos de extensão;
Definir o namespace igual ao objeto ao qual o método esta atrelado.

Fica ai a dica, agora é só mandar bala nos extensions methods.

O Inferno do Utils, Tools e afins!

2011-04-19T09:54:00.001-07:00

Quando estamos pensando nas “camadas” da nossa solução, principalmente no começo do projeto, de uma forma geral temos grandes preocupações com assuntos como por exemplo coesão de responsabilidades, baixos acoplamentos, performance e segurança.
Se você esta em um projeto onde o pessoal diagrama tudo antes de começar a programar, se for criado uma classe diferente do que estava no diagrama os alarmes de incêndio são disparados.

De repente surge uma necessidade de enviar e-mail em mais de um ponto do sistema. Nós como “bons programadores” que somos não vamos duplicar o código, então o que fazemos? Criamos um projeto chamado Utils (tools e seus primos).
Se precisamos encapsular uma transferência de arquivo via ftp agora não temos mais a “dor de cabeça” de decidir onde colocar esse tipo de funcionalidade, muito simples vai para o Utils.
Encapsulamento de leitura e gravação de um xml também não é mais problema, é só colocar no Utils que fica “tudo certo”.

Se pegarmos esse exemplo em particular fica claro que todos os cuidados que estávamos tomando na criação da solução foram totalmente ignorados quando passamos a ter o projeto Utils. E o pior é que fica tendencioso, se aparecer qualquer funcionalidade que não sabemos onde colocar, ela possivelmente irá parar no Utils.

Existem vários problemas com essa abordagem sendo alguns deles:

O projeto fica dependendo de vários Assemblies, das mais diversas finalidades: E-mail, FTP e acesso a banco são dependências claras no exemplo citado.
Se você tiver vários projetos que utiliza o seu Utils, cada alteração que você faça no seu Utils, recompila todos os projetos dependentes.
O projeto vira um “saco de lixo” de código. Lixo mesmo, por que é incrível como a grande maioria das vezes a qualidade do código cai em classes que são colocadas nesses projetos.

Precisa realmente encapsular o envio de e-mail? Precisa mesmo? Será que você não esta sendo motivado em fazer isso simplesmente para facilitar o envio de e-mail? Será que você não esta criando uma abstração da abstração?

Caso seja realmente necessário encapsular o envio de e-mail minha sugestão é que faça isso de verdade, crie uma projeto com essa funcionalidade com um nome sugestivo para o que ele se propõe a fazer. Assim fica claro o que assembly fará, inclusive podemos prever possíveis dependências que isso pode trazer na hora de utilizá-lo.

A Abstração da Abstração

2011-03-25T13:35:00.001-07:00

Eu acho engraçado como somos condicionados a tentar encapsular tudo o que é externo a nossa aplicação em nossas próprias classes. Muitas vezes baixamos um framework para um determinado trabalho e o encapusalmos por inúmeros motivos, para tornar o código um pouco mais aderente com que a funcionalidade se propõe a fazer, para facilitar uma determinada operação do framework que estamos utilizando, e por ai vai.

O problema é que muitas vezes limitamos a utilização da ferramenta a aquilo que estamos diexando disponível nas nossas classes. O quanto isso vale a pena?

Vou pegar como exemplo os nossos Repositories, geralmente o utilizamos como uma abstração de acesso a dados, e deixamos disponíveis em nossos repositories os famosos métodos Save, GetById, GetAll, etc…
Bom, hoje em dia é muito comum utilizarmos um framework ORM para facilitar as implementações de banco de dados, mas perceba, o ORM é uma abstração de acesso a dados, claro, não igual ao Repository, porém não deixa de ser uma abstração de acesso.

Quando encapsulamos os métodos do ORM nos nossos repositories estamos perdendo poderosas features como por exemplo o Multiquery e e Future do NHbernate.
Não tenho a pretensão de classificar quando isso é bom ou ruim, mas cada caso precisa ser analisado com calma.

Fica ai a bandeira levantada.
Até a próxima.

Compilando para Silverlight

2011-03-17T04:50:00.001-07:00

Essa dica eu ja mandei para o MUGSP mas resolvi deixar registrado aqui também.

Não sei se alguém algum dia vai precisar disso, mas se estiver tentando gerar um dll com código C# compilado “na mão” para Silverlight, tem que fazer o seguinte:

Todas as referencias devem ser feitas para as dlls compiladas para Silverlight (System.dll, mscorlib.dll e assim por diante). No meu caso faço referencias as dlls que estão na pasta c:\Arquivos de programas\ReferenceAssemblies\Microsoft\Framework\Silverlight\v4.0\
Para o compilador (csc.exe) é necessário informar os argumentos /nostdlib+ /noconfig. Isso é necessário para que não seja gerado referencia para as bibliotecas padrões do .Net Framework.
No caso de utilizar o CodeDom (que foi o meu caso), é necessário passar esses argumentos para CompilerParameters:

new CompilerParameters
    {
        OutputAssembly = Path.Combine(outputDir, baseNamespace + ".Silverlight.dll"),
        CompilerOptions = @"/noconfig /nostdlib"
    };

Fica ai a dica pra quem precisar.

Até a próxima.

DDD: Melhorando a forma de carregar as Views utilizando Modelo Rico.

2011-03-14T11:07:00.001-07:00

DDD sem dúvida é uma excelente ferramenta para auxiliar a resolver problemas que surgem em domínios complexos porém, como todo mundo diz, não é bala de prata. Mas o problema que eu vou expor aqui não é exclusivo de quem utiliza DDD e sim de qualquer solução que se utiliza de Modelo de Domínio Rico.

Quando você tem um Modelo de domínio rico as operações de escrita ficam mais coesas, as responsabilidades ficam mais claras além de outros benefícios, no entando, você pode ganhar alguns problemas nas operações de leitura.
Imagine uma tela onde você tenha três combobox, cada combobox populada com uma entidade diferente. Agora imagine essas entidades com um número significativo de propriedades (não vou definir aqui o quanto seria esse número, essa discussão não vem ao caso agora) e uma cadeia de relacionamento complexa (A relacionada com B que se relaciona com C e assim por diante). Como faríamos para popular esses combos da tela?

Certamente você utilizaria o repositorio especifico para cada uma das entidades e faria a consulta apropriada para popular os combos.

Você conseguiu identificar alguma problema nisso? Não? Então deixa eu ajudar.

Você percebeu quantas chamadas ao banco de dados você teve que fazer? Se você tiver utilizando alguma forma de serviço (WCF, WCF Data Services, ou qualquer outro tipo de serviço) você teve que chamar no mínimo três chamadas de serviço e cada chamada de serviço resultou em uma chamada de banco de dados.

Pronto, ta ai o pretesto que o seu companheiro de trabalho ou o seu gerente de projetos precisava para falar que DDD não presta! Mas esse tipo de problema também tem solução.

Primeira coisa: Pelo amor de Deus, use um ORM. Se você é daqueles programadores que ainda tem resistência a um ORM (como eu tinha) pare com isso agora antes que a coisa fique feia!
Com a utilização de ORM podemos utilizar recursos que nos ajudam na performance da aplicação como Lazy Loading, Cache, operações em Batch. O NHibernate tem funcionalidades excelentes para esses tipos de caso, por exemplo, com o Future poríamos popular os três combobox com uma única chamada para o banco de dados.

Segundo: Popule sua View somente com dados que ela precisa. Se para um combobox só precisamos de um Id e Descrição, pra que vamos trazer todos os dados da entidade? Novamente ferramentas como o NHibernate nos ajudam com esse tipo de situação.

De onde eu tirei essas soluções? CQRS.

Pretendo colocar algumas soluções práticas para esse tipo de situação, mas ja adianto as dicas apresentadas aqui é apenas uma das várias formas que temos para resolver esse problema. O importante é reconhecer que o problema esta lá e ter a mente aberta para as muitas formas de resolve-lo.

Até mais.

Silverlight: Dica de performance

2011-03-11T10:49:00.001-08:00

Essa semana resolvi um problema interessante de uma aplicação feita em Silverlight.

Estava investigando por que uma determinada aplicação estava lenta e atacamos nas coisas mais óbvias: acesso a banco, chamadas de serviço, tamanho de objetos e por ai vai. Aparentemente não havia que justificasse a lentidadão da aplicação.

Resolvemos então verificar se não havia algum recurso que estavamos usando do silverlight para causar o problema. Procurando no Google por pessoas que passaram pelo mesmo problema, vimos várias dicas referentes ao uso de transparencia e os problemas que isso pode causar quando não utilizado com moderação.
A nossa aplicação não estava utilizando transparencia mas sim sombra (DropShadow), quando removemos o efeito: Bingo!

Não estou querendo dizer que o DropShadow causa problema de performance, tanto que continuamos usando, mas removemos esse efeito em alguns pontos para ter a melhoria necessária sem prejudicar o layout, ou seja, é importante ficar atento ao uso desse tipo de recurso e o quanto ele pode onerar o desempenho da aplicação.

Abraços!

HTTPS no IIS Express

2011-03-08T03:36:00.001-08:00

Recentemente comecei a utilizar o IIS Express para conferir as suas funcionalidades.

Um dos recursos que eu achei interessante é a utilização do HTTPS local. Para utiliza-lo basta clicar com o botão direito sobre o projeto e selecionar a opção “Use IIS Express…”

Será exibido uma janela pedindo confirmação para a criação de um diretório virtual para o seu projeto.

Depois de criado o diretório virtual você deve acionar o botão F4 sobre o projeto e habilitar a opção “SSL Enable”.

Prontinho, agora basta você rodar a sua aplicação através do endereço mesmo endereço só que utilizando https ao invés do http.

Baixar o IIS Express.

Site sobre CQRS

2010-09-10T06:12:00.000-07:00

Você pode encontrar vídeos, documentos e exemplos sobre CQRS no http://cqrsinfo.com/. Vale a pena conferir.

Contextualizando os seus testes

2010-09-03T17:28:00.000-07:00

O Giovanni Bassi postou em seu blog sobre a técnica AAA (Arrange, Act, Assert) para criação de testes. Ele aproveita para abordar o principio de que cada teste só deve testar uma única coisa, e o quanto isso pode ser complicado.

Aproveitando o gancho, partindo do exemplo que ele apresentou da calculado, vamos implementar o método de divisão:

[TestClass]
public class TestCalculadora
{
    private Calculadora _calculadora;
    private int _resultado;

    [TestInitialize]
    public void Inicializar()
    {
        Arrange();
        Act();
    }

    private void Arrange()
    {
        _calculadora = new Calculadora();
    }

    private void Act()
    {
        _resultado = _calculadora.Dividir(10, 5);
    }

    [TestMethod]
    public void Resultado2()
    {
        Assert.AreEqual(2, _resultado);
    }
}

public class Calculadora
{
    public int Dividir(int a, int b)
    {
        return a / b;
    }
}

Legal, mas também precisamos testar a divisão por zero para saber como o método irá se comportar. Como podemos fazer isso?

É nesse momento que precisamos contextualizar nossos testes, isso significa que vamos testar a mesma rotina em cenários diferentes, no exemplo da calculadora precisamos gerar o cenário do dividir com o divisor maior que zero e divisor zero. Podemos testar conforme abaixo:

public abstract class TestarCalculadora
{
    protected Calculadora Calculadora { get; private set; }
    protected int Resultado { get; set; }

    [TestInitialize]
    public void Inicializar()
    {
        Arrange();
        Act();
    }

    private void Arrange()
    {
        Calculadora = new Calculadora();
    }

    protected abstract void Act();

}

[TestClass]
public class TestarDivisaoComDivisorMaiorQueZero : TestarCalculadora
{

    protected override void Act()
    {
        Resultado = Calculadora.Dividir(10, 5);
    }

    [TestMethod]
    public void ResultadoIgual2()
    {
        Assert.AreEqual(2, Resultado);
    }
}

[TestClass]
public class TestarDivisaoComDivisorZero : TestarCalculadora
{
    private bool _divisaoPorZeroGerada = false;

    protected override void Act()
    {
        try { Resultado = Calculadora.Dividir(10, 0); }
        catch (DivideByZeroException) { _divisaoPorZeroGerada = true; }
    }

    [TestMethod]
    public void ExcecaoDivisaoPorZeroGerada()
    {
        Assert.IsTrue(_divisaoPorZeroGerada);
    }

    [TestMethod]
    public void ResultadoIgualZero()
    {
        Assert.AreEqual(0, 0);
    }
}

Contextualizar os testes em cenários nos permite realizar várias verificações em vários cenários de uma mesma transação.
Essa é uma técnica muito simples, porém muito poderosa. Se você utiliza BDD com certeza já conhecia.

Grupo de estudos: Referências de DDD

2010-04-19T15:42:00.000-07:00

Pro pessoal do grupo de estudos e para todos os outros que se interessarem por DDD, abaixo segue uma série de links que considero interessante para ficar por dentro do assunto (Lembrando que o livro do Evans é leitura obrigatória ok?).

http://domaindrivendesign.org/
http://www.infoq.com/minibooks/domain-driven-design-quickly
http://www.infoq.com/presentations/greg-young-unshackle-qcon08
http://www.infoq.com/presentations/Value-Objects-Dan-Bergh-Johnsson
http://www.infoq.com/articles/ddd-in-practice
http://devlicious.com/blogs/casey/archive/tags/DDD/default.aspx
http://codebetter.com/blogs/gregyoung/archive/tags/DDD/default.aspx
http://jimmynilsson.com/blog/
http://elegantcode.com/category/ddd/
http://www.vimeo.com/7838858

Permitir que faça errado!!

2010-04-16T14:57:00.000-07:00

Você já tomou uma bronca por ter feito uma chamada de um método em um lugar errado? (Ex.: gravar um log, abrir ou fechar uma conexão ou transação).
Geralmente quando tomamos uma bronca dessa, do arquiteto responsável por exemplo, abaixamos a cabeça e vamos arrumar o "erro". Mas hoje, quando me deparo esse tipo de coisa eu levanto a questão: O método só foi chamado do lugar errado por que a aplicação deixou que isso fosse feito.

Desenhar uma aplicação de forma que seja fácil fazer o que é certo e difícil fazer o errado é um grande desafio, mas o fato de ser difícil não significa que não deva ser tentado. Ter um conhecimento mais profundo de OO e das ferramentas que utilizamos com certeza nos ajudam a alcançar esse objetivo.

Por tanto, da próxima vez que você passar por esse tipo de situação independente do seu papel, do cara que esta dando ou recebendo a bronca, reflita sobre como esta desenhado a aplicação, isso pode fazer uma grande diferença.

Desvendando o Application Layer

2010-04-16T14:38:00.000-07:00

Sabemos que o coração do DDD esta no domínio, dedicamos grande parte da nossa atenção a ele.
Mas gostaria de destacar o papel do application layer e tentar esclarecer algumas confusões sobre ele.

Se você já procurou sobre application layer na internet, que vou chamar aqui de camada de aplicação, com certeza deve ter encontrado várias definições e aplicabilidades diferentes sobre o mesmo, por exemplo, "Application Layer é o mesmo que Service Layer" ou até mesmo relacionar com tecnologias como Web Services e WCF.

Essa confusão de certa forma se justifica pelo fato de que, a responsabilidade da camada de aplicação é de coordenar (ou delegar) os trabalhos realizados pelo domínio, o que é muitas vezes encarado como um façade, o que não esta errado, mas é nessa comparação que começa os problemas, por que o service layer também pode ser um façade.

Devido a esses problemas de definições e comparações, como você não tem um Service Layer em todos os projetos, você pode encarar que talvez não precise de uma camada de aplicação, e é ai que ao meu ver chegamos no ápice do engano.

Para entender bem as diferenças entre eles é necessário destacar uma frase da definição do Evans sobre o application layer: "The tasks this layer is responsible for are meaningful to the business"

Ou seja, não é simplemente chamar métodos de objetos de domínio em uma ordem específica, mas coordenar as tarefas de forma significativa ao negócio. Se você vê semelhanças entre a camada de aplicação e o controller do MVC elas param na palavra coordenar, ok? A controller coordena as interações entre a View e a Model, não é disto que estamos tratamos nesse momento.

Nós, desenvolvedores, geralmente pensamos nas funcionalidades essencialmente como CRUD, fazemos isso por vários motivos, mas talvez o principal se refere a comodidades de interações com banco de dados. O problema desse pensamento é que para o negócio nem sempre o CRUD atende, o cliente não deleta um recebimento ele provavelmente faz um estorno, o cliente não faz um insert de ordem ele abre uma ordem de produção.

A função da camada de aplicação é expor operações realizadas pelo domínio de forma que façam sentido ao domínio, por tanto, se o seu domínio abre uma ordem de produção não faz sentido eu ter SaveProductionOrder() na minha camada de aplicação mas sim OpenProductionOrder().

Isso não quer dizer que os famosos métodos Save, Delete e similires não devam existir na sua camada de aplicação, devido ao fato de que, em alguns casos, não é possível determinar um termo de negócio para essas ações.

Outro ponto importante é a questão da leitura de dados, no DDD nós obtemos os dados através do repositório, faz sentido criar métodos no Application Layer para ler dados? Eu respondo, nenhum. Enquanto em um serviço nós geralmente o utilizamos para operações de leitura e/ou escrita, a camada de aplicação só coordena as operações realizadas pelo meu domínio, quando eu preciso ler alguma coisa eu peço direto para o repositório.

Você deve estar se perguntando: Mas eu preciso de um acesso único ao domínio, não preciso?
Essa busca por um caminho linear é herança do BOLOVO onde você tinha UI > BL > DL > BL > UI.
Essa idéia de que tudo tem que passar pelo domínio gera grandes transtornos para identificar as responsabilidades de cada coisa ou de até mesmo um alto acoplamento entre o domínio e outros recursos da minha aplicação, afinal, tudo passa pelo meu domínio.

No desenho apresentado pelo Evans vemos claramente que isso não é necessário e nem deve ser praticado. Se precisamos de uma funcionalidade que se encontra na camada de infraestrutura podemos acessar diretamente dessa camada.

Concluíndo, apesar das semelhanças que a camada de aplicação tenha com outras funcionalidades precisamos ter em mente que ela precisa estar totalmente comprometida com o negócio.

Problema com códigos no post

2010-04-04T16:04:00.000-07:00

Estou com problemas com o syntaxhighlighter, nisso exibir código aqui no blog esta um pouco complicado, estou tentando resolver esse problema, mas até lá vou disponibilizar os códigos para download.

Na sexta feira vou finalizar uma apresentação sobre DDD e vou publicar o código utilizado, nele tem exemplos de BDD e Domain Events.

Aguardem.

Testes unitário x TDD x BDD

2010-04-04T14:36:00.000-07:00

Acompanhando os grupos de discussão eu percebo que ainda tem muita gente fazendo confusão entre testes unitários, TDD e BDD. Eu sei que a "sopa de letrinhas" não colabora, mas é fundamental entender as as diferenças entre eles para que você consiga usufluir dos seus benefícios.

Eu não vou ficar aqui dando as definições formais de cada um, abaixo segue alguns links onde você pode obter mais informações, mas vou me preocupar em destacar as diferenças entre eles.

http://pt.wikipedia.org/wiki/Teste_de_unidade
http://pt.wikipedia.org/wiki/Test_Driven_Development
http://pt.wikipedia.org/wiki/Behavior_Driven_Development

Quando estamos aplicando teste unitário, estamos testando um único trecho do nosso código, nada mais do que isso. Se o nosso teste faz mais do que isso ou ele é um teste de integração ou é qualquer outra coisa parecida mas não é teste unitário.

Isso quer dizer que testes de integração não importantes? De forma alguma, mas um dos problemas em se ter teste de integração sem testes unitários é que se o seu teste falhar como você irá descobrir o motivo? Lembrando que, dependendo do tipo de teste de integração que você esteja fazendo, outros fatores podem influenciar o resultado (fatores externos como banco de dados por exemplo).

Um dos fatores de resistência aos testes unitários é a mudança que ele causa no nosso código. Como escrevemos testes para que testem apenas um único trecho, precisamos desacoplar nossas classes e métodos para garantir que estamos testando apenas uma única coisa.

TDD é uma disciplina de desenvolvimento, o seu conceito é bem simples, você cria o testa, o teste falha, você faz funcionar e refatora caso necessário. O famoso red, green, refactoring.
Se você não desenvolve dessa forma você não esta utilizando TDD, isso não significa que você não esteja produzindo testes unitários, mas você não esta seguindo a disciplina de desenvolvimento.

Uma das desvantagens mais levantadas contra a disciplina contida no TDD é referente ao tempo: "Escrever testes e fazer falhar é muito demorado.". A parte ironica disso, é que não é uma reclamação dos gestores mas sim dos desenvolvedores.

BDD é uma evolução do TDD, a quem diz que o TDD foi mal interpretado e que na verdade o BDD sempre existiu.
Com o BDD não é apenas testar, o BDD tem como finalidade documentar o código através de testes feitos com base em especificações contruídas a partir de contextos.
Se você acha o desenvolvimento com TDD é demorado o BDD talvez não ajude a mudar esse conceito.

Bom, podemos ter teste unitário sem TDD e BDD, podemos desenvolver com TDD sem BDD e podemos escrever especificações conforme o BDD sem TDD, entretanto não podemos ter BDD ou TDD sem teste unitário.

Se você vai utilizar TDD ou BDD o mais importante é ter os testes escritos e utilizando as melhores práticas da mesma forma que você escreve o código do produto final, pois com certeza, testes mal escritos são difíceis de entender e manter atualizados.

Como você tem escrito seus testes?

Pensando em ágil

2010-03-13T13:48:00.001-08:00

O quanto às metodologias ágeis são eficases? Essa é uma pergunta que todos com certeza já se fizeram a partir do momento que tiveram contato com elas.

Mas realmente é muito complicado garantir que tais metodologias funcionam ou não. Mas eu ando bem desencanado com isso, Por quê?

Por que já vi projetos ágeis falharem e terem sucesso, assim como já vi projetos cascata falharem e terem sucesso também.

Ayende Rahien, o cara por trás do Rhino Mock, escreveu um post falando sobre metologias e sabe o que é engraçado? Nenhuma delas fala sobre engenharia de software.

Uma vez fui questionado por um colega se eu gostava de XP e quando eu perguntei o porquê ele me falou: O projeto “xyz” foi feito com XP. O detalhe desse projeto em questão é que ele funciona, o cliente esta satisfeito de uma forma geral, mas tem um código horrível de dar manutenção. Por isso eu respondi: “Que culpa a qualidade do código tem de você utilizar XP?”.

Não interessa que tipo de metodologia você utiliza, sem aplicar boas práticas de engenharia de software, boa arquitetura, bom profissionais, adivinha o que vai acontecer?

Bom, mas o que tem realmente chamado a minha atenção e que me tem trazido bons resultados são algumas práticas contidas nas metodologias ágeis. Aqui vão algumas que tenho me atentado:

1) Comece a desenvolver pelo que agrega maior valor ao negócio.

Eu não sei com vocês, mas geralmente as funcionalidades que você tem que desenvolver que agregam maior valor ao negócio, ou seja, o que seu cliente mais precisa, também são as mais difíceis.

Mas isso é bom, pois afeta diretamente o desenho do projeto, arquitetura, forma de comunicação entre outras coisas.

Exemplo, no ramo de manufatura se a funcionalidade que agrega maior valor é a de ordem de produção, por que começar com cadastro de produtos? Ai você vai me questionar o seguinte: Mas você não precisa de produto para criar a ordem de produção? Sim, realmente vou precisar de produtos. Porém, nesse nosso cenário a tela de produto pode ser afetada por várias funcionalidades do nosso sistema (compras, por exemplo).

Bom se eu sei que a tela de ordem de produção vai precisar de informações de produto, não é melhor eu colocar no produto somente as informações necessárias para gerar a ordem de produção?

Perceba o seguinte, se você já desenvolveu tudo que as outras funcionalidades precisam de produto, a tela de produto só terá o necessário, nada a mais e nada a menos. Isso ajuda muito para evitar que você fique tendo retrabalho em funcionalidades que já estavam prontas por que precisa atender necessidades de outras funcionalidades.

2) Revisão entre pares

Eu ainda não tive a oportunidade de trabalhar em lugar que adota programação em pares, mas é uma realidade, se você tem uma pessoa te ajudando a desenvolver ou revisando algo que você já tenha feito as chances disso sair com sucesso aumentam, principalmente se a outra pessoa for mais experiente que você.

3) Validação contínua com o cliente

Tem pessoas que simplesmente tem pavor de validar uma funcionalidade com o cliente antes da entrega formal do projeto, por quê? E o se o cliente pedir alguma alteração?

Ivar Jacobson diz o seguinte:

"Todos os sistemas mudam durante o ciclo de vida. Isto deve estar na cabeça quando se desenvolve sistemas que se espera durar mais do que a primeira versão."

Obs.: Estou à procura da fonte onde ele disse essa frase, assim que eu encontrar eu atualizo o post.

Ou seja, a mudança é uma constante em nosso cotidiano podemos estar desenvolvendo novos produtos ou dando manutenção, o negócio é algo que vive evoluindo, a isso é devido a importância de construirmos softwares flexíveis o bastante para acompanhar essas mudanças.

O que eu coloquei acima não é nenhuma novidade, se você conhecer o manifesto agile vai encontrar tudo isso e muito mais lá. Vale apena conhecer as práticas independente se você irá utilizá-las ou não.

Domain Events

2010-02-23T16:46:00.001-08:00

Quando você utiliza DDD e começa a trabalhar com o modelo rico, você pode começar a se deparar com algumas situações que nem sempre é muito simples achar a melhor a solução, mas uma dessas soluções que você pode utilizar são os eventos de domínio (Domain Events).

Vamos imaginar o seguinte cenário: “Eu preciso cadastrar uma ordem de compra, que no momento da criação ela fica aguardando aprovação.”

Antes de adicionar algum tempero nesse cenário vamos começar a desenhar a classe:

namespace Domain.Entities
{
    public enum PurchaseOrderStateEnum
    {
        WaitingApproval,
        Approval
    }

    public class PurchaseOrder
    {
        public virtual int Id { get; private set; }
        public virtual int OrderNumber { get; private set; }
        public virtual PurchaseOrderStateEnum State { get; private set; }

        protected PurchaseOrder() { }

        public PurchaseOrder(int orderNumber)
        {
            OrderNumber = orderNumber;
            State = PurchaseOrderStateEnum.WaitingApproval;
        }

        public virtual void Approval()
        {
            State = PurchaseOrderStateEnum.Approval;
        }
    }
}

Agora vamos começar a adicionar os temperos: “Quando a ordem de aprovação for aprovada é necessário enviar um e-mail para o gestor da área de compas informando da aprovação da ordem.”

Bom nós já discutimos aqui que enviar e-mail é algo que deve ser feito na camada de infraestrutura, e também sabemos que o domínio não pode depender da camada de infraestrutura, certo?

Uma possível solução para o problema poderia ser o seguinte:

public class PurchaseOrder
{
    public virtual ISendEmailBeforeApprovedPurchase SendEmailBeforeApprovedPurchase { get; private set; }
    public virtual int Id { get; private set; }
    public virtual int OrderNumber { get; private set; }
    public virtual PurchaseOrderStateEnum State { get; private set; }

    protected PurchaseOrder() { }

    public PurchaseOrder(int orderNumber)
    {
        OrderNumber = orderNumber;
        State = PurchaseOrderStateEnum.WaitingApproval;
    }

    public virtual void Approval()
    {
        State = PurchaseOrderStateEnum.Approval;
      SendEmailBeforeApprovedPurchase.SendEmail(this);
    }
}

public interface ISendEmailBeforeApprovedPurchase()
{
    void SendEmail(PurchaseOrder purchaseOrder);
}

Dessa forma podemos “injetar” o serviço de envio de e-mail através de um DI/IoC, mas como tudo nessa vida nada é perfeito, só Deus.

Como faríamos para implementar um segundo comportamento quando uma ordem compra fosse aprovada? Vamos ver como fazer isso com eventos de domínio:

public virtual void Approval()
   {
       State = PurchaseOrderStateEnum.Approval;
       DomainEvents.Raise(new PurchaseOrderAprrovedEvent { PurchaseOrder = this });
   }

O que estamos fazendo é dizendo para o gerenciador de eventos de domínio que, quando o método Approval for chamado, o evento PurchaseOrderApprovedEvent deve ser disparado. Vamos analisar a estrutura do evento:

namespace Domain.Events
{
    public interface IDomainEvent { }

    public class PurchaseOrderAprrovedEvent : IDomainEvent
    {
        public PurchaseOrder PurchaseOrder { get; set; }
    }
}

Veja o código do gerenciador de eventos:

public static class DomainEvents
{
    [ThreadStatic] //so that each thread has its own callbacks
    private static List actions;

    //Registers a callback for the given domain event
    public static void Register(Action callback) where T : IDomainEvent
    {
        if (actions == null)
            actions = new List();
        actions.Add(callback);
    }
    //Clears callbacks passed to Register on the current thread
    public static void ClearCallbacks()
    {
        actions = null;
    }
    //Raises the given domain event
    public static void Raise(T args) where T : IDomainEvent
    {
        if (actions != null)
            foreach (var action in actions)
                if (action is Action)
                    ((Action)action)(args);
    }
}

Agora que disparamos o evento precisamos criar interessados em saber quando esse evento é disparado.

namespace Domain.Handles
{
    public interface IHandles where T : IDomainEvent
    {
        void Handles(T args);
    }
}

namespace Infrastructure.Handles
{
    public class SendEmailBeforeApprovedPurchaseHandler : IHandles
    {
        public void Handles(PurchaseOrderAprrovedEvent args)
        {
            Console.WriteLine("mail sent successfully");
        }
    }
}

Agora só precisamos adicionar “o interessado” na classe de gerenciamento de eventos de domínio para que ele seja notificado:

static void Main(string[] args)
{
    DomainEvents.Register(
        new Action(delegate(PurchaseOrderAprrovedEvent evt)
        {
            new SendEmailBeforeApprovedPurchaseHandler().Handles(evt);
        }));
    var purchase = new PurchaseOrder(123456);
    purchase.Approval();

    Console.Read();
}

Talvez você esteja pensando o seguinte: “Cara, consigo fazer a mesma coisa com mas de outro jeito.”. Com certeza existe outras formas de se chegar no mesmo resultado, mas vamos adicionar um pouco mais de tempero para ver o potencial dos eventos de domínio: “Ao aprovar uma ordem de compra, além de enviar o e-mail, eu preciso que um recebimento seja gerado com as mesmas informações da ordem de compra automaticamente.”.

Primeiramente vamos criar mais um “interessado” em saber que a ordem de compra foi aprovada.

public class GenerateReceiptFromPurchaseOrderApprovedHandler : IHandles
{
    public void Handles(PurchaseOrderAprrovedEvent args)
    {
        Console.WriteLine("Receipt order created.");
    }
}

Agora basta apenas adicioná-lo ao gerenciador de eventos de domínio:

static void Main(string[] args)
{
    DomainEvents.Register(
        new Action(delegate(PurchaseOrderAprrovedEvent evt)
        {
            new SendEmailBeforeApprovedPurchaseHandler().Handles(evt);
        }));
    DomainEvents.Register(
        new Action(delegate(PurchaseOrderAprrovedEvent evt)
        {
            new GenerateReceiptFromPurchaseOrderApprovedHandler().Handles(evt);
        }));
    var purchase = new PurchaseOrder(123456);
    purchase.Approval();
    Console.Read();
}

Pronto, conseguimos adicionar mais umcomportamento ao processo de aprovação de ordem de compra sem a necessidade de alterar a classe, respeitando assim o OCP, e cada novo comportamento tem apenas uma única responsabilidade respeitando o SRP.

Mas perceba o ato de adicionar os interessado, esta sendo feito manualmente pra facilitar um puco podemos utilizar um DI/IoC para adiciona-los ao gerenciador de eventos. Vamos ver um exemplo com o StructureMap.

Precisamos fazer a seguinte alteração no gerenciador de eventos:

public static class DomainEvents
{
    [ThreadStatic] //so that each thread has its own callbacks
    private static List actions;

    public static IContainer HandlesContainer { get; set; }

    //Registers a callback for the given domain event
    public static void Register(Action callback) where T : IDomainEvent
    {
        if (actions == null)
            actions = new List();
        actions.Add(callback);
    }
    //Clears callbacks passed to Register on the current thread
    public static void ClearCallbacks()
    {
        actions = null;
    }
    //Raises the given domain event
    public static void Raise(T args) where T : IDomainEvent
    {
        if (HandlesContainer != null)
            foreach (var handler in HandlesContainer.GetAllInstances>())
                handler.Handles(args);


        if (actions != null)
            foreach (var action in actions)
                if (action is Action)
                    ((Action)action)(args);
    }
}

Agora vamos juntar tudo:

static void Main(string[] args)
{
  var container = new Container(x =>
  {
 x.For<IHandles<PurchaseOrderAprrovedEvent>>().Add<SendEmailBeforeApprovedPurchaseHandler>();
 x.For<IHandles<PurchaseOrderAprrovedEvent>>().Add<GenerateReceiptFromPurchaseOrderApprovedHandler>();

  });

  DomainEvents.HandlesContainer = container;

  var purchase = new PurchaseOrder(123456);
  purchase.Approval();

  Console.Read();

}

Legal né, mas no mundo real, quem faz uma alteração em uma entidade e não persiste no banco né? Como é que colocamos a persistencia no meio de tudo isso?

Vamos criar o repositório, pra isso vou utilizar o Fluent NHibernate:

namespace Domain.Repositories
{
    public interface IPurchaseOrderRepository
    {
        void Save(PurchaseOrder purchaseOrder);
    }
}

namespace Infrastructure.Repositories.Mapping
{
    public class PurchaseOrderMap : ClassMap
    {
        public PurchaseOrderMap()
        {
            Id(x => x.Id).GeneratedBy.Identity();
            Map(x => x.OrderNumber).Not.Nullable();
            Map(x => x.State);
        }
    }
}

namespace Infrastructure.Repositories
{
    public class PurchaseOrderRepository : IPurchaseOrderRepository
    {
        private readonly ISession _session;
        public PurchaseOrderRepository(ISession session)
        {
            _session = session;
        }
        public void Save(PurchaseOrder purchaseOrder)
        {
            _session.SaveOrUpdate(purchaseOrder);
        }
    }
}

Vamos salvar a ordem de compra após realizar a aprovação:

static void Main(string[] args)
{
    Configuration configuration = null;

    var sessionFactory = Fluently.Configure()
        .Database(SQLiteConfiguration.Standard.InMemory().ShowSql())
        .Mappings(M => M.FluentMappings.AddFromAssembly(typeof(PurchaseOrderRepository).Assembly))
        .ExposeConfiguration(c => configuration = c)
        .BuildSessionFactory();

    var container = new Container(x =>
    {
        x.For>().Add();
        x.For>().Add();

        x.For().Singleton().Use(sessionFactory);
        x.For().Singleton().Use(s => s.GetInstance().OpenSession());
        x.For().Use();
    });

    DomainEvents.HandlesContainer = container;

    BuildSchema(configuration, container.GetInstance());

    var purchase = new PurchaseOrder(123456);
    purchase.Approval();
    var repository = container.GetInstance();
    repository.Save(purchase);

    Console.Read();
}


public static void BuildSchema(Configuration cfg, ISession se)
{
    SchemaExport export = new SchemaExport(cfg);
    export.Execute(true, true, false, se.Connection, null);

}

public class NHibernateTestRegistry : Registry
{

    public static Configuration cfg;

    public NHibernateTestRegistry()
    {
        Configuration configuration = null;

        var sessionFactory = Fluently.Configure()
            .Database(SQLiteConfiguration.Standard.InMemory().ShowSql())
            .Mappings(M => M.FluentMappings.AddFromAssembly(typeof(PurchaseOrderRepository).Assembly))
            .ExposeConfiguration(c => configuration = c)
            .BuildSessionFactory();

        For().Singleton().Use(sessionFactory);
        For().Use(x => x.GetInstance().OpenSession());
        For().Use();
    }
}

Concluindo: Eventos de domínio é uma grande solução para manter a sua arquitetura saudavel. Podemos incorporar vários comportamentos a uma determinada ação que ocorre em um objeto do domínio sem ter que alterá-lo, com certeza vale a pena tê-lo como uma carta na manga.

Fontes:

http://www.udidahan.com/2009/06/14/domain-events-salvation/
http://martinfowler.com/eaaDev/DomainEvent.html
http://unplugged.giggio.net/unplugged/post/Domain-Events.aspx

Boas Práticas para interface

2010-02-03T01:51:00.001-08:00

Eu ja havia levantado a bandeira sobre qualidade e organização de código na camada de interface aqui no blog, e tenho percebido que a comunidade tem desprendido um grande esforço nesse sentido também.

O Jeremy D. Miller publicou no seu blog uma série de posts sobre melhores práticas na elaboração de interface:

The Build Your Own CAB Series Table of Contents
http://codebetter.com/blogs/jeremy.miller/archive/2007/07/25/the-build-your-own-cab-series-table-of-contents.aspx
http://www.jeremydmiller.com/ppatterns/(X(1)S(x4of0b450vkpvp454kqddkvw))/default.aspx?AspxAutoDetectCookieSupport=1

Já temos também vários recursos para facilitar a nossa vida: ASP.Net MVC Framework
http://www.asp.net/%28S%28d35rmemuuono1wvm1gsp2n45%29%29/mvc/

E para quem tem o Visual Studio temos também:
Web Client Developer Guidance
http://www.codeplex.com/webclientguidance

Composite WPF and Silverlight
http://www.codeplex.com/CompositeWPF

Se o grande problema para se utilizar as boas práticas era a perca de produtividade, já faz algum tempo que esse argumento não cola a mais.