Usar o atributo metadata-complete para módulos Java EE 5 sem anotações

O Java EE 5 suporta a utilização de anotações para especificar informações de implementação. Quando aplicativos contiverem um grande número de classes Java, o tempo de processo de implementação para as anotações podem aumentar. Para minimizar o impacto no desempenho, é possível utilizar um dos seguintes métodos:

Determine se o módulo precisa utilizar o Java EE 5. Se o módulo não precisar utilizar o Java EE 5, a varredura não é executada para as anotações dentro das classes Java.
Usar o atributo metadata-complete no descritor de módulos se o módulo utilizar Java EE 5 e não contiver nenhuma anotação. Esse atributo desativa o processamento de anotações para o módulo, mas os módulos Java EE 5 ainda podem ser colocados no arquivo descritor. Se estiver migrando seu aplicativo, mas não estiver incluindo anotações, considere a utilização desse valor de atributo.
Reestruture o aplicativo para colocar os arquivos Java archive (JAR) do utilitário nas bibliotecas compartilhadas se esses arquivos JAR não tiverem informações de anotação. Considere este método se você não puder configurar o atributo metadata-complete.
Mova os arquivos JAR no diretório WEB-INF\lib para o diretório-raiz do arquivo Enterprise Archive (EAR). Arquivos aninhados, como um arquivo JAR que está dentro de um archive Web (WAR) que está dentro de um arquivo de archive de aplicativo corporativo (EAR), são muito incômodos para se procurar por causa dos múltiplos níveis de compactação.

O sinalizador metadata-complete pode ser definido no ejb-jar.xml ou no arquivo descritor de implmentação web.xml.

Por exemplo, um descritor de implementação do módulo EJB definiria o atributo metadata-complete como:

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

Um descritor de implementação de módulo da Web definiria o atributo metadata-complete como:

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

Para obter informações adicionais, consulte Metadados para configurações do módulo.