Ins"tuto

Federal de Educao, Cincia e Tecnologia do Rio Grande do Norte

Campus Natal-Central
Diretoria Acadmica de Gesto e Tecnologia da Informao
Curso de Tecnologia em Anlise e Desenvolvimento de Sistemas

U"lizando o Servio de
Temporizao

Prof. Fellipe Aleixo (fellipe.aleixo@ifrn.edu.br)

 Agendamento de Tarefas
Comum em muitos modelos de negcio
Gerao de folha de pagamento
Mudar status em emprs"mos em atraso
Fechar balano dirio de loja
Etc.

Timer service o servio de temporizao

permite o agendamento de no"caes para
todos os "pos de EJB, com exceo dos stateful
 Agendamento de Tarefas
O agendamento pode ser:
Em funo de datas especcas
Em funo da passagem de um perodo de tempo
Passados certos intervalos de tempo
Exemplos:
s 10:30 AM
No dia 23 de maio
Em 30 dias
A cada 12 horas
 Temporizadores
Temporizadores para EJBs pode ser
program"cos ou autom"cos
Program"cos denidos por solicitao explcita
Invocao de mtodos da interface TimerService
Autom"cos criados aps o deploy de um EJB
Anotaes javax.ejb.Schedule
 Expresses de Agendamento
Temporizadores pode ser denidos de acordo
com agendamentos baseados no calendrio

Um agendamento expresso por uma

expresso similar ao u"litrio CRON do UNIX

Os "pos de temporizadores se u"lizam dessas

expresses para denio dos agendamentos
 Atributos para uma Expresso de
Agendamento
Atributo Descrio Padro Exemplos
second Valor em segundos 0 0 a 59. p.ex.: second=30
minute Valor em minutos 0 0 a 59. p.ex.: minute=15
hour Valor em horas 0 0 a 23. p.ex.: hour=13
0 a 7 (0 e 7 = domingo). Tambm pode
dayOfWeek Dia da semana * ser um dos seguintes valores: [Sun,
Mon, Tue, Wed, Thu, Fri, Sat]
1 a 31. p.ex.: dayOfMonth=15.
Expresso com: [1st, 2nd, 3rd, 4th, 5th,
dayOfMonth Dia do ms *
Last] [Sun, Mon, Tue, Wed, Thu, Fri,
Sat]. p.ex: 2nd Fri ou Last
1 a 12. p.ex.: month=7. Ou: [Jan, Feb,
month Ms em questo * Mar, Apr, May, Jun, Jul, Aug, Sep, Oct,
Nov, Dec]
year Ano em questo * Convencional. p.ex.: year=2013
 Expresso de Agendamento
possvel a especicao de ml"plos valores
em uma expresso atravs de curingas
* representa todos os valor permi"dos
Ex.: minute=*

Especicando uma lista de valores

Dois ou mais valores separados por ,
Ex.: dayOfWeek=Tue, Thu
 Expresso de Agendamento
Especicando um intervalo de valores
Usando o -para denir um intervalo inclusivo
Ex.: hour=9-17
Ex.: dayOfWeek=5-1
Ex.: dayOfMonth=25-Last, 1-5
 Expresso de Agendamento
Especicando perodos
U"lizando a / na forma x/y, onde x
representa o ponto inicial e y o perodo
Ex.: minute=*/10
A cada 10 minutos = 0, 10, 20, 30, 40, 50
Ex.: hour=12/2
A cada duas horas, iniciando ao meio dia
TEMPORIZADORES
PROGRAMTICOS
 Temporizadores Program"cos
Quando um temporizador program"co
expira, o continer executa o mtodo anotado
com @Timeout
@Timeout
public void "meout(Timer "mer) {
System.out.println("TimerBean: "meout occurred");
}
Tal mtodo deve retornar void
Opcionalmente receber um javax.ejb.Timer
 Criando Temporizadores
Program"cos
Por meio da invocao de um dos mtodos da
interface TimerService
A expirao do temporizador pode ser
expressa por durao ou uma data absoluta
Nmero de milissegundos aps o disparo
Uma data absoluta objeto java.u9l.Date
 Criando Temporizadores
Program"cos

long dura"on = 60000; // 60 milissegundos

Timer "mer = "merService.createSingleAc"onTimer
(dura"on, new TimerCong());

//OU

SimpleDateForma{er forma{er = new SimpleDateForma{er
("MM/dd/yyyy 'at' HH:mm");
Date date = forma{er.parse("05/01/2010 at 12:05");
Timer "mer = "merService.createSingleAc"onTimer
(date, new TimerCong());
 Temporizadores Baseados em
Calendrio
Denio de uma expresso por meio de um
objeto javax.ejb.ScheduleExpression
Passado como parmetro para o mtodo
TimerService.createCalendarTimer
ScheduleExpression schedule = new ScheduleExpression();
schedule.dayOfWeek("Mon");
schedule.hour("12-17, 23");
Timer "mer = "merService.createCalendarTimer(schedule);
TEMPORIZADORES AUTOMTICOS
 Temporizadores Autom"cos
Criados pelo continer EJB quando na
implantao de um bean anotado com
@Schedule ou @Schedules
Ou atravs do descritor de implantao
Um EJB pode ter ml"plos mtodos de 9meout
O atributo opcional persistent (boolean) permite
suportar, ou no, reinicializao do servidor
 Temporizadores Autom"cos
Tambm pode ser especicada uma Time
Zone especca para o agendamento
Exemplo:
@Schedule(dayOfWeek="Sun", hour="0")
public void cleanupWeekData() { ... }
 Ml"plos Agendamentos
A anotao @Schedules permite que sejam
denidos ml"plos agendamentos referentes
a um dado mtodo
@Schedules ({
@Schedule(dayOfMonth="Last"),
@Schedule(dayOfWeek="Fri", hour="23")
})
public void doPeriodicCleanup() { ... }
INFORMAES ADICIONAIS
 Cancelando Temporizadores
Um temporizador pode ser cancelado por
meio dos seguintes eventos:
Quando o mesmo expira e o mtodo de "meout
executado pelo continer
Quando o bean invoca o mtodo cancel da
interface Timer
 Salvando um Temporizador
Para salvar um temporizador para uma
referncia futura:
Invocar o mtodo getHandle e armazenar o
objeto TimerHandle no banco de dados
O referido objeto serializvel
Para re-instanciar o objeto Timer, deve ser
recuperado o TimerHandle e invocado o mtodo
getTimer
 Recuperando as Informaes do
Temporizador
Informaes adicionais podem ser
recuperadas do temporizador
public long getTimeRemaining();
public java.u"l.Date getNextTimeout();
public java.io.Serializable getInfo();

Para ter acesso a todos os beans com

temporizadores a"vos pode ser usado o
mtodo getTimers da interface TimerService
 Transaes e Temporizadores
Um EJB cria, normalmente, um temporizador
em uma transao
Em caso de rollback o temporizador cancelado
Se o bean cancelar um temporizador em uma
transao em caso de rollback, o
cancelamento desfeito
O tempo restaurado ao do incio da transao
EXEMPLO COMPLETO
 O Exemplo
TimerSessionBean um bean de sesso
singleton com os dois "pos de temporizadores
Os mtodos setTimer e @Timeout so u"lizados
para denir o temporizador program"co
Tambm h a denio de um temporizador
autom"co com a anotao @Schedule
 Ex.Temporizador Program"co
...
public void setTimer(long intervalDura"on) {
logger.info("Seng a programma"c "meout for " +
intervalDura"on + " milliseconds from now.");
Timer "mer = "merService.createTimer(intervalDura"on,
"Created new programma"c "mer");
}

@Timeout
public void programma"cTimeout(Timer "mer) {
this.setLastProgramma"cTimeout(new Date());
logger.info("Programma"c "meout occurred.");
}
...
 Ex. Temporizador Autom"co

...
@Schedule(minute="*/1", hour="*")
public void automa"cTimeout() {
this.setLastAutoma"cTimeout(new Date());
logger.info("Automa"c "meout occured");
}
...
 O Cdigo Completo...
package "mersession.ejb;
import java.u"l.Date;
import java.u"l.logging.Logger;
import javax.annota"on.Resource;
import javax.ejb.Schedule;
import javax.ejb.Stateless;
import javax.ejb.Timeout;
import javax.ejb.Timer;
import javax.ejb.TimerService;

@Singleton
public class TimerSessionBean {
@Resource
TimerService "merService;
 private Date lastProgramma"cTimeout;
private Date lastAutoma"cTimeout;

private Logger logger = Logger.getLogger
("com.sun.tutorial.javaee.ejb."mersession.TimerSessionBean");

public void setTimer(long intervalDura"on) {
logger.info("Seng a programma"c "meout for "
+ intervalDura"on + " milliseconds from now.");
Timer "mer = "merService.createTimer(intervalDura"on,
"Created new programma"c "mer");
}
@Timeout
public void programma"cTimeout(Timer "mer) {
this.setLastProgramma"cTimeout(new Date());
logger.info("Programma"c "meout occurred.");
}
 @Schedule(minute="*/1", hour="*")
public void automa"cTimeout() {
this.setLastAutoma"cTimeout(new Date());
logger.info("Automa"c "meout occured");
}

public String getLastProgramma"cTimeout() {
if (lastProgramma"cTimeout != null) {
return lastProgramma"cTimeout.toString();
} else {
return "never";
}

}
 public void setLastProgramma"cTimeout(Date lastTimeout) {
this.lastProgramma"cTimeout = lastTimeout;
}

public String getLastAutoma"cTimeout() {
if (lastAutoma"cTimeout != null) {
return lastAutoma"cTimeout.toString();
} else {
return "never";
}
}

public void setLastAutoma"cTimeout(Date lastAutoma"cTimeout)
{
this.lastAutoma"cTimeout = lastAutoma"cTimeout;
}
}