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: MessageDrivenBean.java 1100 2006-08-16 13:05:31Z benoitf $
23: * --------------------------------------------------------------------------
24: */package javax.ejb;
25:
26: /**
27: * The MessageDrivenBean interface is implemented by every message-driven
28: * enterprise Bean class. The container uses the MessageDrivenBean methods to
29: * notify the enterprise Bean instances of the instance's life cycle events.
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 MessageDrivenBean extends EnterpriseBean {
34:
35: /**
36: * Set the associated message-driven context. The container calls this
37: * method after the instance creation. The enterprise Bean instance should
38: * store the reference to the context object in an instance variable. This
39: * method is called with no transaction context.
40: * @param ctx A MessageDrivenContext interface for the instance.
41: * @throws EJBException Thrown by the method to indicate a failure caused by
42: * a system-level error.
43: */
44: void setMessageDrivenContext(MessageDrivenContext ctx)
45: throws EJBException;
46:
47: /**
48: * A container invokes this method before it ends the life of the
49: * message-driven object. This happens when a container decides to terminate
50: * the message-driven object. This method is called with no transaction
51: * context.
52: * @throws EJBException Thrown by the method to indicate a failure caused by
53: * a system-level error.
54: */
55: void ejbRemove() throws EJBException;
56:
57: }
|