ItemHome


1   package edu.rice.rubis.beans;
2   
3   import java.rmi.RemoteException  ;
4   import java.util.Collection  ;
5   import javax.ejb.CreateException  ;
6   import javax.ejb.EJBHome  ;
7   import javax.ejb.FinderException  ;
8   import javax.ejb.RemoveException  ;
9   
10  /** This is the Home interface of the Item Bean */
11  
12  public interface ItemHome extends EJBHome   {
13    /**
14     * This method is used to create a new Item Bean. Note that the item id
15     * is automatically generated by the database (AUTO_INCREMENT) on the
16     * primary key.
17     *
18     * @param itemName short item designation
19     * @param itemDescription long item description, usually an HTML file
20     * @param itemInitialPrice initial price fixed by the seller
21     * @param itemQuantity number to sell (of this item)
22     * @param itemReservePrice reserve price (minimum price the seller really wants to sell)
23     * @param itemBuyNow price if a user wants to buy the item immediatly
24     * @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)
25     * @param itemSellerId seller id, must match the primary key of table users
26     * @param itemCategoryId category id, must match the primary key of table categories
27     *
28     * @return pk primary key set to null
29     */
30    public Item create(String   itemName, String   itemDescription, float itemInitialPrice,
31                       int itemQuantity, float itemReservePrice, float itemBuyNow, int duration,
32                       Integer   itemSellerId, Integer   itemCategoryId) throws CreateException  , RemoteException  , RemoveException  ;
33  
34  
35    /**
36     * This method is used to retrieve an Item Bean from its primary key,
37     * that is to say its id.
38     *
39     * @param id Item id (primary key)
40     *
41     * @return the Item if found else null
42     */
43    public Item findByPrimaryKey(ItemPK id) throws FinderException  , RemoteException  ;
44  
45  
46    /**
47     * This method is used to retrieve all Item Beans belonging to
48     * a seller. You must provide the user id of the seller.
49     *
50     * @param id User id of the seller
51     *
52     * @return List of Items found (eventually empty)
53     */
54    public Collection   findBySeller(Integer   id) throws RemoteException  , FinderException  ;
55  
56    /**
57     * This method is used to retrieve all Item Beans belonging to
58     * a specific category. You must provide the category id.
59     *
60     * @param id Category id
61     *
62     * @return List of Items found (eventually empty)
63     */
64    public Collection   findByCategory(Integer   id) throws RemoteException  , FinderException  ;
65  
66  
67    /**
68     * This method is used to retrieve Item Beans belonging to a specific category
69     * that are still to sell (auction end date is not passed).
70     * You must provide the category id.
71     *
72     * @param id Category id
73     *
74     * @return List of Items found (eventually empty)
75     */
76    public Collection   findCurrentByCategory(Integer   id) throws RemoteException  , FinderException  ;
77  
78  
79    /**
80     * Get all the items the user is currently selling.
81     *
82     * @param userId user id
83     *
84     * @return Vector of items primary keys (can be less than maxToCollect)
85     * @exception RemoteException if an error occurs
86     */
87    public Collection   findUserCurrentSellings(Integer   userId) throws RemoteException  , FinderException  ;
88  
89  
90   /**
91     * Get all the items the user sold in the last 30 days.
92     *
93     * @param userId user id
94     *
95     * @return Vector of items primary keys (can be less than maxToCollect)
96     * @exception RemoteException if an error occurs
97     */
98      public Collection   findUserPastSellings(Integer   userId) throws RemoteException  , FinderException  ;
99  
100   /**
101    * This method is used to retrieve all items from the database!
102    *
103    * @return List of all items (eventually empty)
104    */
105   public Collection   findAllItems() throws RemoteException  , FinderException  ;
106 }
107
A to Z: JavaDoc & Examples Daily Java News & Articles Open Source Projects Open Source Codes Free Computer Books Remove Frame
Popular Tags