KickJava   Java API By Example, From Geeks To Geeks.

Java > Open Source Codes > edu > rice > rubis > beans > OldItemLocal


1 package edu.rice.rubis.beans;
2
3 import javax.ejb.*;
4 import java.rmi.*;
5
6 /**
7  * This is the Local Interface of the Old Item Bean.
8  * @author <a HREF="mailto:cecchet@rice.edu">Emmanuel Cecchet</a> and <a HREF="mailto:julie.marguerite@inrialpes.fr">Julie Marguerite</a>
9  * @version 1.1
10  */
11 public interface OldItemLocal extends EJBLocalObject {
12   /**
13    * Get item id.
14    *
15    * @return item id
16    * @since 1.0
17    */
18   public Integer JavaDoc getId();
19
20   /**
21    * Get item name. This description is usually a short description of the item.
22    *
23    * @return item name
24    * @since 1.0
25    */
26   public String JavaDoc getName();
27
28   /**
29    * Get item description . This is usually an HTML file describing the item.
30    *
31    * @return item description
32    * @since 1.0
33    */
34   public String JavaDoc getDescription();
35
36   /**
37    * Get item initial price set by the seller.
38    *
39    * @return item initial price
40    * @since 1.0
41    */
42   public float getInitialPrice();
43
44   /**
45    * Get how many of this item are to be sold.
46    *
47    * @return item quantity
48    * @since 1.0
49    */
50   public int getQuantity();
51
52   /**
53    * Get item reserve price set by the seller. The seller can refuse to sell if reserve price is not reached.
54    *
55    * @return item reserve price
56    * @since 1.0
57    */
58   public float getReservePrice();
59
60   /**
61    * Get item Buy Now price set by the seller. A user can directly by the item at this price (no auction).
62    *
63    * @return item Buy Now price
64    * @since 1.0
65    */
66   public float getBuyNow();
67
68   /**
69    * Get item maximum bid (if any) for this item. This value should be the same as doing <pre>SELECT MAX(bid) FROM bids WHERE item_id=?</pre>
70    *
71    * @return current maximum bid or 0 if no bid
72    * @since 1.1
73    */
74   public float getMaxBid();
75
76   /**
77    * Get number of bids for this item. This value should be the same as doing <pre>SELECT COUNT(*) FROM bids WHERE item_id=?</pre>
78    *
79    * @return number of bids
80    * @since 1.1
81    */
82   public int getNbOfBids();
83
84   /**
85    * Start date of the auction in the format 'YYYY-MM-DD hh:mm:ss'
86    *
87    * @return start date of the auction
88    * @since 1.0
89    */
90   public String JavaDoc getStartDate();
91
92   /**
93    * End date of the auction in the format 'YYYY-MM-DD hh:mm:ss'
94    *
95    * @return end date of the auction
96    * @since 1.0
97    */
98   public String JavaDoc getEndDate();
99
100   /**
101    * Give the user id of the seller
102    *
103    * @return seller's user id
104    * @since 1.0
105    */
106   public Integer JavaDoc getSellerId();
107
108   /**
109    * Give the category id of the item
110    *
111    * @return item's category id
112    * @since 1.0
113    */
114   public Integer JavaDoc getCategoryId();
115
116   /**
117    * Get the seller's nickname by finding the Bean corresponding
118    * to the user.
119    *
120    * @return nickname
121    * @since 1.0
122    */
123   public String JavaDoc getSellerNickname();
124
125   /**
126    * Get the category name by finding the Bean corresponding to the category Id.
127    *
128    * @return category name
129    * @since 1.0
130    */
131   public String JavaDoc getCategoryName();
132
133
134   /**
135    * Set a new item identifier
136    *
137    * @param newId item identifier
138    * @since 1.0
139    */
140   public void setId(Integer JavaDoc newId);
141
142   /**
143    * Set a new item name
144    *
145    * @param newName item name
146    * @since 1.0
147    */
148   public void setName(String JavaDoc newName);
149
150   /**
151    * Set a new item description
152    *
153    * @param newDescription item description
154    * @since 1.0
155    */
156   public void setDescription(String JavaDoc newDescription);
157
158   /**
159    * Set a new initial price for the item
160    *
161    * @param newInitialPrice item initial price
162    * @since 1.0
163    */
164   public void setInitialPrice(float newInitialPrice);
165
166   /**
167    * Set a new item quantity
168    *
169    * @param qty item quantity
170    * @since 1.0
171    */
172   public void setQuantity(int qty);
173
174   /**
175    * Set a new reserve price for the item
176    *
177    * @param newReservePrice item reserve price
178    * @since 1.0
179    */
180   public void setReservePrice(float newReservePrice);
181
182   /**
183    * Set a new Buy Now price for the item
184    *
185    * @param newBuyNow item Buy Now price
186    * @since 1.0
187    */
188   public void setBuyNow(float newBuyNow);
189
190   /**
191    * Set item maximum bid
192    *
193    * @param newMaxBid new maximum bid
194    * @since 1.1
195    */
196   public void setMaxBid(float newMaxBid);
197
198   /**
199    * Set the number of bids for this item
200    *
201    * @param newNbOfBids new number of bids
202    * @since 1.1
203    */
204   public void setNbOfBids(int newNbOfBids);
205
206   /**
207    * Add one bid for this item
208    *
209    * @since 1.1
210    */
211   public void addOneBid();
212
213   /**
214    * Set a new beginning date for the auction
215    *
216    * @param newDate auction new beginning date
217    * @since 1.0
218    */
219   public void setStartDate(String JavaDoc newDate);
220
221   /**
222    * Set a new ending date for the auction
223    *
224    * @param newDate auction new ending date
225    * @since 1.0
226    */
227   public void setEndDate(String JavaDoc newDate);
228
229   /**
230    * Set a new seller identifier. This id must match
231    * the primary key of the users table.
232    *
233    * @param id seller id
234    * @since 1.0
235    */
236   public void setSellerId(Integer JavaDoc id);
237
238   /**
239    * Set a new category identifier. This id must match
240    * the primary key of the category table.
241    *
242    * @param id category id
243    * @since 1.0
244    */
245   public void setCategoryId(Integer JavaDoc id);
246 }
247
Popular Tags