Criando a aplicação empresarial

1. Escolha Arquivo > Novo projeto no menu principal.
2. Selecione Aplicação empresarial na categoria Empresa e clique em Próximo.
3. Digite EnterpriseAppEE5 para o nome do projeto e especifique uma localização do projeto.
4. Desmarque a opção Usar pasta dedicada, se ela estiver selecionada.
   (Esta opção fica disponível se você estiver usando o NetBeans IDE 6.1. Para este tutorial, não há motivo para copiar as bibliotecas do projeto para uma pasta dedicada porque você não precisará compartilhar bibliotecas com outros usuários ou projetos.)
   Clique em Próximo.
5. Defina o servidor como GlassFish e defina a versão de Java EE Java EE 5.
6. Selecione Criar módulo EJB e Criar módulo de cliente de aplicativo, caso não estejam selecionadas.
   Você pode desmarcar Criar módulo de aplicação Web, pois não é necessário um módulo Web para este tutorial.
7. Clique em Terminar.

Criando o bean de sessão no aplicativo empresarial

Agora você cria o bean EJB SessionBean no módulo EJB. Para criar o SessionBean, faça o seguinte:

1. Clique com o botão direito do mouse no módulo EJB EnterpriseAppEE5-ejb na janela Projeto e escolha Novo > Outro para abrir o assistente para Novo arquivo.
2. Na categoria Empresa, selecione Bean de sessão e clique em Próximo.
3. Digite Sessão para o nome EJB e digite ejb para o pacote.
4. Selecione Sem estado como o Tipo de sessão e selecione Remota para o tipo de interface a ser criada.
   (Você pode desmarcar a interface local porque só usará a interface remota neste tutorial.)
   Clique em Terminar.

   Ao clicar em Terminar, a classe de entidade SessionBean.java irá se abrir no editor de código-fonte.

5. Clique com o botão direito do mouse no editor de código-fonte e escolha Métodos EJB > Adicionar método comercial para gerar um método comercial para o bean.
6. Na caixa de diálogo Adicionar método comercial, digite getResult para o nome, defina o Tipo de retorno como String, e selecione a caixa de interface Remota. Clique em OK.
7. Em SessionBean.java, modifique o método getResult para o seguinte:

   public String getResult() {
       return "This is EJB 3.0 Bean";
   }

8. Salve as alterações.

Chamando o bean de sessão a partir do cliente de aplicativo

Agora você adiciona o código ao aplicativo cliente usado para chamar o bean EJB. Para modificar o cliente de aplicativo, faça o seguinte:

1. Expanda EnterpriseAppEE5-app-client > Pacotes de códigos-fonte > enterpriseappee5 na janela Projetos e clique duas vezes em Main.java para abrir o arquivo no editor de código-fonte.
2. Clique com o botão direito do mouse no editor de código-fonte e escolha Recursos comerciais > Chamar enterprise bean.
3. Na caixa de diálogo Chamar enterprise bean, expanda o nó EnterpriseAppEE5-ejb e selecione SessionBean como o bean que você deseja chamar e selecione Remota como a interface referenciada. Clique em OK.
   Quando você clica em OK, a anotação seguinte é adicionada a Main.java para chamar o bean de sessão:

   @EJB
   private static SessionRemote sessionBean;

4. Modifique o método main com o código seguinte para gerar alguma saída simples. Você usará System.err.println para que possa ver facilmente a mensagem na janela Saída.

   public static void main(String[] args) {
       System.err.println("result=" + sessionBean.getResult());

5. Salve as alterações.

Configurando o aplicativo empresarial

Agora quase tudo está feito, e a última coisa que você precisa fazer é configurar o cliente do aplicativo como um módulo, que deve ser executado quando você executa o aplicativo empresarial. Ele provavelmente já está configurado porque você criou o cliente do aplicativo e o aplicativo empresarial ao mesmo tempo.

Para configurar o aplicativo empresarial, faça o seguinte:

1. Clique com o botão direito do mouse no nó do projeto de aplicativo empresarial EnterpriseAppEE5 na janela Projetos e escolha Propriedades.
2. Selecione Executar na caixa de diálogo Propriedades do projeto.
3. Escolha EnterpriseAppEE5-app-client para a URI do módulo cliente (que deve ser selecionada por padrão). Clique em OK.

Executando o aplicativo empresarial

Agora você pode executar o aplicativo empresarial para testar o cliente do aplicativo.

1. Clique com o botão direito do mouse em EnterpriseAppEE5 na janela Projetos e escolha Executar.

Quando você executa o projeto, o IDE constrói e implante o aplicativo. A mensagem seguinte é exibida na janela Saída:

result = This is EJB 3.0 Bean

Criando o módulo EJB

Neste exercício, você cria um módulo EJB chamado EJBModule30. Neste exercício, você não deseja adicionar o módulo EJB a um projeto comercial.

1. Escolha Arquivo > Novo projeto no menu principal.
2. Selecione Módulo EJB na categoria Empresa e clique em Próximo.
3. Digite EJBModule30 para o nome do projeto e defina a localização do projeto.
4. Desmarque a opção Usar pasta dedicada. Clique em Próximo.
5. Garanta que o módulo EJB não seja adicionado a um aplicativo empresarial.
6. Defina o servidor como GlassFish e defina a versão de Java EE Java EE 5.
7. Clique em Terminar.

Criando um bean de sessão no módulo EJB

Neste exercício, você criará o bean de sessão Bean30 em seu módulo EJB. Para criar o Bean30, faça o seguinte:

1. Clique com o botão direito do mouse no módulo EJB na janela Projetos e escolha Novo > Outro para abrir o assistente para Novo arquivo.
2. Na categoria Empresa, selecione Bean de sessão e clique em Próximo.
3. Digite Bean30 para o nome do EJB, digite ejb para o pacote, deixe o Tipo de sessão como Sem estado e selecione Remota para criar uma interface remota. Clique em Terminar.

   Ao clicar em Terminar, a classe de bean Bean30Bean.java irá se abrir no Editor de código-fonte.

4. No editor de código-fonte, clique com o botão direito do mouse no código-fonte e escolha Métodos EJB > Adicionar método comercial na janela pop-up para gerar um método comercial para o bean. Na caixa de diálogo Adicionar método comercial, digite getResult para o nome do método, defina o Tipo de retorno como String e garanta que a caixa de interface Remota esteja selecionada. Clique em OK.
5. Em Bean30Bean.java, modifique o retorno do método getResult com o seguinte (em negrito):

   public String getResult() {
       return "This is EJB 3.0 Bean";
   }

6. Modifique a anotação do bean de sessão @Stateless para alterar o nome padrão usado para mapear o bean de Bean30Bean para Bean30. Em seguida, você usará Bean30 no cliente do aplicativo para procurar o bean. A anotação agora deve ter a seguinte aparência (alterações em negrito):

   @Stateless(mappedName="Bean30")
   public class Bean30Bean implements Bean30Remote {

7. Salve as alterações.

Criando o projeto de cliente de aplicativo

Agora você cria o cliente de aplicativo ApplicationClientForTest que acessará o EJB.

1. Escolha Arquivo > Novo projeto no menu principal.
2. Selecione Cliente de aplicativo empresarial na categoria Empresa e clique em Próximo.
3. Digite ApplicationClientForTest para o nome do projeto e defina a localização.
4. Desmarque a opção Usar pasta dedicada. Clique em Próximo.
5. Defina o servidor como GlassFish e defina a versão de Java EE Java EE 5.
6. Clique em Terminar.

Chamando o EJB a partir do cliente do aplicativo

Agora você adiciona o projeto EJBModule30 a ApplicationClientForTest como uma biblioteca e adiciona o código para acessar Bean30.

1. Expanda o nó do projeto ApplicationClientForTest na janela Projetos, clique com o botão direito do mouse em Bibliotecas e selecione Adicionar projeto.
   Como alternativa, você pode abrir a janela de propriedades do projeto ApplicationClientForTest e clicar em Adicionar projeto na categoria Bibliotecas.
2. Na caixa de diálogo Adicionar projeto, localize e selecione o projeto EJBModule30 project e clique em Adicionar arquivos JAR do projeto.

   O arquivo JAR do EJBModule30 é adicionado à biblioteca de ApplicationClientForTest. Você pode ver as bibliotecas do projeto, expandindo o nó Bibliotecas do projeto na janela Projetos.

3. Clique duas vezes em Main.java na janela Projetos para abrir o arquivo no editor de código-fonte.
4. No editor de código-fonte, adicione o código seguinte ao método main de Main.java. Novamente, você usará System.err.println para que possa ver facilmente a mensagem na janela Saída.

   public static void main(String[] args) {
       InitialContext ctx = new InitialContext();
       Bean30Remote br = (Bean30Remote) ctx.lookup("Bean30");
       System.err.println("EJB message is:" + br.getResult());

5. Corrija as instruções de importação (Ctrl-Shift-I).
6. Corrija quaisquer erros no código. Você pode usar o recurso de sugestão no IDE para ajudá-lo.

   Observação: Nesse caso, o erro é causado por uma cláusula throws ausente. Para usar o recurso de sugestão do IDE, coloque o ponto de inserção na primeira linha do código que contém o erro, sublinhado em vermelho. Quando a lâmpada de sugestão aparecer na margem esquerda, clique na lâmpada e escolha "Adicionar cláusula throws..." para adicionar uma cláusula throws ao método. O IDE adiciona as instruções de importação apropriadas quando adicionar a cláusula throws ao método.

   
7. Salve as alterações.

Agora tudo deve estar correto, portanto, você pode implantar o EJBModule30 e o ApplicationClientForTest no servidor, clicando com o botão direito do mouse no nó de projeto de cada um dos projetos na janela Projetos e escolhendo Desimplantar e Implantar. Depois que você implantar ambos os projetos, execute o cliente de aplicativo, clicando com o botão direito do mouse em ApplicationClientForTest na janela Projetos e escolhendo Executar. Na janela Saída você deve ver o seguinte:
A mensagem do EJB é: This is EJB 3.0 Bean

Observação: Se estiver usando um firewall, talvez você precise desativar o firewall para permitir que o cliente do aplicativo acesse o EJB.

Criando uma segunda interface remota para o EJB Bean30

Neste exercício, você cria uma segunda interface remota chamada Bean30Remote2 para o EJB Bean30.

Para criar a segunda interface, faça o seguinte:

1. Clique com o botão direito do mouse no módulo EJB na janela Projetos e escolha Novo > Classe Java.
2. Digite Bean30Remote2 para o nome da classe, digite ejb para o pacote e clique em Terminar.

   Quando você clica em Terminar, a classe do bean Bean30Remote2.java se abre no editor de código-fonte.

3. Adicione a anotação @Remote à classe para declarar a classe como uma interface remota.
4. Modifique a definição da classe para declarar a classe uma interface e adicionar um método getResult. A classe agora deve ter a seguinte aparência (alterações em negrito):

   @Remote
   public interface Bean30Remote2 {
       String getResult2();
   }

5. Corrija as instruções de importação. Agora você precisará importar javax.ejb.Remote.
6. Salve as alterações.

Modifique Bean30 para implementar a interface

Neste exercício, você modifica Bean30 para implementar a interface Bean30Remote2.

1. Em Bean30Bean.java, implemente o método getResult2 a partir de Bean30Remote2.java. O método deve ter uma aparência semelhante a esta:
   

   public String getResult2() {
       return "This is EJB 3.0 Bean 2";
   }

2. Modifique a definição da classe para implementar Bean30Remote2.

A classe deve ter uma aparência semelhante a esta:

E a estrutura do diretório deve ter esta aparência:

Modificando ApplicationClientForTest

Em seguida, modificamos o código de pesquisa na classe Main do cliente de aplicativo.

1. Clique duas vezes na classe main.java de ApplicationClientForTest na janela Projetos para abrir a classe no editor de código-fonte.
2. Modifique o código no método main para procurar a segunda interface. Nesse caso, quando há mais de uma interface remota, temos que usar o nome completo de cada uma das interfaces na pesquisa.

   public static void main(String[] args) throws NamingException {
       InitialContext ctx = new InitialContext();
       Bean30Remote br = (Bean30Remote) ctx.lookup("Bean30#ejb.Bean30Remote");
       System.err.println("EJB message is:" + br.getResult());
       Bean30Remote2 br2 = (Bean30Remote2) ctx.lookup("Bean30#ejb.Bean30Remote2");
       System.err.println("EJB message 2 is:" + br2.getResult2());

3. Corrija as importações para adicionar uma instrução de importação de ejb.Bean30Remote2.
4. Salve as alterações.

Agora, implante novamente o EJBModule30, e execute o cliente do aplicativo. Na janela Saída, você verá a seguinte saída:
A mensagem EJB é: This is EJB 3.0 Bean
A mensagem EJB 2 é: This is EJB 3.0 Bean 2

Resumo

Neste exercício, mostramos como usar um cliente de aplicativo para acessar o EJB 3.0 Enterprise JavaBeans. Mostramos como acessar o EJB a partir de um aplicativo que era comercial e também a partir de um cliente de aplicativo independente. Também demonstramos a diferença entre chamar um bean com uma única interface remota e beans com mais de uma interface remota.

Criando um módulo EJB EJBModule14

Primeiro crie o módulo EJB.

1. Escolha Arquivo > Novo projeto no menu principal.
2. Selecione Módulo EJB na categoria Empresa e clique em Próximo.
3. Digite EJBModule14 para o nome do projeto e definida a localização do projeto.
4. Desmarque a opção Usar pasta dedicada. Clique em Próximo.
5. Garanta que o módulo EJB não seja adicionado a um aplicativo empresarial.
6. Defina o servidor como GlassFish e defina a versão de Java EE como J2EE 1.4.
7. Clique em Terminar.

Criando o bean de sessão em EJBModule14

Agora você cria o bean EJB Bean14 no módulo EJB. Para criar o Bean14, faça o seguinte:

1. Clique com o botão direito do mouse no módulo EJB na janela Projetos e escolha Novo > Outro para abrir o assistente para Novo arquivo.
2. Selecione Bean de sessão na categoria Empresa e clique em Próximo.
3. Digite Bean14 para o nome da classe, digite ejb para o pacote, deixe o Tipo de sessão como Sem estado e selecione Remota para criar uma interface remota. Clique em Terminar.

   Ao clicar em Terminar, a classe de bean Bean14Bean.java irá se abrir no editor de código-fonte.

4. No editor de código-fonte, clique com o botão direito do mouse no código-fonte e escolha Métodos EJB > Adicionar método comercial no menu pop-up para abrir a caixa de diálogo Adicionar método comercial.
5. Na caixa de diálogo Adicionar método comercial, digite getResult para o nome do método comercial, defina o Tipo de retorno como String, e selecione Remota para a interface. Clique em OK.
6. Modifique o método getResult em Bean14Bean.java para que um método de retorno acesse o bean a partir de outro componente:

   public String getResult() {
       return "This is EJB 1.4 Bean";
   }

7. Salve as alterações.

Chamando o EJB a partir do cliente do aplicativo

Agora você adiciona o projeto EJBModule14 a ApplicationClientForTest como uma biblioteca e adiciona o código para acessar Bean14.

1. Expanda o nó do projeto ApplicationClientForTest na janela Projetos, clique com o botão direito do mouse em Bibliotecas e selecione Adicionar projeto.
2. Na caixa de diálogo Adicionar projeto, localize e selecione o projeto EJBModule14 e clique em Adicionar arquivos JAR do projeto.

   O arquivo JAR de EJBModule14 é adicionado à biblioteca de ApplicationClientForTest. Você pode ver as bibliotecas do projeto, expandindo o nó Bibliotecas do projeto na janela Projetos.

3. Clique duas vezes em Main.java na janela Projetos para abrir o arquivo no editor de código-fonte.
4. No editor de código-fonte, remova ou comente o código usado para acessar o EJBModule30 e adicione o código seguinte (em negrito) ao método main de Main.java:

   public static void main(String[] args) throws NamingException {
       InitialContext ctx = new InitialContext();
       Object remote = ctx.lookup("ejb/Bean14Bean");
       Bean14RemoteHome sbrh = (Bean14RemoteHome) PortableRemoteObject.narrow(remote, Bean14RemoteHome.class);
       Bean14Remote sbr = sbrh.create();
       System.err.println("EJB 1.4 result:" + sbr.getResult());

5. Corrija as instruções de importação.
6. Corrija os erros no código-fonte. Existem erros porque o método precisa de uma cláusula throws para NamingException, CreateException e RemoteException a partir da pesquisa. Você pode usar o recurso de sugestão do IDE para ajudá-lo a resolver os erros.

Agora tudo deve estar correto, portanto, implante o EJBModule14 e o ApplicationClientForTest no servidor (clique com o botão direito do mouse em cada projeto e escolha Desimplantar e Implantar) e, em seguida, clique com o botão direito do mouse em ApplicationClientForTest e escolha Executar. Quando você executa o cliente, devemos ver o seguinte na janela Saída:
Resultado do EJB 1.4: This is EJB 1.4 Bean