com.bankframe.examples.bo.impl.customer
Class CustomerBMPBean

java.lang.Object
  com.bankframe.examples.bo.customer.CustomerBean
      com.bankframe.examples.bo.impl.customer.CustomerBean
          com.bankframe.examples.bo.impl.customer.CustomerBMPBean

All Implemented Interfaces:

EBMPEntity, EBMPMasterEntity, EEntity, Serializable, EnterpriseBean, EntityBean

public class CustomerBMPBean
extends CustomerBean
implements EntityBean, EBMPMasterEntity

This class is the implementation of the Customer Entity EJB using bean managed persistence.

See Also:

Serialized Form

Field Summary

Fields inherited from class com.bankframe.examples.bo.customer.CustomerBean

firstName, lastName, ownerId, title

Fields inherited from interface com.bankframe.ejb.EEntity

serialVersionUID

Constructor Summary

CustomerBMPBean()
Default constructor.

Method Summary

void	amend(String title, String firstName, String lastName) This method amends the attributes of the customer entity.
Address	amendAddress(String addressLine1, String addressLine2, String addressLine3, String addressLine4, String country, String postCode) This method amends the address entity associated with this customer entity.
EPrimaryKey	createPrimaryKey(DataPacket dp) This method builds a primary from a given DataPacket.
void	ejbActivate() This method is called by the EJB container when this EJB instance is activated.
CustomerPK	ejbCreate(String ownerId, String title, String firstName, String lastName) This method initialises a new instance of the customer entity.
Enumeration	ejbFindAll() This method gets all instances of this EJB
Enumeration	ejbFindByFirstName(String firstName) This method get all instance of this EJB with the given first name
Enumeration	ejbFindByLastName(String lastName) This method get all instance of this EJB with the given last name
CustomerPK	ejbFindByPrimaryKey(CustomerPK primaryKey) This method verifies that the specified customer instance exists.
Enumeration	ejbFindByTitle(String title) This method get all instance of this EJB with the given title.
void	ejbLoad() This method is called by the EJB container when this EJB instance must refresh itself from persistent storage.
void	ejbPassivate() This method is called by the EJB container when this EJB instance is passivated.
void	ejbPostCreate(String ownerId, String title, String firstName, String lastName)
void	ejbRemove() This method is called by the EJB container when this EJB instance must be deleted from persistent storage.
void	ejbStore() This method is called by the EJB contain when this EJB instance must store its attributes in persistent storage.
Vector	getDependentEntities() This method gets all entity beans that depend on this EJB.
String	getEntityName() This method gets the JNDI name of this entity.
EPersister	getPersister() This method retrieves the persister to use with this entity bean instance.
EPrimaryKey	getPrimaryKey() This method returns the primary key object for this entity instance.
void	populate(DataPacket dp) This method populates the attributes of the entity instance with the specified data.
void	setEntityContext(EntityContext newCtx) This method is called by the EJB container when the EJB instance is about to be used.
void	unsetEntityContext() This method is called by the EJB container when the EJB instance is no longer being used.

Methods inherited from class com.bankframe.examples.bo.impl.customer.CustomerBean

getAddress, toDataPacket

Methods inherited from class com.bankframe.examples.bo.customer.CustomerBean

create, getFirstName, getLastName, getOwnerId, getTitle

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface com.bankframe.ejb.EEntity

toDataPacket

Constructor Detail

CustomerBMPBean

public CustomerBMPBean()

Default constructor.

Method Detail

amend

public void amend(String title,
                  String firstName,
                  String lastName)
           throws ValidationException

This method amends the attributes of the customer entity.

Overrides:

amend in class CustomerBean

Parameters:

title -

firstName -

lastName -

Throws:

ValidationException

amendAddress

public Address amendAddress(String addressLine1,
                            String addressLine2,
                            String addressLine3,
                            String addressLine4,
                            String country,
                            String postCode)
                     throws ProcessingErrorException,
                            ValidationException,
                            RemoteException

This method amends the address entity associated with this customer entity.

Overrides:

amendAddress in class CustomerBean

Parameters:

addressLine1 -

addressLine2 -

addressLine3 -

addressLine4 -

country -

postCode -

Throws:

ProcessingErrorException

RemoteException

ValidationException

createPrimaryKey

public EPrimaryKey createPrimaryKey(DataPacket dp)
                             throws ProcessingErrorException

This method builds a primary from a given DataPacket.

Specified by:

createPrimaryKey in interface EBMPEntity

Parameters:

dp - the DataPacket to create the key from

Returns:

a primary key instance from the specified data

Throws:

ProcessingErrorException - if processing fails.

ejbActivate

public void ejbActivate()

This method is called by the EJB container when this EJB instance is activated.

Specified by:

ejbActivate in interface EntityBean

ejbCreate

public CustomerPK ejbCreate(String ownerId,
                            String title,
                            String firstName,
                            String lastName)
                     throws CreateException,
                            ValidationException,
                            ProcessingErrorException

This method initialises a new instance of the customer entity.

Parameters:

ownerId -

title -

firstName -

lastName -

Returns:

The key to this entity

Throws:

CreateException

ProcessingErrorException

ValidationException

ejbFindAll

public Enumeration ejbFindAll()
                       throws FinderException,
                              ValidationException

This method gets all instances of this EJB

Returns:

an enumeration of all instances of the customer entity

Throws:

FinderException

ValidationException

ejbFindByFirstName

public Enumeration ejbFindByFirstName(String firstName)
                               throws FinderException,
                                      ValidationException

This method get all instance of this EJB with the given first name

Parameters:

firstName - the first name of the customers to retrieve

Returns:

an enumeration of all instances of the customer entity with the specified first name

Throws:

FinderException

ValidationException

ejbFindByLastName

public Enumeration ejbFindByLastName(String lastName)
                              throws FinderException,
                                     ValidationException

This method get all instance of this EJB with the given last name

Parameters:

lastName - the last name of the customers to retrieve

Returns:

an enumeration of all instances of the customer entity with the specified last name

Throws:

FinderException

ValidationException

ejbFindByPrimaryKey

public CustomerPK ejbFindByPrimaryKey(CustomerPK primaryKey)
                               throws FinderException,
                                      ValidationException

This method verifies that the specified customer instance exists.

Parameters:

primaryKey - the primary to check if it exists

Returns:

the primary key of the customer

Throws:

FinderException

ValidationException

ejbFindByTitle

public Enumeration ejbFindByTitle(String title)
                           throws FinderException,
                                  ValidationException

This method get all instance of this EJB with the given title.

Parameters:

title - of the customers to retrieve

Returns:

an enumeration of all instances of the customer entity with the specified title

Throws:

FinderException

ValidationException

ejbLoad

public void ejbLoad()

This method is called by the EJB container when this EJB instance must refresh itself from persistent storage.

Specified by:

ejbLoad in interface EntityBean

ejbPassivate

public void ejbPassivate()

This method is called by the EJB container when this EJB instance is passivated.

Specified by:

ejbPassivate in interface EntityBean

ejbPostCreate

public void ejbPostCreate(String ownerId,
                          String title,
                          String firstName,
                          String lastName)

ejbRemove

public void ejbRemove()

This method is called by the EJB container when this EJB instance must be deleted from persistent storage.

Specified by:

ejbRemove in interface EntityBean

ejbStore

public void ejbStore()

This method is called by the EJB contain when this EJB instance must store its attributes in persistent storage.

Specified by:

ejbStore in interface EntityBean

getDependentEntities

public Vector getDependentEntities()
                            throws ProcessingErrorException,
                                   RemoteException

This method gets all entity beans that depend on this EJB.

Specified by:

getDependentEntities in interface EBMPMasterEntity

Returns:

a vector od entity instances that depend on this EJB

Throws:

ProcessingErrorException

RemoteException

getEntityName

public String getEntityName()

This method gets the JNDI name of this entity.

Specified by:

getEntityName in interface EBMPEntity

Returns:

the JNDI name of this entity

getPersister

public EPersister getPersister()

This method retrieves the persister to use with this entity bean instance.

Specified by:

getPersister in interface EBMPEntity

Returns:

the persiter to use with this ejb

getPrimaryKey

public EPrimaryKey getPrimaryKey()

This method returns the primary key object for this entity instance.

Specified by:

getPrimaryKey in interface EBMPEntity

Returns:

the primary key of this entity

populate

public void populate(DataPacket dp)

This method populates the attributes of the entity instance with the specified data.

Specified by:

populate in interface EBMPEntity

Parameters:

dp - The DataPacket to populate with

setEntityContext

public void setEntityContext(EntityContext newCtx)

This method is called by the EJB container when the EJB instance is about to be used.

Specified by:

setEntityContext in interface EntityBean

unsetEntityContext

public void unsetEntityContext()

This method is called by the EJB container when the EJB instance is no longer being used.

Specified by:

unsetEntityContext in interface EntityBean