Metadaten für Moduleinstellungen

Verwenden Sie diese Seite, um einen Java-EE-EJB-Implementierungsdeskriptor, einen Webmodulimplementierungsdeskriptor oder ein JCA-RAR-Modul anzuweisen, Annotationen zu ignorieren, die Implementierungsinformationen enthalten.

Klicken Sie zum Anzeigen dieser Seite der Administrationskonsole auf Anwendungen > Anwendungstypen > WebSphere-Unternehmensanwendungen > Anwendungsname > Metadaten für Module. Diese Seite entspricht der Seite Metadaten für Module in den Assistenten für die Installation und Aktualisierung von Anwendungen.

Wenn Ihre Anwendung Module der Java EE 5 oder höher enthält, können Sie den Implementierungsdeskriptor eines oder mehrerer Module auf der Seite Metadaten für Module sperren. Wenn Sie ein Kontrollkästchen für das Attribut metadata-complete auswählen (das Attribut metadata-complete auf true setzen) und Implementierungsdeskriptoren sperren, schreibt das Produkt den vollständigen Modulimplementierungsdeskriptor, einschließlich der Implementierungsinformationen aus Annotationen, im XML-Format.

Annotationen sind ein Standardmechanismus für das Hinzufügen von Metadaten zu Java-Klassen. Sie können Metadaten verwenden, um die Entwicklung und Implementierung von Artefakten der Java EE Version 5 oder höher zu vereinfachen. Vor der Einführung von Java-Annotationen waren Implementierungsdeskriptoren der Standardmechanismus, der von Java-EE-Komponenten verwendet wurde. Diese Implementierungsdeskriptoren wurden dem XML-Format zugeordnet, was ihre Persistenz vereinfachte. Wenn Sie Implementierungsdeskriptoren sperren, führt das Produkt annotationsbasierte Java-EE-Metadaten mit den XML-basierten Metadaten vorhandener Implementierungsdeskriptoren zusammen und definiert sie als persistente Daten.

Wenn Anwendungen sehr viele Java-Klassen enthalten, kann sich die Verarbeitungszeit für die Annotationen erhöhen. Sie können eine der folgenden Methoden verwenden, um die Leistungseinflüsse zu minimieren:

Stellen Sie fest, ob das Modul Java EE 5 oder 6 verwenden muss. Wenn das Modul Java EE 5 oder 6 nicht verwenden muss, werden die Annotationen in den Java-Klassen nicht gescannt.
Verwenden Sie den Attribut "metadata-complete" im Moduldeskriptor, wenn das Modul Java EE 5 oder höher verwendet und keine Annotationen enthält. Dieses Attribut inaktiviert die Annotationsverarbeitung für das Modul, aber Module mit Java EE 5 oder höher können weiterhin in die Deskriptordatei eingefügt werden. Wenn Sie Ihre Anwendung migrieren, aber keine Annotationen hinzufügen, sollten Sie diesen Attribut verwenden.
Restrukturieren Sie die Anwendung, um die JAR-Dateien des Dienstprogramms in gemeinsam genutzte Bibliotheken einzufügen, wenn diese JAR-Dateien keine Annotationsinformationen enthalten. Sie sollten diese Methode verwenden, wenn Sie den Attribut "metadata-complete" nicht setzen können.
Verschieben Sie die JAR-Dateien im Verzeichnis WEB-INF/lib in das Stammverzeichnis der EAR-Datei. Verschachtelte Archive, wie z. B. eine JAR-Datei in einer WAR-Datei (Webarchiv) in einer EAR-Datei, lassen sich auf grund der zahlreichen Komprimierungsstufen nur schwer durchsuchen.

Modul

Gibt den Namen eines Moduls in der installierten (oder implementierten) Anwendung an.

Information	Wert
Datentyp	String

URI

Gibt die Position des Moduls relativ zum Stammverzeichnis der EAR-Datei an.

Information	Wert
Datentyp	String

Attribut "metadata-complete"

Gibt an, ob der vollständige Modulimplementierungsdeskriptor, einschließlich der Implementierungsinformationen aus Annotationen, in XML-Format geschrieben werden.

Standardmäßig wird das Kontrollkästchen für das Attribut metadata-complete nicht ausgewählt, und das Produkt schreibt keine Annotationsdaten in einen Modulimplementierungsdeskriptor.

Wenn Ihre Module kein Attribut metadata-complete haben oder das Attribut metadata-complete auf false gesetzt ist, können Sie ein Kontrollkästchen auswählen und das Produkt anweisen, Annotationsdaten in einen Modulimplementierungsdeskriptor zu schreiben.

Fehler vermeiden: Wenn Ihre Anwendung der Java EE Version oder höher Annotationen und eine gemeinsam genutzte Bibliothek verwendet, wählen Sie das Attribut metadata-complete nicht aus. Wenn Ihre Anwendung Annotationen und eine gemeinsam genutzte Bibliothek verwendet, bewirkt die Einstellung des Attributs metadata-complete auf true, dass das Produkt eine @EJB-Annotation im Implementierungsdeskriptor fälschlicherweise als <ejb-ref> und nicht als <ejb-local-ref> darstellt. Wenn Sie beispielsweise das Attribut metadata-complete für Webmodule auf true setzen, können InjectionException-Fehler auftreten. Wenn Sie das Attribut metadata-complete auswählen müssen (metadata-complete auf true setzen), können Sie Fehler vermeiden, indem Sie keine gemeinsam genutzte Bibliothek verwenden, indem Sie die gemeinsam genutzte Bibliothek in das Verzeichnis classes oder lib des Anwendungsservers stellen oder indem Sie die Metadaten in den Implementierungsdeskriptoren vollständig angeben.gotcha

Nach der Auswahl eines Kontrollkästchens können Sie das Kontrollkästchen nicht mehr abwählen, und das Modul wird nicht mehr in der Liste der Module auf dieser Seite angezeigt. Wenn Sie alle Kontrollkästchen auswählen, wird der Link zu dieser Seite nicht mehr auf der Seite mit den Einstellungen für Unternehmensanwendungen angezeigt.

Information	Wert
Datentyp	Boolean
Standardeinstellung	false (abgewählt)

Dateiname: urun_rapp_metadata_lockdd.html