Como criar um EJB Criando um projeto EJB com um cliente WEB no Eclipse Gabriel Novais Amorim Abril/2014 Este tutorial apresenta o passo a passo para se criar um projeto EJB no Eclipse com um cliente web que acessa as funcionalidades do EJB. Foi utilizado o Eclipse Kepler e JBoss AS 7.1.
Sumário 1. Introdução... 2 1.1 Quando usar Enterprise Beans?... 2 1.2 Tipos de Enterprise Beans... 2 2. Criando um projeto EJB no Eclipse... 3 3. Criando um EJB... 4 4. Criando métodos no EJB... 6 5. Criando uma aplicação cliente para o EJB... 7 6. Conclusão... 7 1
1. Introdução Enterprise Beans são componentes Java EE que implementam a tecnologia Enterprise JavaBeans (EJB). Estes componentes rodam em um container EJB, dentro de um servidor de aplicação, que fornece serviços de transação e segurança de forma transparente para o desenvolvedor. Enterprise Beans rodam do lado servidor encapsulando a lógica do negócio da aplicação e trazem inúmeros benefícios. Primeiro, fornece serviços de nível de sistema, como gerenciamento de transações e segurança. Segundo, implementam a lógica do negócio e, em times onde há divisão de camadas, favorece o foco do desenvolvedor em alguma camada específica. Terceiro, são componentes portáveis e pode-se criar novas aplicações a partir de beans existentes. 1.1 Quando usar Enterprise Beans? O uso de EJBs deve ser considerado quando: A aplicação deve ser escalável. EJBs podem rodar em máquinas diferentes de forma transparente aos clientes, tornando a aplicação naturalmente distribuída. Transações são utilizadas para garantir a integridade dos dados. Enterprise Beans suportam transações, que é o mecanismo que gerencia o acesso concorrente a objetos compartilhados. A aplicação terá uma variedade de clientes. Com poucas linhas de código, clientes remotos podem facilmente localizar Enterprise Beans. 1.2 Tipos de Enterprise Beans Há dois tipos de Enterprise Beans: Session: Executa tarefas para um cliente, opcionalmente podem implementar um web service. Message-Drive: Atua como um listener para um tipo particular de mensagens, como JMS. Nas versões anteriores da especificação EJB 3, as versões EJB 2.x e EJB 1, havia um terceiro tipo de Enterprise Bean, o Entity Bean. Eles foram substituídos pelas entities da JPA. 2
2. Criando um projeto EJB no Eclipse No Eclipse, clique em File > New > EJB Project, como mostra a figura 1. Figura 1 New EJB Project no Eclipse Será aberta uma janela de configuração de projeto como a apresentada na figura 2. Escolha um nome para o projeto no campo Project name e marque a opção Add project to an EAR. A opção de adicionar o projeto a um EAR criará um arquivo EAR que conterá o projeto EJB recém-criado, desta forma, o deploy será do arquivo EAR com o JAR que contém os EJBs. Clique em Finish para concluir a configuração e criar o projeto. Note na aba Project Explorer que foram criados três projetos, MyEJBProject, MyEJBProjectClient e MyEJBProjectEAR. Segue descrição de cada um dos projetos: MyEJBProject: projeto contendo todas as classes de implementação dos EJBs. É compilado como um arquivo JAR. MyEJBProjectClient: projeto contendo as interfaces dos EJBs. É compilado como um arquivo JAR. MyEJBProjectEAR: projeto EAR contendo os projetos da aplicação, neste caso, MyEJBProject.jar e MyEJBProjectClient.jar. 3
Figura 2 Configuração de um novo projeto EJB 3. Criando um EJB Clique com o botão direito sobre o projeto EBJ, MyEJBProject no caso, em seguida New > Session Bean (EJB 3.x), como mostra a figura 3. Será aberta uma janela de configuração para o EJB a ser criado, conforme figura 4. Informe o pacote do EJB e o nome da classe. Por default, o tipo do EJB é Stateless sem interface (Nointerface view). Mantenha o EJB Stateless, mas altere a criação da interface (Create business interface) marcando a opção Local e desmarcando a opção No-interface View. Clique em Finish para criar o EJB e sua interface Local. 4
Figura 3 Criação de um EJB no Eclipse Figura 4 Configuração do EJB no Eclipse 5
Atente-se para o local onde os artefatos são criados. O EJB é criado no MyEJBProject (HelloBean.java) e a interface local (HelloBeanLocal.java) no MyEJBProjectClient. Note também que o EAR MyEJBProjectEAR contém o módulo MyEJBProject.jar e a biblioteca MyEJBProjectClient.jar, desta forma, pode-se fazer o deploy do EAR e utilizar as interfaces em MyEJBProjectClient para obter instâncias dos EJBs em MyEJBProject. 4. Criando métodos no EJB Crie métodos na interface do EJB para que sejam acessados pelos clientes. A listagem de código 1 define um método na interface HelloBeanLocal. package com.gabrielamorim.myejb; import javax.ejb.local; @Local public interface HelloBeanLocal { public String gethellomessage(); Listagem de Código 1 Definição de método na interface local Este método deve ser implementado no EJB. A listagem de código 2 mostra o EJB com a implementação do método String gethellomessage(). package com.gabrielamorim.myejb; import javax.ejb.stateless; @Stateless public class HelloBean implements HelloBeanLocal { /** * Default constructor. */ public HelloBean() { @Override public String gethellomessage() { return "Hello!"; Listagem de Código 2 Implementação do EJB HelloBean Após estes passos, tem-se um EJB pronto para ser usado! A próxima sessão mostra como usar o EJB HelloBean injetando-o em uma aplicação Web (em um Servlet) por meio da anotação @EJB. 6
5. Criando uma aplicação cliente para o EJB Crie um Dynamic Web Project no Eclipse, durante a criação, marque a opção Add project to an EAR e selecione o arquivo EAR onde já estão o projeto EJB e as interfaces. Isto fará o projeto Web ser adicionado ao mesmo EAR do EJB, desta forma será necessário apenas um deploy. Crie um Servlet na aplicação Web. A listagem de código 3 mostra a implementação de um Servlet que injeta o EJB HelloBean por meio da sua interface local HelloBeanLocal. package com.gabrielamorim.myservlets; import com.gabrielamorim.myejb.hellobeanlocal; @WebServlet("/ServletToEJB") public class ServletToEJB extends HttpServlet { private static final long serialversionuid = 1L; @EJB private HelloBeanLocal hellobean; public ServletToEJB() { super(); protected void doget(httpservletrequest request, HttpServletResponse response) throws ServletException, IOException { PrintWriter out = response.getwriter(); out.println(hellobean.gethellomessage()); Listagem de Código 3 Servlet injetando o EJB por meio da interface local Atente-se para a anotação @EJB sob o atributo hellobean do tipo HelloBeanLocal. Esta anotação injeta uma instância do EJB HelloBean em hellobean. Basta fazer o deploy do EAR em um container Web e EJB e acessar o ServletToEJB para ver a mensagem do EJB. 6. Conclusão Foi criado um projeto EJB com um EJB Stateless sendo exposto por uma interface local aos seus clientes. O projeto EJB foi adicionado a um EAR, junto com o a biblioteca contendo a interface local do EJB. Foi criado também um projeto Web para utilizar o EJB criado por meio de um Servlet que teve o EJB injetado por meio da anotação @EJB. O projeto Web também foi adicionado ao EAR, resultando assim em um único deploy. Este passo a passo teve o intuito de mostrar a criação e a utilização de um EJB de forma simples e objetiva, tendo como público alvo pessoas que já estudaram a teoria e que ficaram confusos na hora de implementar um EJB na prática. 7