CKTIS / Java
when — condición adicional en un patrón de switch
En Java SE 21, la palabra clave contextual when introduce una condición adicional (una guarda) después de un patrón case en una instrucción o expresión switch. La rama solo se selecciona cuando el valor coincide con el patrón y la guarda se evalúa como true.
Versión: Language target: Java SE 21. Neither the repository runtime version nor the production runtime version is attested.
Sintaxis
case Pattern when Expression -> ...
case Pattern when Expression: ...when es una palabra clave contextual, no reservada: desempeña esta función en la gramática de Guard, pero puede usarse como identificador fuera de ese contexto. En Java SE 21, introduce una condición adicional después de un patrón case en una instrucción o expresión switch. No es una instrucción independiente ni sustituye a if.
Primero se comprueba el patrón. La condición que sigue a when solo se evalúa después de que haya una coincidencia; puede usar variables declaradas por ese patrón, como s. Si el resultado es true, se puede seleccionar la rama; si es false, continúa la búsqueda de una etiqueta aplicable. La guarda puede usarse tanto con -> como con :. No se puede añadir a una etiqueta constante como case 42.
La guarda debe tener el tipo boolean o Boolean; desempaquetar un valor null de tipo Boolean lanza NullPointerException. No se permite una expresión constante cuyo valor sea false. Las variables locales y los parámetros usados en la guarda pero no declarados en ella deben ser final o efectivamente finales.
Coloca un caso con guarda más específico antes de un caso general del mismo tipo. Invertir ese orden en el ejemplo provocaría un error de compilación porque la etiqueta con guarda quedaría dominada. case null gestiona explícitamente null; default por sí solo no garantiza ese tratamiento. El ejemplo está dirigido a Java SE 21 y no necesita funciones preview; no acredita la versión del entorno de ejecución del repositorio ni la del entorno de producción.
Ejemplos
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
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.