Web-Annotationstags hinzufügen

Annotationsbasierte Programmierungs-Tags dienen innerhalb Ihrer Webprojekte als Bereitsteller von Metadaten, die anschließend zum Generieren erforderlicher anderer Anwendungsartefakte verwendet werden. Diese Tags werden dem Code auf dieselbe Weise hinzugefügt wie Javadoc-Kommentare.
Warum und wann dieser Vorgang ausgeführt wird
Das Hinzufügen von Annotationen auf Klassenebene kann über die Option Eine <artefakt>-Klasse mit Anmerkungen erstellen erfolgen. Dabei kann <artefakt> ein Servlet oder eine JSP sein, das bzw. die Sie in Ihrem Webprojekt erstellen.
Eine Klasse mit Anmerkungen (annotierte Klasse) können Sie in Ihrem Webprojekt automatisch generieren. Wählen Sie Eine <artefakt>-Klasse mit Anmerkungen erstellen aus. Daraufhin wird eine Standardklasse mit Anmerkungen erstellt.

Der Code für die Servletklasse mit Anmerkungen sieht beispielsweise folgendermaßen aus:

Code für annotierte Servletklasse

Beispiel
Anhand dieser Standardservletklasse mit Anmerkungen werden die drei Grundelemente der annotationsbasierten Programmierung veranschaulicht:
  • Das erste Element ist die Wortfolge
    * Servlet implementation class for Servlet: MyServlet

    Diese Wortfolge stellt den Quellcodekommentar dar, der die Funktion oder den Zweck dieser Klasse beschreibt.

  • Das zweite Element umfasst den Stern und das @-Zeichen:
    * @

    Das Zeichen @ gibt an, dass eine Annotation folgt, die verarbeitet werden muss.

  • Das dritte Element bildet den Hauptteil des Annotationstags:
     * @web.servlet
     *   name="myServlet"
     *   display-name="myServlet" 
     *
     * @web.servlet-mapping
     *   url-pattern="/myServlet"
     *  

    Dieser Code enthält die Annotationen, die zum Generieren der Artefakte verwendet werden. In diesem Fall gibt die Annotation an, dass sie vom Typ "web.servlet" ist. Dieser Typ definiert Daten, die sich auf Servlets beziehen. Ferner gibt der Tag Werte für die Parameter name, display-name und url-pattern an.

Nächste Maßnahme
Die von den Annotationstags angegebenen Artefakte werden zur Laufzeit generiert.

Zugehörige Verweise


Feedback