EJB - Serviço de cronômetro

O serviço de cronômetro é um mecanismo pelo qual o aplicativo programado pode ser criado. Por exemplo, geração de comprovante de salário no primeiro dia de cada mês. A especificação EJB 3.0 especificou a anotação @Timeout, que ajuda na programação do serviço EJB em um bean sem estado ou controlado por mensagem. O contêiner EJB chama o método, que é anotado por @Timeout.

O EJB Timer Service é um serviço fornecido pelo contêiner EJB, que ajuda a criar o cronômetro e a agendar o retorno de chamada quando o cronômetro expira.

Passos para criar cronômetro

Injete SessionContext no bean usando a anotação @Resource -

@Stateless
public class TimerSessionBean {

   @Resource
   private SessionContext context;
   ...
}

Use o objeto SessionContext para obter TimerService e para criar um cronômetro. Passe o tempo em milissegundos e mensagem.

public void createTimer(long duration) {
   context.getTimerService().createTimer(duration, "Hello World!");
}

Passos para usar o cronômetro

Use a anotação @Timeout para um método. O tipo de retorno deve ser nulo e passar um parâmetro do tipo Timer. Estamos cancelando o cronômetro após a primeira execução, caso contrário, ele continuará em execução após os intervalos fixos.

@Timeout
public void timeOutHandler(Timer timer) {
   System.out.println("timeoutHandler : " + timer.getInfo());        
   timer.cancel();
}

Aplicação de exemplo

Vamos criar um aplicativo EJB de teste para testar o Serviço de Timer no EJB.

Degrau	Descrição
1	Crie um projeto com um nome EjbComponent em um pacote com.tutorialspoint.timer conforme explicado no capítulo EJB - Criar Aplicativo .
2	Crie TimerSessionBean.java e TimerSessionBeanRemote conforme explicado no capítulo EJB - Criar Aplicativo . Mantenha o resto dos arquivos inalterados.
3	Limpe e construa o aplicativo para garantir que a lógica de negócios esteja funcionando de acordo com os requisitos.
4	Finalmente, implante o aplicativo na forma de arquivo jar no JBoss Application Server. O servidor de aplicativos JBoss será iniciado automaticamente se ainda não tiver sido iniciado.
5	Agora crie o cliente EJB, um aplicativo baseado em console da mesma maneira que explicado no capítulo EJB - Criar Aplicativo no tópicoCreate Client to access EJB.

EJBComponent (Módulo EJB)

TimerSessionBean.java

package com.tutorialspoint.timer;

import javax.annotation.Resource;
import javax.ejb.SessionContext;
import javax.ejb.Timer;
import javax.ejb.Stateless;
import javax.ejb.Timeout;

@Stateless
public class TimerSessionBean implements TimerSessionBeanRemote {

   @Resource
   private SessionContext context;

   public void createTimer(long duration) {
      context.getTimerService().createTimer(duration, "Hello World!");
   }

   @Timeout
   public void timeOutHandler(Timer timer) {
      System.out.println("timeoutHandler : " + timer.getInfo());        
      timer.cancel();
   }
}

TimerSessionBeanRemote.java

package com.tutorialspoint.timer;

import javax.ejb.Remote;

@Remote
public interface TimerSessionBeanRemote {
   public void createTimer(long milliseconds);
}

Assim que você implantar o projeto EjbComponent no JBOSS, observe o log do jboss.
JBoss criou automaticamente uma entrada JNDI para nosso bean de sessão - TimerSessionBean/remote.
Usaremos esta string de pesquisa para obter objeto de negócios remoto do tipo - com.tutorialspoint.timer.TimerSessionBeanRemote

Saída de log do servidor de aplicativos JBoss

...
16:30:01,401 INFO  [JndiSessionRegistrarBase] Binding the following Entries in Global JNDI:
   TimerSessionBean/remote - EJB3.x Default Remote Business Interface
   TimerSessionBean/remote-com.tutorialspoint.timer.TimerSessionBeanRemote - EJB3.x Remote Business Interface
16:30:02,723 INFO  [SessionSpecContainer] Starting jboss.j2ee:jar=EjbComponent.jar,name=TimerSessionBean,service=EJB3
16:30:02,723 INFO  [EJBContainer] STARTED EJB: com.tutorialspoint.timer.TimerSessionBeanRemote ejbName: TimerSessionBean
...

Testador EJB (Cliente EJB)

jndi.properties

java.naming.factory.initial=org.jnp.interfaces.NamingContextFactory
java.naming.factory.url.pkgs=org.jboss.naming:org.jnp.interfaces
java.naming.provider.url=localhost

Essas propriedades são usadas para inicializar o objeto InitialContext do serviço de nomenclatura java.
O objeto InitialContext será usado para pesquisar o bean de sessão sem estado.

EJBTester.java

package com.tutorialspoint.test;
   
import com.tutorialspoint.stateful.TimerSessionBeanRemote;
import java.io.BufferedReader;
import java.io.FileInputStream;
import java.io.IOException;
import java.io.InputStreamReader;
import java.util.List;
import java.util.Properties;
import javax.naming.InitialContext;
import javax.naming.NamingException;

public class EJBTester {

   BufferedReader brConsoleReader = null; 
   Properties props;
   InitialContext ctx;
   {
      props = new Properties();
      try {
         props.load(new FileInputStream("jndi.properties"));
      } catch (IOException ex) {
         ex.printStackTrace();
      }
      try {
         ctx = new InitialContext(props);            
      } catch (NamingException ex) {
         ex.printStackTrace();
      }
      brConsoleReader = 
      new BufferedReader(new InputStreamReader(System.in));
   }
   
   public static void main(String[] args) {

      EJBTester ejbTester = new EJBTester();

      ejbTester.testTimerService();
   }
   
   private void showGUI() {
      System.out.println("**********************");
      System.out.println("Welcome to Book Store");
      System.out.println("**********************");
      System.out.print("Options \n1. Add Book\n2. Exit \nEnter Choice: ");
   }
   
   private void testTimerService() {
      try {
         TimerSessionBeanRemote timerServiceBean = (TimerSessionBeanRemote)ctx.lookup("TimerSessionBean/remote");

         System.out.println("["+(new Date()).toString()+ "]" + "timer created.");
         timerServiceBean.createTimer(2000);            

      } catch (NamingException ex) {
         ex.printStackTrace();
      }
   }
}

O EJBTester está executando as seguintes tarefas.

Carregue as propriedades de jndi.properties e inicialize o objeto InitialContext.
No método testTimerService (), a consulta jndi é feita com o nome - "TimerSessionBean / remote" para obter o objeto de negócios remoto (EJB sem estado do cronômetro).
Em seguida, createTimer é invocado passando 2.000 milissegundos como tempo de agendamento.
O contêiner EJB chama o método timeoutHandler após 2 segundos.

Execute o cliente para acessar o EJB

Localize EJBTester.java no explorador de projetos. Clique com o botão direito na classe EJBTester e selecionerun file.

Verifique a seguinte saída no console do Netbeans.

run:
[Wed Jun 19 11:35:47 IST 2013]timer created.
BUILD SUCCESSFUL (total time: 0 seconds)

Saída de log do servidor de aplicativos JBoss

Você pode encontrar as seguintes entradas de retorno de chamada no log do JBoss

...
11:35:49,555 INFO  [STDOUT] timeoutHandler : Hello World!
...