package com.oreilly.jent.ejb.containerManaged;

/**
 * In general, you may use the code in this book in your programs and 
 * documentation. You do not need to contact us for permission unless 
 * you're reproducing a significant portion of the code. For example, 
 * writing a program that uses several chunks of code from this book does 
 * not require permission. Selling or distributing a CD-ROM of examples 
 * from O'Reilly books does require permission. Answering a question by 
 * citing this book and quoting example code does not require permission. 
 * Incorporating a significant amount of example code from this book into 
 * your product's documentation does require permission.
 * 
 * We appreciate, but do not require, attribution. An attribution usually 
 * includes the title, author, publisher, and ISBN. For example: 
 * 
 *   "Java Enterprise in a Nutshell, Third Edition, 
 *    by Jim Farley and William Crawford 
 *    with Prakash Malani, John G. Norman, and Justin Gehtland. 
 *    Copyright 2006 O'Reilly Media, Inc., 0-596-10142-2."
 *  
 *  If you feel your use of code examples falls outside fair use or the 
 *  permission given above, feel free to contact us at 
 *  permissions@oreilly.com.
 */

import java.rmi.RemoteException;

import javax.ejb.CreateException;
import javax.ejb.EJBHome;
import javax.ejb.FinderException;

import com.oreilly.jent.ejb.NoSuchPersonException;
import com.oreilly.jent.ejb.Person;

// The "home" interface for the PersonBean.  This interface provides
// methods used to create beans on the server.  The container provider is
// responsible for implementing this interface, most likely using
// auto-generated Java classes derived from the interface bytecodes.
public interface PersonHome extends EJBHome {
  // Create a new (nameless) person
  public Person create() throws CreateException, RemoteException;

  // Create a named person.
  public Person create(String name, String fname, String lname)
    throws NoSuchPersonException, CreateException, RemoteException;

  // Lookup a Person by name (the primary key)
  public Person findByPrimaryKey(String name)
    throws RemoteException, FinderException;
}
