Preferências de erros/avisos de compilação Java

Indique as suas preferências para as definições de Erros/Avisos na página de preferências Abre a página de preferências Erros/Avisos Java > Compilador > Erros/Avisos .

Estilo de código

Opção

Descrição

Predefinição

Acesso não estático a um membro estático

Quando activado, o compilador emite um erro ou um aviso sempre que um método ou campo estático é acedido com um receptor de expressões. Uma referência a um membro estático deverá ser qualificada com um nome de tipo.

Aviso

Acesso indirecto a um membro estático

Quando estiver activado, o compilador vai emitir um erro ou um aviso sempre que um campo ou método estáticos forem acedidos indirectamente. Um campo estático de uma interface deverá ser qualificado com o nome do tipo declarante.

Ignorar

Acesso não qualificado ao campo da instância

Quando activado, o compilador emite um erro ou um aviso sempre encontra um acesso a campo que não está qualificado (p.ex. falta um 'este').

Ignorar

Aceder a um membro não acessível de um tipo delimitador

Quando estiver activado, o compilador vai emitir um erro ou um aviso sempre que emular acesso a um membro não acessível de um tipo delimitador. Este tipo de acessos pode ter implicações no rendimento.

Ignorar

Atribuição de parâmetros

Atribuir um valor a um parâmetro é geralmente considerado programação de estilo pobre. Ao activar esta opção, o compilador vai sinalizar esta situação como um erro ou um aviso.

Ignorar

Cadeias não exteriorizadas

Quando activado, o compilador emite um erro ou aviso para Literais de cadeia não exteriorizadas (isto é, não codificados com //$NON-NLS-<n>$) ou para Identificadores de cadeias não exteriorizadas que não pertençam a uma Cadeia.

Ignorar

Bloco vazio não documentado

Quando estiver activado, o compilador vai emitir um erro ou um aviso sempre que detectar uma instrução de bloco vazio sem um comentário explicativo.

Ignorar

Recurso não gerido através de try-with-resource (1.7 ou superior)

Quando activado, o compilador irá emitir um erro ou aviso se uma variável local tiver um valor do tipo 'java.lang.AutoCloseable', e se o método 'close()' for explicitamente invocado nesse recurso, mas o recurso não for gerido por um bloco try-with-resources.

Ignorar

Método com nome de construtor

Dar a um método o nome do construtor é normalmente considerado uma programação de pouco estilo. Ao activar esta opção, o compilador vai sinalizar esta situação como um erro ou um aviso.

Aviso

Método pode ser estático

Quando activado, o compilador irá emitir um erro ou um aviso para métodos que são privados ou finais, e que fazem referência apenas a membros estáticos.

Ignorar

Método pode ser potencialmente estático

Quando activado, o compilador irá emitir um erro ou um aviso para métodos que não são privados ou finais, e que fazem referência apenas a membros estáticos. Tenha em atenção que os métodos podem ser substituídos numa subclasse, por isso se tornar um método "potencialmente estático" isso pode quebrar os clientes existentes.

Ignorar

Potenciais problemas de programação

Comparar valores idênticos ('x == x')

Quando activado, o compilador irá emitir um erro ou um aviso se uma comparação envolver operadores idênticos (p. ex., 'x == x').

Aviso

A atribuição não tem efeito (por exemplo, 'x = x')

Quando activado, o compilador vai emitir um erro ou um aviso sempre que uma atribuição não produz efeitos (por exemplo, 'x = x').

Aviso

Atribuição booleana possivelmente acidental (por exemplo, 'if (a = b)')

Quando activado, o compilador emitirá um erro ou um aviso sempre que encontrar uma atribuição booleana possivelmente acidental (por exemplo, 'if (a = b)').

Ignorar

Conversões de encaixe e desencaixe

Quando estiver activado, o compilador vai emitir um erro ou um aviso sempre que detectar o encaixe ou desencaixe de uma conversão. O auto-encaixe pode afectar negativamente o rendimento.

Ignorar

Utilizar uma matriz char na concatenação da cadeia

Quando estiver activado, o compilador vai emitir um erro ou um aviso sempre que uma expressão char[] for utilizada com concatenações de Cadeia,

"hello" + new char[]{'w','o','r','l','d'}

Aviso

Correspondência de tipo inexacta para argumentos vararg

Quando estiver activado, o compilador vai emitir um erro ou um aviso sempre que detectar uma correspondência de tipo inexacta para argumentos vararg.

Aviso

Instrução vazia

Quando activado, o compilador emitirá um erro ou um aviso sempre que encontrar uma instrução vazia (por exemplo, um ponto e vírgula irrelevante).

Ignorar

Atribuição de objecto não utilizado

Quando activado, o compilador emite um erro ou um aviso quando detecta um objecto atribuído que não é utilizado, p. ex.

if (name == null)
   new IllegalArgumentException();

Ignorar

Casos 'switch' incompletos na enumeração

Quando activado, o compilador irá emitir um erro ou um aviso sempre que encontrar uma instrução de comutação, que não contém declarações de combinação de maiúsculas e minúsculas para cada constante de enumeração da enumeração referenciada nem numa combinação maiúsculas-minúsculas predefinida. Assume-se que uma combinação de maiúsculas-minúsculas predefinida para abranger as declarações de combinação de maiúsculas-minúsculas em falta para qualquer constante de enumeração, por isso, o compilador fica silencioso na presença de combinações de maiúsculas-minúsculas a não ser que a opção "Assinalar mesmo que exista a combinação de maiúsculas-minúsculas 'predefinida'" (ver em baixo) esteja activada.

Aviso

Assinalar mesmo que exista a combinação de maiúsculas-minúsculas 'predefinida'

Quando activado, o compilador irá emitir adicionalmente um erro ou um aviso se uma constante de enumeração não for abrangida por uma combinação de maiúsculas-minúsculas mesmo que exista uma combinação predefinida. Estas opções são úteis na captura de declarações de combinação de maiúsculas-minúsculas em falta quando uma constante de enumeração nova é adicionada.

Desligado

Falta a combinação de maiúscula-minúscula 'predefinida' de 'switch'

Quando activado, o compilador irá emitir um erro ou um aviso se uma instrução 'switch' não tiver uma combinação de maiúsculas-minúsculas predefinida. Consequentemente, a 'predefinição' em falta será assinalada mesmo que todos os valores possíveis sejam abrangidos por declarações 'case'. Este aviso é recomendado pela Especificação de Idioma Java para a compatibilidade binária.

Ignorar

processamento de caso de 'switch'

Quando activado, o compilador emite um erro ou um aviso quando for possível introduzir um caso através de um caso anterior não vazio.

Ignorar

Bloco catch oculto

Localmente, de uma instrução 'try', alguns blocos 'catch' podem esconder outros, por exemplo:

try { throw new java.io.CharConversionException();
} catch (java.io.CharConversionException e) {
} catch (java.io.IOException e) {}

Ao activar o compilador, este irá emitir um erro ou um aviso para blocos catch ocultos correspondentes a excepções seleccionadas.

Aviso

'finally' não terminou normalmente

Quando activado, o compilador emitirá um erro ou um aviso sempre que uma instrução 'finally' não termina normalmente (por exemplo, contém uma instrução de retorno).

Aviso

Código desnecessário (por exemplo, 'if (false)')

Quando activado, o compilador emite um erro ou um aviso quando detecta um código irrelevante (p. ex., 'if (false)').

Aviso

Fuga de recursos

Quando activado, o compilador irá emitir um erro ou um aviso se uma variável local tiver um valor de tipo 'java.lang.AutoCloseable' (conformidade >= 1.7) ou o valor de tipo 'java.io.Closeable' (conformidade <= 1.6) e se a análise de fluxo mostra que o método 'close()' não é invocado localmente nesse valor.

Aviso

Potencial fuga de recursos

Quando activado, o compilador irá emitir um erro ou um aviso se uma variável local tiver um valor do tipo 'java.lang.AutoCloseable' (conformidade >= 1.7) ou um valor do tipo 'java.io.Closeable' (conformidade <= 1.6) e se a análise de fluxo mostrar que o método 'close()' não é invocado localmente nesse valor para todos os caminhos de execução.

Ignorar

Classe serializável sem serialVersionUID

Quando estiver activado, o compilador vai emitir um erro ou um aviso sempre que um tipo a implementar 'java.io.Serializable' não contiver um campo serialVersionUID.

Aviso

Falta o modificador sincronizado no método herdado

Quando activado, o compilador irá emitir um erro ou um aviso quando detecta que o modificador sincronizado está a faltar num método herdado.

Ignorar

Classe substitui 'equals()' mas não 'hashCode()'

Quando activado, o compilador emite um erro ou um aviso quando detecta uma classe que substitui 'equals()' mas não 'hashCode()'.

Ignorar

Sombrear nomes e conflitos

A instrução do campo oculta outro campo ou variável

Quando activado, o compilador vai emitir um erro ou um aviso se uma instrução de campo ocultar outro campo herdado.

Ignorar

Instrução de variável local oculta outro campo ou variável

Quando activado, o compilador vai emitir um erro ou aviso se uma instrução de variável local ocultar outro campo ou variável.

Ignorar

Incluir parâmetros de métodos de construtor ou setter

Quando activado, o compilador vai emitir adicionalmente um erro ou um aviso se um construtor ou parâmetro do método setter ocultar outro campo ou variável.

Desligado

Parâmetro de tipo oculta outro tipo

Quando activado, o compilador vai emitir um erro ou aviso se um parâmetro de tipo de uma classe interna ocultar um tipo externo.

Aviso

O método não substitui o método visível do pacote

Um método predefinido do pacote não é visível num pacote diferente e por isso não pode ser sobreposto. Ao activar esta opção, o compilador vai sinalizar esta situação como um erro ou um aviso.

Aviso

Conflitos do método de interface com o método 'Object' protegido

Quando estiver activado, o compilador vai emitir um erro ou um aviso sempre que uma interface definir um método incompatível com um método Objecto não herdado. Até este conflito ser resolvido, tal interface não pode ser implementada, por exemplo:

interface I {
   int clone();
}

Aviso

API obsoleta e restrita

API Desactualizada

Quando activado, o compilador vai assinalar o uso de API obsoleta com um erro ou um aviso.

Aviso

Sinalizar a utilização de API obsoleta dentro de código obsoleto

Quando estiver activado, o compilador vai sinalizar a utilização da API desactualizada dentro do código obsoleto. A gravidade do problema é controlada com a opção "API Desactualizada".

Desligado

Sinalizar método de substituição ou implementação obsoleto

Quando estiver activado, o compilador vai sinalizar a sobreposição ou implementação de um método obsoleto. A gravidade do problema é controlada com a opção "API Desactualizada".

Desligado

Referência proibida (regras de acesso)

Quando estiver activado, o compilador vai sinalizar uma referência proibida especificada nas regras de acesso.

Erro

Referência desaconselhada (regras de acesso)

Quando estiver desactivado, o compilador vai sinalizar uma referência desaconselhada especificada nas regras de acesso.

Aviso

Código desnecessário

Valor da variável local não é utilizado

Quando activado, o compilador irá emitir um erro ou um aviso sempre que uma variável local é declarada, mas o seu valor nunca é utilizado dentro do seu âmbito.

Aviso

Valor do parâmetro não é utilizado

Quando activado, o compilador irá emitir um erro ou um aviso sempre que um parâmetro é declarado mas o seu valor nunca é utilizado dentro do seu âmbito.

Ignorar

Ignorar em métodos de substituição e implementação

Quando activado, o compilador não irá emitir um erro nem um aviso sempre que um parâmetro for declarado sem ser utilizado no seu âmbito, num método que substitui ou implementa outro método.

Ligado

Ignorar parâmetros documentados com o controlo '@param'

Quando activar esta opção, o compilador não vai emitir um erro ou aviso sempre que um parâmetro não lido estiver documentado com um controlo '@param'.

Ligado

Importação não utilizada

Quando activado, o compilador vai emitir um erro ou um aviso para referência de importação não utilizada.

Aviso

Membro privado não utilizado

Quando activado, o compilador irá emitir um erro ou um aviso sempre que um membro privado é declarado, mas nunca utilizado dentro da mesma unidade.

Aviso

Instrução 'else' desnecessária

Quando activar esta opção, o compilador vai emitir um erro ou aviso sempre que encontrar uma instrução 'else' desnecessária (por exemplo, if (condition) return; else doSomething();).

Ignorar

Difusão ou operação 'instanceof' desnecessárias

Quando activado, o compilador vai emitir um erro ou aviso sempre que encontrar uma difusão ou operação 'instanceof' desnecessárias (por exemplo, if (object instanceof Object) return;).

Ignorar

Instrução desnecessária de excepção lançada

Quando activado, o compilador vai emitir um erro ou um aviso sempre que detectar uma instrução desnecessária de uma excepção lançada.

Ignorar

Ignorar em métodos de substituição e implementação

Quando estiver activado, o compilador não vai emitir um erro nem um aviso sempre que detectar uma instrução desnecessária de uma excepção lançada num método que substitua ou implemente outro método.

Ligado

Ignorar excepções documentadas com controlos '@throws' ou '@exception'

Quando activado, o compilador emite um erro ou um aviso sempre que uma instrução desnecessária de uma excepção lançada for documentada com um identificador '@throws' ou '@exception'.

Ligado

Ignorar 'Exception' e 'Throwable'

Quando activado, o compilador não irá emitir um erro ou um aviso sempre que detectar uma instrução desnecessária de excepção 'Exception' e 'Throwable'

Ligado

Etiquetas 'break' ou 'continue' não utilizadas

Quando activado, o compilador emite um erro ou um aviso sempre que encontra uma etiqueta 'break' ou 'continue' não utilizada.

Aviso

Superinterface redundante

Quando estiver activado, o compilador vai emitir um erro ou um aviso sempre que detectar um tipo que implemente explicitamente uma interface que já se encontre implementada por um dos seus supertipos.

Ignorar

Tipos genéricos

Operação de tipo genérico não seleccionada

Quando activado, o compilador vai emitir um erro ou um aviso sempre que detectar uma operação de tipo genérico não seleccionada.

Aviso

Utilização de um tipo em bruto

Quando activado, o compilador irá emitir um erro ou um aviso sempre que encontrar uma utilização de tipo raw (por exemplo, List em vez de List<String>).

Aviso

Parâmetro de tipo genérico declarado com uma associação de tipo final

Quando activado, o compilador vai emitir um erro ou um aviso sempre que detectar uma associação de tipo que envolva um tipo final.

Aviso

Ignorar problemas de tipo genérico não evitáveis

Quando activado, o compilador irá emitir um erro ou um aviso quando detectar um problema de tipo genérico que o programador não consegue evitar. Por exemplo, um tipo pode ser forçado a utilizar tipos raw nas assinaturas de métodos e devolver tipos porque os métodos que substitui a partir de um supertipo são declarados para utilizar tipos raw.

Assim que as API raw referenciadas forem tornadas genéricas, não irá ver nenhum problema (se os tipos genéricos forem correctos) ou erros de compilação (se a API tiver sido tornada genérica de forma diferente).

Desligado

Anotações

Anotação '@Override' em falta

Quando activado, o compilador vai emitir um erro ou um aviso sempre que detectar um método a sobrepor outro método implementado e em que falta a anotação '@Override'.

Ignorar

Incluir implementações dos métodos de interface (1.6 ou superior)

Quando estiver activado, o compilador irá emitir um erro ou um aviso sempre que encontrar um método a sobrepor ou implementar um método declarado numa interface, e em que falta a anotação '@Override'.
Observe que '@Override' é apenas permitido neste tipo de métodos se o nível de conformidade do compilador for 1.6 ou superior, por isso, este erro ou aviso nunca irá aparecer no código 1.5.

Ligado

Anotação '@Deprecated' em falta

Quando activado, o compilador vai emitir um erro ou um aviso sempre que detectar um tipo obsoleto sem a anotação adicional '@Deprecated'.

Ignorar

Anotação é utilizada como super interface

Quando estiver activado, o compilador vai emitir um erro ou um aviso sempre que detectar um tipo a implementar uma anotação. Apesar de ser possível, esta acção não é considerada como positiva.

Aviso

Sinais não processados em '@SuppressWarnings'

Quando activado, o compilador irá emitir um erro ou um aviso sempre que encontrar um símbolo desconhecido numa anotação '@SuppressWarnings'.

Aviso

Activar anotações '@SuppressWarnings'

Quando activado, o compilador vai processar anotações '@SuppressWarnings'. Quando desactivado, irá agir como se todas as anotações '@SuppressWarnings' forem removidas.

Ligado

Sinal '@SuppressWarnings' não usado

Quando estiver activado, o compilador vai emitir um erro ou um aviso sempre que detectar um sinal não usado numa anotação '@SuppressWarnings'.

Aviso

Suprimir erros opcionais com '@SuppressWarnings'

Quando activado, a anotação '@SuppressWarnings' também irá suprimir erros de compilação opcionais. Não é possível suprimir erros de compilação obrigatórios.

Desligado

Análise nula

Acesso de indicador de nulos

Quando activado, o compilador emite um erro ou um aviso quando se depara com uma variável não referenciada cujo valor é certamente nulo. Repare que esta análise não pode ser feita para todos os acessos de indicador de nulos; consulte Acesso a potencial indicador de nulos.

Aviso

Acesso a potencial indicador de nulos

Quando activado, o compilador emite um erro ou um aviso sempre que encontra um caso em que uma variável local que pode ser nula não é referenciada. Tenha em consideração que a análise é relativamente conservadora, considerando apenas os casos em que existe algo duvidoso.

A qualidade da análise pode ser melhorada utilizando anotações nulas, que podem ser activadas utilizando a opção Activar análise nula baseada em anotações

Ignorar

Verificação de nulos redundante

Quando activar esta opção, o compilador vai emitir um erro ou aviso sempre que se testar valores nulos a uma variável local que não pode ter um valor nulo.

Ignorar

Incluir 'assert' na análise nula

Quando activado, o compilador irá honrar a instrução 'assert' ao realizar a análise nula.

Desligado

Activar análise nula baseada em anotação

Quando activado, o compilador irá interpretar as anotações @Nullable, @NonNull e @NonNullByDefault especificando se um determinado tipo inclui ou não o valor 'null'.

O efeito dessas análises é ainda mais controlado pelas subopções seguintes.

Consulte também Utilizar anotações nulas.

Desligado

Violação de especificação nula

Dependendo desta opção, o compilador irá emitir um erro ou um aviso sempre que é detectada uma das seguintes situações:

  1. Um método declarado com uma anotação não nula devolve uma expressão nullable (passível de ser nula).
  2. Uma expressão nullable é transmitida como um argumento numa chamada de método onde o parâmetro correspondente do método chamado é declarado com uma anotação não nula.
  3. Uma expressão nullable é atribuída a uma variável local que é declarada com uma anotação não nula.
  4. Um método que substitui um método herdado declarado com uma anotação não nula tenta afrouxar esse contrato especificando uma anotação não nula (proibição de retorno contravariante).
  5. Um método que substitui um método herdado que tem uma instrução passível de ser nula para, pelo menos, um dos seus parâmetros, tenta restringir esse contrato nulo especificando uma anotação não nula para o seu parâmetro correspondente (proibição de parâmetros covariantes).

Em cima, uma expressão é considerada como nullable (passível de ser nula) se estaticamente se souber que avalia para o valor null (nulo), ou se for declarada com uma anotação passível de ser nula.

Erro

Conflito entre anotações nulas e inferência nula

Dependendo desta opção, o compilador irá emitir um erro ou um aviso sempre que é detectada uma das seguintes situações:

  1. Um método declarado com uma anotação não nula devolve uma expressão que é estaticamente conhecida como avaliando para um valor nulo no mesmo fluxo.
  2. Uma expressão que é estaticamente conhecida como avaliando para um valor nulo no mesmo fluxo é transmitida como um argumento numa chamada de método onde o parâmetro correspondente do método chamado é declarado com uma anotação não nula.
  3. Uma expressão que é conhecida estaticamente como avaliando para um valor nulo no mesmo fluxo é atribuída a uma variável local que é declarada com uma anotação não nula.

Erro

Conversão não seleccionada do tipo não anotado para tipo @NonNull

Dependendo desta opção, o compilador irá emitir um erro ou um aviso sempre que é detectada uma das seguintes situações:

  1. Um método declarado com uma anotação não nula devolve uma expressão para a qual a informação de nulidade insuficiente está disponível para provar estaticamente que nenhum fluxo irá transmitir um valor nulo no tempo de execução.
  2. Uma expressão para a qual está disponível informação de nulidade insuficiente para provar estaticamente que nunca irá avaliar para um valor nulo no tempo de execução é passada como um argumento numa chamada de método onde o parâmetro correspondente do método chamado é declarado com uma anotação não nula.
  3. Uma expressão para a qual está disponível informação de nulidade insuficiente para provar estaticamente que nunca irá avaliar para um valor nulo no tempo de execução é atribuída a uma variável local que é declarada com uma anotação não nula.

A conversão não seleccionada é normalmente uma consequência de utilizar outras variáveis ou métodos não anotados.

Aviso

Anotação nula redundante

Quando activado, o compilador irá emitir um erro ou um aviso quando uma anotação não nula é aplicada embora o mesmo efeito já tenha sido atingido por uma predefinição aplicável na localização actual. Essa predefinição pode ser definida activando a opção Utilizar não nulo como predefinição de amplitude de espaço de trabalho (ou amplitude de projecto) ou utilizando a anotação @NonNullByDefault.

Aviso

Falta anotação '@NonNullByDefault' no pacote

Quando activado, o compilador irá emitir um erro ou um aviso nos seguintes casos:

  1. Quando um pacote não contém uma anotação passível de ser nula predefinida, em resultado de um package-info.java em falta ou anotação passível de ser nula predefinida em falta em package-info.java.
  2. Quando um tipo dentro de um pacote predefinido não contém uma anotação passível de ser nula predefinida.

Ignorar

Utilizar anotações predefinidas para especificações nulas

Quando activado, o compilador irá utilizar o conjunto predefinido de anotações para especificações nulas. Estas anotações são incluídas no Eclipse SDK no lote org.eclipse.jdt.annotation.

Pode especificar nomes de anotações diferentes para utilizar nos seus projectos, mas tenha em atenção que o compilador do Eclipse apenas suporta a semântica especificada nas anotações predefinidas:

  • org.eclipse.jdt.annotation.Nullable: um nome totalmente qualificado de um tipo de anotação Java, que quando aplicado a um tipo numa assinatura de método ou instrução de variável, será interpretado como uma especificação que nulo é um valor legal nessa posição.
    Actualmente, as posições suportadas são: parâmetros de método, tipo de retorno de método e variáveis locais.
  • org.eclipse.jdt.annotation.NonNull: um nome totalmente qualificado de um tipo de anotação Java, que quando aplicado a um tipo numa assinatura de método ou instrução de variável, será interpretado como uma especificação que nulo não é um valor legal nessa posição.
    Actualmente, as posições suportadas são: parâmetros de método, tipo de retorno de método e variáveis locais.
  • org.eclipse.jdt.annotation.NonNullByDefault: um nome totalmente qualificado de um tipo de anotação Java. Quando aplicado a um elemento sem um argumento de anotação, todos os tipos não anotados nas assinaturas de método dentro do elemento anotado serão tratados como se tivessem sido especificados com a anotação não nula.
    Pelo contrário, quando a anotação é aplicada com a constante 'false' como seu argumento, todas as predefinições correspondentes nos âmbitos exteriores serão cancelados para o elemento anotado.

Ligado

Quando a opção Tratar erros em cima como erros de compilação fatais estiver activada, todos os erros gerados, fatais ou configuráveis, levam a um código não executável. Se desactivada, o código será executado desde que não tenha nenhum erro fatal (erro de sintaxe, erro de inserção ou qualquer erro de acordo com a Especificação de Idioma Java).

Conceitos relacionados

Vista Problemas
Correcção Rápida
Construtor Java