01: /**
02: * EasyBeans
03: * Copyright (C) 2006 Bull S.A.S.
04: * Contact: easybeans@objectweb.org
05: *
06: * This library is free software; you can redistribute it and/or
07: * modify it under the terms of the GNU Lesser General Public
08: * License as published by the Free Software Foundation; either
09: * version 2.1 of the License, or any later version.
10: *
11: * This library is distributed in the hope that it will be useful,
12: * but WITHOUT ANY WARRANTY; without even the implied warranty of
13: * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
14: * Lesser General Public License for more details.
15: *
16: * You should have received a copy of the GNU Lesser General Public
17: * License along with this library; if not, write to the Free Software
18: * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307
19: * USA
20: *
21: * --------------------------------------------------------------------------
22: * $Id: TimerHandle.java 1100 2006-08-16 13:05:31Z benoitf $
23: * --------------------------------------------------------------------------
24: */package javax.ejb;
25:
26: import java.io.Serializable;
27:
28: /**
29: * The TimerHandle interface is implemented by all EJB timer handles.
30: * @see <a href="http://www.jcp.org/en/jsr/detail?id=220">EJB 3.0 specification</a>
31: * @author Florent Benoit
32: */
33: public interface TimerHandle extends Serializable {
34:
35: /**
36: * Obtain a reference to the timer represented by this handle.
37: * @return a reference to the timer represented by this handle.
38: * @throws IllegalStateException If this method is invoked while the
39: * instance is in a state that does not allow access to this method.
40: * @throws NoSuchObjectLocalException If invoked on a handle whose
41: * associated timer has expired or has been cancelled.
42: * @throws EJBException If this method could not complete due to a
43: * system-level failure.
44: */
45: Timer getTimer() throws IllegalStateException,
46: NoSuchObjectLocalException, EJBException;
47:
48: }
|