package com.oreilly.jent.people.ejb;

/**
 * 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.EJBObject;

import com.oreilly.jent.people.InvalidSearchException;
import com.oreilly.jent.people.PersistenceException;
import com.oreilly.jent.people.Person;
import com.oreilly.jent.people.SearchArg;

/**
 * Remote client interface for the EJB component
 */
public interface PeopleFinder extends EJBObject {
    /**
     * findPeople: Search the underlying person information using the 
     *   search parameters provided in the arguments.  This method
     *   supports the same search parameters as those supported by the
     *   PersonDAO interface.
     * @param args Search parameters, as an array of SearchArgs.
     * @return Array of Person beans representing the results.
     * @throws InvalidSearchException, PersistenceException or RemoteException
     */
    public Person[] findPeople(SearchArg[] args)
    	    throws InvalidSearchException, PersistenceException, RemoteException;
}