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; 29 import java.rmi.RemoteException; 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 { 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 getEJBObject() throws RemoteException; 47 48 } 49