Unterstützung von JCA 1.6 für Annotationen in RAR-Modulen

Die Spezifikation Java™ Connector Architecture (JCA) Version 1.6 fügt die Unterstützung für Java-Annotationen in RAR-Modulen hinzu. Annotationen bieten eine Möglichkeit zur Angabe von Metadaten oder Konfigurationsdaten für ein RAR-Modul in den Klassendateien, aus denen sich das Modul zusammensetzt.

In den Versionen vor JCA 1.6 konnten diese Metadaten nur im Implementierungsdeskriptor angegeben werden, jetzt haben Sie jedoch die Möglichkeit, diese Metadaten entweder in einem Implementierungsdeskriptor oder in Annotationen anzugeben. Metadaten, die in Annotationen angegeben werden, werden bei der Aktualisierung in den Implementierungsdeskriptor eines RAR-Moduls aufgenommen, vorausgesetzt, das Modul ist im Implementierungsdeskriptor nicht mit der Markierung "metadata-complete" versehen, und die Modulversion ist 1.6 oder höher.

Das metadata-complete-Element definiert, ob der Implementierungsdeskriptor für das Ressourcenadaptermodul vollständig ist oder ob die Klassendateien, die für das Modul verfügbar sind und mit dem Ressourcenadapter bereitgestellt werden, nach Annotationen untersucht werden sollen, die Implementierungsinformationen angeben. Wenn "metadata-complete" auf true gesetzt ist, muss das Implementierungstool des Anwendungsservers alle möglicherweise in den Klassendateien der Anwendung vorhandenen Annotationen, die Implementierungsinformationen angeben, ignorieren. Wenn "metadata-complete" nicht angegeben oder auf false gesetzt ist, muss das Implementierungstool die Klassendateien der Anwendung nach Annotationen untersuchen, wie dies in der Spezifikation JCA 1.6 angegeben ist. Wenn der Implementierungsdeskriptor nicht enthalten ist oder wenn er zwar enthalten, aber nicht mit der Markierung "metadata-complete" versehen ist, verarbeitet das Implementierungstool Annotationen.

Anwendungsserver müssen von der Voraussetzung ausgehen, dass "metadata-complete" für Ressourcenadaptermodule mit Implementierungsdeskriptoren, die die Voraussetzungen der Spezifikation JCA 1.5 und älterer Spezifikationen erfüllen, auf true gesetzt sind. Eine vollständige Liste der unterstützten Annotationen und deren Verwendung finden Sie in der JCA-Spezifikation.

Die Spezifikation JCA Version 1.6 unterstützt auch Annotationen in RAR-Modulen, die Bedingungen für die Bean-Validierung formulieren. Sie können Metadaten zu den Bedingungen für die Bean-Validierung für RAR-JavaBeans definieren, indem Sie Ihre Klassen mit Annotationen zu Bedingungen für die Bean-Validierung versehen oder Deskriptoren für die XML-Validierung angeben. Der Application Server validiert die Bedingungen aller RAR-JavaBeans-Instanzen von JCA 1.6, bevor er sie zur Ausführungszeit aktiviert.


Symbol, das den Typ des Artikels anzeigt. Konzeptartikel



Symbol für Zeitmarke Letzte Aktualisierung: 25.05.2016
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=cdat_jca1_6rar
Dateiname:cdat_jca1_6rar.html