Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / Java

when — condizione aggiuntiva su un pattern di switch

In Java SE 21, la parola chiave contestuale when introduce una condizione aggiuntiva (una guardia) dopo un pattern case in un’istruzione o un’espressione switch. Il ramo viene selezionato solo se il valore corrisponde al pattern e la guardia restituisce true.

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

Sintassi

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

when è una parola chiave contestuale, non riservata: svolge questo ruolo nella grammatica di Guard, ma al di fuori di tale contesto può essere usata come identificatore. In Java SE 21 introduce una condizione aggiuntiva dopo un pattern case in un’istruzione o un’espressione switch. Non è un’istruzione autonoma né un sostituto di if.

Il pattern viene verificato per primo. La condizione che segue when viene valutata solo dopo una corrispondenza e può usare le variabili dichiarate dal pattern, ad esempio s. Se il risultato è true, il ramo può essere selezionato; se è false, la ricerca di un’etichetta applicabile continua. Una guardia può essere usata sia con -> sia con :. Non può essere aggiunta a un’etichetta costante come case 42.

La guardia deve avere tipo boolean o Boolean; l’unboxing di un valore null di tipo Boolean genera NullPointerException. È vietata un’espressione costante il cui valore sia false. Le variabili locali e i parametri usati nella guardia ma non dichiarati al suo interno devono essere final o effettivamente finali.

Posiziona un caso con guardia più specifico prima di un caso generale dello stesso tipo. Invertire quest’ordine nell’esempio causerebbe un errore di compilazione perché l’etichetta con guardia sarebbe dominata. case null gestisce esplicitamente null; default da solo non garantisce tale gestione. L’esempio è destinato a Java SE 21 e non richiede funzionalità preview; non attesta la versione dell’ambiente di esecuzione del repository né quella di produzione.

Esempi

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));
    }
}

Risultato

long string
short string
other
null

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti