Attribut metadata-complete für Java-EE-5-Module ohne Annotationen verwenden

Java EE 5 verwendet Annotationen, um die Implementierungsinformationen anzugeben. Wenn Anwendungen viele Java-Klassen enthalten, kann die Verarbeitungszeit der Implementierung für die Annotationen zunehmen. Um den Leistungseinfluss zu verringern, können Sie eine der folgenden Methoden verwenden:

Bestimmen Sie, ob das Modul Java EE 5 verwenden muss. Ist das nicht der Fall, werden die Annotationen in den Java-Klassen nicht überprüft.
Verwenden Sie das Attribut metadata-complete im Moduldeskriptor, wenn das Modul Java EE 5 verwendet und keine Annotationen enthält. Dieses Attribut inaktiviert die Annotationsverarbeitung für das Modul, aber Java-EE-5-Module können immer noch in die Deskriptordatei gestellt werden. Wenn Sie Ihre Anwendung migrieren, aber keine Annotationen hinzufügen möchten, sollten Sie in Betracht ziehen, diesen Attributwert zu verwenden.
Strukturieren Sie die Anwendung um, um die JAR-Dienstprogrammdateien in gemeinsam genutzte Bibliotheken zu stellen, wenn diese JAR-Dateien keine Annotationsinformationen haben. Ziehen Sie in Erwägung, diese Methode zu verwenden, wenn Sie das Attribut metadata-complete nicht setzen können.
Verschieben Sie die JAR-Dateien aus dem Verzeichnis WEB-INF\lib in das Stammverzeichnis der EAR-Datei (Unternehmensarchiv). Verschachtelte Archive, wie z. B. eine JAR-Datei, die sich in einer WAR-Datei (Webarchiv) befindet, welche sich wiederum in einer EAR-Datei (Unternehmensarchiv) befindet, sind sehr umständlich zu durchsuchen, weil sie auf den einzelnen Ebenen unterschiedlich komprimiert sind.

Das Flag metadata-complete kann in der Datei ejb-jar.xml oder in der Implementierungsdeskriptordatei web.xml definiert werden.

Beispielsweise würde ein Implementierungsdeskriptor für EJB-Module das Attribut metadata-complete wie folgt definieren:

<ejb-jar xmlns="http://java.sun.com/xml/ns/javaee"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://java.sun.com/xml/ns/javaee"
         http://java.sun.com/xml/ns/javaee/ejb-jar_3_0.xsd"
         version="3.0" metadata-complete="true">

</ejb-jar>

Ein Implementierungsdeskriptor für Webmodule würde das Attribut metadata-complete wie folgt definieren:

<web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xmlns="http://java.sun.com/xml/ns/javaee"
         xmlns:web="http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd"
         xsi:schemaLocation="http://java.sun.com/xml/ns/javaee"
         http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd"
         id="WebApp_ID" version="2.5" metadata-complete="true">

</web-app>

Weitere Informationen finden Sie unter Metadaten für Moduleinstellungen.