Boas práticas para escrita de métodos, funções e procedimentos - Revista Engenharia de Software Magazine 40 - Parte 2

A escrita de código de forma sequencial, isto é, código que é executado de cima para baixo, da primeira linha até a última, restringe uma ação a ser executada somente depois da sua anterior, não considerando estruturas condicionais que fornecem mais de um caminho. As funções, métodos e procedimentos permitem que o código seja organizado em sequência, mas também em blocos, o que traz como benefício a organização do código em estruturas que podem ser executadas em qualquer ponto de uma classe ou arquivo de código fonte quando invocados.

Mediante a importância das estruturas como métodos, funções e procedimentos em uma aplicação, é necessário que eles sejam escritos de forma limpa e mantidos limpos durante todo o ciclo de vida do software.

Todas as teorias que serão abordadas neste artigo contribuirão para uma melhora efetiva na qualidade e legibilidade do código fonte, mas além das técnicas sobre código limpo, outros recursos se fazem importantes, que são as técnicas de refatoração de código. As teorias sobre código limpo não prevêem uma forma controlada de modificar o código dos métodos, funções e procedimentos como as técnicas de refatoração de código (FOWLER, 2004), portanto a sugestão para que o sucesso seja obtido nessa tarefa é a utilização de refatorações em alguns casos específicos. Quando necessárias, elas serão destacadas, bem como onde aprender mais sobre elas.

Como dito anteriormente, os métodos, funções e procedimentos são estruturas de dados que permitem que tarefas sejam organizadas em blocos e executadas quando necessário. É fato também que todo desenvolvedor conhece os tipos de funções, métodos e procedimentos existentes que são, no caso dos métodos, estruturas que possuem um moderador de acesso (privado, público e protegido, entre outros), um tipo de dados de retorno (inteiro, string, void, entre outros), um nome para o método e uma lista de parâmetros, que pode ser vazia. Alguns métodos possuem um retorno de alguma informação, e outros não, como os que utilizam void como tipo de retorno.

Cada um dos tipos de métodos citados aqui, e também as funções e procedimentos, possuem suas particularidades. Nesse sentido, o objetivo deste artigo é apresentar as teorias sobre código limpo, relativo a funções, que proporcionarão ao desenvolvedor a capacidade de criar estruturas limpas. Os assuntos que serão abordados na seção Funções permitirão ao desenvolvedor criar ou modificar métodos, procedimentos e funções utilizando nomes significativos, isto é, que deixem clara a intenção da estrutura. Outros pontos que receberão destaque neste artigo são referentes ao tamanho das estruturas, ao corpo dos métodos e aos seus objetivos. Além disso, serão abordadas em detalhes todas as teorias que envolvem a definição de bons parâmetros e os riscos das muitas responsabilidades em uma única estrutura.