Código conciso: claro e breve
3 minutos de leitura
Autor(a)
gas
Inscreva-se em nossa Newsletter
Fique por dentro de conteúdos, insights e oportunidades do universo tech. Receba novidades e lançamentos direto no seu e-mail.
3 minutos de leitura
Autor(a)
Fique por dentro de conteúdos, insights e oportunidades do universo tech. Receba novidades e lançamentos direto no seu e-mail.
Há poucos anos, com a onda de novas linguagens, surgiram discussões defendendo código com a intenção de ser "conciso".
Ser conciso é expressar muito, com poucas palavras; ser claro e sucinto; curto, mas com todas as informações necessárias; breve e claro. Note como todas as definições de concisão implicam em ser curto, mas também na clareza da informação. Dois fatores fundamentais para a busca do código de qualidade
Tomemos como exemplo o ato de salvar um usuário no único banco de dados acessado por uma aplicação:
user.saveInTheDatabase(database)
Ele é claro, e chega a ser até mesmo redundante uma vez que "tipifica" o nome do método ao repetir a palavra database. Já o código a seguir mantem a clareza relativa a responsabilidade citada, além de ser sucinto:
user.save
Em uma outra situação, o mesmo código acima pode ser implementado executando outras tarefas, como inserindo outros objetos relativos a um usuário:
def save super maquinas\_a\_instalar.each do |instancia| cria\_maquina\_no\_banco(instancia) end
\# ou qualquer outro tipo de efeito colateral end
Agora o código anterior, continua sucinto mas já não é mais tão claro:
user.save
Ele não diz que faz o que realmente fará. A busca pelo código curto introduziu a possibilidade de engano daquele que vai ler, pior ainda, o nome do método e a maneira de implementá-lo levam ao erro: ele não é conciso, ele é somente breve.
Por isso alguns usos excessivos de técnicas avançadas, como AOP ou mesmo reflection, precisam de muito cuidado. Remotabilidade transparente, EJBs, JPA, ActiveResource e quaisquer outras bibliotecas que trabalham um serviço de maneira a ocultá-lo podem gerar problemas caso o usuário não tenha um certo conhecimento do efeito de suas chamadas. É o caso do excesso de invocações remotas ou de queries sqls, que os frameworks já citados podem trazer sem um conhecimento mais profundo..
Concisão não significa texto curto. Um dos grandes desafios de um autor é ser conciso, para não cansar seus leitores, mantendo a clareza de seu texto. Algumas linguagens ou até mesmo bibliotecas podem acelerar ou desacelerar o processo de falar algo com poucas palavras, o que não significa necessariamente o código mais fácil de entender e, consequentemente, de manter a longo prazo.
Escrever pouco - a métrica de linhas de código - traz o menor código, mas não necessariamente o mais claro ou melhor. No exemplo a seguir, o cliente está sendo somente salvo ou algo mais está sendo feito e a "pseudo-concisão" está nos enganando?
cliente.save()
Avalie este artigo
