Projetos JAR do Cliente EJB

Um projeto JAR do cliente EJB contém todos os arquivos de classe que um programa cliente precisa para utilizar a visualização de cliente dos beans corporativos contidos no módulo EJB.

Com as ferramentas EJB, você pode criar um projeto EJB com um projeto JAR de cliente EJB correspondente. O projeto EJB dependerá do projeto JAR do cliente EJB. O projeto JAR do cliente EJB contém todas as classes necessárias para um cliente dos beans corporativos, incluindo todas as classes de interface, as classes de chave e as classes de suporte. Como essas classes não são duplicadas no projeto EJB, o projeto EJB depende de seu projeto JAR do cliente EJB. Qualquer projeto que tenha uma referência a um bean corporativo no projeto EJB precisará de uma referência para o projeto JAR do cliente EJB. Se o projeto JAR do cliente EJB estiver em outro aplicativo corporativo, o arquivo JAR do cliente EJB deverá ser incluído no arquivo EAR de referência como um arquivo JAR do utilitário.

Depois que o projeto JAR do cliente EJB for criado, caberá a você incluir os objetos de valor neste projeto, que forem necessários pelas interfaces home ou do componente. Se os objetos não estiverem presentes, resultarão erros de compilação.

Arquivos JAR do Cliente EJB

Os projetos do cliente EJB serão exportados como arquivos JAR do cliente EJB quando o aplicativo for exportado. O arquivo JAR do cliente EJB é especificado no descritor de implementação do arquivo JAR EJB utilizando o elemento ejb-client-jar opcional. O valor do elemento ejb-client-jar é o nome do caminho que especifica o local do arquivo JAR do cliente EJB no arquivo .ear (Enterprise Application Archive) do J2EE que o contém. O valor do nome do caminho é um URI relativo ao arquivo JAR EJB no aplicativo.
Nota: O caminho URI relativo para o arquivo JAR do cliente EJB deve ser o mesmo em todos os aplicativos aos quais o projeto EJB pertence.

Quando você cria um projeto JAR do cliente EJB para um projeto EJB, o arquivo JAR do cliente EJB é incluído no aplicativo corporativo contido como um JAR do utilitário do projeto. A referência a esse arquivo JAR do cliente EJB não pode ser removida do aplicativo corporativo enquanto o projeto EJB estiver definido como um módulo para o aplicativo.

Importante: Se você utilizar o assistente de Exportação de Arquivo JAR EJB para exportar um projeto EJB, o assistente de exportação não incluirá um projeto JAR do cliente EJB associado com um projeto EJB. Para incluir o arquivo JAR do cliente EJB, recomenda-se exportar o arquivo EAR do aplicativo corporativo que contém o projeto EJB. O arquivo EAR resultante incluirá os arquivos JAR de cliente EJB dependentes como arquivos JAR do utilitário. Alternativamente, você pode exportar o projeto JAR do cliente EJB separadamente como um arquivo JAR.