edu.rice.rubis.beans
Class RegionBean

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

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

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

 CREATE TABLE regions (
    id   INTEGER UNSIGNED NOT NULL UNIQUE
    name VARCHAR(20),
    PRIMARY KEY(id)
 );
 

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

Field Summary
 java.lang.Integer id
           
 java.lang.String name
           
 
Constructor Summary
RegionBean()
           
 
Method Summary
 void ejbActivate()
          Mandatory methods
 RegionPK ejbCreate(java.lang.String regionName)
          This method is used to create a new Region Bean and insert a record in the database.
 java.util.Collection ejbFindAllRegions()
          This method is used to retrieve all categories from the database!
 RegionPK ejbFindByName(java.lang.String regionName)
          This method is used to retrieve a Region Bean from its name.
 RegionPK ejbFindByPrimaryKey(RegionPK id)
          This method is used to retrieve a Region Bean from its primary key, that is to say its id.
 void ejbLoad()
          Read the reccord from the database and update the bean.
 void ejbPassivate()
           
 void ejbPostCreate(java.lang.String regionName)
          This method does currently nothing
 void ejbRemove()
          This method delete the record from the database.
 void ejbStore()
          Update the record.
 java.sql.Connection getConnection()
          Retrieve a connection..
 java.lang.Integer getId()
          Get region's id.
 java.lang.String getName()
          Get region name.
 void setEntityContext(javax.ejb.EntityContext context)
          Sets the associated entity context.
 void setName(java.lang.String newName)
          Set region's name
 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

name

public java.lang.String name
Constructor Detail

RegionBean

public RegionBean()
Method Detail

getId

public java.lang.Integer getId()
                        throws java.rmi.RemoteException
Get region's id.
Returns:
region id
Throws:
java.rmi.RemoteException - if an error occurs

getName

public java.lang.String getName()
                         throws java.rmi.RemoteException
Get region name.
Returns:
region name
Throws:
java.rmi.RemoteException - if an error occurs

setName

public void setName(java.lang.String newName)
             throws java.rmi.RemoteException
Set region's name
Parameters:
newName - region name
Throws:
java.rmi.RemoteException - if an error occurs

getConnection

public java.sql.Connection getConnection()
                                  throws java.lang.Exception
Retrieve a connection..
Returns:
connection
Throws:
java.lang.Exception - if an error occurs

ejbFindByPrimaryKey

public RegionPK ejbFindByPrimaryKey(RegionPK id)
                             throws javax.ejb.FinderException,
                                    java.rmi.RemoteException
This method is used to retrieve a Region Bean from its primary key, that is to say its id.
Parameters:
id - Region id (primary key)
Returns:
the Region if found else null
Throws:
javax.ejb.FinderException - if an error occurs
java.rmi.RemoteException - if an error occurs

ejbFindByName

public RegionPK ejbFindByName(java.lang.String regionName)
                       throws javax.ejb.FinderException,
                              java.rmi.RemoteException
This method is used to retrieve a Region Bean from its name.
Parameters:
regionName - Region name
Returns:
the Region if found else null
Throws:
javax.ejb.FinderException - if an error occurs
java.rmi.RemoteException - if an error occurs

ejbFindAllRegions

public java.util.Collection ejbFindAllRegions()
                                       throws java.rmi.RemoteException,
                                              javax.ejb.FinderException
This method is used to retrieve all categories from the database!
Returns:
List of all categories (eventually empty)
Throws:
java.rmi.RemoteException - if an error occurs
javax.ejb.FinderException - if an error occurs

ejbCreate

public RegionPK ejbCreate(java.lang.String regionName)
                   throws javax.ejb.CreateException,
                          java.rmi.RemoteException,
                          javax.ejb.RemoveException
This method is used to create a new Region Bean and insert a record in the database.
Parameters:
regionName - Region name
Returns:
pk primary key set to null
Throws:
javax.ejb.CreateException - if an error occurs
java.rmi.RemoteException - if an error occurs
javax.ejb.RemoveException - if an error occurs

ejbPostCreate

public void ejbPostCreate(java.lang.String regionName)
This method does currently nothing

ejbActivate

public void ejbActivate()
                 throws java.rmi.RemoteException
Mandatory methods
Specified by:
ejbActivate in interface javax.ejb.EntityBean

ejbPassivate

public void ejbPassivate()
                  throws java.rmi.RemoteException
Specified by:
ejbPassivate in interface javax.ejb.EntityBean

ejbRemove

public void ejbRemove()
               throws java.rmi.RemoteException,
                      javax.ejb.RemoveException
This method delete the record from the database.
Specified by:
ejbRemove in interface javax.ejb.EntityBean
Throws:
java.rmi.RemoteException - if an error occurs
javax.ejb.RemoveException - if an error occurs

ejbStore

public void ejbStore()
              throws java.rmi.RemoteException
Update the record.
Specified by:
ejbStore in interface javax.ejb.EntityBean
Throws:
java.rmi.RemoteException - if an error occurs

ejbLoad

public void ejbLoad()
             throws java.rmi.RemoteException
Read the reccord from the database and update the bean.
Specified by:
ejbLoad in interface javax.ejb.EntityBean
Throws:
java.rmi.RemoteException - if an error occurs

setEntityContext

public void setEntityContext(javax.ejb.EntityContext context)
                      throws java.rmi.RemoteException
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.
java.rmi.RemoteException - - This exception is defined in the method signature to provide backward compatibility for enterprise beans written for the EJB 1.0 specification. Enterprise beans written for the EJB 1.1 and higher specification should throw the javax.ejb.EJBException instead of this exception.

unsetEntityContext

public void unsetEntityContext()
                        throws java.rmi.RemoteException
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.
java.rmi.RemoteException - - This exception is defined in the method signature to provide backward compatibility for enterprise beans written for the EJB 1.0 specification. Enterprise beans written for the EJB 1.1 and higher specification should throw the javax.ejb.EJBException instead of this exception.


Copyright © 2003 - ObjectWeb Consortium - All Rights Reserved.