Garantizar la completitud de sentencias switch

Constituye un procedimiento recomendado asegurarse de que cada sentencia switch esté completa, en el sentido de que cada ejecución encuentre una rama adecuada. En realidad esta tarea no es trivial cuando se tiene en cuenta todo lo siguiente:

Además, JLS ordena la realización de un análisis de flujo para sentencias enum switch que puede llevar a errores de tiempo de compilación inesperados:

    enum Colors { RED, GREEN, BLUE }
    String colorString(Color c) {
        switch(c) {
            case RED: return "red";
            case GREEN: return "green";
            case BLUE: return "blue";
        }
    }

El compilador responderá:

"Este método debe devolver un resultado de tipo String. Tenga en cuenta que se ha suprimido un problema relacionado con la falta de 'default:' en 'switch', y esto posiblemente está relacionado con este problema".

Este mensaje se ha diseñado para alertar a los usuarios de las diferentes nociones de completitud: el análisis de flujo ordenado por JLS considera la sentencia each enum switch sin un caso default como incompleta, incluso aunque lista todas las constantes enum (conocidas actualmente). Esto atañe a las sentencias return así como a la asignación definitiva de variables locales o campos finales en blanco. Sin embargo, si sigue todas las recomendaciones que figuran a continuación, el mensaje de error no se producirá nunca.

A continuación, consulte las preferencias del compilador respecto a las opciones de configuración individuales para informar de varios niveles de incompletitud. En la secuela tratamos diferentes objetivos y políticas de diseño y cómo se pueden comprobar mediante el compilador Eclipse Java.

Al utilizar "default:"

Normalmente cada sentencia switch debe tener una rama predeterminada significativa, lo que maneja todos los casos que no se listan explícitamente mediante una estrategia "siempre-razonable". Normalmente, una estrategia así es difícil o incluso imposible de encontrar en muchos casos, pero si puede encontrar una implementación predeterminada significativa, eso es seguramente la mejor solución.

Recomendación: al permitir que el compilador le avise sobre la falta de un caso default para cada sentencia switch, deberá buscar una buena implementación de default para cada sentencia switch.

Si el compilador le avisa sobre un caso default faltante pero lo razonable es no hacer nada de forma predeterminada, no haga nada; esto merecerá la pena documentarlo.

Recomendación: si "no hacer nada" es una estrategia predeterminada razonable, debe añadir una etiqueta default: cuya acción sólo sea un comentario que explique que (y por qué) no hacer nada está bien en este switch. Al hacerlo así, también indica al compilador que no simplemente se ha olvidado de un caso default.

Si definitivamente no se encuentra ninguna implementación de default razonable, como último resorte querrá evitar que un valor inesperado sea la causa raíz de otros errores más adelante, es decir, querrá fallar pronto en tiempo de ejecución.

Recomendación: si no se encuentra ninguna implementación predeterminada razonable y "no hacer nada" no parece una buena estrategia, añada un caso default: que lance una excepción y/o registre el problema.

Cada sentencia switch debe poder asignarse a una de las tres categorías anteriores. Esto significa que dejar que el compilador le avise sobre cada caso default faltante es una estrategia universalmente válida.

Manejar todas las constantes de enumeración

Cuando se realiza un switch a través de un valor enum, es deseable cubrir explícitamente cada constante de enumeración mediante una sentencia case correspondiente.

Recomendación: si desea que se le avise sobre las sentencias switch de enumeración a las que les falta una sentencia case para cualquiera de las constantes de enumeración, considere la posibilidad de habilitar la opción Señal incluso si existe el caso 'default'.

Si no le gusta la opción de que todos los switch de enumeración deban mencionar todas las constantes de enumeración pero todavía desea recibir el aviso sobre las etiquetas de caso faltantes para algunas sentencias switch de enumeración, debe seleccionar la estrategia para cada sentencia switch de enumeración individual.

Recomendación: si el aviso anterior es deseable para algunas sentencias switch, considere la posibilidad de habilitar globalmente el aviso e identificar aquellas sentencias switch en las que está bien omitir casos para algunas constantes de enumeración, porque esas las maneja adecuadamente el caso default. Para las sentencias switch, utilice el código '//$CASES-OMITTED$' para documentar la decisión:
    String colorString2(Color c) {
        switch(c) {
        case RED: return "red";
        case GREEN: return "green";
            //$CASES-OMITTED$
        default:
        	return "unknown color";
        }
    }

Sugerencia: si el compilador informa de algo como por ejemplo "La constante de enumeración BLUE debe tener una etiqueta de caso correspondiente en esta conmutación de enumeración en Color" se ofrecerá un arreglo rápido para insertar el comentario de código.

Resumen

Las consideraciones anteriores han mostrado que puede obtener la mayoría de la ayuda del compilador si habilita todos los avisos opcionales respecto a sentencias switch incompletas y utiliza casos predeterminados documentados vacío más comentarios de código //$CASES-OMITTED$ para marcar las sentencias switch en las que la incompletitud es aceptable por diseño. Si sigue estas recomendaciones, obtendrá avisos muy relevantes (o errores si lo prefiere) cuando se omitan accidentalmente ramas, incluyendo la situación o la adición tardía de una o varias constantes de enumeración. Todas las excepciones a esta completitud máxima se documentarán en el código y ya no se marcarán con un aviso.

Aun y así, el compilador no puede impedir el uso de versiones de clases incoherentes en tiempo de ejecución, de modo que una clase se puede compilar contra una versión antigua de un tipo de enumeración, pero en la aplicación que se está ejecutando del tipo de enumeración puede haber más constantes de enumeración. Para estas y otras situaciones parecidas, mediante "catch-all" implementaciones de default se pueden producir excepciones de tiempo de ejecución que alerten de esta incoherencia y que impidan que el error se propague más en la aplicación.

Como valor añadido a los valores de compilador estrictos recomendados más arriba, el mensaje de error dudoso sobre una sentencia return faltante mostrado más arriba (o mensajes similares sobre variables no inicializadas) ya no aparecerá.