Tópico 04 - Funções

Argumentos vs Parâmetros

// 'nome' é um parâmetro
public void saudacao(String nome) {}

// "Fulano" é um argumento
saudacao("Fulano");

• Argumentos: Valores passados para uma função quando ela é chamada.
• Parâmetros: Variáveis declaradas em uma função para receber os argumentos.

public class GerenciadorDePedidos {
    public void processarPedido(String pedido) {
        if (validarPedido(pedido)) {
            double valor = calcularValorTotal(pedido);
            gerarNotaFiscal(pedido, valor);
            enviarConfirmacao(pedido);
        } else {
            System.out.println("Pedido inválido.");
        }
    }

    private boolean validarPedido(String pedido) {}
    private void gerarNotaFiscal(String pedido, double valor) {}
    private double calcularValorTotal(String pedido) {}
    private void enviarConfirmacao(String pedido) {}
}

Ordem de Leitura

O código-fonte deve contar a história de forma lógica e linear.

Pode-se usar diferentes estratégias, como ler o código de cima para baixo (top-down) ou de baixo para cima (bottom-up).

Switches

public Money calculatePay(Employee e) throws InvalidEmployeeType {
    if (e.type == EmployeeType.COMMISSIONED) {
        return calculateCommissionedPay(e);
    } else if (e.type == EmployeeType.HOURLY) {
        return calculateHourlyPay(e);
    } else if (e.type == EmployeeType.SALARIED) {
        return calculateSalariedPay(e);
    } else {
        throw new InvalidEmployeeType(e.type);
    }
}

O uso de switch é geralmente desencorajado por questões de legibilidade e manutenção.

Assim como um conjunto de if, o switch pode ser substituído por uma tabela de decisão.

public void postTweet(String tweet) {
    // Lógica para postar um tweet
}
public void deleteUser(String userId) {
    // Lógica para deletar um usuário
}
public double calculateTotal(List<Item> items) {
    // Lógica para calcular o total
}

Nomes Significativos

Nomes de métodos ou funções são geralmente verbos ou frases verbais, como: post_tweet, delete_user, calculate_total.

public void createSchedule(
    String class1Name,
    Credits[] class1Credits,
    String class2Name,
    Credits class2Credits,
    String class3Name,
    Credits class3Credits,
    String class4Name,
    Credits class4Credits,
    String class5Name,
    Credits class5Credits,
    String class6Name,
    Credits class6Credits
) {}

Parâmetros em Funções

Segundo o livro "Clean Code", a quantidade ideal de parâmetros de uma função deve ser 0, seguida de 1, 2 ou 3.

É importante compreender que quanto mais parâmetros uma função tiver, mais difícil se torna identificar todas as possibilidades de uso.

Parâmetros Booleanos

public void render(Boolean isSilent) {
    if (isSilent) {
        // Renderiza em modo silencioso
    } else {
        // Renderiza normalmente
    }
}

Robert C. Martin:

"Esses parâmetros são feios"

O uso de um booleano como parâmetro de uma função é um sinal de que a função faz mais do que uma coisa.

Parâmetros de Saída

public void calculate(int a, int b, int[] result) {
    result[0] = a + b;
    result[1] = a - b;
    result[2] = a * b;
}

Parâmetros são geralmente interpretados como entradas de uma função.

Parâmetros de saída são alterados pela função e seu uso é desencorajado, especialmente em linguagens orientadas a objetos.

public void setUsername(String username) {
    this.username = username;
}

public String getUsername() {
    return this.username;
}

Separação comando-consulta

Uma função deve executar uma modificação ou definir uma consulta, mas não ambas.