Red Hat SummitEste conteúdo não está disponível no idioma selecionado.
30.5. EJB Timer Configuration
The J2EE timer service allows for any EJB object to register for a timer callback either at a designated time in the future. Timer events can be used for auditing, reporting or other cleanup tasks that need to need to happen at some given time in the future. Timer events are intended to be persistent and should be executed even in the event of a server failure. Coding to EJB timers is a standard part of the J2EE specification, so we will not explore the programming model. We will, instead, look at the configuration of the timer service in JBoss so that you can understand how to make timers work best in your environment
The EJB timer service is configure by several related MBeans in the
ejb-deployer.xml file. The primary MBean is the EJBTimerService MBean.
The
EJBTimerService has the following configurable attributes:
- RetryPolicy: This is name of the MBean that implements the retry policy. The MBean must support the
org.jboss.ejb.txtimer.RetryPolicy interface. JBoss provides one implementation,FixedDelayRetryPolicy, which will be described later. - PersistencePolicy: This is the name of the MBean that implements the persistence strategy for saving timer events. The MBean must support the
org.jboss.ejb.txtimer.PersistencePolicyinterface. JBoss provides two implementations, NoopPersistencePolicy and DatabasePersistencePolicy, which will be described later. - TimerIdGeneratorClassName: This is the name of a class that provides the timer ID generator strategy. This class must implement the
org.jboss.ejb.txtimer.TimerIdGeneratorinterface. JBoss provides theorg.jboss.ejb.txtimer.BigIntegerTimerIdGeneratorimplementation. - TimedObjectInvokerClassname: This is the name of a class that provides the timer method invocation strategy. This class must implement the
org.jboss.ejb.txtimer.TimedObjectInvokerinterface. JBoss provides theorg.jboss.ejb.txtimer.TimedObjectInvokerImplimplementation.
The retry policy MBean definition used is shown here:
<mbean code="org.jboss.ejb.txtimer.FixedDelayRetryPolicy"
name="jboss.ejb:service=EJBTimerService,retryPolicy=fixedDelay">
<attribute name="Delay">100</attribute>
</mbean>
<mbean code="org.jboss.ejb.txtimer.FixedDelayRetryPolicy"
name="jboss.ejb:service=EJBTimerService,retryPolicy=fixedDelay">
<attribute name="Delay">100</attribute>
</mbean>
The retry policy takes one configuration value:
- Delay: This is the delay (ms) before retrying a failed timer execution. The default delay is 100ms.
If EJB timers do not need to be persisted, the
NoopPersistence policy can be used. This MBean is commented out by default, but when enabled will look like this:
<mbean code="org.jboss.ejb.txtimer.NoopPersistencePolicy"
name="jboss.ejb:service=EJBTimerService,persistencePolicy=noop"/>
<mbean code="org.jboss.ejb.txtimer.NoopPersistencePolicy"
name="jboss.ejb:service=EJBTimerService,persistencePolicy=noop"/>
Most applications that use timers will want timers to be persisted. For that the
DatabasePersitencePolicy MBean should be used.
- DataSource: This is the MBean for the DataSource that timer data will be written to.
- DatabasePersistencePlugin: This is the name of the class the implements the persistence strategy. This should be
org.jboss.ejb.txtimer.GeneralPurposeDatabasePersistencePlugin.
'%20d='M201.5%20305.5c-13.8%200-24.9-11.1-24.9-24.6%200-13.8%2011.1-24.9%2024.9-24.9%2013.6%200%2024.6%2011.1%2024.6%2024.9%200%2013.6-11.1%2024.6-24.6%2024.6zM504%20256c0%20137-111%20248-248%20248S8%20393%208%20256%20119%208%20256%208s248%20111%20248%20248zm-132.3-41.2c-9.4%200-17.7%203.9-23.8%2010-22.4-15.5-52.6-25.5-86.1-26.6l17.4-78.3%2055.4%2012.5c0%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.3%2024.9-24.9s-11.1-24.9-24.9-24.9c-9.7%200-18%205.8-22.1%2013.8l-61.2-13.6c-3-.8-6.1%201.4-6.9%204.4l-19.1%2086.4c-33.2%201.4-63.1%2011.3-85.5%2026.8-6.1-6.4-14.7-10.2-24.1-10.2-34.9%200-46.3%2046.9-14.4%2062.8-1.1%205-1.7%2010.2-1.7%2015.5%200%2052.6%2059.2%2095.2%20132%2095.2%2073.1%200%20132.3-42.6%20132.3-95.2%200-5.3-.6-10.8-1.9-15.8%2031.3-16%2019.8-62.5-14.9-62.5zM302.8%20331c-18.2%2018.2-76.1%2017.9-93.6%200-2.2-2.2-6.1-2.2-8.3%200-2.5%202.5-2.5%206.4%200%208.6%2022.8%2022.8%2087.3%2022.8%20110.2%200%202.5-2.2%202.5-6.1%200-8.6-2.2-2.2-6.1-2.2-8.3%200zm7.7-75c-13.6%200-24.6%2011.1-24.6%2024.9%200%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.1%2024.9-24.6%200-13.8-11-24.9-24.9-24.9z'/%3e%3c/svg%3e){kind=small}