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: EJBHome.java 1100 2006-08-16 13:05:31Z benoitf $
23: * --------------------------------------------------------------------------
24: */package javax.ejb;
25:
26: import java.rmi.Remote;
27: import java.rmi.RemoteException;
28:
29: /**
30: * Used by EJB 2.1 for their business remote home interface.
31: * @see <a href="http://www.jcp.org/en/jsr/detail?id=220">EJB 3.0 specification</a>
32: * @author Florent Benoit
33: */
34: public interface EJBHome extends Remote {
35:
36: /**
37: * Remove an EJB object identified by its handle.
38: * @param handle the given handle
39: * @throws RemoteException Thrown when the method failed due to a
40: * system-level failure.
41: * @throws RemoveException Thrown if the enterprise Bean or the container
42: * does not allow the client to remove the object.
43: */
44: void remove(Handle handle) throws RemoteException, RemoveException;
45:
46: /**
47: * Remove an EJB object identified by its primary key.
48: * @param primaryKey the given primary key;
49: * @throws RemoteException Thrown when the method failed due to a
50: * system-level failure.
51: * @throws RemoveException Thrown if the enterprise Bean or the container
52: * does not allow the client to remove the object.
53: */
54: void remove(Object primaryKey) throws RemoteException,
55: RemoveException;
56:
57: /**
58: * Obtain the EJBMetaData interface for the enterprise Bean. The EJBMetaData
59: * interface allows the client to obtain information about the enterprise
60: * Bean.<br>
61: * The information obtainable via the EJBMetaData interface is intended to
62: * be used by tools.
63: * @return The enterprise Bean's EJBMetaData interface.
64: * @throws RemoteException Thrown when the method failed due to a
65: * system-level failure.
66: */
67: EJBMetaData getEJBMetaData() throws RemoteException;
68:
69: /**
70: * Obtain a handle for the remote home object. The handle can be used at
71: * later time to re-obtain a reference to the remote home object, possibly
72: * in a different Java Virtual Machine.
73: * @return A handle for the remote home object.
74: * @throws RemoteException Thrown when the method failed due to a
75: * system-level failure.
76: */
77: HomeHandle getHomeHandle() throws RemoteException;
78:
79: }
|