Preferencias de errores/avisos de compilación Java

Indique las preferencias para los valores de Errores/Avisos en la página de preferencias Abre la página de preferencias Errores/Avisos Java > Compilador > Errores/Avisos.

Estilo de código

Opción

Descripción

Valor predeterminado

Acceso no estático a un miembro estático

Si se habilita esta opción, el compilador emitirá un error o un aviso siempre que se acceda a un campo o a un método estático con un receptor de expresión. Las referencias a un método estático deben estar calificadas por el nombre de un tipo.

Aviso

Acceso indirecto a un miembro estático

Si se habilita esta opción, el compilador emitirá un error o un aviso siempre que se acceda indirectamente a un campo o método estático. Los campos estáticos de una interfaz deben estar calificados por el nombre del tipo declarante.

Omitir

Acceso no calificado a campo de instancia

Si se habilita esta opción, el compilador emitirá un error o un aviso siempre que encuentre un acceso a campo que no esté calificado (por ejemplo, en el que falte 'this').

Omitir

Acceso a un miembro no accesible de un tipo delimitador

Si se habilita esta opción, el compilador emitirá un error o un aviso siempre que emule el acceso a un miembro no accesible de un tipo delimitador. Tales accesos pueden tener implicaciones en el rendimiento.

Omitir

Asignación de parámetro

Asignar un valor a un parámetro se considera generalmente un estilo de programación pobre. Si se habilita esta opción, el compilador indicará este caso como error o aviso.

Omitir

Series no externalizadas

Si se habilita esta opción, el compilador emitirá un error o un aviso para los literales de tipo serie no externalizados (es decir, no señalados con el código //$NON-NLS-<n>$) o para los códigos de serie no externalizados que no pertenezcan a una serie.

Omitir

Bloque vacío no documentado

Si se habilita esta opción, el compilador emitirá un error o un aviso siempre que encuentre una sentencia de bloque vacío sin ningún comentario explicativo.

Omitir

Recurso no gestionado a través de try-with-resource (1.7 o superior)

Si se habilita, el compilador emitirá un error o un aviso si una variable local tiene un valor del tipo 'java.lang.AutoCloseable' y si el método 'close()' se invoca explícitamente en ese recurso, pero el recurso no se gestiona mediante un bloque try-with-resources.

Omitir

Método con nombre de constructor

Dar a un método el nombre de un constructor se considera generalmente como programación de estilo pobre. Si se habilita esta opción, el compilador indicará este caso como error o aviso.

Aviso

El método puede ser estático

Si se habilita esta opción, el compilador emitirá un error o un aviso para los métodos que son privados o finales, y que hacen referencia solamente a miembros estáticos.

Omitir

El método puede ser potencialmente estático

Si se habilita esta opción, el compilador emitirá un error o un aviso para los métodos que no son privados ni finales, y que hacen referencia solamente a miembros estáticos. Tenga en cuenta que los métodos se pueden alterar temporalmente en una subclase, de manera que si define un método "potencialmente estático" como estático, puede interrumpir los clientes existentes.

Omitir

Problemas potenciales de programación

Comparando valores idénticos ('x == x')

Si se habilita, el compilador emitirá un error o un aviso si una comparación implica operandos idénticos (p.ej. 'x == x').

Aviso

Asignación sin efecto (por ejemplo 'x = x')

Si se habilita esta opción, el compilador emitirá un error o un aviso siempre que haya una asignación sin efecto (por ejemplo, 'x = x').

Aviso

Posible asignación booleana accidental (por ejemplo 'if (a = b)')

Si se habilita esta opción, el compilador emitirá un error o un aviso siempre que encuentre una posible asignación booleana accidental (por ejemplo 'if (a = b)').

Omitir

Conversiones de encaje y desencaje

Si se habilita esta opción, el compilador emitirá un error o un aviso siempre que encuentre una conversión de encaje o desencaje. El encaje automático puede afectar negativamente al rendimiento.

Omitir

Utilizar una matriz de tipo char en una concatenación de series

Si se habilita esta opción, el compilador emitirá un error o un aviso siempre que se utilice una expresión de tipo char[] en concatenaciones de series:

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

Aviso

Coincidencia de tipos inexacta para argumentos vararg

Si se habilita esta opción, el compilador emitirá un error o un aviso siempre que encuentre una coincidencia de tipos inexacta para argumentos vararg.

Aviso

Sentencia vacía

Si se habilita esta opción, el compilador emitirá un error o un aviso siempre que encuentre una sentencia vacía (por ejemplo, un punto y coma superfluo).

Omitir

Asignación de objeto no utilizada

Si se habilita esta opción, el compilador emitirá un error o un aviso cuando encuentre un objeto asignado que no se utilice, p. ej.

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

Omitir

Casos de conmutación 'incompleta' en enumeración

Si se habilita esta opción, el compilador emitirá un error o un aviso siempre que encuentre una sentencia de conmutación que no contenga una sentencia de caso para cada constante de enumeración de la enumeración referenciada ni un caso predeterminado. Se presupone que un caso predeterminado cubre las sentencias de caso de cualquier constante de enumeración, por lo que el compilador no se pronuncia si hay casos predeterminados presentes, a menos se haya habilitado "Señalar aunque exista el caso 'predeterminado" (consulte la explicación a continuación).

Aviso

Señalar aunque exista el caso 'predeterminado'

Si se habilita, el compilador emitirá además un error o un aviso si un caso no cubre una constante de enumeración, aunque exista un caso predeterminado. Esta opción es útil para detectar la falta de sentencias de caso cuando se añade una constante de enumeración nueva.

Desactivada

A la 'conmutación' le falta un caso 'predeterminado'

Si se habilita, el compilador emitirá un error o un aviso si una sentencia de 'conmutación' carece de un caso predeterminado. Por lo tanto, el 'valor predeterminado' que falta se marcara aunque todos los valores posibles queden cubiertos por las sentencias de 'caso'. La especificación de lenguaje Java recomienda este aviso en favor de la compatibilidad binaria.

Omitir

Recorrido de casos 'switch'

Si se habilita esta opción, el compilador emitirá un error o un aviso cuando se entre en un caso pasando por un caso precedente no vacío.

Omitir

Bloque catch oculto

Localmente con respecto a una sentencia try, algunos bloques catch pueden ocultar otros; por ejemplo:

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

Si se habilita esta opción, el compilador emitirá un error o un aviso para bloques catch ocultos que se correspondan con excepciones comprobadas.

Aviso

Sentencia 'finally' que no se completa con normalidad

Cuando está habilitado, el compilador emitirá un error o un aviso siempre que una sentencia 'finally' no se lleve a cabo normalmente (por ejemplo, contenga una sentencia de retorno).

Aviso

Código muerto (p.ej. 'if (false)')

Si se habilita esta opción, el compilador emitirá un error o un aviso cuando encuentre código muerto (e.g 'if (false)' ).

Aviso

Fuga de recursos

Si se habilita, el compilador emitirá un error o un aviso si una variable local tiene un valor del tipo 'java.lang.AutoCloseable' (conformidad >= 1.7) o un valor del tipo 'java.io.Closeable' (conformidad <= 1.6) y si el análisis de flujo muestra que el método 'close()' no se invoca localmente a partir de ese valor.

Aviso

Posible fuga de recursos

Si se habilita, el compilador emitirá un error o un aviso si una variable local tiene un valor del tipo 'java.lang.AutoCloseable' (conformidad >= 1.7) o un valor del tipo 'java.io.Closeable' (conformidad <= 1.6) y si el análisis de flujo muestra que el método 'close()' no se invoca localmente a partir de ese valor para todas las vías de acceso de ejecución.

Omitir

Clase serializable sin serialVersionUID

Si se habilita esta opción, el compilador emitirá un error o un aviso siempre que un tipo que implemente 'java.io.Serializable' no contenga un campo serialVersionUID.

Aviso

Falta el modificador sincronizado en el método heredado

Si se habilita esta opción, el compilador emitirá un error o un aviso cuando encuentre un método heredado al que le falte el modificador sincronizado.

Omitir

La clase altera temporalmente 'equals()' pero no 'hashCode()'

Si se habilita esta opción, el compilador emitirá un error o un aviso cuando encuentre una clase que altere temporalmente 'equals()' pero no 'hashCode()'.

Omitir

Indefinición y conflictos de nombres

Declaración de campo que oculta otro campo o variable

Si se habilita esta opción, el compilador emitirá un error o un aviso si una declaración de campo oculta otro campo heredado.

Omitir

Declaración de variable local que oculta otro campo o variable

Si se habilita esta opción, el compilador emitirá un error o un aviso si una declaración de variable local oculta otro campo u otra variable.

Omitir

Incluir parámetros de constructor o método set

Si se habilita esta opción está habilitada, el compilador emitirá adicionalmente un error o un aviso si un parámetro de constructor o de método set oculta otro campo u otra variable.

Desactivada

Parámetro de tipo que oculta otro tipo

Si se habilita esta opción,el compilador emitirá un error o un aviso si, por ejemplo, un parámetro de tipo de una clase interior oculta un tipo exterior.

Aviso

El método no altera temporalmente el método visible del paquete

Un método predeterminado de un paquete no está visible en otro paquete y, por lo tanto, no se puede alterar temporalmente. Si se habilita esta opción, el compilador indicará este caso como error o aviso.

Aviso

El método de interfaz está en conflicto con el método de 'Object' protegido

Si se habilita esta opción, el compilador emitirá un error o un aviso siempre que una interfaz defina un método incompatible con un método de Object no heredado. Mientras no se resuelva este conflicto, una interfaz así no se puede implementar; por ejemplo,

interface I {
   int clone();
}

Aviso

API en desuso y restringida

API obsoleta

Si se habilita esta opción, el compilador indicará la utilización de una API obsoleta como error o aviso.

Aviso

Señalar el uso de API obsoleta dentro de código obsoleto

Si se habilita esta opción, el compilador indicará la utilización de una API obsoleta dentro de código obsoleto. La gravedad del problema se controla con la opción "API obsoleta".

Desactivada

Señalar alteración temporal o implementación de método obsoleto

Si se habilita esta opción, el compilador señalará la alteración temporal o la implementación de un método obsoleto. La gravedad de este problema se controla con la opción "API obsoleta".

Desactivada

Referencia prohibida (reglas de acceso)

Si se habilita esta opción, el compilador señalará una referencia prohibida especificada en las reglas de acceso.

Error

Referencia inconveniente (reglas de acceso)

Si se habilita esta opción, el compilador señalará una referencia inconveniente especificada en las reglas de acceso.

Aviso

Código innecesario

No se utiliza el valor de la variable local

Si se habilita esta opción, el compilador emitirá un error o un aviso siempre que se declare una variable local y que su valor no se utilice nunca dentro de su ámbito.

Aviso

No se utiliza el valor del parámetro

Si se habilita esta opción, el compilador emitirá un error o un aviso siempre que se declare un parámetro y que su valor no se utilice nunca dentro de su ámbito.

Omitir

Omitir en métodos de alteración temporal e implementación

Si se habilita esta opción, el compilador no emitirá un error ni un aviso siempre que un parámetro se declare pero no se utilice nunca dentro de su ámbito en un método que altere temporalmente o implemente otro método.

Activada

Omitir parámetros documentados con el código '@param'

Cuando está habilitado, el compilador no emitirá un error o un aviso siempre que un parámetro no leído esté documentado con un código '@param'.

Activada

Importación no utilizada

Si se habilita esta opción, el compilador emitirá un error o un aviso para las referencias a importaciones no utilizadas.

Aviso

Miembro privado no utilizado

Si se habilita esta opción, el compilador emitirá un error o un aviso siempre que se declare un método privado que no se utilice nunca dentro de la misma unidad.

Aviso

Sentencia 'else' innecesaria

Si se habilita esta opción, el compilador emitirá un error o un aviso siempre que encuentre una sentencia else innecesaria (por ejemplo, if (condición) return; else hacerAlgo();).

Omitir

Operación de conversión de tipo o 'instanceof' innecesaria

Si se habilita esta opción, el compilador emitirá un error o un aviso siempre que encuentre una operación innecesaria de conversión de tipo o 'instanceof' (por ejemplo, if (object instanceof Object) return;).

Omitir

Declaración innecesaria de excepción lanzada

Si se habilita esta opción, el compilador emitirá un error o un aviso siempre que encuentre una declaración innecesaria de una excepción lanzada.

Omitir

Omitir en métodos de alteración temporal e implementación

Si se habilita esta opción, el compilador no emitirá un error ni un aviso siempre que encuentre un método que altere temporalmente o implemente otro método.

Activada

Omitir excepciones documentadas con códigos '@throws' o '@exception'

Si se habilita esta opción, el compilador no emitirá un error ni un aviso siempre que una declaración innecesaria de una excepción lanzada esté documentada con un código '@throws' o '@exception'.

Activada

Omitir 'Exception' y 'Throwable'

Si se habilita esta opción, el compilador no emitirá un error ni un aviso siempre que encuentre una declaración innecesaria de una excepción 'Exception' y 'Throwable'

Activada

Etiqueta 'break' o 'continue' no utilizada

Si se habilita esta opción, el compilador emitirá un error o un aviso siempre que encuentre una etiqueta 'break' o 'continue' no utilizada.

Aviso

Superinterfaz redundante

Si se habilita esta opción, el compilador emitirá un error o un aviso siempre que encuentre un tipo que implemente explícitamente una interfaz que ya esté implementada por cualquiera de sus supertipos.

Omitir

Tipos genéricos

Operación de tipo no comprobada

Si se habilita esta opción, el compilador emitirá un error o un aviso siempre que encuentre una operación de tipo genérico no comprobada.

Aviso

Utilización de un tipo puro.

Si se habilita esta opción, el compilador emitirá un error o un aviso siempre que encuentre una utilización de tipo puro (por ejemplo, List en lugar de List<Serie>).

Aviso

Parámetro de tipo genérico declarado con límite de tipo final

Si se habilita esta opción, el compilador emitirá un error o un aviso siempre que encuentre un límite de tipo que implique un tipo final.

Aviso

Omitir problemas de tipo genérico inevitables

Si se habilita esta opción, el compilador emitirá un error o un aviso incluso cuando detecta un problema de tipo genérico que el programador no podría haber evitado. A modo de ejemplo, un tipo puede hacerle utilizar tipos raw en sus firmas de método y tipos de retorno porque que ha declarado que los métodos que altera temporalmente desde un supertipo utilizan tipos raw en primera instancia.

Una vez que las API puras referidas se generalizan, no verá ningún problema (si los tipos genéricos eran correctos) o verá errores de compilación (si la API se generalizó de forma diferente).

Desactivada

Anotaciones

Anotación '@Override' ausente

Si se habilita esta opción, el compilador emitirá un error o un aviso siempre que encuentre un método que altere temporalmente a otro método implementado, pero falta la anotación '@Override'.

Omitir

Incluir implementaciones de métodos de interfaz (1.6 o superior)

Cuando está habilitado, el compilador también emitirá un error o un aviso siempre que encuentre un método que altere temporalmente o implemente un método declarador en una interfaz y falte la anotación '@Override'.
Tenga en cuenta que '@Override' sólo está permitido en algunos métodos si el nivel de conformidad del compilador es 1.6 o superior, por lo que este error o aviso nunca aparecerá en el código 1.5.

Activada

Anotación '@Deprecated' ausente

Si se habilita esta opción, el compilador emitirá un error o un aviso siempre que encuentre un tipo en desuso sin la anotación '@Deprecated' adicional.

Omitir

Anotación utilizada como superinterfaz

Si se habilita esta opción, el compilador emitirá un error o un aviso siempre que encuentre un tipo que implemente una anotación. Aunque es posible, no conviene hacerlo.

Aviso

Símbolo no manejado en '@SuppressWarnings'

Si se habilita esta opción, el compilador emitirá un error o un aviso siempre que encuentre un símbolo desconocido en una anotación '@SuppressWarnings'.

Aviso

Habilitar anotaciones '@SuppressWarnings'

Si se habilita esta opción, el compilador procesará las anotaciones '@SuppressWarnings'. Si se inhabilita, actuará como si todas las anotaciones '@SuppressWarnings' se hubieran eliminado.

Activada

Símbolo '@SuppressWarnings' no utilizado

Si se habilita esta opción, el compilador emitirá un error o un aviso siempre que encuentre un símbolo no utilizado en una anotación '@SuppressWarnings'.

Aviso

Suprimir errores opcionales con '@SuppressWarnings'

Si se habilita, la anotación '@SuppressWarnings' también suprimirá los errores de compilador opcionales, por ejemplo las opciones establecidas en "Error". Los errores de compilación obligatorios no se pueden suprimir.

Desactivada

Análisis de nulos

Acceso de puntero nulo

Si se habilita esta opción, el compilador emitirá un error o un aviso cuando encuentre que una variable local que ciertamente es nula está desreferenciada. Tenga en cuenta que el análisis no puede encontrar todos los accesos de puntero nulo, consulte Posible acceso de puntero nulo.

Aviso

Posible acceso de puntero nulo

Si se habilita esta opción, el compilador emitirá un error o un aviso cuando encuentre que una variable local que puede ser nula está desreferenciada. Tenga en cuenta que el análisis es bastante conservador, solo tiene en cuenta los casos en los que hay algo sospechoso.

La calidad del análisis se pueden mejorar con el uso de anotaciones de nulos, que se pueden habilitar con la opción Habilitar el análisis de nulos basado en anotaciones

Omitir

Comprobación de nulo redundante

Cuando está habilitado, el compilador emitirá un error o un aviso siempre que se compruebe el nulo de una variable local que no pueda ser nula.

Omitir

Incluir 'aserción' en análisis de nulos

Si se habilita, el compilador respetará la sentencia de 'aserción' cuando lleve a cabo el análisis de nulos.

Desactivada

Habilitar el análisis de nulos basado en anotaciones

Si se habilita, el compilador interpretará que las anotaciones @Nullable, @NonNull y @NonNullByDefault especifican si un tipo determinado incluye el valor 'null'.

Las subopciones siguientes controla más el efecto de esos análisis.

Consulte también Utilización de las anotaciones de nulos.

Desactivada

Violación de la especificación de nulos

En función de esta opción, el compilador emitirá un error o un aviso siempre que se detecte una de las situaciones siguientes:

  1. Un método declarado con una anotación no nula devuelve una expresión anulable.
  2. Una expresión anulable se pasa como argumento en una llamada de método donde el parámetro correspondiente del método llamado se declara con una anotación de no nulos.
  3. Una expresión anulable se asigna a una variable local que se declara con una anotación no nula.
  4. Un método que altera temporalmente un método heredado declarado con una anotación no nula intenta relajar ese contrato especificando una anotación anulable (prohibición de devolución de contravariante).
  5. Un método que altera temporalmente un método heredado que tiene una declaración anulable para uno de sus parámetros, por lo menos, intenta hacer más estricto ese contrato de nulos especificando una anotación no nula para su parámetro correspondiente (prohibición de parámetros de covariante).

En el ejemplo anterior, una expresión se considera anulable si estáticamente se reconoce que da como resultado el valor null o si se declara con una anotación anulable.

Error

Conflicto entre anotaciones de nulos e inferencia de nulos

En función de esta opción, el compilador emitirá un error o un aviso siempre que se detecte una de las situaciones siguientes:

  1. Un método declarado con una anotación de no nulos devuelve una expresión que estáticamente se reconoce que da como resultado un valor nulo en algún flujo.
  2. Una expresión que estáticamente se reconoce que da como resultado un valor nulo en algún flujo se pasa como argumento en una llamada de método donde el parámetro correspondiente del método llamado se declara con una anotación de no nulos.
  3. Una expresión que estáticamente se reconoce que da como resultado un valor nulo en algún flujo se asigna a una variable local que se declara con una anotación de no nulos.

Error

Conversión no comprobada de tipo no anotado en tipo @NonNull

En función de esta opción, el compilador emitirá un error o un aviso siempre que se detecte una de las situaciones siguientes:

  1. Un método declarado con una anotación no nula devuelve una expresión para la que no hay suficiente información sobre ausencia de nulos disponible como para probar de forma estática que ningún flujo pasará un valor nulo en tiempo de ejecución.
  2. Una expresión para la que no hay suficiente información disponible sobre ausencia de nulos como para probar de forma estática que nunca dará como resultado un valor nulo en tiempo de ejecución se pasa como argumento en una llamada de método donde el parámetro correspondiente del método llamado se declara como una anotación de no nulos.
  3. Una expresión para la que no hay suficiente información disponible sobre ausencia de nulos como para probar de forma estática que nunca dará como resultado un valor nulo en tiempo de ejecución se asigna a una variable local que se declara con una anotación de no nulos.

Una conversión no comprobada suele ser el resultado de utilizar otras variables o métodos no anotados.

Aviso

Anotación de nulos redundante

Si se habilita, el compilador emitirá un error o un aviso cuando se aplique una anotación que no sea de nulos aunque un valor predeterminado aplicable en la ubicación actual haya conseguido el mismo efecto. De esta manera, se puede establecer un valor predeterminado habilitando la opción Utilizar no nulo como valor predeterminado para todo el espacio de trabajo (o todo el proyecto) o utilizando la anotación @NonNullByDefault.

Aviso

Falta la anotación '@NonNullByDefault' en el paquete

Si se habilita, el compilador emitirá un error o un aviso en los casos siguientes:

  1. Cuando un paquete no contenga una anotación de ausencia de nulos predeterminada, como resultado de la falta de package-info.java o de una anotación de ausencia de nulos predeterminada en package-info.java.
  2. Cuando un tipo de un paquete predeterminado no contenga una anotación de ausencia de nulos predeterminada.

Omitir

Utilizar las anotaciones predeterminadas para las especificaciones de nulos

Si se habilita, el compilador utilizará el conjunto predeterminado de anotaciones para las especificaciones de nulos. Estas anotaciones se incluyen en el SDK de Eclipse en el paquete org.eclipse.jdt.annotation.

Puede especificar distintos nombres de anotación para utilizarlos en los proyectos, pero tenga presente que el compilador de Eclipse sólo admite la semántica especificada en las anotaciones predeterminadas:

  • org.eclipse.jdt.annotation.Nullable: nombre totalmente calificado de un tipo de anotación Java, que, cuando se aplique a un tipo en una firma de método o declaración de variable, se interpretará como especificación de que un nulo es un valor permitido en esa posición.
    Actualmente las posiciones soportadas son: parámetros de método, tipo de retorno de método y variables locales.
  • org.eclipse.jdt.annotation.NonNull: nombre totalmente calificado de un tipo de anotación Java, que, cuando se aplique a un tipo en una firma de método o declaración de variable, se interpretará como especificación de que un nulo no es un valor permitido en esa posición.
    Actualmente las posiciones soportadas son: parámetros de método, tipo de retorno de método y variables locales.
  • org.eclipse.jdt.annotation.NonNullByDefault: nombre totalmente calificado de un tipo de anotación Java. Cuando se aplica a un elemento sin un argumento de anotación, todos los tipos no anotados en las firmas de método dentro del elemento anotado se tratarán como si se hubieran especificado con la anotación de no nulos.
    Por el contrario, cuando la anotación se aplique con la constante 'false' como argumento, todos los valores predeterminados correspondientes en ámbitos externos se cancelarán para el elemento anotado.

Activada

Si la opción Tratar errores anteriores como errores de compilación muy graves está habilitada, todos los errores generados, ya sean muy graves o configurables hacen que el código no sea ejecutable. Si está inhabilitada, el código puede ejecutarse mientras no tenga errores muy graves (es decir, errores de sintaxis, errores de tipo o cualquier error que indique la especificación de lenguaje Java).

Conceptos relacionados

Vista Problemas
Arreglo rápido
Constructor Java