CKTIS / Java
when — dodatkowy warunek przy wzorcu w switch
W Java SE 21 słowo kontekstowe when wprowadza dodatkowy warunek (guard) po wzorcu case w instrukcji lub wyrażeniu switch. Gałąź zostaje wybrana dopiero wtedy, gdy wartość pasuje do wzorca, a warunek ma wartość true.
Wersja: Language target: Java SE 21. Neither the repository runtime version nor the production runtime version is attested.
Składnia
case Pattern when Expression -> ...
case Pattern when Expression: ...when jest słowem kluczowym kontekstowym, a nie zastrzeżonym: pełni tę rolę w składni warunku Guard, lecz poza tym kontekstem może być identyfikatorem. W Java SE 21 wprowadza dodatkowy warunek po wzorcu case w instrukcji lub wyrażeniu switch. Nie jest osobną instrukcją ani zamiennikiem if.
Najpierw sprawdzany jest wzorzec. Dopiero po dopasowaniu obliczany jest warunek po when, który może korzystać ze zmiennych tego wzorca, np. s. Wynik true pozwala wybrać gałąź; wynik false powoduje dalsze szukanie pasującej etykiety. Warunek można stosować zarówno z ->, jak i z :. Nie można dołączyć go do etykiety stałej, takiej jak case 42.
Warunek musi mieć typ boolean lub Boolean; rozpakowanie wartości null typu Boolean powoduje NullPointerException. Stałe wyrażenie o wartości false jest niedozwolone. Używane w warunku, lecz w nim niezadeklarowane zmienne lokalne i parametry muszą być final lub efektywnie finalne.
Umieszczaj bardziej szczegółowy przypadek z warunkiem przed ogólnym przypadkiem tego samego typu. Odwrotna kolejność w przykładzie spowodowałaby błąd kompilacji z powodu zdominowanej etykiety. case null jawnie obsługuje null; samo default nie zapewnia takiej obsługi. Przykład dotyczy Java SE 21 i nie wymaga funkcji preview; nie potwierdza wersji środowiska repozytorium ani środowiska produkcyjnego.
Przykłady
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));
}
}Wynik
long string short string other null
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.