Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / Java

Sobrecarga de métodos

A sobrecarga de métodos permite que vários métodos tenham o mesmo nome, mas listas de parâmetros diferentes. O compilador escolhe uma sobrecarga com base nos argumentos e nos respetivos tipos conhecidos em tempo de compilação, e não nas classes em tempo de execução dos objetos passados como argumentos.

Versão: Java SE 21; repository runtime, production runtime not attested

Sintaxe

static String describe(int value) { return "int"; }
static String describe(Object value) { return "Object"; }
static String describe(String value) { return "String"; }

Existe sobrecarga de métodos quando métodos pertencentes a uma classe têm o mesmo nome, mas assinaturas que não são equivalentes para efeitos de substituição. Estes métodos podem ser declarados nessa classe ou herdados.

Nos métodos comuns não genéricos, as sobrecargas diferem no número, nos tipos ou na ordem dos tipos dos parâmetros. Os nomes dos parâmetros, o tipo de retorno ou a cláusula throws, por si só, não são suficientes para criar uma sobrecarga.

A escolha da sobrecarga ocorre em tempo de compilação. No exemplo, describe(value) seleciona describe(Object) porque o tipo declarado de value é Object, apesar de conter um objeto String. Não confunda isto com a substituição: para a assinatura selecionada de um método de instância, a implementação pode ser determinada em tempo de execução.

Se não existir um método aplicável, ou se não for possível selecionar sem ambiguidade o método mais específico, a compilação falha. As sobrecargas devem representar a mesma operação para entradas diferentes, para que as chamadas continuem a ser fáceis de compreender.

Exemplos

public class Main {
    static String describe(int value) {
        return "int";
    }

    static String describe(Object value) {
        return "Object";
    }

    static String describe(String value) {
        return "String";
    }

    public static void main(String[] args) {
        Object value = "hello";
        System.out.println(describe(7));
        System.out.println(describe("hello"));
        System.out.println(describe(value));
    }
}

Resultado

int
String
Object

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes