package com.oreilly.jent.annotation.xdoclet.soap;

/**
 * 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 java.sql.Connection;
import java.util.Collection;
import java.util.HashMap;
import java.util.Iterator;
import java.util.Map;

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

/**
 * PeopleFinderImpl: Implementation of our remote PeopleFinder interface.
 * 
 * XDoclet tags:
 * 
 * @web.servlet
 *     name="PeopleFinderService"
 */
public class PeopleFinderImpl {

    public PeopleFinderImpl() throws RemoteException {}
    /**
     * Implementation of findPeople.  Here we simply invoke our PersonDAO
     * to perform the search using whatever information source it's configured
     * to use.
     * 
     * @web.interface-method
     *     
     */
    public Person[] findPeople(SearchArg[] args)
    	throws InvalidSearchException, PersistenceException, RemoteException {
        PersonDAO dao = PersonDAO.getInstance();
        Map searchParamsMap = new HashMap();
        for (int i = 0; i < args.length; i++) {
            searchParamsMap.put(args[i].getName(), args[i].getValue());
        }
        Collection people = dao.findPeople(searchParamsMap);
        Person[] peopleArray = new Person[people.size()];
        Iterator pIter = people.iterator();
        int i = 0;
        while (pIter.hasNext()) {
            peopleArray[i++] = (Person)pIter.next();
        }
        return peopleArray;
    }
    
    /**
     * @web.interface-method
     */
    public Person findPerson(String id) 
      throws InvalidSearchException, PersistenceException, RemoteException {
      return null;  
    }
    
    /** Utility method for retrieving a database connection */
    private Connection getConnection() {
        return null;
    }
}