Neste post vou analisar alguns pontos relacionados a encapsulamento e o uso do Linq.

Vamos começar a analisar um modelo de objetos simples:

Como podemos perceber uma empresa tem muitos funcionários e estas classes poderiam ser escritas desta forma:

class Funcionario
{
    public string Nome { get; set; }
    public string Cargo { get; set; }
    public double Salario { get; set; }
    public bool Ativo { get; set; }
}
 
class Empresa
{
    public List Funcionarios {get; set;}
    public Empresa()
    {
      Funcionarios = new List();
    }
}

Aqui um exemplo de como utilizar as classes deste modelo:

 Funcionario luiz = new Funcionario() { Ativo = true, Nome = "Luiz", Salario = 1000,
    Cargo = "Desenvolvedor" };
 Funcionario sergio = new Funcionario() { Ativo = true, Nome = "Sergim", Salario = 1000,
    Cargo = "Desenvolvedor" };
 Funcionario iuri = new Funcionario() { Ativo = true, Nome = "Iuri", Salario = 1100,
    Cargo = "Desenvolvedor" };
 Funcionario luciano = new Funcionario() { Ativo = false, Nome = "Luciano", Salario = 2000,
    Cargo = "Arquiteto" };
 Funcionario eduardo = new Funcionario() { Ativo = true, Nome = "Eduardo", Salario = 3000,
    Cargo = "Gerente" };
 
  // adicionando funcionários na empresa.
 Empresa google = new Empresa();
 google.Funcionarios.Add(luiz);
 google.Funcionarios.Add(iuri);
 google.Funcionarios.Add(luciano);
 google.Funcionarios.Add(sergio);

Identificando falhas no design

Mesmo com  um design simples como este um problema básico de design aparece. A classe empresa expõe o atributo Funcionário através de uma property e assim viola o encapsulamento. Mas uma property não encapsula o atributo, através de gets e sets? A resposta é que neste caso, o atributo está escondido, mas eu tenho acesso a referência diretamente e o resultado disso é que qualquer “cliente” que usar o objeto do tipo empresa, pode manipular a lista de funcionários diretamente, ignorando quaisquer regras que por ventura existam. Por exemplo imagine a situação onde quisessemos que nunca um Funcionario fosse removido. Do jeito que está qualquer um poderia fazer google.Funcionarios.Remove(sergio).

Um outro problema que aparece nesse código é que temos um conceito de negócio sendo manipulado, mas não explícito. Quando fazemos google.Funcionarios.add(luiz), isso  representa uma ação no nosso domínio. Na verdade o que queremos fazer é contratar o Luiz. Técnicas como Domain Driven Design, pregam que nosso código deve falar a lingua do negócio. De acordo com DDD, precisamos tornar este conceito explícito em nosso código. Vamos alterar a classe empresa para suportar isso:

 class Empresa
 {
    public List Funcionarios {get; set;}
    public Empresa()
    {
      Funcionarios = new List();
    }
 
    public void Contrata(Funcionario funcionario)
    {
       this.Funcionarios.Add(funcionario);
    }
 }

Repare que agora, existe um método na classe empresa que representa o conceito que estava implícito. Sempre devemos tornar os conceitos implícitos explícitos. Agora nosso código fica muito mais OO, se é que se pode usar esta expressão:

  google.Contrata(eduardo);
  google.Contrata(luiz);
  google.Contrata(iuri);
  google.Contrata(luciano);
  google.Contrata(sergio);

Agora o conceito “contratação” está explícito, mas ainda existe um problema, a classe empresa, ainda tem uma property que te permite acessar a lista de funcionários. Apesar de ter criado o método contrata, isso não garante que a lista não será manipulada diretamente.

google.Funcionarios.Remove(luiz);

Este trecho de código mostra novamente o problema de expor a lista, neste caso ao invés de contratar um funcionário estamos demitindo. Agora imagine que existe uma regra que especifica que todo funcinário demitido tem que ser inativado, como vamos garantir que isto vai ser feito? Podemos inativar o funcionário antes de removê-lo da lista:

  luiz.Inativar();
  google.Funcionarios.Remove(luiz);

O problema desta abordagem é óbvio, não tem como garantir que esta regra será executada toda vez que precisarmos demitir um funcionário. Para resolver isso, novamente vamos tornar explícito o conceito de demissão.

 class Empresa
 {
    private List Funcionarios;
    public Empresa()
    {
      Funcionarios = new List();
    }
 
    public void Contrata(Funcionario funcionario)
    {
       this.Funcionarios.Add(funcionario);
    }
 
    public void Demite(Funcionario funcionario)
    {
      funcionario.Inativar();
      this.Funcionarios.Remove(funcionario);
     }
  }

Agora a classe Empresa  tem um método Demite, o que torna explícito o conceito demissão. Note que antes de executar a remoção do usuário, fazemos a sua inativação. Além disso, não existe mais a property na classe empresa que expõe o atributo funcionários, este atributo é privado e somente a classe empresa sabe como manipulá-lo de forma correta.

Não fizemos nada além de seguir princípios básicos de OO aplicando o encapsulamento, e neste pequeno exemplo mostramos como é possível tornar o código mais fácil de se manter utilizando esta técnica.

Encapsulamento e linq no C#

Nas últimas versões do C# várias coisas interessantes foram incluídas, tornando a linguagem muito poderosa. Mas por outro lado, tenho visto uso destas técnicas de forma não muito organizada, principalmente em relação as boas práticas de programação em uma linguagem Orientada a Objetos.

Um dos recursos mais interessantes e que utiliza muitas das novas características da linguagem é o Linq. Vamos dar uma olhada no que é possível fazer com o Linq:

  var nomes = new string[] {"luiz","sergio", "iuri", "eduardo", "jose maria"};
  var nomesQueComecamComS = nomes.Where(nome => nome.StartsWith("S"));
  var nomesQueContemMaria = nomes.Where(nome => nome.Contains("maria"));
  string[] cities = new string[] { "Auckland", "Oslo", "Sydney","Seattle", "Paris", "Los Angeles" };
  IEnumerable places = from city in cities
                             where city.Length >
                             orderby city descending
                             select city;

Isso é muito poderoso, podemos fazer operações sobre lista de forma muito mais declarativa. O problema é que todo esse poder pode esconder algumas surpresas se não tomarmos os devidos cuidados com sua utilização.
No nosso primeiro exemplo, vimos como encapsulamento na sua forma mais simples, torna nosso código mais simples, expressivo e de mais fácil manutenção.
Vamos voltar a analisar o primeiro exemplo, só que pela perspectiva do uso do linq. Para isso vamos precisar colocar criar novamente a property  funcionários na classe empresa.

 class Empresa
 {
    public List Funcionarios {get;set;}
  }

Considere os seguintes trechos de códigos, e veja como é possível trabalhar de forma declarativa utilizando os recursos do linq:

  var funcionarios = google.Funcionarios;
  var salarioMedido = funcionarios.Average(f => f.Salario);
  Console.WriteLine(salarioMedido);
  var funcionariosAtivos = funcionarios.Where(f => f.Ativo == true);
  var desenvolvedores = funcionarios.Where(f => f.Cargo.Equals("desenvolvedor"));
  var GerenteComSalarioMaior2000 = funcionarios.Where(f => f.Cargo.Equals("Gerente") &
                                                                            f.Salario > 2000);

Veja que fizemos várias operações sobre a lista de funcionários da empresa. A primeira vista isso é muito prático, mas podemos ter problemas com essa abordagem.  Na minha opinião o maior problema disso é que perdemos o conhecimento fundamental do negócio. Se eu quero saber o salário médio dos funcionários de uma empresa, então esta operaçao deve estar explícita no objeto empresa.

Mas se eu fizer isso vou deixar  de tirar proveito das facilidaes do Linq? Não, basta promover o encapsulamento e mover este código para a classe empresa. A partir de agora o usuário da classe vai passar a invocar o método disponível no objeto empresa:

  salarioMedido = google.ObterSalarioMedio();

Após fazer a mudança, o código fica mais simples, intuitivo e expressivo. O leitor do código, entende rapidamente o que esta linha de código faz e não precisa saber detalhes de implementação.
Outro exemplo de código é a linha :

  var funcionariosAtivos = funcionarios.Where(f => f.Ativo == true);

Neste trecho temos 2 problemas. Novamente a falta de encapsulamento. De quem é a responsabilidade de dizer quem são os funcionários ativos? Deveria ser da classe empresa, então precisamos criar um novo método na classe para obter os funcionários ativos.
Então na classe empresa temos:

  public IEnumerablel ObterFuncionariosAtivos()
  {
     return this.Funcionarios.Where(f => f.Ativo == true);
  }

O segundo problema desta expressão novamente é falta de encapsulamento, estamos violando o princípio Tell don’t Ask quando fazemos  f.ativo == true. Quem sabe dizer se o funcionário é ativo ou não é o objeto funcionário, então é necessário criar o método na classe funcionário para tornar o explícito o conceito:

  class Funcionario
  {
     public string Nome { get; set; }
     public string Cargo { get; set; }
     public double Salario { get; set; }
     public bool Ativo { get; set; }
 
     public bool EstahAtivo()
     {
       return this.ativo == true;
     }
  }

E na classe empresa  podemos alterar a expressão Linq para utilizar o método da classe funcionário.

  public IEnumerable ObterFuncionariosAtivos()
  {
    return this.Funcionarios.Where(f => f.EstahAtivo());
  }

Aqui a classe empresa completa:

class Empresa
 {
    private List Funcionarios;
    public Empresa()
    {
      Funcionarios = new List();
    }
 
    public void Contrata(Funcionario funcionario)
    {
       this.Funcionarios.Add(funcionario);
    }
 
    public void Demite(Funcionario funcionario)
    {
      funcionario.Inativar();
      this.Funcionarios.Remove(funcionario);
     }     
 
     public IEnumerablel ObterFuncionariosAtivos()
     {
       return this.Funcionarios.Where(f => f.Ativo == true);
     }  
 
     public double ObterSalarioMedio()
     {
         return this.Funcionarios.Average(f => f.Salario);
     }
  }

Estes são apenas alguns exemplos de código simples onde a falta de encapsulamento pode trazer problemas no futuro. Com certeza um dos mais evidentes é a replicação de código e consequentemente os problemas de manutenção causados por ele, além é claro do fato do conhecimento do domínio ficar espalhado entre várias expressões Linq.

Então os problemas são das novas features do C#?

Não, com certeza isso não é problema das novas features do c#. A questão evidente é que muitos desenvolvedores estão esquecendo princípios básicos ao utilizarem estes recursos.

Existem alguns artigos na web falando sobre a tendência de se misturar os paradigmas funcional e OO. Nós como desenvolvedores só temos a ganhar com isso, pois podemos tirar proveito do  melhor dos dois paradigmas. O que não pode acontecer é voltarmos aos problemas que tínhamos no passado, geralmente por  descuido ou  simplesmente por um “relaxamento”  com princípios básicos de Orientação Objetos.

até a próxima,
Luiz Costa

Problema Inicial:

Devemos criar um  método que seja capaz de percorrer um array, exibindo seus elementos. (Ok, tudo bem nós sabemos que todo array possui um método each. Mas vamos fingir que esse kra não existe)

lista = ["sergio","roberto", "iuri","luiz"]
def mostra_elementos( array )
  for elemento in array
    puts elemento
  end
end
mostra_elementos(lista)

Ótimo! Atingimos nosso objetivo. O codigo acima exibira os nomes contidos no array.

Os requisitos mudaram:

Agora nós queremos  percorrer o array exibindo cada um de seus elementos ao contrario, por exemplo, "sergio" será exibido como "oigres". Podemos criar um novo método para isso, então vamos ao trabalho:

<span id="more-451"></span>def mostra_elementos_ao_contrario( array )
  for elemento in array
    puts elemento.reverse
  end
end
mostra_elementos_ao_contrario( lista )

Perfeito! Mais uma vez concluímos nossa tarefa.

DRY, mais um princípio de Desenvolvimento de Software:

Os problemas anteriores envolviam operações com elementos de um array (uma lista), e assim acabamos criando dois métodos para resolver os problemas propostos. Existe um princípio de desenvolvimento de software que é focado em reduzir a repetição/duplicação de código, ele é conhecido como: Don't Repeat Yourself - (DRY). Este principio diz que:

"Every piece of knowledge must have a single, unambiguous, authoritative representation within a system."

O que poderiamos traduzir como: "Cada parte do conhecimento deve ter uma representação única e não ambigua dentro de um sistema". Desta forma utilizando o DRY para analisar as funções que escrevemos até agora, podemos notar que a parte do conhecimento de percorrer um array não possui uma representação única em nosso sistema. O ideal seria que o codigo de percorrer um array nao fosse mais repetido, e é exatamente nisso que vamos trabalhar agora.

Aplicando o DRY

A maneira mais simples de resolvemos o problema de duplicação do codigo de percorrer o array, é sem duvida realizar um refactor chamado extract method, e assim isolar a lógica de percorrer arrays em um método. Entao vamos lá:

def percorre_array( array )
  for elemento in array
 
  end
end
def mostra_elementos( array )
   percorre_array( array)
   puts elemento
end
def mostra_elementos_ao_contrario( array )
  percorre_array(array)
  puts elemento.reverse
end
lista = ["sergio","roberto", "iuri","luiz"]
mostra_elementos(lista)
mostra_elementos_ao_contrario(lista)

Pronto! Com este método que acabamos de criar eliminamos o problema de  repetição de código. Porém ao executar este programa receberemos uma mensagem de erro. O grande problema aqui é que agora os métodos mostra_elementos e mostra_elementos_ao_contrario não conseguem mais acessar cada elemento do array. Estes métodos agora usam a função percorre_array, e somente dentro desta função é que a variavel elemento existe. Neste ponto podemos pensar que, ou fazemos a coisa ficar DRY, ou fazemos o programa funcionar. Calma, com Ruby nos poderemos fazer isso funcionar e ainda ser DRY. Para isso só precisamos aprender a usar os famosos blocos do Ruby.

Ruby block's

Com certeza você já ouviu, que tudo em ruby é objeto. Na verdade mesmo, quase tudo em Ruby é objeto, por exemplo blocos de código não são objetos. Mas o importante é  que  em Ruby podemos armazenar trechos de código em um objeto especial que se chama Proc. Veja:

bloco = Proc.new { puts "sou um bloco de codigo" }
bloco.call

Acabamos de criar um objeto, que contem código, e fizemos isso utilizando Proc.new e fornecendo o código através das chaves  "{ }". De posse de uma Proc, podemos executar o código que ela contem a qualquer momento. Basta pra isso usar o método call da Proc. No exemplo acima ao chamar bloco.call veremos o texto sou um bloco de codigo. O interessante disso é que agora podemos passar código como parametro, veja um exemplo:

def faco_o_que_mandar( block )
  block.call
end
bloco = Proc.new {puts "sou um bloco de codigo"}
faco_o_que_mandar(bloco)
faco_o_que_mandar Proc.new{puts "Mais um bloco"}

Mas podemos fazer como os rubistas fazem na maioria das vezes. Eles chamam a função e passam o bloco como parametro, para isso precisamos fazer uma pequena alteração em nossa função, basta colocar um & a frente do nome do nosso parametro. Outra coisa é que geralmente os rubistas utilizam a plavara yield ao invés de coisas como bloco.call, vamos mudar isso também:

def faco_o_que_mandar( &block )
  yield
end
faco_o_que_mandar {puts "sou um bloco de codigo tipo rubista"}
faco_o_que_mandar do
  puts "blocos do end sao usados quando vc quer"
  puts "fazer coisas que precisem de mais de uma"
  puts "linha =)"
end

O grande barato é que agora escrevemos uma função que recebe e executa um código "visitante". Este é um recurso muito poderoso, e é graças a ele que vamos conseguir resolver o problema de percorrer um array para fazer coisas diferentes com seus elementos, sem precisar repetir código.

Tirando vantagem dos blocos

Bem, nós já temos uma função que sabe andar em um array. Agora só precisamos fazer esta função receber um bloco de código "visitante" e assim teremos tudo resolvido. Vamos então ao trabalho:

def percorre_array( array, &block )
  for elemento in array
    yield
  end
end
lista = ["sergio","roberto", "iuri","luiz"]
percorre_array(lista) { puts elemento }
percorre_array(lista) { puts elemento.reverse }

Neste momento você pode estar se perguntando o porquê do bloco de código estar fora dos parênteses. Por mais estranho que possa parecer é desse jeito que funciona mesmo. Os blocos são informados depois dos parametros "convencionais".

Agora seria ótimo se isso funcionasse, não é? Pena que não vai funcionar. Ao executar esse código veremos o seguinte erro: undefined local variable or method `elemento' for main:Object (NameError).

Repare no erro, ele diz que a variavel elemento não está definida. Isso aconteceu porque esta variavel é local do método percorre_array, ou seja só existe, e só é visivel naquele método. Nós precisamos manipular esta variavel, para que isto seja possível o método que possui a variavel precisa permitir que os blocos visitantes utilizem esta variavel. Fazer isso é simples, basta que no yield nos passemos a variavel em questão como parâmetro.

Quando colocamos o  yield na função é como se dissesemos: "Rode o codigo visitante agora". E quando colocamos a frente do yield parâmetros é como se dissessemos: "Ei código vistante, se você quiser pode usar estes caras aqui que eu tenho". Vejamos como fica isso no nosso codigo:

def percorre_array( array, &block )
  for elemento in array
    #agora estamos expondo a variavel elemento
    # para o codigo visitante
    yield elemento
  end
end
lista = ["sergio","roberto", "iuri","luiz"]
# uma pequena alteracao é necessaria aqui
percorre_array(lista) { |elemento| puts elemento }
percorre_array(lista) do |elemento|
  puts elemento.reverse
end

Agora sim o código funciona. A linha yield elemento, tem o efeito de enviar para o bloco visitante a variavel elemento como parametro. Assim a cada iteracao do loop for um novo valor é enviado ao código visitante através da variavel elemento. Com isso nosso trabalho está terminado, implementamos as funcionalidades solicitadas, sem repetir código, e de quebra aprendemos sobre DRY e blocos de código em Ruby.

Bloco de código é um assunto bem interessante, e aqui nós abordamos só uma pequena parte. Tem ainda um lance de lambdas, enfim como disse antes o assunto é muito interessante, e se você quiser saber mais pode olhar um post do Anderson Leite sobre isso, o link é este.

Abraços.

O Restfulie teve sua versão original implementada em ruby e logo depois foi lançada a versão para Java, mas ainda não havia nenhuma versão para .Net. Foi então que eu e o Sergio Junior aqui do blog resolvemos escrever uma versão para C# da api.
Começamos a implementar a parte cliente do Restfulie e fizemos isto utilizando as características dinâmicas da versão 4.0 do C#.
A idéia é que podemos fazer o client em C# bem próximo da idéia inicial que foi escrita em Ruby.

Aqui vamos mostrar alguns exemplos de utilização desta versão em C#.
Um recurso Pedido pode ter sua representação em xml como a que segue:

<pedido>
        <data>26/12/2009 11:40</data>
        <total>300.00</total>
	<atom:link rel="refresh"
          href="http://www.caelum.com.br/pedidos/1"
          xmlns:atom="http://www.w3.org/2005/Atom"/>
        <atom:link rel="update"
          href="http://www.caelum.com.br/pedidos/1"
          xmlns:atom="..."/>
        <atom:link rel="pagar"
		  href="http://www.caelum.com.br/pedidos/1/pagar"
          xmlns:atom="..."/>
        <atom:link rel="excluir"
          href="http://www.caelum.com.br/pedidos/1
          xmlns:atom="..."/>
         <atom:link rel="GetCliente"
          href="http://www.caelum.com.br/pedidos/1/cliente
          xmlns:atom="..."/>
</pedido>

Respare que a representação deste recurso além de conter  os dados do recurso, possui também  todas as possíveis transições de estado do recurso.
Além  disso, ainda é possível seguir os links e obter outros recursos relacionados: este é o conceito de Hipermedia tanto utilizado na web humana.

Utilizando o Restfulie client C#

Primeiro começamos fazendo o download da DLL e então para obter a representação de um recurso em C#, podemos utilizar algo bem parecido com ruby, o acesso a um entry point:

dynamic  pedido = Restfulie.At(“www.caelum.com.br/pedidos/1.xml”).Get();

Uma vez com a representação do recurso em mãos, podemos obter as informações do mesmo e seguir seus links.

Console.WriteLine(
   string.format(“O valor total do pedido é:{0}”, pedido.Total ) );
Console.WriteLine(
   string.format(“A data do pedido é: {0}”, pedido.Data) );

É possível invocar métodos e alterar o estado do pedido, além de navegar em suas relações com outros recursos.

   pedido.Pagar();
   pedido.Cancelar();
   pedido.Excluir();

Estas chamadas de métodos são remotas, baseadas nos links fornecidos pelo xml e nos protocolos http e media types bem conhecidos.
Para recuperar um recurso relacionado através dos links:

  dynamic cliente = pedido.GetCliente();
  Console.WriteLine(
     string.format(“Nome do cliente {0}”, cliente.nome));

Ainda podemos obter as informações sobre sua resposta web, para analisar headers ou response codes:

  Console.WriteLine(pedido.WebResponse.StatusCode);

As vezes a representação xml do recurso pode conter tags com o caracter “-”.
Por exemplo:

<city>
    <name>Sao Paulo</name>
    <population>
         <size>18000000</size>
         <growth>10</growth>
    </population>
    <updated-at>10/01/2010</updated-at>
    <link rel="next_largest" href="http://localhost:3000/cities/18.xml" />
</city>

Obtendo o recurso:

dynamic city = Restfulie.At(“http://localhost:3000/cities/17.xml”).Get();

Acessando o atributo “update-at”:

  Console.WriteLine(
     string.format(“A data de atualização é {0}”,city.Update_At));
  Console.WriteLine(
     string.format(“População {0}”, city.Population.size));

Note que em na vesão C#, não acessamos o atributo update-at com caracter “-”, este é substituído por “_”. Então quando for necessário acessar um atributo ou método que utilize o “-”, substituída por “_”.
Com as novas capacidades dinâmicas do C# 4.0, conseguimos atingir um resultado bem próximo ao que é possível na versão ruby.
Aqui segue um comparativo básico:

Em Ruby:

  pedido = Restfulie.at(“http://restfulie-test.heroku.com/orders/14”).get
  puts pedido.customer-name
  pedido.cancel

Em C#

  pedido = Restfulie.At(“http://restfulie-test.heroku.com/orders/14.xml”).Get();
  Console.WriteLine(pedido.customer_name);
  pedido.Cancel();

Por enquanto só temos a versão do client em C#. Ainda falta uma série de features a serem implementadas. No site do projeto, tem uma lista de coisas que necessitam de ser feitas no cliente
para que ele fique tão maduro quanto as versões em ruby ou Java. Vamos continuar trabalhando no cliente para isso.

Se você está interessado em ajudar neste projeto, deixe um comentário ou mande um e-mail para nós.

Para saber mais:

http://github.com/caelum/restfulie-csharp
http://restfulie.caelumobjects.com/

Para saber mais sobre as idéias por trás do Restfulie, segue o link do artigo na infoq.
http://www.infoq.com/articles/webber-rest-workflow

Até a Próxima
Luiz Costa
Sérgio Júnior.

Para analizar um código, assim como qualquer outra coisa, nós precisamos de parâmetros. Precisamos nos basear em algo que saibamos que seja bom, para assim podermos determinar se outra coisa é tão boa quanto, melhor, ou até pior.

Com código não é diferente. Então antes de respondermos a pergunta feita no inicio deste texto, precisamos definir o que é um código bom, ou melhor, que caracteristicas deve ter um codigo para ser considerado bom. Vamos agora recorrer a alguns principios OO para nos municiar de paramêtros para assim julgarmos o codigo em questão

Robert Martin, o uncle Bob, escreveu a muito tempo sobre os principios OO num documento chamado: PrinciplesOfOod. Dos principios OO descritos neste artigo, pelo menos 5 ficaram bastante famosos, e são conhecidos pela sigla SOLID, são eles:

Single Responsibility Principle (SRP) - A classe deve ter uma única responsabilidade, uma única razão de existir.

Open Closed Principle (OCP) - A classe deve ser aberta para extensão (sublcasses e sobrescrita de metodos) e fechada para modifiação *

Liskov Substitution Principle (LSP) - Resumidamente ele serve para nos aletar para heranças sem sentido.

Interface Segregation Principle (ISP) - Defende que uma classe deve depender apenas dos métodos que usa de uma outra classe. Interfaces são um mecanismo para isso.

Dependency Inversion Principle (ISP) - Defende que componentes maiores devem depender não de componentes menores, mas sim de uma abstração deles.

*Pode ser discutido, principalmente se você estiver trabalhando em um modelo de dominio incremental, ou seja, você vai descobrindo as necessidades de suas classes durante o desenvolvimento de software. Neste cenário o principio OCP pode ser radical demais. Lembre-se é preciso ter bom senso.

Dos principios descritos por Robert Martin, ficaremos apenas com o SRP. Sabendo agora que uma classe deve possuir apenas uma úncia responsabilidade. Quantas responsabilidades podemos identificar na classe Principal do post anterior?

Podemos identificar facilmente 3 responsabilidades. São elas:

1 - Controla a execução da aplicação.

2 - Cadastra um novo DVD

3 - Lista todos os DVD's cadastrados

Agora ficou facil ver que a classe Principal está ferindo o SRP. A resposabilidade desta classe deveria ser apenas: Controlar a execução da aplicação. Precisamos retirar da classe Principal as demais responsabilidades. Como faremos isso?

A melhor solução é remover todo o código "extra" da classe Principal. Mas o grande problema, é que sem esse codigo nossa aplicação vai parar de funcionar! Este código não pode simplesmente desaparecer. O que nós precisamos fazer e leva-lo para outro lugar. E como estamos programando segundo o paradigma de Orientação a Objetos, vamos precisar de novas classes para cada uma das responsabilidades descritas acima.

Teriamos as seguintes classes com as seguintes responsabilidades:

Classe: Principal

Responsabilidade: Controlar a execucao da aplicação

Classe: CadastrarDvd

Responsabilidade: Cuidar da lógica de inclusao de um dvd

Classe: ListarTodosDvds

Responsabilidade: Cuidar da lógica de exibicao dos dvd's

Após estas alterações vamos perceber que a classe Principal ficou bem melhor.

Mas será que isso foi suficiente? Apenas esta alteração terá salvado a vida de nossa pequena aplicação?

Tente aplicar você mesmo o SRP em nossas novas classes e comente a respeito. No proximo post continuamos nossa saga.

Abraços.

Sergio Azevedo Junior

Confira abaixo como ficaram nossas classes:

Principal

public class Principal {
  public static void main(String[] args) throws IOException {
    Scanner scan = new Scanner(System.in);
    int opcao = 0;
    do {
      System.out.println("--------------- Controle de Dvds e Cds ---------------");
      System.out.println("   1 - Cadastrar Novo Dvd ");
      System.out.println("   2 - Listar Dvd's ");
      System.out.println("   3 - Terminar ");
      System.out.println("------------------------------------------------------");
      System.out.println(" Escolha uma opção:--> ");
 
      opcao = scan.nextInt();
      switch (opcao) {
      case 1: {
        new CadastraDvd().executa();
        break;
      }
      case 2: {
        new ListaTodosDvds().executa();
        break;
      }
      }
    } while (opcao < 3);
  }
}

CadastraDvds

public class CadastraDvd {
 
  public void executa() throws IOException {
    PrintStream ps = null;
    File file = new File("Dvds.txt");
    BufferedReader br = new BufferedReader(new InputStreamReader(System.in));
    try {
      ps = new PrintStream(file);
 
      Dvd dvd = new Dvd();
      System.out.println("Titulo.: ");
      dvd.setTitulo(br.readLine());
      System.out.println("Sinopse: ");
      dvd.setSinopse(br.readLine());
      System.out.println("Genero.: ");
      dvd.setGenero(br.readLine());
      System.out.println("Ano....: ");
      dvd.setAno(br.readLine());
      System.out.println("Duracao: ");
      dvd.setDuracao(br.readLine());
 
      ps.println(dvd.getTitulo());
      ps.println(dvd.getSinopse());
      ps.println(dvd.getGenero());
      ps.println(dvd.getAno());
      ps.println(dvd.getDuracao());
    } finally {
      br.close();
      if (ps != null)
        ps.close();
    }
  }
}

ListaTodosDvds

public class ListaTodosDvds {
  public void executa() throws FileNotFoundException {
    System.out.println("------------- Lista de Dvd's -------------");
    Scanner reader = new Scanner(new File("Dvds.txt"));
    while (reader.hasNext()) {
      System.out.println(reader.nextLine());
    }
    reader.close();
  }
}

Bom artigo amigo, porém penso que esteja havendo alguma confusão sobre o que é “tipagem forte” e o que é “type casting implícito”, em minha opinião a linguagem é fracamente tipada, haja visto que se pode atribuir uma referência de qualquer TIPO de objeto a uma variável, porém a linguagem não realiza o TypeCasting de tipos de forma implícita e arbritária como caso de algumas “Linguagens Chatas” (tomei a liberdade de utilizar seu termo…).

Como o post era antigo acabei demorando para ver o comentário e consequentemente enviar uma respota, porém o comentário aborda um assunto tão interessante, que resolvi escrever um post para esclarecer o assunto, por tanto gostaria antes de mais nada  agradecer o seu comémtario, e aqui vai a minha resposta

O Fato de não precisar definir um tipo para uma variavél, não é necessáriamene uma caracterísica de uma tipagem fraca, pois quando estamos atribuindo algo a uma variável, estamos apenas passando uma refêrencia, por exemplo:

nome = "Iuri"
puts nome
>> "Iuri"

O que eu fiz no exemplo acima, foi atribuir a instancia de um objeto do tipo string a variavel nome, não preciso dizer que a variavel nome é do tipo string, isso é uma característica de uma linguagem dinâmica. porém as vezes as pessoa confundem isso com tipagem fraca por causa do exemplo abaixo:

 nome = "Iuri"
 puts nome
>> "Iuri"
 nome = 1
 puts nome
>> 1

Nesse exemplo o que eu fiz foi atribuir a referência de um objeto string "Iuri" para a variavel nome, imprimir seu valor na tela, em seguida atribui a referência de um objeto FixNum 1 para o varivel nome e imprimir o seu valor. O fato de eu conseguir passar um valor string para uma variavel e em seguida um valor FixNum, não quer dizer que a minha linguagem tem tipagem fraca, ruby tem tipagem implicita o que é bem diferente de tipagem fraca, o minha variavel apenas trocou de referência no processo acima e por ela ser dinâmica automaticamente trocou de tipo.
Agora vamos ver outro exemplo para provar de vez que Ruby possui tipagem forte:

nome = "Iuri"
soma = nome + 1
>> TypeError: can't convert Fixnum into String

Viu?? deu erro!
Isso por que Ruby tem tipagem forte, eu não posso somar um objeto do tipo string com um objeto do tipo FixNum. Isso é tipagem forte
Se excutarmos o mesmo algoritimo em javascript ,que esse sim possui tipagem fraca, o resultado seria bem diferente:

  nome = "Iuri"
  soma = nome + 1
  document.write(soma)

O resultado desse exemplo será Iuri1

Referencias:

http://en.wikipedia.org/wiki/Type_system#Duck_typing

http://en.wikipedia.org/wiki/Type_system#Dynamic_typing

http://en.wikipedia.org/wiki/Type_system#Strong_and_weak_typing

Depois de ler livros, ou fazer cursos, essas "dificuldades operacionais" desaparecem, afinal aprendemos a usar melhor a linguagem e passamos a conhecer melhor suas apis. Nesse ponto já somos capazes de por exemplo converter um String em um numero, criar e organizar listas de elementos, usar arquivos para realizar operações de leitura e escrita.

Uma vez que já sabemos criar aplicações em Java, precisamos nos perguntar outras coisas:

• "As aplicações que criamos foram constuidas da melhor maneira possível?"
• "Meu código está orientado a objetos, ou é apenas procedural Java?"
• "Como eu identifico o que deve e o que nao deve ser uma classe no meu sistema?"

A boa noticia é que estas perguntas possuem respostas. A má noticia é que eu não vou dar todas as respostas de bandeja a vocês. Ao invés disso vamos aprender a ter "senso critico" sobre o código que escrevemos. Para isso vamos começar simplesmente criando uma pequena e simples aplicação Java para cadastro e consulta de Dvd's.

Em geral, nos preocupamos primeiramente em escrever uma aplicação que funcione, e talvez esta atitude nos leve a não ter uma aplicação bem construida. Existem várias "desculpas" que podemos utilizar para justificar esse tipo de construção, mas dentre elas destacam-se as classicas: "nao tenho tempo" e "o cronograma está apertado". =)

Nesta primeira etapa estamos interessados em escrever uma aplicação que funcione. ( Talvez porque estejamos sem tempo =p )

Bem, para isso nos vamos precisar da classe Dvd, entao:

public class Dvd {
	private String titulo;
	private String sinopse;
	private String genero;
	private String ano;
	private String duracao;
	private boolean emprestado;
        //Gets e Sets
}

Agora vamos a nossa classe "principal":

public class Principal {
	public static void main(String[] args) throws FileNotFoundException {
		Scanner scan = new Scanner(System.in);
		int opcao = 0;
		do {
			System.out
					.println("--------------- Controle de Dvds e Cds ---------------");
			System.out.println("   1 - Cadastrar Novo Dvd ");
			System.out.println("   2 - Listar Dvd's ");
			System.out.println("   3 - Terminar ");
			System.out
					.println("------------------------------------------------------");
			System.out.println(" Escolha uma opção:--> ");
 
			opcao = scan.nextInt();
 
			switch (opcao) {
			case 1: {
				BufferedReader br = new BufferedReader(new InputStreamReader(
						System.in));
				PrintStream ps = new PrintStream(new File("Dvds.txt"));
				try {
					Dvd dvd = new Dvd();
					System.out.println("Titulo.: ");
					dvd.setTitulo(br.readLine());
					System.out.println("Sinopse: ");
					dvd.setSinopse(br.readLine());
					System.out.println("Genero.: ");
					dvd.setGenero(br.readLine());
					System.out.println("Ano....: ");
					dvd.setAno(br.readLine());
					System.out.println("Duracao: ");
					dvd.setDuracao(br.readLine());
 
					ps.println(dvd.getTitulo());
					ps.println(dvd.getSinopse());
					ps.println(dvd.getGenero());
					ps.println(dvd.getAno());
					ps.println(dvd.getDuracao());
					ps.close();
					br.close();
				} catch (IOException e) {
					e.printStackTrace();
				}
				break;
			}
			case 2: {
				System.out
						.println("------------- Lista de Dvd's -------------");
				Scanner reader = new Scanner(new File("Dvds.txt"));
				while (reader.hasNext()) {
					System.out.println(reader.nextLine());
				}
				reader.close();
			}
			}
		} while (opcao < 3);
	}
}

É isso ai gente! Nossa aplicação está pronta e funcionando. Porém eu faço a vocês duas perguntas:
Este codigo está bom? Porque?

No proximo post, vamos analisar este codigo responder a estas perguntas. Porém você que leu este post nao precisa esperar, pode escrever seu comentario aqui respondendo esta pergunta.

Abraços,
Sergio Junior

Confira a sequencia deste post aqui.

Acho que isso a maioria das pessoas já sabia, mas o que tenho visto por aí em projetos que trabalhei é exatamente o contrário: um modelo de objetos exatamente igual ao modelo de dados.

Por que ainda utilizamos uma abordagem assim?
Em minha opinião, o principal problema é que muitos desenvolvedores ainda não entenderam corretamente Orientação a Objetos. A prova disso são os sistemas escritos de forma totalmente procedural.

Tentarei exemplificar algumas destas diferenças. Este exemplo é uma adaptação de um problema real que eu presenciei. Vamos imaginar um sistema de cursos onde nós temos as tabelas:

Curso
id
nome
data Inicio
data Fim
idInstrutor

Instrutor
id
nome

Esta é uma simplificação, mas vai ajudar a explorar o problema.
A abordagem comum que eu tenho visto é ter um modelo de objetos que represente as tabelas do banco de dados, pois é necessário persistir as informações destes objetos. Para persistência, em java podemos utilizar o Hibernate/JPA, em Rails podemos utilizar o framework Active Record (que aliás, te induz a fazer exatamente o que eu descrevi acima) e em C# podemos utilizar o NHibernate.

Vamos ver algum código:

public class Curso{
    private int id;
    private String nome;
    private Date dataInicio;
    private Date dataFim;
    private Instrutor instrutor;
 
     ..gets e sets
}
 
public class Instrutor{
    private int id;
    private String nome;
 
    .. gets e sets
}

Em um primeiro momento, não há nada de errado com esta abordagem, certo? Apesar de nosso modelo de objetos refletir exatamente nossas tabelas no banco de dados, ele parece razoável.

Neste sistema, ao cadastrar um curso, temos que assegurar que não existe sobreposição de datas entre cursos com o mesmo instrutor. Exemplo:

Curso: Orientação a Objetos
Instrutor: Zé Bedeu
período: 18/07/2009 até 10/08/2009

Curso: Java
Instrutor: Zé Bedeu
período: 25/07/2009 até 20/08/2009

Reparem que estes dois cursos vão se sobrepor em algum momento. Até o dia 24/07/2009 o Zé Bedeu está ministrando o curso de OO e a partir de 25/07 ele também estará ministrando o curso de Java. Isso pode até fazer sentido, mas no nosso sistema de cursos isso não pode acontecer.

Então o que podemos fazer para evitar isso?
Podemos criar uma verificação para não deixar o mesmo instrutor ser alocado para outro curso se ele já tem aulas previstas dentro daquele período.

Para validar esta regra de negócio, poderíamos escrever um teste:

@Test
public void naoDeveSerPossivelTerDoisCursosParaUmInstrutorEmPeriodosSobrePostos(){
    // para simplicar, vamos utilizar strings para as datas
    // utilizando um buider.
    Curso oo = Curso.de("Orientacao a Objetos")
                               .comInstrutor("Ze Bedeu")
                               .comecandoEm("18/07/2009")
                               .ate("25/07/2009")
                               .Build();    
 
    Curso java = Curso.de("Java")
                               .comInstrutor("Ze Bedeu")
                               .comecandoEm("25/07/2009")
                               .ate("20/08/2009")
                               .Build();
 
     boolean existeSobrePosição =
                           DataUtils.existeSobrePosicaoDeDatas(
                                          oo.getDataInicio,
                                          oo.getDataFim,java.getDataInicio,
                                          java.getDataFim);
    assertFalse(existeSobrePosicao,
                   "não deve haver dois cursos com períodos sobrepostos");
}

Nosso teste faz a validação da regra de negócio, mas tem um problema nesta abordagem. Quem faz a verificação de datas é um objeto totalmente separado do nosso domínio. Reparem que o objeto DataUtils tem um método estatico que recebe 4 parâmetros. Podemos melhorar este exemplo atribuindo a responsabilidade de validar sobreposição para a classe curso, já que é ele quem tem as informações do período.

public class Curso{
    private int id;
    private String nome;
    private Date dataInicio;
    private Date dataFim;
    private Instrutor instrutor;
 
     ..gets e sets
 
    public boolean estahNoMesmoPeriodo(Curso outroCurso){
      return  DataUtils.existeSobrePosicaoDeDatas(
                                           this.getDataInicio(),
                                           this.getDataFim(),
                                           outroCurso.getDataInicio(),
                                           outroCurso.getDataFim());
 
    }
}

Vamos refatorar nosso teste:

@Test
public void naoDeveSerPossivelTerDoisCursosParaUmInstrutorEmPeriodosSobrePostos(){
    // para simplicar, vamos utilizar strings para as datas
    // utilizando um buider.
    Curso oo = Curso.de("Orientacao a Objetos")
                               .comInstrutor("Ze Bedeu")
                               .comecandoEm("18/07/2009")
                               .ate("25/07/2009")
                               .Build();
 
    Curso java = Curso.de("Java")
                               .comInstrutor("Ze Bedeu")
                               .comecandoEm("25/07/2009")
                               .ate("20/08/2009")
                               .Build();
 
    boolean existeSobrePosição = oo.estahNoMesmoPeriodo(java);
    assertFalse(existeSobrePosição,
                    "não deve haver dois cursos com períodos sobrepostos");
}

Começou a melhorar, repare que agora o próprio curso sabe validar se está no mesmo período de outro. Isso é começar delegar responsabilidades para os objetos de domínio, e evitar de se ter objetos fantoches. Nosso modelo de objetos deve ser rico e não anêmico.

Mas ainda temos algo pra melhorar. Existe um conceito que sempre falamos aqui até agora e ainda não foi explorado. Este conceito é o "Período". Mas o que é o Período?
O período nada mais é que uma representação do tempo transcorrido entre duas datas.

Um curso ocorre em um Período. Se vocês observarem a classe curso, temos data inicial e data final. O que temos na verdade é um período, e este conceito está implícito nesta classe. Em uma boa modelagem de objetos, nós temos que tornar os conceitos explícitos. Para isso podemos refatorar a classe curso e criar a classe período. Podemos também refatorar o método existeSobrePosicaoDeDatas da classe DataUtils para utilizar um período.

class Periodo{
    private Date dataInicio;
    private Date dataFim;
}
 
public class Curso{
    private int id;
    private String nome;
    private Periodo periodo;
    private Instrutor instrutor;
 
     ..gets e sets
 
    public boolean estahNoMesmoPeriodo(Curso outroCurso){
     return  DataUtils.existeSobrePosicaoDeDatas(
                                this.getPeriodo(),
                                outroCurso.getPeriodo());
 
    }
}

Agora a classe Curso na verdade tem um Período. Mas qual a vantagem de se ter o Período ao invés da data Inicio e data Fim? A vantagem é que período agora é uma classe, pode ter responsabilidades, pode tirar vantagens dos conceitos de OO. Além disso este período é altamente reutilizável por várias classes, qualquer uma que precisar do conceito de período pode utilizá-lo.

Mas ainda podemos melhorar mais. Na verdade quem tem a reponsabilidade de verificar se um período sobrepoe outro é o próprio período. A classe período é que sabe quem são as datas de início e de fim. Logo podemos fazer mais um refactoring atribuir a responsabilidade a classe período.

class Periodo{
    private Date dataInicio;
    private Date dataFim;
 
   public Periodo(Date dataInicio, Date DataFim){
      this.dataInicio = dataInicio;
      this.dataFim = dataFim;
   }
 
    public boolean estahNoMesmoPeriodo(Periodo outroPeriodo){
      /// código de validação
    }
 
    public int quantidadeDeDias(){
      // código
    }
    .. gets
}
 
public class Curso{
    private int id;
    private String nome;
    private Periodo periodo;
    private Instrutor instrutor;
 
     ..gets e sets
 
    public boolean estahNoMesmoPeriodo(Curso outroCurso){
     return  this.getPeriodo().estahNoMesmoPeriodo(
                outroCurso.getPeriodo());
    }
}

Após este refactoring, podemos observar algumas coisas:

• A classe período tem um construtor que recebe 2 datas e não tem sets. Não faz sentido você instanciar um objeto período sem data de inicio e data de fim, pois ele (o objeto período)ficararia em um estado inválido.
• A classe período agora é quem sabe validar sobreposição de datas.
• A classe período agora também sabe dizer quantos dias tem no período, já que ela conhece o início e o fim.
• A classe curso agora somente delega a responsabilidade para a classe período validar as datas.
• E o mais importante, eliminamos a necessidade da classe DataUtils. Uma classe como essa é sintoma de um código procedural. A classe dataUtils tem somente procedimentos que lidam com dados separados. A grande sacada de Orientação a Objetos é colocar junto Dados + Operações sobre estes dados.

Agora voltando ao assunto do início do tópico. A classe período não tem necessidade de ser persistida, ela é apenas um Value Object. Os dados da classe período podem ser persistidos junto com a tabela curso. Mas isso não nos limita a ter uma classe que representa um conceito do domínio.
Com JPA vc pode fazer isso facilmente utilizando anotações @Embeddable.

A utilização de uma Fluent Interface nos testes foi de propósito, pois pretendo voltar ao assunto logo logo aqui no blog.

Valeu pessoal,

Luiz Costa

2) Alem disso tem uma grande capacidade de manipular elementos de uma página com pouco código.
Exemplos:
Deixar um elemento invisível:

  $("#id_do_meu_elemento").hide();

Manipular o css de um elemento:

  $("#id_do_meu_elemento").css("background-color","Blue");

Manipular o conteúdo de um elemento:

  $(p).append("inserindo esse conteúdo em todos os parágrafos");

A lista e exemplos que poderia exibir aqui é enorme, mas esse não é o foco no momento

3) Possibilita uma grande reutilização de código através de plugins.
Exemplo: podemos criar um código para validar campos numéricos, uma função chamada "validaNumeros()".
Agora vamos supor que você possua um formulário com 8 campos do tipo numérico, ao invés de você replicar esse código no evento "onkeypress" de cada input do seu formulário, você pode transformar esse função em um plugin e no carregar da página, você simplesmente escreve o seguinte código:

  $(".campo_numerico").validaNumeros();
 //.campo_numerico seria a classe css atribuída aos inputs.

4)Atualmente existem uma quantidade enorme de plugins, disponíveis na internet que nos facilita em N tipos de tarefas e que economizam nosso tempo de escrever linhas e linhas de código javascript, muita das vezes para simplesmente fazer uma validação de formulário .

5) jQuery tem um ótimo suporte a Ajax.
Exemplos:
Carregar o conteudo de uma url em um determinado div.

  $("#id_do_meu_div").load("pagina_que_eu_quero_carregar.html");

Pegar um determinando valor via ajax e atribuir esse valor para um campo:

  $.get("retornavalor.php",function(valor) {
    $("#id_do_meu_imput").val(valor);
  });

Também temos suporte a JSON

  $.getJSON("retornavalor.php",function(objeto) {
    $("#id_do_meu_imput").val(objeto.valor);
  });

Nesse post, eu listei cinco motivos, mas tenho certeza que quando você começar a utilizar jQuery, nos seus projetos, você vai encontrar muito mais!

Pretendo escrever mais artigos, detalhando determinadas funcionalidades do jQuery , mas atualmente já existe bastante conteúdo disponivel sobre o assunto, no próprio site oficial temos uma documentação bem legal com bastante exemplos: http://docs.jquery.com.

Até a próxima!

Iuri Menescal