jobmatch.data
Class CountryBDO

java.lang.Object
  |
  +--jobmatch.data.CountryBDO

Direct Known Subclasses:

Country

public class CountryBDO

extends Object

implements Serializable

CountryBDO contains the same set and get methods as the CountryDO class. Business Object (BO) classes typically need these set and get methods. So by deriving a BO from a BDO, or by implementing a BO that contains a BDO, the developer of the BO is spared some work.

Version:

$Revision: 1.7 $

See Also:

Serialized Form

Field Summary

protected CountryDO

DO The CountryDO object upon which the set and get methods operate.

Constructor Summary

CountryBDO()
Constructor required by CountryBDO.create methods.

CountryBDO(CountryDO DO)
Constructor for use by classes derived from CountryBDO.

Method Summary

void	addAdressBDO(AdressBDO rbdo) Add (set & commit) a AdressBDO object whose AdressDO refers to the DO held by this BDO.
void	addAdressBDO(AdressBDO rbdo, jobmatch.data.DBTransaction tran) Add (set & commit) a AdressBDO object whose AdressDO refers to the DO held by this BDO.
void	addCandidateBDO(CandidateBDO rbdo) Add (set & commit) a CandidateBDO object whose CandidateDO refers to the DO held by this BDO.
void	addCandidateBDO(CandidateBDO rbdo, jobmatch.data.DBTransaction tran) Add (set & commit) a CandidateBDO object whose CandidateDO refers to the DO held by this BDO.
void	addPersonalProfileBDO(PersonalProfileBDO rbdo) Add (set & commit) a PersonalProfileBDO object whose PersonalProfileDO refers to the DO held by this BDO.
void	addPersonalProfileBDO(PersonalProfileBDO rbdo, jobmatch.data.DBTransaction tran) Add (set & commit) a PersonalProfileBDO object whose PersonalProfileDO refers to the DO held by this BDO.
void	addPersonBDO(PersonBDO rbdo) Add (set & commit) a PersonBDO object whose PersonDO refers to the DO held by this BDO.
void	addPersonBDO(PersonBDO rbdo, jobmatch.data.DBTransaction tran) Add (set & commit) a PersonBDO object whose PersonDO refers to the DO held by this BDO.
protected void	afterAnySet()
protected void	beforeAnyGet() The developer of a Business Object that derives from this class can override the methods: beforeAnyGet beforeAnySet afterAnySet to handle any general assertions or cleanup needed for get and set methods.
protected void	beforeAnySet()
void	commit() Inserts/Updates the DO into its table.
void	commit(jobmatch.data.DBTransaction dbt) Inserts/Updates the DO into its table.
static CountryBDO	createExisting(CountryDO DO) The createExisting method is used to create a CountryBDO from a CountryDO that was returned by the CountryQuery class.
static CountryBDO	createVirgin() Like the class CountryDO, this class acts as a factory.
void	delete() Deletes the DO from its table.
void	delete(jobmatch.data.DBTransaction dbt) Deletes the DO from its table.
AdressBDO	getAdressBDO() Get the single AdressBDO object holding a AdressDO object that refers to the DO held by this BDO.
AdressBDO[]	getAdressBDOArray() Get array of AdressBDO objects holding AdressDO objects that refer to the DO held by this BDO.
AdressDO	getAdressDO() Get the single AdressDO object that refers to the DO held by this BDO.
AdressDO[]	getAdressDOArray() Get array of AdressDO objects that refer to the DO held by this BDO.
static CountryBDO[]	getBDOarray() The getBDOarray method performs a database query to return an array of CountryBDO objects representing all the rows in the Country table.
CandidateBDO	getCandidateBDO() Get the single CandidateBDO object holding a CandidateDO object that refers to the DO held by this BDO.
CandidateBDO[]	getCandidateBDOArray() Get array of CandidateBDO objects holding CandidateDO objects that refer to the DO held by this BDO.
CandidateDO	getCandidateDO() Get the single CandidateDO object that refers to the DO held by this BDO.
CandidateDO[]	getCandidateDOArray() Get array of CandidateDO objects that refer to the DO held by this BDO.
String	getDescription() Get Description of the CountryDO
CountryDO	getDO() Note: This method is intended for use only by other BDO classes.
String	getHandle() The methods getHandle hasMatchingHandle are used by Presentation Objects that need to populate HTML select lists with CountryBDO objects as options.
PersonalProfileBDO	getPersonalProfileBDO() Get the single PersonalProfileBDO object holding a PersonalProfileDO object that refers to the DO held by this BDO.
PersonalProfileBDO[]	getPersonalProfileBDOArray() Get array of PersonalProfileBDO objects holding PersonalProfileDO objects that refer to the DO held by this BDO.
PersonalProfileDO	getPersonalProfileDO() Get the single PersonalProfileDO object that refers to the DO held by this BDO.
PersonalProfileDO[]	getPersonalProfileDOArray() Get array of PersonalProfileDO objects that refer to the DO held by this BDO.
PersonBDO	getPersonBDO() Get the single PersonBDO object holding a PersonDO object that refers to the DO held by this BDO.
PersonBDO[]	getPersonBDOArray() Get array of PersonBDO objects holding PersonDO objects that refer to the DO held by this BDO.
PersonDO	getPersonDO() Get the single PersonDO object that refers to the DO held by this BDO.
PersonDO[]	getPersonDOArray() Get array of PersonDO objects that refer to the DO held by this BDO.
boolean	hasMatchingHandle(String handle)
protected void	modifyDO(jobmatch.data.DBTransaction dbt, boolean delete) Modifies the DO within its table.
void	removeAdressBDO(AdressBDO rbdo) Remove (delete) a AdressBDO object whose AdressDO refers to the DO held by this BDO.
void	removeAdressBDO(AdressBDO rbdo, jobmatch.data.DBTransaction tran) Remove (delete) a AdressBDO object whose AdressDO refers to the DO held by this BDO.
void	removeCandidateBDO(CandidateBDO rbdo) Remove (delete) a CandidateBDO object whose CandidateDO refers to the DO held by this BDO.
void	removeCandidateBDO(CandidateBDO rbdo, jobmatch.data.DBTransaction tran) Remove (delete) a CandidateBDO object whose CandidateDO refers to the DO held by this BDO.
void	removePersonalProfileBDO(PersonalProfileBDO rbdo) Remove (delete) a PersonalProfileBDO object whose PersonalProfileDO refers to the DO held by this BDO.
void	removePersonalProfileBDO(PersonalProfileBDO rbdo, jobmatch.data.DBTransaction tran) Remove (delete) a PersonalProfileBDO object whose PersonalProfileDO refers to the DO held by this BDO.
void	removePersonBDO(PersonBDO rbdo) Remove (delete) a PersonBDO object whose PersonDO refers to the DO held by this BDO.
void	removePersonBDO(PersonBDO rbdo, jobmatch.data.DBTransaction tran) Remove (delete) a PersonBDO object whose PersonDO refers to the DO held by this BDO.
void	setDescription(String Description) Set Description of the CountryDO
String	toString() for debugging

Methods inherited from class java.lang.Object

, clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

DO

protected CountryDO DO

The CountryDO object upon which the set and get methods operate. This member is protected so that classes derived from CountryBDO can access the underlying Data Object.

Constructor Detail

CountryBDO

public CountryBDO(CountryDO DO)

Constructor for use by classes derived from CountryBDO. Example usage: class CustomerBO extends CustomerBDO { // a BDO class is commonly extended in order to implement: public void beforeAnySet() throws Exception { if ( CustomerDO should not be altered ) throw new ApplicationException( "ERROR" ); } public CustomerBO( CustomerDO DO ) { super( DO ); } } class SomePresentationLayerClass { public CustomerBO findCustomer( String name ) { CustomerQuery q = new CustomerQuery(); q.setQueryName( name ); CustomerDO DO = q.getNextDO(); // Here the CustomerBO ctor fires the CustomerBDO ctor. return new CustomerBO( DO ); } }

CountryBDO

public CountryBDO()
           throws Exception

Constructor required by CountryBDO.create methods.

Method Detail

getDO

public CountryDO getDO()

Note: This method is intended for use only by other BDO classes. Presentation Layer classes should (theoretically) always use the Business Layer (BDO) to create/access Data Layer (DO) objects. The overhead for using BDO objects is small (the BDO classes are fairly lightweight.)

Returns:

The DO object held by this BDO object.

createVirgin

public static CountryBDO createVirgin()
                               throws Exception

Like the class CountryDO, this class acts as a factory. Business Object (BO) classes typically need these set and get methods. So by deriving a BO from a BDO, or by implementing a BO that contains one or more BDOs, the developer of the BO is spared some work.

Throws:

Exception - If an error occurs.

createExisting

public static CountryBDO createExisting(CountryDO DO)

The createExisting method is used to create a CountryBDO from a CountryDO that was returned by the CountryQuery class.

getBDOarray

public static CountryBDO[] getBDOarray()
                                throws jobmatch.data.DataObjectException

The getBDOarray method performs a database query to return an array of CountryBDO objects representing all the rows in the Country table. This method is a minimal example of using a Query class. To restrict the set of objects returned, you could invoke query.setXxx(), where Xxx is an Attribute of CountryDO which was marked as "Can be queried" in the DODS Attribute Editor.

Throws:

jobmatch.data.DataObjectException - If an object is not found in the database.

beforeAnyGet

protected void beforeAnyGet()

The developer of a Business Object that derives from this class can override the methods: beforeAnyGet beforeAnySet afterAnySet to handle any general assertions or cleanup needed for get and set methods.

beforeAnySet

protected void beforeAnySet()
                     throws Exception

afterAnySet

protected void afterAnySet()

getHandle

public String getHandle()
                 throws jobmatch.data.DatabaseManagerException

The methods getHandle hasMatchingHandle are used by Presentation Objects that need to populate HTML select lists with CountryBDO objects as options. The getHandle() method is used to set the value for each option, and the hasMatchingHandle() methods are used to lookup the Data Object when the selection has been made. This CountryBDO object holds a reference to a CountryDO object. The id of this CountryBDO is the id of its CountryDO.

Returns:

id of this BDO as a string If an object id can't be allocated for this object.

Throws:

jobmatch.data.DatabaseManagerException - If a connection to the database cannot be established, etc.

hasMatchingHandle

public boolean hasMatchingHandle(String handle)

Parameters:

handle - String representation of the id for this BDO

Returns:

boolean True if the string version of the id of this DO matches passed handle

See Also:

getHandle

toString

public String toString()

for debugging

Overrides:

toString in class Object

getDescription

public String getDescription()
                      throws jobmatch.data.DataObjectException

Get Description of the CountryDO

Returns:

Description of the CountryDO

Throws:

jobmatch.data.DataObjectException - If the object is not found in the database.

setDescription

public void setDescription(String Description)
                    throws jobmatch.data.DataObjectException

Set Description of the CountryDO

Parameters:

Description - of the CountryDO

Throws:

jobmatch.data.DataObjectException - If the object is not found in the database.

getAdressDOArray

public AdressDO[] getAdressDOArray()
                            throws jobmatch.data.DataObjectException,
                                   jobmatch.data.QueryException

Get array of AdressDO objects that refer to the DO held by this BDO.

Returns:

array of AdressDO objects.

Throws:

jobmatch.data.DataObjectException - If the object is not found in the database.

getAdressDO

public AdressDO getAdressDO()
                     throws jobmatch.data.DataObjectException,
                            jobmatch.data.NonUniqueQueryException,
                            jobmatch.data.QueryException

Get the single AdressDO object that refers to the DO held by this BDO.

Returns:

AdressDO object.

Throws:

jobmatch.data.DataObjectException - If the object is not found in the database.

jobmatch.data.NonUniqueQueryException - If more than one AdressDO object was found.

getAdressBDOArray

public AdressBDO[] getAdressBDOArray()
                              throws jobmatch.data.DataObjectException,
                                     jobmatch.data.QueryException

Get array of AdressBDO objects holding AdressDO objects that refer to the DO held by this BDO.

Returns:

array of AdressBDO objects.

Throws:

jobmatch.data.DataObjectException - If the object is not found in the database.

getAdressBDO

public AdressBDO getAdressBDO()
                       throws jobmatch.data.DataObjectException,
                              jobmatch.data.NonUniqueQueryException,
                              jobmatch.data.QueryException

Get the single AdressBDO object holding a AdressDO object that refers to the DO held by this BDO.

Returns:

AdressBDO object.

Throws:

jobmatch.data.DataObjectException - If the object is not found in the database.

jobmatch.data.NonUniqueQueryException - If more than one AdressBDO object was found.

addAdressBDO

public void addAdressBDO(AdressBDO rbdo)
                  throws SQLException,
                         jobmatch.data.DatabaseManagerException,
                         jobmatch.data.DataObjectException,
                         jobmatch.data.RefAssertionException,
                         jobmatch.data.DBRowUpdateException,
                         jobmatch.data.QueryException

Add (set & commit) a AdressBDO object whose AdressDO refers to the DO held by this BDO.

Parameters:

rbdo - AdressBDO to be set to point to this BDO and committed.

Throws:

jobmatch.data.DatabaseManagerException - if could not create a transaction

SQLException - if any SQL errors occur.

jobmatch.data.DataObjectException - If object is not found in the database.

addAdressBDO

public void addAdressBDO(AdressBDO rbdo,
                         jobmatch.data.DBTransaction tran)
                  throws SQLException,
                         jobmatch.data.DatabaseManagerException,
                         jobmatch.data.DataObjectException,
                         jobmatch.data.RefAssertionException,
                         jobmatch.data.DBRowUpdateException,
                         jobmatch.data.QueryException

Add (set & commit) a AdressBDO object whose AdressDO refers to the DO held by this BDO.

Parameters:

rbdo - AdressBDO to be set to point to this BDO and committed.

tran - The transaction to be used for the commit. If null, a new transaction is created.

Throws:

jobmatch.data.DatabaseManagerException - if could not create a transaction

SQLException - if any SQL errors occur.

jobmatch.data.DataObjectException - If object is not found in the database.

removeAdressBDO

public void removeAdressBDO(AdressBDO rbdo)
                     throws SQLException,
                            jobmatch.data.DatabaseManagerException,
                            jobmatch.data.DataObjectException,
                            jobmatch.data.RefAssertionException,
                            jobmatch.data.DBRowUpdateException,
                            jobmatch.data.QueryException

Remove (delete) a AdressBDO object whose AdressDO refers to the DO held by this BDO.

Parameters:

r - AdressBDO to be deleted.

Throws:

jobmatch.data.DatabaseManagerException - if could not create a transaction

SQLException - if any SQL errors occur.

jobmatch.data.DataObjectException - If object is not found in the database.

removeAdressBDO

public void removeAdressBDO(AdressBDO rbdo,
                            jobmatch.data.DBTransaction tran)
                     throws SQLException,
                            jobmatch.data.DatabaseManagerException,
                            jobmatch.data.DataObjectException,
                            jobmatch.data.RefAssertionException,
                            jobmatch.data.DBRowUpdateException,
                            jobmatch.data.QueryException

Remove (delete) a AdressBDO object whose AdressDO refers to the DO held by this BDO.

Parameters:

r - AdressBDO to be deleted.

tran - The transaction to be used for the commit. If null, a new transaction is created.

Throws:

jobmatch.data.DatabaseManagerException - if could not create a transaction

SQLException - if any SQL errors occur.

jobmatch.data.DataObjectException - If object is not found in the database.

getCandidateDOArray

public CandidateDO[] getCandidateDOArray()
                                  throws jobmatch.data.DataObjectException,
                                         jobmatch.data.QueryException

Get array of CandidateDO objects that refer to the DO held by this BDO.

Returns:

array of CandidateDO objects.

Throws:

jobmatch.data.DataObjectException - If the object is not found in the database.

getCandidateDO

public CandidateDO getCandidateDO()
                           throws jobmatch.data.DataObjectException,
                                  jobmatch.data.NonUniqueQueryException,
                                  jobmatch.data.QueryException

Get the single CandidateDO object that refers to the DO held by this BDO.

Returns:

CandidateDO object.

Throws:

jobmatch.data.DataObjectException - If the object is not found in the database.

jobmatch.data.NonUniqueQueryException - If more than one CandidateDO object was found.

getCandidateBDOArray

public CandidateBDO[] getCandidateBDOArray()
                                    throws jobmatch.data.DataObjectException,
                                           jobmatch.data.QueryException

Get array of CandidateBDO objects holding CandidateDO objects that refer to the DO held by this BDO.

Returns:

array of CandidateBDO objects.

Throws:

jobmatch.data.DataObjectException - If the object is not found in the database.

getCandidateBDO

public CandidateBDO getCandidateBDO()
                             throws jobmatch.data.DataObjectException,
                                    jobmatch.data.NonUniqueQueryException,
                                    jobmatch.data.QueryException

Get the single CandidateBDO object holding a CandidateDO object that refers to the DO held by this BDO.

Returns:

CandidateBDO object.

Throws:

jobmatch.data.DataObjectException - If the object is not found in the database.

jobmatch.data.NonUniqueQueryException - If more than one CandidateBDO object was found.

addCandidateBDO

public void addCandidateBDO(CandidateBDO rbdo)
                     throws SQLException,
                            jobmatch.data.DatabaseManagerException,
                            jobmatch.data.DataObjectException,
                            jobmatch.data.RefAssertionException,
                            jobmatch.data.DBRowUpdateException,
                            jobmatch.data.QueryException

Add (set & commit) a CandidateBDO object whose CandidateDO refers to the DO held by this BDO.

Parameters:

rbdo - CandidateBDO to be set to point to this BDO and committed.

Throws:

jobmatch.data.DatabaseManagerException - if could not create a transaction

SQLException - if any SQL errors occur.

jobmatch.data.DataObjectException - If object is not found in the database.

addCandidateBDO

public void addCandidateBDO(CandidateBDO rbdo,
                            jobmatch.data.DBTransaction tran)
                     throws SQLException,
                            jobmatch.data.DatabaseManagerException,
                            jobmatch.data.DataObjectException,
                            jobmatch.data.RefAssertionException,
                            jobmatch.data.DBRowUpdateException,
                            jobmatch.data.QueryException

Add (set & commit) a CandidateBDO object whose CandidateDO refers to the DO held by this BDO.

Parameters:

rbdo - CandidateBDO to be set to point to this BDO and committed.

tran - The transaction to be used for the commit. If null, a new transaction is created.

Throws:

jobmatch.data.DatabaseManagerException - if could not create a transaction

SQLException - if any SQL errors occur.

jobmatch.data.DataObjectException - If object is not found in the database.

removeCandidateBDO

public void removeCandidateBDO(CandidateBDO rbdo)
                        throws SQLException,
                               jobmatch.data.DatabaseManagerException,
                               jobmatch.data.DataObjectException,
                               jobmatch.data.RefAssertionException,
                               jobmatch.data.DBRowUpdateException,
                               jobmatch.data.QueryException

Remove (delete) a CandidateBDO object whose CandidateDO refers to the DO held by this BDO.

Parameters:

r - CandidateBDO to be deleted.

Throws:

jobmatch.data.DatabaseManagerException - if could not create a transaction

SQLException - if any SQL errors occur.

jobmatch.data.DataObjectException - If object is not found in the database.

removeCandidateBDO

public void removeCandidateBDO(CandidateBDO rbdo,
                               jobmatch.data.DBTransaction tran)
                        throws SQLException,
                               jobmatch.data.DatabaseManagerException,
                               jobmatch.data.DataObjectException,
                               jobmatch.data.RefAssertionException,
                               jobmatch.data.DBRowUpdateException,
                               jobmatch.data.QueryException

Remove (delete) a CandidateBDO object whose CandidateDO refers to the DO held by this BDO.

Parameters:

r - CandidateBDO to be deleted.

tran - The transaction to be used for the commit. If null, a new transaction is created.

Throws:

jobmatch.data.DatabaseManagerException - if could not create a transaction

SQLException - if any SQL errors occur.

jobmatch.data.DataObjectException - If object is not found in the database.

getPersonDOArray

public PersonDO[] getPersonDOArray()
                            throws jobmatch.data.DataObjectException,
                                   jobmatch.data.QueryException

Get array of PersonDO objects that refer to the DO held by this BDO.

Returns:

array of PersonDO objects.

Throws:

jobmatch.data.DataObjectException - If the object is not found in the database.

getPersonDO

public PersonDO getPersonDO()
                     throws jobmatch.data.DataObjectException,
                            jobmatch.data.NonUniqueQueryException,
                            jobmatch.data.QueryException

Get the single PersonDO object that refers to the DO held by this BDO.

Returns:

PersonDO object.

Throws:

jobmatch.data.DataObjectException - If the object is not found in the database.

jobmatch.data.NonUniqueQueryException - If more than one PersonDO object was found.

getPersonBDOArray

public PersonBDO[] getPersonBDOArray()
                              throws jobmatch.data.DataObjectException,
                                     jobmatch.data.QueryException

Get array of PersonBDO objects holding PersonDO objects that refer to the DO held by this BDO.

Returns:

array of PersonBDO objects.

Throws:

jobmatch.data.DataObjectException - If the object is not found in the database.

getPersonBDO

public PersonBDO getPersonBDO()
                       throws jobmatch.data.DataObjectException,
                              jobmatch.data.NonUniqueQueryException,
                              jobmatch.data.QueryException

Get the single PersonBDO object holding a PersonDO object that refers to the DO held by this BDO.

Returns:

PersonBDO object.

Throws:

jobmatch.data.DataObjectException - If the object is not found in the database.

jobmatch.data.NonUniqueQueryException - If more than one PersonBDO object was found.

addPersonBDO

public void addPersonBDO(PersonBDO rbdo)
                  throws SQLException,
                         jobmatch.data.DatabaseManagerException,
                         jobmatch.data.DataObjectException,
                         jobmatch.data.RefAssertionException,
                         jobmatch.data.DBRowUpdateException,
                         jobmatch.data.QueryException

Add (set & commit) a PersonBDO object whose PersonDO refers to the DO held by this BDO.

Parameters:

rbdo - PersonBDO to be set to point to this BDO and committed.

Throws:

jobmatch.data.DatabaseManagerException - if could not create a transaction

SQLException - if any SQL errors occur.

jobmatch.data.DataObjectException - If object is not found in the database.

addPersonBDO

public void addPersonBDO(PersonBDO rbdo,
                         jobmatch.data.DBTransaction tran)
                  throws SQLException,
                         jobmatch.data.DatabaseManagerException,
                         jobmatch.data.DataObjectException,
                         jobmatch.data.RefAssertionException,
                         jobmatch.data.DBRowUpdateException,
                         jobmatch.data.QueryException

Add (set & commit) a PersonBDO object whose PersonDO refers to the DO held by this BDO.

Parameters:

rbdo - PersonBDO to be set to point to this BDO and committed.

tran - The transaction to be used for the commit. If null, a new transaction is created.

Throws:

jobmatch.data.DatabaseManagerException - if could not create a transaction

SQLException - if any SQL errors occur.

jobmatch.data.DataObjectException - If object is not found in the database.

removePersonBDO

public void removePersonBDO(PersonBDO rbdo)
                     throws SQLException,
                            jobmatch.data.DatabaseManagerException,
                            jobmatch.data.DataObjectException,
                            jobmatch.data.RefAssertionException,
                            jobmatch.data.DBRowUpdateException,
                            jobmatch.data.QueryException

Remove (delete) a PersonBDO object whose PersonDO refers to the DO held by this BDO.

Parameters:

r - PersonBDO to be deleted.

Throws:

jobmatch.data.DatabaseManagerException - if could not create a transaction

SQLException - if any SQL errors occur.

jobmatch.data.DataObjectException - If object is not found in the database.

removePersonBDO

public void removePersonBDO(PersonBDO rbdo,
                            jobmatch.data.DBTransaction tran)
                     throws SQLException,
                            jobmatch.data.DatabaseManagerException,
                            jobmatch.data.DataObjectException,
                            jobmatch.data.RefAssertionException,
                            jobmatch.data.DBRowUpdateException,
                            jobmatch.data.QueryException

Remove (delete) a PersonBDO object whose PersonDO refers to the DO held by this BDO.

Parameters:

r - PersonBDO to be deleted.

tran - The transaction to be used for the commit. If null, a new transaction is created.

Throws:

jobmatch.data.DatabaseManagerException - if could not create a transaction

SQLException - if any SQL errors occur.

jobmatch.data.DataObjectException - If object is not found in the database.

getPersonalProfileDOArray

public PersonalProfileDO[] getPersonalProfileDOArray()
                                              throws jobmatch.data.DataObjectException,
                                                     jobmatch.data.QueryException

Get array of PersonalProfileDO objects that refer to the DO held by this BDO.

Returns:

array of PersonalProfileDO objects.

Throws:

jobmatch.data.DataObjectException - If the object is not found in the database.

getPersonalProfileDO

public PersonalProfileDO getPersonalProfileDO()
                                       throws jobmatch.data.DataObjectException,
                                              jobmatch.data.NonUniqueQueryException,
                                              jobmatch.data.QueryException

Get the single PersonalProfileDO object that refers to the DO held by this BDO.

Returns:

PersonalProfileDO object.

Throws:

jobmatch.data.DataObjectException - If the object is not found in the database.

jobmatch.data.NonUniqueQueryException - If more than one PersonalProfileDO object was found.

getPersonalProfileBDOArray

public PersonalProfileBDO[] getPersonalProfileBDOArray()
                                                throws jobmatch.data.DataObjectException,
                                                       jobmatch.data.QueryException

Get array of PersonalProfileBDO objects holding PersonalProfileDO objects that refer to the DO held by this BDO.

Returns:

array of PersonalProfileBDO objects.

Throws:

jobmatch.data.DataObjectException - If the object is not found in the database.

getPersonalProfileBDO

public PersonalProfileBDO getPersonalProfileBDO()
                                         throws jobmatch.data.DataObjectException,
                                                jobmatch.data.NonUniqueQueryException,
                                                jobmatch.data.QueryException

Get the single PersonalProfileBDO object holding a PersonalProfileDO object that refers to the DO held by this BDO.

Returns:

PersonalProfileBDO object.

Throws:

jobmatch.data.DataObjectException - If the object is not found in the database.

jobmatch.data.NonUniqueQueryException - If more than one PersonalProfileBDO object was found.

addPersonalProfileBDO

public void addPersonalProfileBDO(PersonalProfileBDO rbdo)
                           throws SQLException,
                                  jobmatch.data.DatabaseManagerException,
                                  jobmatch.data.DataObjectException,
                                  jobmatch.data.RefAssertionException,
                                  jobmatch.data.DBRowUpdateException,
                                  jobmatch.data.QueryException

Add (set & commit) a PersonalProfileBDO object whose PersonalProfileDO refers to the DO held by this BDO.

Parameters:

rbdo - PersonalProfileBDO to be set to point to this BDO and committed.

Throws:

jobmatch.data.DatabaseManagerException - if could not create a transaction

SQLException - if any SQL errors occur.

jobmatch.data.DataObjectException - If object is not found in the database.

addPersonalProfileBDO

public void addPersonalProfileBDO(PersonalProfileBDO rbdo,
                                  jobmatch.data.DBTransaction tran)
                           throws SQLException,
                                  jobmatch.data.DatabaseManagerException,
                                  jobmatch.data.DataObjectException,
                                  jobmatch.data.RefAssertionException,
                                  jobmatch.data.DBRowUpdateException,
                                  jobmatch.data.QueryException

Add (set & commit) a PersonalProfileBDO object whose PersonalProfileDO refers to the DO held by this BDO.

Parameters:

rbdo - PersonalProfileBDO to be set to point to this BDO and committed.

tran - The transaction to be used for the commit. If null, a new transaction is created.

Throws:

jobmatch.data.DatabaseManagerException - if could not create a transaction

SQLException - if any SQL errors occur.

jobmatch.data.DataObjectException - If object is not found in the database.

removePersonalProfileBDO

public void removePersonalProfileBDO(PersonalProfileBDO rbdo)
                              throws SQLException,
                                     jobmatch.data.DatabaseManagerException,
                                     jobmatch.data.DataObjectException,
                                     jobmatch.data.RefAssertionException,
                                     jobmatch.data.DBRowUpdateException,
                                     jobmatch.data.QueryException

Remove (delete) a PersonalProfileBDO object whose PersonalProfileDO refers to the DO held by this BDO.

Parameters:

r - PersonalProfileBDO to be deleted.

Throws:

jobmatch.data.DatabaseManagerException - if could not create a transaction

SQLException - if any SQL errors occur.

jobmatch.data.DataObjectException - If object is not found in the database.

removePersonalProfileBDO

public void removePersonalProfileBDO(PersonalProfileBDO rbdo,
                                     jobmatch.data.DBTransaction tran)
                              throws SQLException,
                                     jobmatch.data.DatabaseManagerException,
                                     jobmatch.data.DataObjectException,
                                     jobmatch.data.RefAssertionException,
                                     jobmatch.data.DBRowUpdateException,
                                     jobmatch.data.QueryException

Remove (delete) a PersonalProfileBDO object whose PersonalProfileDO refers to the DO held by this BDO.

Parameters:

r - PersonalProfileBDO to be deleted.

tran - The transaction to be used for the commit. If null, a new transaction is created.

Throws:

jobmatch.data.DatabaseManagerException - if could not create a transaction

SQLException - if any SQL errors occur.

jobmatch.data.DataObjectException - If object is not found in the database.

commit

public void commit()
            throws SQLException,
                   jobmatch.data.DatabaseManagerException,
                   jobmatch.data.DataObjectException,
                   jobmatch.data.RefAssertionException,
                   jobmatch.data.DBRowUpdateException,
                   jobmatch.data.QueryException

Inserts/Updates the DO into its table.

Throws:

com.lutris.appserver.server.sql.DatabaseManagerException - if a Transaction can not be created.

jobmatch.data.RefAssertionException - thrown by okTo method.

SQLException - if any SQL errors occur.

commit

public void commit(jobmatch.data.DBTransaction dbt)
            throws SQLException,
                   jobmatch.data.DatabaseManagerException,
                   jobmatch.data.DataObjectException,
                   jobmatch.data.RefAssertionException,
                   jobmatch.data.DBRowUpdateException,
                   jobmatch.data.QueryException

Inserts/Updates the DO into its table. The transaction is likely provided by the commit() method of another BDO whose DO references this DO.

Parameters:

dbt - The transaction object to use for this operation.

Throws:

com.lutris.appserver.server.sql.DatabaseManagerException - if a Transaction can not be created.

jobmatch.data.RefAssertionException - thrown by okTo method.

SQLException - if any SQL errors occur.

delete

public void delete()
            throws SQLException,
                   jobmatch.data.DatabaseManagerException,
                   jobmatch.data.DataObjectException,
                   jobmatch.data.RefAssertionException,
                   jobmatch.data.DBRowUpdateException,
                   jobmatch.data.QueryException

Deletes the DO from its table.

Throws:

com.lutris.appserver.server.sql.DatabaseManagerException - if a Transaction can not be created.

jobmatch.data.RefAssertionException - thrown by okTo method.

SQLException - if any SQL errors occur.

delete

public void delete(jobmatch.data.DBTransaction dbt)
            throws SQLException,
                   jobmatch.data.DatabaseManagerException,
                   jobmatch.data.DataObjectException,
                   jobmatch.data.RefAssertionException,
                   jobmatch.data.DBRowUpdateException,
                   jobmatch.data.QueryException

Deletes the DO from its table. The transaction is likely provided by the delete() method of another BDO whose DO references this DO.

Parameters:

dbt - The transaction object to use for this operation.

Throws:

com.lutris.appserver.server.sql.DatabaseManagerException - if a Transaction can not be created.

jobmatch.data.RefAssertionException - thrown by okTo method.

SQLException - if any SQL errors occur.

modifyDO

protected void modifyDO(jobmatch.data.DBTransaction dbt,
                        boolean delete)
                 throws SQLException,
                        jobmatch.data.DatabaseManagerException,
                        jobmatch.data.DataObjectException,
                        jobmatch.data.RefAssertionException,
                        jobmatch.data.DBRowUpdateException,
                        jobmatch.data.QueryException

Modifies the DO within its table. Performs recursive commit/delete on referenced DOs; all operations occur within a single transaction to allow rollback in the event of error. Only the creator of the transaction releases it.

Parameters:

dbt - The transaction object to use for this operation.

delete - True if doing a delete, otherwise doing insert/update.

Throws:

com.lutris.appserver.server.sql.DatabaseManagerException - if a Transaction can not be created.

jobmatch.data.RefAssertionException - thrown by okTo method.

SQLException - if any SQL errors occur.