Diretrizes: Montagem de Aplicativos J2EE
Tópicos
Introdução
Os assemblers do aplicativo J2EE montam Módulos J2EE
em um Aplicativo J2EE. Os Assemblers de Aplicativos
podem selecionar diretamente os módulos e utilizá-los em seus aplicativos pela simples
modificação dos descritores de implementação ou pelo fornecimento de descritores alternativos.
Alguns servidores de aplicativos requerem um "wrapper" EAR perto de EJB-JAR,
WAR e outros archives JAR para implementação, o que significa que o provedor de componente
do aplicativo J2EE também pode precisar montar um EAR para teste.
São fornecidas etapas detalhadas sobre a montagem de um Aplicativo J2EE pela especificação J2EE,
seção Montagem do Aplicativo J2EE.8.3. A seguir,
um extrato resumido dessa orientação.
Montagem de um Aplicativo J2EE
A montagem de um aplicativo J2EE envolve as etapas a seguir:
- Selecione os Módulos J2EE que serão utilizados pelo aplicativo.
- Crie uma estrutura de diretórios do aplicativo.
- Reconcilie os descritores de implementação do Módulo J2EE.
- Edite os descritores de implementação do Módulo J2EE para vincular as dependências atendidas
internamente e eliminar os nomes de função de segurança redundantes.
- Defina transações, funções de segurança, permissões de métodos, etc.
- Utilize, opcionalmente, o elemento alt-dd para especificar um descritor de implementação
alternativo enquanto preserva o descritor de implementação original.
- Designe uma raiz de contexto para cada módulo da Web incluído no aplicativo J2EE.
- Assegure-se de que as dependências do componente estejam descritas corretamente.
- Assegure-se de que haja apenas uma versão de cada classe no aplicativo.
- Crie um descritor de implementação XML para o aplicativo denominado "application.xml".
- Compacte o aplicativo.
a. Coloque os módulos J2EE nos diretórios apropriados. Coloque o descritor de
implementação em META-INF/application.xml.
b. Compacte em um arquivo ".EAR".
Incluindo/Removendo Módulos
É possível incluir os módulos J2EE em um aplicativo antes
da implementação, utilizando as etapas a seguir:
- Decida o local para o novo módulo no pacote de aplicativos. Opcionalmente,
crie novos diretórios na hierarquia do pacote de aplicativos.
- Copie os novos Módulos J2EE para o local desejado no pacote de aplicativos.
- Edite os descritores de implementação dos Módulos J2EE para vincular as dependências
atendidas internamente pelos Módulos J2EE incluídos no aplicativo.
- Edite o descritor de implementação do Aplicativo J2EE, conforme necessário.
É possível remover um módulo de forma semelhante, removendo-se o módulo da hierarquia do
pacote de aplicativos e editando-se os descritores de implementação para remover as inconsistências.
Validando o Aplicativo
É interessante validar o conteúdo do archive antes de tentar a implementação,
uma vez que erros desconhecidos, especialmente do lado do servidor de aplicativos, podem resultar em
mensagens de erro vagas ou inexistentes. Por exemplo, confirme se há pelo menos
um módulo definido no EAR
O EAR também pode ser validado utilizando uma ferramenta verificadora do J2EE fornecida com
o J2EE SDK. Ela garante que o EAR está consistente e bem formado internamente.
Por exemplo, ela garante que os archives do módulo e do aplicativo estão consistentes
com as especificações padrão (J2EE, Servlet e EJB).
|