KickJava   Java API By Example, From Geeks To Geeks.

Java > Open Source Codes > javax > ejb > Handle


1 /**
2  * EasyBeans
3  * Copyright (C) 2006 Bull S.A.S.
4  * Contact: easybeans@objectweb.org
5  *
6  * This library is free software; you can redistribute it and/or
7  * modify it under the terms of the GNU Lesser General Public
8  * License as published by the Free Software Foundation; either
9  * 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: Handle.java 1100 2006-08-16 13:05:31Z benoitf $
23  * --------------------------------------------------------------------------
24  */

25
26 package javax.ejb;
27
28 import java.io.Serializable JavaDoc;
29 import java.rmi.RemoteException JavaDoc;
30
31 /**
32  * The Handle interface is implemented by all EJB object handles. A handle is an
33  * abstraction of a network reference to an EJB object. A handle is intended to
34  * be used as a "robust" persistent reference to an EJB object.
35  * @see <a HREF="http://www.jcp.org/en/jsr/detail?id=220">EJB 3.0 specification</a>
36  * @author Florent Benoit
37  */

38 public interface Handle extends Serializable JavaDoc {
39
40     /**
41      * Obtain the EJB object reference represented by this handle.
42      * @return the EJB object reference represented by this handle.
43      * @throws RemoteException The EJB object could not be obtained because of a
44      * system-level failure.
45      */

46     EJBObject JavaDoc getEJBObject() throws RemoteException JavaDoc;
47
48 }
49
Popular Tags