Java 9 verbetert @Deprecated Annotation: forRemoval en betere richtlijnen

De @Deprecated-annotatie werd in Java 5 geïntroduceerd. Een programma-element gemarkeerd met @Deprecated betekent dat het niet gebruikt moet worden om een van de volgende redenen:

Gebruik kan leiden tot fouten.
Het kan in toekomstige versies incompatibel zijn.
Het kan in een toekomstige versie verwijderd worden.
Een betere, efficiëntere alternatief heeft het vervangen.

De compiler genereert waarschuwingen bij gebruik van een gedeprecateerd element. Met Java 9 zijn twee verbeteringen aan @Deprecated toegevoegd:

forRemoval – Geeft aan of het geannoteerde element in een toekomstige versie verwijderd zal worden. Standaardwaarde is false.
since – Geeft de versie terug waarin het element gedeprecateerd is. Standaard is de lege string.

Deprecated met since

Het volgende voorbeeld van de Boolean-klasse in Java 9 Javadoc toont het gebruik van het since-attribuut:

Boolean Class

Java 9 verbetert @Deprecated Annotation: forRemoval en betere richtlijnen

Deprecated met forRemoval

Het volgende voorbeeld van de System-klasse in Java 9 Javadoc toont het gebruik van het forRemoval-attribuut:

System Class

Java 9: Verbeterde Try-With-Resources voor schonere code Java 9: Anonieme inner classes vereenvoudigen met de Diamond Operator

Java