edu.rice.rubis.beans
Interface Query

All Superinterfaces:
javax.ejb.EJBObject, java.rmi.Remote

public interface Query
extends javax.ejb.EJBObject, java.rmi.Remote

This is the Remote Interface of the Region Bean

Version:
1.1
Author:
Emmanuel Cecchet and Julie Marguerite

Method Summary
 java.util.Vector getCurrentItemsInCategory(java.lang.Integer categoryId, int startingRow, int nbOfRows)
          /** Get all the items that match a specific category and that are still to sell (auction end date is not passed).
 java.util.Vector getCurrentItemsInCategoryAndRegion(java.lang.Integer categoryId, java.lang.Integer regionId, int startingRow, int nbOfRows)
          Get all the items that match a specific category and region and that are still to sell (auction end date is not passed).
 java.util.Vector getItemBidHistory(java.lang.Integer itemId)
          Get the bid history for an item sorted from the last bid to the first bid (oldest one).
 float getItemMaxBid(java.lang.Integer itemId)
          Get the maximum bid (winning bid) for an item.
 int getItemNbOfBids(java.lang.Integer itemId)
          Get the number of bids for an item.
 java.util.Vector getItemQtyMaxBid(int maxToCollect, java.lang.Integer itemId)
          Get the first maxToCollect bids for an item sorted from the maximum to the minimum.
 java.util.Vector getUserBids(java.lang.Integer userId)
          Get all the latest bids for each item the user has bid on.
 java.util.Vector getUserWonItems(java.lang.Integer userId)
          Get all the items the user won in the last 30 days.
 
Methods inherited from interface javax.ejb.EJBObject
getEJBHome, getHandle, getPrimaryKey, isIdentical, remove
 

Method Detail

getCurrentItemsInCategory

public java.util.Vector getCurrentItemsInCategory(java.lang.Integer categoryId,
                                                  int startingRow,
                                                  int nbOfRows)
                                           throws java.rmi.RemoteException
/** Get all the items that match a specific category and that are still to sell (auction end date is not passed). You must select the starting row and number of rows to fetch from the database to get only a limited number of items. For example, returns 25 Books.
Parameters:
categoryId - id of the category you are looking for
regionId - id of the region you are looking for
startingRow - row where result starts (0 if beginning)
nbOfRows - number of rows to get
Returns:
Vector of items primary keys
Since:
1.1

getCurrentItemsInCategoryAndRegion

public java.util.Vector getCurrentItemsInCategoryAndRegion(java.lang.Integer categoryId,
                                                           java.lang.Integer regionId,
                                                           int startingRow,
                                                           int nbOfRows)
                                                    throws java.rmi.RemoteException
Get all the items that match a specific category and region and that are still to sell (auction end date is not passed). You must select the starting row and number of rows to fetch from the database to get only a limited number of items. For example, returns 25 Books to sell in Houston.
Parameters:
categoryId - id of the category you are looking for
regionId - id of the region you are looking for
startingRow - row where result starts (0 if beginning)
nbOfRows - number of rows to get
Returns:
Vector of items primary keys
Since:
1.1

getItemMaxBid

public float getItemMaxBid(java.lang.Integer itemId)
                    throws java.rmi.RemoteException
Get the maximum bid (winning bid) for an item.
Parameters:
itemId - item id
Returns:
maximum bid or 0 if no bid
Throws:
java.rmi.RemoteException - if an error occurs
Since:
1.0

getItemQtyMaxBid

public java.util.Vector getItemQtyMaxBid(int maxToCollect,
                                         java.lang.Integer itemId)
                                  throws java.rmi.RemoteException
Get the first maxToCollect bids for an item sorted from the maximum to the minimum.
Parameters:
maxToCollect - number of bids to collect
itemId - item id
Returns:
Vector of bids primary keys (can be less than maxToCollect)
Throws:
java.rmi.RemoteException - if an error occurs
Since:
1.0

getItemNbOfBids

public int getItemNbOfBids(java.lang.Integer itemId)
                    throws java.rmi.RemoteException
Get the number of bids for an item.
Parameters:
itemId - item id
Returns:
number of bids or 0 if no bid
Throws:
java.rmi.RemoteException - if an error occurs
Since:
1.0

getItemBidHistory

public java.util.Vector getItemBidHistory(java.lang.Integer itemId)
                                   throws java.rmi.RemoteException
Get the bid history for an item sorted from the last bid to the first bid (oldest one).
Parameters:
itemId - item id
Returns:
Vector of bids primary keys or null if no bids
Throws:
java.rmi.RemoteException - if an error occurs
Since:
1.0

getUserBids

public java.util.Vector getUserBids(java.lang.Integer userId)
                             throws java.rmi.RemoteException
Get all the latest bids for each item the user has bid on.
Parameters:
userId - user id
Returns:
Vector of bids primary keys (can be less than maxToCollect)
Throws:
java.rmi.RemoteException - if an error occurs
Since:
1.0

getUserWonItems

public java.util.Vector getUserWonItems(java.lang.Integer userId)
                                 throws java.rmi.RemoteException
Get all the items the user won in the last 30 days.
Parameters:
userId - user id
Returns:
Vector of items primary keys (can be less than maxToCollect)
Throws:
java.rmi.RemoteException - if an error occurs
Since:
1.0


Copyright © 2003 - ObjectWeb Consortium - All Rights Reserved.