package edu.rice.rubis.beans;

import java.rmi.RemoteException;
import java.util.Collection;
import javax.ejb.CreateException;
import javax.ejb.EJBLocalHome;
import javax.ejb.FinderException;
import javax.ejb.RemoveException;

/** This is the Local Home interface of the Old Item Bean */

public interface OldItemLocalHome extends EJBLocalHome {
  /**
   * This method is used to create a new Old Item Bean. Note that the item id
   * is automatically generated by the database (AUTO_INCREMENT) on the
   * primary key.
   *
   * @param itemId item identifier
   * @param itemName short item designation
   * @param itemDescription long item description, usually an HTML file
   * @param itemInitialPrice initial price fixed by the seller
   * @param itemQuantity number to sell (of this item)
   * @param itemReservePrice reserve price (minimum price the seller really wants to sell)
   * @param itemBuyNow price if a user wants to buy the item immediatly
   * @param duration duration of the auction in days (start date is when the method is called and end date is computed according to the duration)
   * @param itemSellerId seller id, must match the primary key of table users
   * @param itemCategoryId category id, must match the primary key of table categories
   *
   * @return the Old Item
   */
  public OldItemLocal create(Integer itemId, String itemName, String itemDescription, float itemInitialPrice,
                     int itemQuantity, float itemReservePrice, float itemBuyNow, int duration,
                     Integer itemSellerId, Integer itemCategoryId) throws CreateException, RemoveException;


  /**
   * This method is used to retrieve an Old Item Bean from its primary key,
   * that is to say its id.
   *
   * @param id Old Item id (primary key)
   *
   * @return the Old Item if found else null
   */
  public OldItemLocal findByPrimaryKey(OldItemPK id) throws FinderException;


  /**
   * This method is used to retrieve all OldItem Beans belonging to
   * a seller. You must provide the user id of the seller.
   *
   * @param id User id of the seller
   *
   * @return List of OldItems found (eventually empty)
   */
  public Collection findBySeller(Integer id) throws FinderException;

  /**
   * This method is used to retrieve all OldItem Beans belonging to
   * a specific category. You must provide the category id.
   *
   * @param id Category id
   *
   * @return List of OldItems found (eventually empty)
   */
  public Collection findByCategory(Integer id) throws FinderException;


  /**
   * This method is used to retrieve OldItem Beans belonging to a specific category
   * that are still to sell (auction end date is not passed).
   * You must provide the category id.
   *
   * @param id Category id
   *
   * @return List of OldItems found (eventually empty)
   */
  public Collection findCurrentByCategory(Integer id) throws FinderException;


  /**
   * Get all the items the user is currently selling.
   *
   * @param userId user id
   *
   * @return Vector of items primary keys (can be less than maxToCollect)
   */
  public Collection findUserCurrentSellings(Integer userId) throws FinderException;


 /**
   * Get all the items the user sold in the last 30 days.
   *
   * @param userId user id
   *
   * @return Vector of items primary keys (can be less than maxToCollect)
   */
    public Collection findUserPastSellings(Integer userId) throws FinderException;

  /**
   * This method is used to retrieve all items from the database!
   *
   * @return List of all items (eventually empty)
   */
  public Collection findAllOldItems() throws FinderException;
}