jobmatch.data
Class ProfileBDO

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

Direct Known Subclasses:

Profile

public class ProfileBDO

extends Object

implements Serializable

ProfileBDO contains the same set and get methods as the ProfileDO 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.5 $

See Also:

Serialized Form

Field Summary

protected ProfileDO

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

Constructor Summary

ProfileBDO()
Constructor required by ProfileBDO.create methods.

ProfileBDO(ProfileDO DO)
Constructor for use by classes derived from ProfileBDO.

Method Summary

void	addCandidateProfileBDO(CandidateProfileBDO rbdo) Add (set & commit) a CandidateProfileBDO object whose CandidateProfileDO refers to the DO held by this BDO.
void	addCandidateProfileBDO(CandidateProfileBDO rbdo, jobmatch.data.DBTransaction tran) Add (set & commit) a CandidateProfileBDO object whose CandidateProfileDO 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 ProfileBDO	createExisting(ProfileDO DO) The createExisting method is used to create a ProfileBDO from a ProfileDO that was returned by the ProfileQuery class.
static ProfileBDO	createVirgin() Like the class ProfileDO, 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.
static ProfileBDO[]	getBDOarray() The getBDOarray method performs a database query to return an array of ProfileBDO objects representing all the rows in the Profile table.
CandidateDO[]	getCandidateDOArray_via_CandidateProfile() From the many-to-many relationship expressed by CandidateProfileDO, get array of CandidateDO objects that indirectly refer to the DO held by this BDO.
CandidateProfileBDO	getCandidateProfileBDO() Get the single CandidateProfileBDO object holding a CandidateProfileDO object that refers to the DO held by this BDO.
CandidateProfileBDO[]	getCandidateProfileBDOArray() Get array of CandidateProfileBDO objects holding CandidateProfileDO objects that refer to the DO held by this BDO.
CandidateProfileDO	getCandidateProfileDO() Get the single CandidateProfileDO object that refers to the DO held by this BDO.
CandidateProfileDO[]	getCandidateProfileDOArray() Get array of CandidateProfileDO objects that refer to the DO held by this BDO.
CompanyDO	getCompany() Get Company of the ProfileDO
CompanyBDO	getCompanyBDO() Get BDO-wrapped Company of the ProfileDO
ProfileDO	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 ProfileBDO objects as options.
Timestamp	getLastNotification() Get LastNotification of the ProfileDO
byte[]	getMatchTree() Get MatchTree of the ProfileDO
String	getName() Get Name of the ProfileDO
boolean	getNeedsRematching() Get NeedsRematching of the ProfileDO
int	getNotificationPeriod() Get NotificationPeriod of the ProfileDO
boolean	getNotify() Get Notify of the ProfileDO
boolean	hasMatchingHandle(String handle)
void	mapCandidate_via_CandidateProfileBDO(CandidateBDO b) To the many-to-many relationship expressed by CandidateProfileDO, add a CandidateDO object that indirectly refers to the DO held by this BDO.
void	mapCandidate_via_CandidateProfileBDO(CandidateBDO b, jobmatch.data.DBTransaction tran) To the many-to-many relationship expressed by CandidateProfileDO, add a CandidateDO object that indirectly refers to the DO held by this BDO.
void	mapCandidate_via_CandidateProfileDO(CandidateDO d) To the many-to-many relationship expressed by CandidateProfileDO, add a CandidateDO object that indirectly refers to the DO held by this BDO.
void	mapCandidate_via_CandidateProfileDO(CandidateDO d, jobmatch.data.DBTransaction tran) To the many-to-many relationship expressed by CandidateProfileDO, add a CandidateDO object that indirectly refers to the DO held by this BDO.
protected void	modifyDO(jobmatch.data.DBTransaction dbt, boolean delete) Modifies the DO within its table.
protected void	okToCommitCompany(CompanyDO member) A stub method for implementing pre-commit assertions for the Company data member.
protected void	okToDeleteCompany(CompanyDO member) A stub method for implementing pre-delete assertions for the Company data member.
void	removeCandidateProfileBDO(CandidateProfileBDO rbdo) Remove (delete) a CandidateProfileBDO object whose CandidateProfileDO refers to the DO held by this BDO.
void	removeCandidateProfileBDO(CandidateProfileBDO rbdo, jobmatch.data.DBTransaction tran) Remove (delete) a CandidateProfileBDO object whose CandidateProfileDO refers to the DO held by this BDO.
void	setCompany(CompanyBDO Company) Set Company of the ProfileDO
void	setCompany(CompanyDO Company) Set Company of the ProfileDO
void	setLastNotification(Timestamp LastNotification) Set LastNotification of the ProfileDO
void	setMatchTree(byte[] MatchTree) Set MatchTree of the ProfileDO
void	setName(String Name) Set Name of the ProfileDO
void	setNeedsRematching(boolean NeedsRematching) Set NeedsRematching of the ProfileDO
void	setNotificationPeriod(int NotificationPeriod) Set NotificationPeriod of the ProfileDO
void	setNotify(boolean Notify) Set Notify of the ProfileDO
String	toString() for debugging
void	unmapCandidate_via_CandidateProfileBDO(CandidateBDO b) From the many-to-many relationship expressed by CandidateProfileDO, remove (delete) the CandidateDO object that indirectly refers to the DO held by this BDO.
void	unmapCandidate_via_CandidateProfileBDO(CandidateBDO b, jobmatch.data.DBTransaction tran) From the many-to-many relationship expressed by CandidateProfileDO, remove (delete) the CandidateDO object that indirectly refers to the DO held by this BDO.
void	unmapCandidate_via_CandidateProfileDO(CandidateDO d) From the many-to-many relationship expressed by CandidateProfileDO, remove (delete) the CandidateDO object that indirectly refers to the DO held by this BDO.
void	unmapCandidate_via_CandidateProfileDO(CandidateDO d, jobmatch.data.DBTransaction tran) From the many-to-many relationship expressed by CandidateProfileDO, remove (delete) the CandidateDO object that indirectly refers to the DO held by this BDO.

Methods inherited from class java.lang.Object

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

Field Detail

DO

protected ProfileDO DO

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

Constructor Detail

ProfileBDO

public ProfileBDO(ProfileDO DO)

Constructor for use by classes derived from ProfileBDO. 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 ); } }

ProfileBDO

public ProfileBDO()
           throws Exception

Constructor required by ProfileBDO.create methods.

Method Detail

getDO

public ProfileDO 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 ProfileBDO createVirgin()
                               throws Exception

Like the class ProfileDO, 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 ProfileBDO createExisting(ProfileDO DO)

The createExisting method is used to create a ProfileBDO from a ProfileDO that was returned by the ProfileQuery class.

getBDOarray

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

The getBDOarray method performs a database query to return an array of ProfileBDO objects representing all the rows in the Profile 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 ProfileDO 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 ProfileBDO 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 ProfileBDO object holds a reference to a ProfileDO object. The id of this ProfileBDO is the id of its ProfileDO.

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

getCompany

public CompanyDO getCompany()
                     throws jobmatch.data.DataObjectException

Get Company of the ProfileDO

Returns:

Company of the ProfileDO

Throws:

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

setCompany

public void setCompany(CompanyDO Company)
                throws jobmatch.data.DataObjectException

Set Company of the ProfileDO

Parameters:

Company - of the ProfileDO

Throws:

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

getCompanyBDO

public CompanyBDO getCompanyBDO()
                         throws jobmatch.data.DataObjectException

Get BDO-wrapped Company of the ProfileDO

Returns:

BDO-wrapped Company of the ProfileDO

Throws:

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

setCompany

public void setCompany(CompanyBDO Company)
                throws jobmatch.data.DataObjectException

Set Company of the ProfileDO

Parameters:

BDO-wrapped - Company of the ProfileDO

Throws:

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

getLastNotification

public Timestamp getLastNotification()
                              throws jobmatch.data.DataObjectException

Get LastNotification of the ProfileDO

Returns:

LastNotification of the ProfileDO

Throws:

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

setLastNotification

public void setLastNotification(Timestamp LastNotification)
                         throws jobmatch.data.DataObjectException

Set LastNotification of the ProfileDO

Parameters:

LastNotification - of the ProfileDO

Throws:

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

getMatchTree

public byte[] getMatchTree()
                    throws jobmatch.data.DataObjectException

Get MatchTree of the ProfileDO

Returns:

MatchTree of the ProfileDO

Throws:

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

setMatchTree

public void setMatchTree(byte[] MatchTree)
                  throws jobmatch.data.DataObjectException

Set MatchTree of the ProfileDO

Parameters:

MatchTree - of the ProfileDO

Throws:

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

getName

public String getName()
               throws jobmatch.data.DataObjectException

Get Name of the ProfileDO

Returns:

Name of the ProfileDO

Throws:

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

setName

public void setName(String Name)
             throws jobmatch.data.DataObjectException

Set Name of the ProfileDO

Parameters:

Name - of the ProfileDO

Throws:

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

getNeedsRematching

public boolean getNeedsRematching()
                           throws jobmatch.data.DataObjectException

Get NeedsRematching of the ProfileDO

Returns:

NeedsRematching of the ProfileDO

Throws:

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

setNeedsRematching

public void setNeedsRematching(boolean NeedsRematching)
                        throws jobmatch.data.DataObjectException

Set NeedsRematching of the ProfileDO

Parameters:

NeedsRematching - of the ProfileDO

Throws:

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

getNotify

public boolean getNotify()
                  throws jobmatch.data.DataObjectException

Get Notify of the ProfileDO

Returns:

Notify of the ProfileDO

Throws:

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

setNotify

public void setNotify(boolean Notify)
               throws jobmatch.data.DataObjectException

Set Notify of the ProfileDO

Parameters:

Notify - of the ProfileDO

Throws:

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

getNotificationPeriod

public int getNotificationPeriod()
                          throws jobmatch.data.DataObjectException

Get NotificationPeriod of the ProfileDO

Returns:

NotificationPeriod of the ProfileDO

Throws:

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

setNotificationPeriod

public void setNotificationPeriod(int NotificationPeriod)
                           throws jobmatch.data.DataObjectException

Set NotificationPeriod of the ProfileDO

Parameters:

NotificationPeriod - of the ProfileDO

Throws:

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

getCandidateProfileDOArray

public CandidateProfileDO[] getCandidateProfileDOArray()
                                                throws jobmatch.data.DataObjectException,
                                                       jobmatch.data.QueryException

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

Returns:

array of CandidateProfileDO objects.

Throws:

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

getCandidateProfileDO

public CandidateProfileDO getCandidateProfileDO()
                                         throws jobmatch.data.DataObjectException,
                                                jobmatch.data.NonUniqueQueryException,
                                                jobmatch.data.QueryException

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

Returns:

CandidateProfileDO object.

Throws:

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

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

getCandidateProfileBDOArray

public CandidateProfileBDO[] getCandidateProfileBDOArray()
                                                  throws jobmatch.data.DataObjectException,
                                                         jobmatch.data.QueryException

Get array of CandidateProfileBDO objects holding CandidateProfileDO objects that refer to the DO held by this BDO.

Returns:

array of CandidateProfileBDO objects.

Throws:

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

getCandidateProfileBDO

public CandidateProfileBDO getCandidateProfileBDO()
                                           throws jobmatch.data.DataObjectException,
                                                  jobmatch.data.NonUniqueQueryException,
                                                  jobmatch.data.QueryException

Get the single CandidateProfileBDO object holding a CandidateProfileDO object that refers to the DO held by this BDO.

Returns:

CandidateProfileBDO object.

Throws:

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

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

addCandidateProfileBDO

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

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

Parameters:

rbdo - CandidateProfileBDO 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.

addCandidateProfileBDO

public void addCandidateProfileBDO(CandidateProfileBDO 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 CandidateProfileBDO object whose CandidateProfileDO refers to the DO held by this BDO.

Parameters:

rbdo - CandidateProfileBDO 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.

removeCandidateProfileBDO

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

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

Parameters:

r - CandidateProfileBDO 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.

removeCandidateProfileBDO

public void removeCandidateProfileBDO(CandidateProfileBDO 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 CandidateProfileBDO object whose CandidateProfileDO refers to the DO held by this BDO.

Parameters:

r - CandidateProfileBDO 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_via_CandidateProfile

public CandidateDO[] getCandidateDOArray_via_CandidateProfile()
                                                       throws jobmatch.data.DataObjectException

From the many-to-many relationship expressed by CandidateProfileDO, get array of CandidateDO objects that indirectly 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.

mapCandidate_via_CandidateProfileDO

public void mapCandidate_via_CandidateProfileDO(CandidateDO d)
                                         throws jobmatch.data.DataObjectException,
                                                jobmatch.data.DatabaseManagerException,
                                                jobmatch.data.RefAssertionException,
                                                SQLException,
                                                jobmatch.data.DBRowUpdateException,
                                                jobmatch.data.QueryException

To the many-to-many relationship expressed by CandidateProfileDO, add a CandidateDO object that indirectly refers to the DO held by this BDO.

Parameters:

d - The CandidateDO to add to the CandidateProfileDO mapping for this BDO.

Throws:

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

mapCandidate_via_CandidateProfileDO

public void mapCandidate_via_CandidateProfileDO(CandidateDO d,
                                                jobmatch.data.DBTransaction tran)
                                         throws jobmatch.data.DataObjectException,
                                                jobmatch.data.DatabaseManagerException,
                                                jobmatch.data.RefAssertionException,
                                                SQLException,
                                                jobmatch.data.DBRowUpdateException,
                                                jobmatch.data.QueryException

To the many-to-many relationship expressed by CandidateProfileDO, add a CandidateDO object that indirectly refers to the DO held by this BDO.

Parameters:

d - The CandidateDO to add to the CandidateProfileDO mapping for this BDO.

Throws:

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

mapCandidate_via_CandidateProfileBDO

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

To the many-to-many relationship expressed by CandidateProfileDO, add a CandidateDO object that indirectly refers to the DO held by this BDO.

Parameters:

b - The CandidateBDO to add to the CandidateProfileDO mapping for this BDO.

Throws:

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

mapCandidate_via_CandidateProfileBDO

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

To the many-to-many relationship expressed by CandidateProfileDO, add a CandidateDO object that indirectly refers to the DO held by this BDO.

Parameters:

b - The CandidateBDO to add to the CandidateProfileDO mapping for this BDO.

Throws:

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

unmapCandidate_via_CandidateProfileDO

public void unmapCandidate_via_CandidateProfileDO(CandidateDO d)
                                           throws jobmatch.data.DataObjectException,
                                                  jobmatch.data.DatabaseManagerException,
                                                  jobmatch.data.RefAssertionException,
                                                  SQLException,
                                                  jobmatch.data.DBRowUpdateException,
                                                  jobmatch.data.QueryException

From the many-to-many relationship expressed by CandidateProfileDO, remove (delete) the CandidateDO object that indirectly refers to the DO held by this BDO.

Parameters:

d - The CandidateDO to remove from the CandidateProfileDO mapping for this BDO.

Throws:

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

unmapCandidate_via_CandidateProfileDO

public void unmapCandidate_via_CandidateProfileDO(CandidateDO d,
                                                  jobmatch.data.DBTransaction tran)
                                           throws jobmatch.data.DataObjectException,
                                                  jobmatch.data.DatabaseManagerException,
                                                  jobmatch.data.RefAssertionException,
                                                  SQLException,
                                                  jobmatch.data.DBRowUpdateException,
                                                  jobmatch.data.QueryException

From the many-to-many relationship expressed by CandidateProfileDO, remove (delete) the CandidateDO object that indirectly refers to the DO held by this BDO.

Parameters:

d - The CandidateDO to remove from the CandidateProfileDO mapping for this BDO.

Throws:

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

unmapCandidate_via_CandidateProfileBDO

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

From the many-to-many relationship expressed by CandidateProfileDO, remove (delete) the CandidateDO object that indirectly refers to the DO held by this BDO.

Parameters:

b - The CandidateBDO to remove from the CandidateProfileDO mapping for this BDO.

Throws:

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

unmapCandidate_via_CandidateProfileBDO

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

From the many-to-many relationship expressed by CandidateProfileDO, remove (delete) the CandidateDO object that indirectly refers to the DO held by this BDO.

Parameters:

b - The CandidateBDO to remove from the CandidateProfileDO mapping for this BDO.

Throws:

jobmatch.data.DataObjectException - If the 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.

okToCommitCompany

protected void okToCommitCompany(CompanyDO member)
                          throws jobmatch.data.RefAssertionException

A stub method for implementing pre-commit assertions for the Company data member. Implement this stub to throw an RefAssertionException for cases where Company is not valid for writing to the database.

okToDeleteCompany

protected void okToDeleteCompany(CompanyDO member)
                          throws jobmatch.data.RefAssertionException

A stub method for implementing pre-delete assertions for the Company data member. Implement this stub to throw an RefAssertionException for cases where Company is not valid for deletion from the database.

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.