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

CKTIS / Java

when — condição adicional num padrão de switch

Em Java SE 21, a palavra-chave contextual when introduz uma condição adicional (uma guarda) após um padrão case numa instrução ou expressão switch. O ramo só é selecionado quando o valor corresponde ao padrão e a guarda é avaliada como true.

Versão: Language target: Java SE 21. Neither the repository runtime version nor the production runtime version is attested.

Sintaxe

case Pattern when Expression -> ...
case Pattern when Expression: ...

when é uma palavra-chave contextual, não reservada: desempenha este papel na gramática de Guard, mas pode ser usada como identificador fora desse contexto. Em Java SE 21, introduz uma condição adicional após um padrão case numa instrução ou expressão switch. Não é uma instrução autónoma nem um substituto de if.

O padrão é testado primeiro. A condição que se segue a when só é avaliada após uma correspondência e pode usar variáveis declaradas por esse padrão, como s. Se o resultado for true, o ramo pode ser selecionado; se for false, a procura de uma etiqueta aplicável prossegue. Uma guarda pode ser usada tanto com -> como com :. Não pode ser acrescentada a uma etiqueta constante como case 42.

A guarda tem de ser do tipo boolean ou Boolean; o unboxing de um valor null do tipo Boolean lança NullPointerException. É proibida uma expressão constante cujo valor seja false. As variáveis locais e os parâmetros usados na guarda, mas não declarados nela, têm de ser final ou efetivamente finais.

Coloque um caso com guarda mais específico antes de um caso geral do mesmo tipo. Inverter essa ordem no exemplo causaria um erro de compilação, porque a etiqueta com guarda seria dominada. case null trata explicitamente null; default, por si só, não garante esse tratamento. O exemplo destina-se a Java SE 21 e não necessita de funcionalidades preview; não atesta a versão do ambiente de execução do repositório nem a do ambiente de produção.

Exemplos

public class WhenExample {
    static String classify(Object value) {
        return switch (value) {
            case null -> "null";
            case String s when s.length() > 3 -> "long string";
            case String s -> "short string";
            default -> "other";
        };
    }

    public static void main(String[] args) {
        System.out.println(classify("Java"));
        System.out.println(classify("Hi"));
        System.out.println(classify(42));
        System.out.println(classify(null));
    }
}

Resultado

long string
short string
other
null

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