É uma boa prática garantir que a instrução switch deve estar completa
no sentido de que cada execução no tempo de execução irá encontrar uma ramificação adequada.
Esta é na realidade uma tarefa não trivial quando se tem tudo o que se segue em consideração:
Adicionalmente, o JSL obriga a uma análise de fluxo para instruções enum switch que podem conduzir a erros de hora de compilação inesperados:
enum Colors { RED, GREEN, BLUE }
String colorString(Color c) {
switch(c) {
case RED: return "red";
case GREEN: return "green";
case BLUE: return "blue";
}
}
O compilador irá responder:
"Este método tem de devolver um resultado do tipo String. Tenha em atenção que um problema relativo a uma 'default:' em falta em 'switch' foi suprimido, o que talvez esteja relacionado a este problema".
Esta mensagem foi concebida para alertar os utilizadores sobre as diferentes noções de totalidade: a análise de fluxo exigida pelo JSL considera cada instrução enum switch sem uma combinação de maiúsculas-minúsculas predefinida como incompleta, mesmo que liste todas as constantes enum (actualmente conhecidas). Isto diz respeito a instruções de retorno bem como à atribuição definitiva de variáveis locais ou campos finais em branco. No entanto, se seguir todas as recomendações em baixo, a mensagem de erro em cima nunca irá ocorrer.
Consulte as preferências do compilador relativas às opções de configuração individuais para registar vários níveis de não totalidade. Em seguida, iremos falar sobre os diferentes objectivos e políticas de concepção e sobre como podem ser verificadas utilizando o compilador Java do Eclipse.
De uma forma perfeita, cada instrução switch deve ter uma ramificação predefinida com significado, que processa todos os casos que não são explicitamente listados utilizando uma estratégia "sempre razoável". Obviamente, essa estratégia é difícil ou mesmo impossível de localizar em muitos casos, mas se localizar uma implementação predefinida com significado, essa é certamente a melhor solução.
Se o compilador o aviso sobre uma combinação de maiúsculas-minúsculas em falta, mas o razoável por predefinição é apenas não fazer nada, talvez seja melhor documentar também esta opção.
default: cuja acção seja apenas um comentário que explica que (e porquê)
não fazer nada é uma boa opção nesta instrução switch. Ao fazê-lo, também diz ao compilador que não
se esqueceu simplesmente que uma combinação de maiúsculas-minúsculas em falta.
Se definitivamente não for possível encontrar nenhuma implementação predefinida razoável, como último recurso pode pretender prevenir que um valor inesperado seja a causa raiz para outros erros mais à frente, isto é, pode pretender falhar mais cedo no tempo de execução.
default: que lance
uma excepção e/ou registe o problema.
Cada instrução switch deve ser atribuível a uma das três categorias em cima. Isto significa que deixar o compilador avisar sobre cada combinação de maiúsculas-minúsculas predefinida em falta é uma estratégia universalmente válida.
Ao executar uma instrução switch sobre um valor enum, poderá ser desejável abranger explicitamente cada constante de enumeração por uma instrução de combinação de maiúsculas-minúsculas correspondente.
Se não gostar da opção que todas as instruções enum switches devem mencionar todas as constantes de enumeração, mas quiser ser avisado sobre etiquetas case em falta para algumas instruções enum switch, terá de seleccionar a estratégia para cada instrução enum switch individual.
String colorString2(Color c) {
switch(c) {
case RED: return "red";
case GREEN: return "green";
//$CASES-OMITTED$
default:
return "unknown color";
}
}
Sugestão: se o compilador registar algo como "A constante de enumeração BLUE deve ter uma etiqueta case correspondente nesta enum switch em Cor" será oferecida uma correcção rápida para inserir o comentário de sinalizador.
As considerações anteriores mostraram que obterá muita ajuda do compilador se activar todos os avisos opcionais
relativos a instruções switch incompletas, e utilizar combinações de maiúsculas-minúsculas predefinidas documentadas vazias mais comentários de sinalizadores //$CASES-OMITTED$
para marcar essas instruções switch onde a não totalidade é aceitável por concepção.
Se seguir essas recomendações, irá obter todos os avisos relevantes (ou erros se quiser)
onde as ramificações são acidentalmente omitidas, incluindo a situação de junção tardia de uma ou mais constantes de enumeração.
Todas as excepções desta totalidade máxima serão documentadas no código e não serão sinalizadas com um aviso.
Ainda assim, o compilador não consegue prevenir o uso de versões de classe inconsistentes no tempo da execução, por isso, uma classe pode ser compilada numa versão antiga de um tipo de enumeração, mas na aplicação em execução o tipo de enumeração pode ter mais constantes de enumeração. Para estas situações semelhantes, uma implementação "catch-all" predefinida apropriada pode levantar uma excepção de tempo de execução para alertar para esta inconsistência e impedir que o erro se propague mais para a aplicação.
Como valor adicionado das definições do compilador restritas recomendadas em cima, a mensagem de erro dúbia sobre uma instrução de retorno em falta mostrada em cima (ou mensagens semelhantes sobre variáveis não iniciadas) já não irá ocorrer.