1. /*
  2. * Copyright 2002 Sun Microsystems, Inc. All rights reserved.
  3. * SUN PROPRIETARY/CONFIDENTIAL. Use is subject to license terms.
  4. */
  5. package javax.ejb;
  6. /**
  7. * The EJBLocalHome interface must be extended by all enterprise
  8. * Beans' local home interfaces. An enterprise Bean's local home
  9. * interface defines the methods that allow local clients to create,
  10. * find, and remove EJB objects, as well as home business methods that
  11. * are not specific to a bean instance (session Beans do not have
  12. * finders and home business methods).
  13. *
  14. * <p> The local home interface is defined by the enterprise Bean provider
  15. * and implemented by the enterprise Bean container.
  16. */
  17. public interface EJBLocalHome {
  18. /**
  19. * Remove an EJB object identified by its primary key.
  20. *
  21. * <p>This method can only be used by local clients of an entity bean.
  22. * An attempt
  23. * to call this method on a session bean will result in an EJBException.
  24. *
  25. * @exception RemoveException Thrown if the enterprise Bean or
  26. * the container does not allow the client to remove the object.
  27. *
  28. * @exception EJBException Thrown when the method failed due to a
  29. * system-level failure.
  30. *
  31. */
  32. void remove(Object primaryKey) throws RemoveException, EJBException;
  33. }