Java: Verwenden von vordefinierten Annotations
Die Arten und Inhalte von Annotationen in Java, wie Kommentare, sind nur durch Ihre Fantasie. Ja, bietet Java einige vordefinierte Anmerkungen, aber Sie können auch Anmerkungen erstellen, die Programmelemente in irgendeiner Weise beschreiben Sie wollen. Die Idee ist, dass Sie beschreiben, wie eine Anmerkung funktionieren sollte, liefern Daten für sie, und der Compiler kümmert sich um den Rest.
Anmerkungen immer mit dem @ (at) Symbol beginnen. Also, wenn Sie @Documented sehen, wissen Sie, dass Sie eine Anmerkung zu sehen sind. In den folgenden Abschnitten erfahren Sie mehr über vordefinierte und benutzerdefinierte Anmerkungen.
Eine vordefinierte Anmerkung ist eine, die als Teil von Java existiert. Sie finden diese Anmerkungen in der java.lang.annotation Paket. Um sie zu verwenden, fügen Sie importieren java.lang.annotation. * - Bis zum Beginn der Anwendung. Die folgende Liste gibt einen Überblick über die vordefinierten Anmerkungen:
@deprecated: Manchmal ein Element - eine Klasse, Methode, ein Feld oder andere Feature-Programmierung - wird durch eine neuere Element ersetzt oder einfach nicht mehr benötigt.
Wenn dies geschieht, markieren Sie das Element als veraltet, so dass Entwickler wissen müssen, um sie ihren Code zu aktualisieren und die Verwendung dieser bestimmten Elements zu stoppen. Das Hinzufügen der @deprecated Anmerkung gibt den deprecated Status des Elements in der Dokumentation, die durch Javadoc (Ein Dienstprogramm, das verwendet wird, Dokumentation zu erstellen automatisch basierend auf dem Inhalt des Codes Dateien).
@Documented: Jedes Mal, wenn Sie ein Element markieren, wie dokumentiert, erstellt das Javadoc-Dienstprogramm gibt es an die Dokumentationsdatei auf dem Quelldateiinhalt basiert.
@FunctionalInterface: Gibt an, dass die Schnittstelle eine funktionale Schnittstelle für anonyme Klassen und Lambda-Ausdrücke verwendet wird.
@Inherited: Klassen können Eigenschaften von einer übergeordneten Klasse erben. Standardmäßig enthält diese Funktionalität wie Methoden, aber beinhaltet nicht die Anmerkungen der übergeordneten Klasse. die @Inherited Anmerkung Verwenden sagt Java die Elternklasse Anmerkungen zu der Unterklasse als auch anzuwenden.
@Override: Gibt an, dass ein Kind Klasse Element ist eine übergeordnete Klasse (Oberklasse) Element überschrieben wird. Wenn diese Anmerkung vorhanden ist, und die übergeordnete Klasse fehlt ein Element des gleichen Namens, gibt der Compiler einen Fehler, so dass Sie wissen, dass etwas nicht stimmt mit der Überschreibung.
@Repeatable: Die meisten Anmerkungen werden nur einmal auf ein bestimmtes Element angewendet. In einigen Fällen jedoch müssen Sie die Anmerkung mehr als einmal anzuwenden. Diese Anmerkung sagt Java, dass es akzeptabel, die Anmerkung zu einem bestimmten Element mehr als einmal anzuwenden.
@Retention: Eine Anmerkung kann nur die Quelle Code- den Quellcode beeinflussen und Compiler- oder den Quellcode, Compiler und JVM. Diese Anmerkung definiert, welche Wirkung eine andere Anmerkung haben sollte. Zum Beispiel müssen Sie nur eine Dokumentation spezifische Annotation den Quellcode und Compiler zu beeinflussen.
@SafeVarargs: Es ist möglich, Operationen durchzuführen, die sich auf ein Verfahren oder Konstruktor übergeben auf die Argumente nicht sicher sind. Diese Anmerkung sagt, dass der Code nichts tut unsicher und daher nicht alle üblichen Kontrollen erfordert. Die Verringerung der Anzahl der Kontrollen macht die Anwendung schneller laufen.
@SuppressWarnings: Der Java-Compiler gibt eine Fülle von Warnungen potentielle Probleme zu signalisieren. Zum Beispiel, wenn Sie versuchen, eine veraltete Methode in Ihrem Code verwenden, gibt der Compiler eine Warnmeldung darüber. Diese Anmerkung teilt dem Compiler nicht ausgegeben werden solche Warnungen für das betroffene Element.
@Target: Wenn Sie Ihre eigenen Anmerkungen zu erstellen, kann es hilfreich sein, den Compiler zu sagen, dass diese Anmerkungen nur einen bestimmten Elementtyp beeinflussen sollte. Zum Beispiel, wenn Sie einen Autor Block erstellen, die nur auf Paketebene erscheinen gemeint ist, dann können Sie die Anmerkung zu genau diesem Elementtyp begrenzen, indem die @Target Anmerkung verwenden.