package org.yeeku.service;

import java.util.List;

import org.yeeku.business.*;
import org.yeeku.dao.*;
import org.yeeku.exception.AuctionException;

/**
 * @author  yeeku.H.lee kongyeeku@163.com
 * @version  1.0
 * <br>Copyright (C), 2005-2008, yeeku.H.Lee
 * <br>This program is protected by copyright laws.
 * <br>Program Name:
 * <br>Date: 
 */
public interface AuctionManager  
{
    /**
     * 根據(jù)贏取者查詢物品
     * @param winerId 贏取者id
     * @return 贏取者獲得的全部物品
     */
    List getItemByWiner(int winerId) throws AuctionException;
    /**
     * 查詢?nèi)苛髋牡奈锲?     * @return 全部流拍物品
     */
    List getFailItems() throws AuctionException;
    /**
     * 根據(jù)用戶名，密碼驗證登錄是否成功
     * @param username 登錄所輸入的用戶名
     * @param pass 登錄的密碼
     * @return 全部流拍物品
     */
    Integer validLogin(String username , String pass) throws AuctionException;
    /**
     * 查詢用戶的全部出價
     * @param userId 需查詢的用戶id
     * @return 用戶的全部出價
     */
    List getBidByUser(int userId) throws AuctionException;
	/**
	 * 根據(jù)用戶id查找目前仍在拍賣中的物品
	 * @param userId 用戶id
	 * @return 當(dāng)前用戶所有的全部物品。
	 */
    List getItemsByOwner(int userId) throws AuctionException;

    /**
     * 查詢?nèi)繝顟B(tài)
     * @return 獲得全部種類
     */ 
    List getAllKind()throws AuctionException; 

    /**
     * 添加物品
     * @param name 物品名稱
     * @param desc 物品描述
     * @param remark 物品備注
     * @param avail 有效天數(shù)
     * @param kind 物品種類
     */ 
    void addItem(String name , String desc , String remark , double initPrice , int avail , int kind , int userId) throws AuctionException;

    /**
     * 添加種類
     * @param name 種類名稱
     * @param desc 種類描述
     */ 
    void addKind(String name , String desc ) throws AuctionException;

    /**
     * 根據(jù)產(chǎn)品分類，獲取當(dāng)前拍賣的全部商品
     * @param kindId 種類id;
     * @return 該類的全部產(chǎn)品
     */
    List getItemsByKind(int kindId) throws AuctionException;

    /**
     * 根據(jù)分類id，獲取種類名
     * @param kindId 種類id;
     * @return 該分類的名稱
     */
    String getKind(int kindId) throws AuctionException;
    /**
     * 根據(jù)物品id，獲取物品
     * @param itemId 物品id;
     * @return 該物品的名稱
     */
    ItemBean getItem(int itemId) throws AuctionException;

	/**
	 * 增加新的競價
	 * @param userId 用戶id;
	 * @param itemId 物品id;
	 * @param bidPrice 競價價格
	 */
	void addBid(int userId , int itemId , double bidPrice)throws AuctionException;
	
	/**
	 * 根據(jù)時間來修改物品的贏取者
	 */
	void updateWiner()throws AuctionException;
}