Java 9 Anotación @Deprecated mejorada

Java 9 新特性Nuevas características de Java 9

La anotación @Deprecated puede marcar el estado de una API de Java, que puede ser uno de los siguientes:

  • Usarla conlleva riesgos y puede provocar errores.
  • Puede ser incompatible en futuras versiones.
  • Puede ser eliminada en futuras versiones.
  • Una solución mejor y más eficiente la ha reemplazado.

En Java 9, la anotación añade dos nuevos elementos:sinceyforRemoval。

  • since: el elemento especifica la versión en la que el elemento de API anotado fue marcado como obsoleto.
  • forRemoval: el elemento indica que el elemento de API anotado será eliminado en una versión futura; se debe migrar la API.

El siguiente ejemplo es la documentación de la clase Boolean en Java 9; en ella, la anotación @Deprecated utiliza el atributo since:Boolean Class。

El siguiente ejemplo es la documentación de la clase System en Java 9; en ella, la anotación @Deprecated utiliza el atributo forRemoval:System Class。

Java 9 新特性Nuevas características de Java 9

Otras extensiones