Grau de Abstração do Código-fonte

Estipular níveis de abstração do código-fonte nada mais é que saber determinar o que pode ser transofromado em uma função, método ou classe e o que é extremamente específico.

No caso de funções, métodos ou classes, pode ser muito útil estipular um limite de linhas ou um limite de níveis de identação para não tornar o código muito complexo. É claro que isso deve ser apenas uma convensão e não uma regra. Existem casos de código com muitas linhas mas muito legíveis. Em geral, a legibilidade de uma função ou método diminui a medida que se aumentam os níveis de identação. Veja um exemplo:


O código utilizou 5 níveis de identação em alguns pontos.

Uma alternativa que pode tornar o código mais legível é colocar estruturas condicionais que utilizam break ou continue no início de um bloco de repetição. Desta forma, não é necessário criar um "else" com mais um nível de identação, já que o "continue" ou o "break" irão interromper o fluxo natural do loop. Além disso, utilizar o operador ternário pode ser muito útil para evitar mais um nível de identação.

O código apresentado anteriormente seria convertido para a seguinte forma:


Definir níveis de abstração, é quebrar um bloco de instruções em funções/métodos. O código acima poderia ser convertido para a seguinte forma:


Neste caso, o nível de identação não passou de 3. Note que as operações ficaram mais específicas. Logo, se um programador está interessado em saber apenas o que a função "imprimir_itens" faz, ele terá a resposta mais rapidamente do que lendo o código mostrado anteriormente. A função não precisa de comentários internos, pois é extremamente simples e legível.

A dica para construir códigos em níveis de abstração cada vez mais específicos é utilizando a estratégia top-down. Pensar no problema sob uma perspectiva geral, lançar a chamada da função com os parâmetros imaginados inicialmente, depois implementar a função. Ao implementar a função, ela deve chamar outras funções mais específicas e que ainda não foram implementadas. Depois, implemente-as e, caso necessário, inclua parâmetros não previstos inicialmente.

ini_set('memory_limit', '128M');

$time = time();
foreach ($itens as $item) {
    if ($item->tamanho > $tamanho_minimo) {
        foreach ($item->elementos as $elemento) {
            if ($elemento->visivel) {
                echo '<p>';
                if ($data > $time) {
                    echo 'teste';
                }
                echo $elemento->nome;
                echo '</p>';
            }
        }
    }
}