Projectos JAR de clientes EJB

Um projecto JAR de cliente EJB contém todos os ficheiros de classes de que um programa de cliente necessita para utilizar a vista do cliente de beans empresariais contidos no módulo EJB.

Com as ferramentas EJB, pode criar um projecto EJB com um projecto JAR de cliente EJB correspondente. O projecto EJB dependerá do projecto JAR de cliente EJB. Um projecto JAR de cliente EJB contém todas as classes necessárias para um cliente de beans empresariais, incluindo todas as classes de interface, as classes chave e as classes de suporte. Como estas classes não são duplicadas no projecto EJB, este depende do projecto JAR de cliente EJB. Qualquer projecto que tenha uma referência a um bean empresarial no projecto EJB necessitará de uma referência ao projecto JAR de cliente EJB. Se o projecto JAR de cliente EJB estiver noutra aplicação empresarial, o ficheiro JAR de cliente EJB tem de ser adicionado ao ficheiro EAR de referência como sendo um ficheiro JAR utilitário.

Após ser criado o projecto JAR de cliente EJB, compete-lhe adicionar quaisquer objectos de valor necessários a este projecto que sejam requeridos pelas interfaces principais ou componentes. Se os objectos não estiverem presentes, isto resultará em erros de compilação.

Ficheiros JAR de cliente EJB

Os projectos de cliente EJB são exportados como ficheiros JAR de cliente EJB quando a aplicação é exportada. O ficheiro JAR de cliente EJB é especificado no descritor de implementação do ficheiro JAR EJB ao utilizar o elemento opcional ejb-client-jar. O valor do elemento ejb-client-jar é o nome do caminho que especifica a localização do ficheiro JAR de cliente EJB no ficheiro contentor Arquivo de Aplicação Empresarial J2EE (.ear - Enterprise Application Archive). O valor do nome do caminho é um URI relativo ao ficheiro JAR EJB na aplicação.
Nota: O caminho URI relativo do ficheiro JAR de cliente EJB deverá ser o mesmo em todas as aplicações a que o projecto EJB pertence.

Ao criar um projecto JAR de cliente EJB para um projecto EJB, o ficheiro JAR de cliente EJB é adicionado à aplicação empresarial contentora como sendo um JAR de um projecto utilitário. A referência a este ficheiro JAR de cliente EJB não pode ser removida da aplicação empresarial enquanto o projecto EJB for definido como sendo um módulo para a aplicação.

Importante: Se utilizar o assistente de ficheiro JAR EJB para exportar um projecto EJB, o assistente de exportação não inclui um projecto JAR de cliente EJB associado a um projecto EJB. Para incluir o ficheiro JAR de cliente EJB, recomenda-se que exporte o ficheiro EAR de aplicação empresarial que contém o projecto EJB. O ficheiro EAR resultante incluirá quaisquer ficheiros JAR de cliente EJB dependentes como ficheiros JAR utilitários. Como alternativa, pode exportar o projecto JAR de cliente EJB separadamente como sendo um ficheiro JAR.

(C) Copyright IBM Corporation 2000, 2005. Todos os direitos reservados.