Java 9 - Anotación @Deprecated mejorada
La anotación @Deprecated se introdujo en la versión Java 5. Un elemento de programa anotado con @Deprecated significa que no debe usarse por ninguna de las siguientes razones:
- Su uso puede conducir a errores.
- Puede ser incompatible en versiones futuras.
- Es posible que se elimine en una versión futura.
- Una alternativa mejor y más eficiente lo ha reemplazado.
El compilador genera advertencias cada vez que se usa un elemento en desuso. Con Java 9, se realizan dos nuevas mejoras en la anotación @Deprecated.
-
para eliminación − Indica si el elemento anotado está sujeto a eliminación en una versión futura. El valor predeterminado es falso.
-
desde − Devuelve la versión en la que el elemento anotado quedó obsoleto. El valor predeterminado es la cadena vacía.
Obsoleto con desde
El siguiente ejemplo de javadoc de clase booleana en Java 9 ilustra el uso del atributo since en la anotación @Deprecated.
Clase booleana
Obsoleto con forRemoval
El siguiente ejemplo de clase de sistema javadoc en Java 9 ilustra el uso del atributo forRemoval en la anotación @Deprecated.
Clase de sistema
Java