Używaj atrybutu metadata-complete dla modułów Java EE 5 bez adnotacji

Platforma Java EE 5 obsługuje Używaj adnotacji do określania informacji o wdrażaniu. Jeśli aplikacja zawiera wiele klas Java, czas przetwarzania wdrożenia dla adnotacji może ulec wydłużeniu. Aby zminimalizować wpływ na wydajność, można użyć jednej z następujących metod:

Określenie, czy moduł wymaga użycia platformy Java EE 5. Jeśli nie wymaga użycia platformy Java EE 5, adnotacje w ramach klas Java nie zostaną przeskanowane.
Użycie atrybutu metadata-complete w deskryptorze modułu, jeśli moduł używa platformy Java EE 5 i nie zawiera żadnych adnotacji. Za jego pomocą można wyłączyć przetwarzanie adnotacji dla modułu i mimo to nadal mieć możliwość umieszczania modułów platformy Java EE 5 w pliku deskryptora. Ta wartość atrybutu jest przydatna podczas migrowania aplikacji, gdy nie są dodawane adnotacje.
Jeśli narzędziowe pliki archiwum Java (JAR) nie zawierają informacji o adnotacjach, należy przeprowadzić restrukturyzację aplikacji i umieścić pliki JAR w bibliotekach współużytkowanych. Tej metody można użyć, jeśli nie jest możliwe ustawienie atrybutu metadata-complete.
Przeniesienie plików JAR znajdujących się w katalogu WEB-INF\lib do katalogu głównego pliku archiwum korporacyjnego (EAR). Z powodu wielokrotnej kompresji archiwa zagnieżdżone, takie jak plik JAR umieszczony w archiwum WWW (WAR), który znajduje się z kolei w pliku EAR, są trudne do przeszukiwania.

Flaga atrybutu metadata-complete może być zdefiniowana w pliku deskryptora wdrażania ejb-jar.xml lub web.xml.

Na przykład deskryptor wdrażania modułu EJB może zdefiniować atrybut metadata-complete w następujący sposób:

<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>

Deskryptor wdrażania modułu WWW może zdefiniować atrybut metadata-complete w następujący sposób:

<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>

Więcej informacji na ten temat zawiera sekcja Ustawienia metadanych dla modułu.