edu.rice.rubis.beans
Class BidBean

java.lang.Object
  |
  +--edu.rice.rubis.beans.BidBean
All Implemented Interfaces:
javax.ejb.EnterpriseBean, javax.ejb.EntityBean, java.io.Serializable

public class BidBean
extends java.lang.Object
implements javax.ejb.EntityBean

BidBean is an entity bean with "container managed persistence". The state of an instance is stored into a relational database. The following table should exist:

 CREATE TABLE bids (
    id      INTEGER UNSIGNED NOT NULL UNIQUE,
    user_id INTEGER,
    item_id INTEGER,
    qty     INTEGER,
    bid     FLOAT UNSIGNED NOT NULL,
    max_bid FLOAT UNSIGNED NOT NULL,
    date    DATETIME
   INDEX item (item_id),
   INDEX user (user_id)
 );
 

Version:
1.0
Author:
Emmanuel Cecchet and Julie Marguerite
See Also:
Serialized Form

Field Summary
 float bid
           
 java.lang.String date
           
 java.lang.Integer id
           
 java.lang.Integer itemId
           
 float maxBid
           
 int qty
           
 java.lang.Integer userId
           
 
Constructor Summary
BidBean()
           
 
Method Summary
 void ejbActivate()
          This method is empty because persistence is managed by the container
 BidPK ejbCreate(java.lang.Integer bidUserId, java.lang.Integer bidItemId, float userBid, float userMaxBid, int quantity)
          This method is used to create a new Bid Bean.
 void ejbLoad()
          Persistence is managed by the container and the bean becomes up to date
 void ejbPassivate()
          This method is empty because persistence is managed by the container
 void ejbPostCreate(java.lang.Integer bidUserId, java.lang.Integer bidItemId, float userBid, float userMaxBid, int quantity)
          This method just set an internal flag to reload the id generated by the DB
 void ejbRemove()
          This method is empty because persistence is managed by the container
 void ejbStore()
          Persistence is managed by the container and the bean becomes up to date
 float getBid()
          Get the bid of the user.
 java.lang.String getBidderNickName()
          Give the nick name of the bidder
 java.lang.String getDate()
          Time of the Bid in the format 'YYYY-MM-DD hh:mm:ss'
 java.lang.Integer getId()
          Get bid's id.
 java.lang.Integer getItemId()
          Get the item id which is the primary key in the items table.
 float getMaxBid()
          Get the maximum bid wanted by the user.
 int getQuantity()
          Get how many of this item the user wants.
 java.lang.Integer getUserId()
          Get the user id which is the primary key in the users table.
 boolean isModified()
          Returns true if the beans has been modified.
 java.lang.String printBidHistory()
          Display bid history information as an HTML table row
 void setBid(float newBid)
          Set a new bid on the item for the user.
 void setDate(java.lang.String newDate)
          Set a new date for this bid
 void setEntityContext(javax.ejb.EntityContext context)
          Sets the associated entity context.
 void setItemId(java.lang.Integer id)
          Set a new item identifier.
 void setMaxBid(float newBid)
          Set a new maximum bid on the item for the user
 void setQuantity(int Qty)
          Set a new quantity for this bid
 void setUserId(java.lang.Integer id)
          Set a new user identifier.
 void unsetEntityContext()
          Unsets the associated entity context.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

id

public java.lang.Integer id

userId

public java.lang.Integer userId

itemId

public java.lang.Integer itemId

qty

public int qty

bid

public float bid

maxBid

public float maxBid

date

public java.lang.String date
Constructor Detail

BidBean

public BidBean()
Method Detail

getId

public java.lang.Integer getId()
Get bid's id.
Returns:
bid id

getUserId

public java.lang.Integer getUserId()
Get the user id which is the primary key in the users table.
Returns:
user id

getItemId

public java.lang.Integer getItemId()
Get the item id which is the primary key in the items table.
Returns:
item id

getQuantity

public int getQuantity()
Get how many of this item the user wants.
Returns:
quantity of items for this bid.

getBid

public float getBid()
Get the bid of the user.
Returns:
user's bid

getMaxBid

public float getMaxBid()
Get the maximum bid wanted by the user.
Returns:
user's maximum bid

getDate

public java.lang.String getDate()
Time of the Bid in the format 'YYYY-MM-DD hh:mm:ss'
Returns:
bid time

getBidderNickName

public java.lang.String getBidderNickName()
Give the nick name of the bidder
Returns:
bidder's nick name

setUserId

public void setUserId(java.lang.Integer id)
Set a new user identifier. This id must match the primary key of the users table.
Parameters:
id - user id

setItemId

public void setItemId(java.lang.Integer id)
Set a new item identifier. This id must match the primary key of the items table.
Parameters:
id - item id

setQuantity

public void setQuantity(int Qty)
Set a new quantity for this bid
Parameters:
Qty - quantity

setBid

public void setBid(float newBid)
Set a new bid on the item for the user.
 Warning! This method does not update the maxBid value in the items table
 
Parameters:
newBid - a float value

setMaxBid

public void setMaxBid(float newBid)
Set a new maximum bid on the item for the user
Parameters:
newBid - a float value

setDate

public void setDate(java.lang.String newDate)
Set a new date for this bid
Parameters:
newDate - bid date

ejbCreate

public BidPK ejbCreate(java.lang.Integer bidUserId,
                       java.lang.Integer bidItemId,
                       float userBid,
                       float userMaxBid,
                       int quantity)
                throws javax.ejb.CreateException
This method is used to create a new Bid Bean. The date is automatically set to the current date when the method is called.
Parameters:
bidUserId - user id of the bidder, must match the primary key of table users
bidItemId - item id, must match the primary key of table items
userBid - the amount of the user bid
userMaxBid - the maximum amount the user wants to bid
quantity - number of items the user wants to buy
Returns:
pk primary key set to null
Throws:
javax.ejb.CreateException - if an error occurs

ejbPostCreate

public void ejbPostCreate(java.lang.Integer bidUserId,
                          java.lang.Integer bidItemId,
                          float userBid,
                          float userMaxBid,
                          int quantity)
This method just set an internal flag to reload the id generated by the DB

ejbLoad

public void ejbLoad()
Persistence is managed by the container and the bean becomes up to date
Specified by:
ejbLoad in interface javax.ejb.EntityBean

ejbStore

public void ejbStore()
Persistence is managed by the container and the bean becomes up to date
Specified by:
ejbStore in interface javax.ejb.EntityBean

ejbActivate

public void ejbActivate()
This method is empty because persistence is managed by the container
Specified by:
ejbActivate in interface javax.ejb.EntityBean

ejbPassivate

public void ejbPassivate()
This method is empty because persistence is managed by the container
Specified by:
ejbPassivate in interface javax.ejb.EntityBean

ejbRemove

public void ejbRemove()
This method is empty because persistence is managed by the container
Specified by:
ejbRemove in interface javax.ejb.EntityBean

setEntityContext

public void setEntityContext(javax.ejb.EntityContext context)
Sets the associated entity context. The container invokes this method on an instance after the instance has been created. This method is called in an unspecified transaction context.
Specified by:
setEntityContext in interface javax.ejb.EntityBean
Parameters:
context - An EntityContext interface for the instance. The instance should store the reference to the context in an instance variable.
Throws:
javax.ejb.EJBException - Thrown by the method to indicate a failure caused by a system-level error.

unsetEntityContext

public void unsetEntityContext()
Unsets the associated entity context. The container calls this method before removing the instance. This is the last method that the container invokes on the instance. The Java garbage collector will eventually invoke the finalize() method on the instance. This method is called in an unspecified transaction context.
Specified by:
unsetEntityContext in interface javax.ejb.EntityBean
Throws:
javax.ejb.EJBException - Thrown by the method to indicate a failure caused by a system-level error.

isModified

public boolean isModified()
Returns true if the beans has been modified. It prevents the EJB server from reloading a bean that has not been modified.
Returns:
a boolean value

printBidHistory

public java.lang.String printBidHistory()
Display bid history information as an HTML table row
Returns:
a String containing HTML code
Since:
1.0


Copyright © 2003 - ObjectWeb Consortium - All Rights Reserved.