PSE 2000 Group 4

jobmatch.data
Class LanguageCandidateBDO

java.lang.Object
  |
  +--jobmatch.data.LanguageCandidateBDO
Direct Known Subclasses:
LanguageSkill

public class LanguageCandidateBDO
extends Object
implements Serializable

LanguageCandidateBDO contains the same set and get methods as the LanguageCandidateDO 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  LanguageCandidateDO DO
          The LanguageCandidateDO object upon which the set and get methods operate.
 
Constructor Summary
LanguageCandidateBDO()
          Constructor required by LanguageCandidateBDO.create methods.
LanguageCandidateBDO(LanguageCandidateDO DO)
          Constructor for use by classes derived from LanguageCandidateBDO.
 
Method Summary
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 LanguageCandidateBDO createExisting(LanguageCandidateDO DO)
          The createExisting method is used to create a LanguageCandidateBDO from a LanguageCandidateDO that was returned by the LanguageCandidateQuery class.
static LanguageCandidateBDO createVirgin()
          Like the class LanguageCandidateDO, 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 LanguageCandidateBDO[] getBDOarray()
          The getBDOarray method performs a database query to return an array of LanguageCandidateBDO objects representing all the rows in the LanguageCandidate table.
 CandidateDO getCandidate()
          Get Candidate of the LanguageCandidateDO
 CandidateBDO getCandidateBDO()
          Get BDO-wrapped Candidate of the LanguageCandidateDO
 String getDiploma()
          Get Diploma of the LanguageCandidateDO
 LanguageCandidateDO 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 LanguageCandidateBDO objects as options.
 LanguageDO getLanguage()
          Get Language of the LanguageCandidateDO
 LanguageBDO getLanguageBDO()
          Get BDO-wrapped Language of the LanguageCandidateDO
 LanguagecapabilityDO getSpoken()
          Get Spoken of the LanguageCandidateDO
 LanguagecapabilityBDO getSpokenBDO()
          Get BDO-wrapped Spoken of the LanguageCandidateDO
 LanguagecapabilityDO getWritten()
          Get Written of the LanguageCandidateDO
 LanguagecapabilityBDO getWrittenBDO()
          Get BDO-wrapped Written of the LanguageCandidateDO
 boolean hasMatchingHandle(String handle)
           
protected  void modifyDO(jobmatch.data.DBTransaction dbt, boolean delete)
          Modifies the DO within its table.
protected  void okToCommitCandidate(CandidateDO member)
          A stub method for implementing pre-commit assertions for the Candidate data member.
protected  void okToCommitLanguage(LanguageDO member)
          A stub method for implementing pre-commit assertions for the Language data member.
protected  void okToCommitSpoken(LanguagecapabilityDO member)
          A stub method for implementing pre-commit assertions for the Spoken data member.
protected  void okToCommitWritten(LanguagecapabilityDO member)
          A stub method for implementing pre-commit assertions for the Written data member.
protected  void okToDeleteCandidate(CandidateDO member)
          A stub method for implementing pre-delete assertions for the Candidate data member.
protected  void okToDeleteLanguage(LanguageDO member)
          A stub method for implementing pre-delete assertions for the Language data member.
protected  void okToDeleteSpoken(LanguagecapabilityDO member)
          A stub method for implementing pre-delete assertions for the Spoken data member.
protected  void okToDeleteWritten(LanguagecapabilityDO member)
          A stub method for implementing pre-delete assertions for the Written data member.
 void setCandidate(CandidateBDO Candidate)
          Set Candidate of the LanguageCandidateDO
 void setCandidate(CandidateDO Candidate)
          Set Candidate of the LanguageCandidateDO
 void setDiploma(String Diploma)
          Set Diploma of the LanguageCandidateDO
 void setLanguage(LanguageBDO Language)
          Set Language of the LanguageCandidateDO
 void setLanguage(LanguageDO Language)
          Set Language of the LanguageCandidateDO
 void setSpoken(LanguagecapabilityBDO Spoken)
          Set Spoken of the LanguageCandidateDO
 void setSpoken(LanguagecapabilityDO Spoken)
          Set Spoken of the LanguageCandidateDO
 void setWritten(LanguagecapabilityBDO Written)
          Set Written of the LanguageCandidateDO
 void setWritten(LanguagecapabilityDO Written)
          Set Written of the LanguageCandidateDO
 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 LanguageCandidateDO DO
The LanguageCandidateDO object upon which the set and get methods operate. This member is protected so that classes derived from LanguageCandidateBDO can access the underlying Data Object.
Constructor Detail

LanguageCandidateBDO

public LanguageCandidateBDO(LanguageCandidateDO DO)
Constructor for use by classes derived from LanguageCandidateBDO. 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 ); } }

LanguageCandidateBDO

public LanguageCandidateBDO()
                     throws Exception
Constructor required by LanguageCandidateBDO.create methods.
Method Detail

getDO

public LanguageCandidateDO 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 LanguageCandidateBDO createVirgin()
                                         throws Exception
Like the class LanguageCandidateDO, 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 LanguageCandidateBDO createExisting(LanguageCandidateDO DO)
The createExisting method is used to create a LanguageCandidateBDO from a LanguageCandidateDO that was returned by the LanguageCandidateQuery class.

getBDOarray

public static LanguageCandidateBDO[] getBDOarray()
                                          throws jobmatch.data.DataObjectException
The getBDOarray method performs a database query to return an array of LanguageCandidateBDO objects representing all the rows in the LanguageCandidate 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 LanguageCandidateDO 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 LanguageCandidateBDO 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 LanguageCandidateBDO object holds a reference to a LanguageCandidateDO object. The id of this LanguageCandidateBDO is the id of its LanguageCandidateDO.
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

getCandidate

public CandidateDO getCandidate()
                         throws jobmatch.data.DataObjectException
Get Candidate of the LanguageCandidateDO
Returns:
Candidate of the LanguageCandidateDO
Throws:
jobmatch.data.DataObjectException - If the object is not found in the database.

setCandidate

public void setCandidate(CandidateDO Candidate)
                  throws jobmatch.data.DataObjectException
Set Candidate of the LanguageCandidateDO
Parameters:
Candidate - of the LanguageCandidateDO
Throws:
jobmatch.data.DataObjectException - If the object is not found in the database.

getCandidateBDO

public CandidateBDO getCandidateBDO()
                             throws jobmatch.data.DataObjectException
Get BDO-wrapped Candidate of the LanguageCandidateDO
Returns:
BDO-wrapped Candidate of the LanguageCandidateDO
Throws:
jobmatch.data.DataObjectException - If the object is not found in the database.

setCandidate

public void setCandidate(CandidateBDO Candidate)
                  throws jobmatch.data.DataObjectException
Set Candidate of the LanguageCandidateDO
Parameters:
BDO-wrapped - Candidate of the LanguageCandidateDO
Throws:
jobmatch.data.DataObjectException - If the object is not found in the database.

getLanguage

public LanguageDO getLanguage()
                       throws jobmatch.data.DataObjectException
Get Language of the LanguageCandidateDO
Returns:
Language of the LanguageCandidateDO
Throws:
jobmatch.data.DataObjectException - If the object is not found in the database.

setLanguage

public void setLanguage(LanguageDO Language)
                 throws jobmatch.data.DataObjectException
Set Language of the LanguageCandidateDO
Parameters:
Language - of the LanguageCandidateDO
Throws:
jobmatch.data.DataObjectException - If the object is not found in the database.

getLanguageBDO

public LanguageBDO getLanguageBDO()
                           throws jobmatch.data.DataObjectException
Get BDO-wrapped Language of the LanguageCandidateDO
Returns:
BDO-wrapped Language of the LanguageCandidateDO
Throws:
jobmatch.data.DataObjectException - If the object is not found in the database.

setLanguage

public void setLanguage(LanguageBDO Language)
                 throws jobmatch.data.DataObjectException
Set Language of the LanguageCandidateDO
Parameters:
BDO-wrapped - Language of the LanguageCandidateDO
Throws:
jobmatch.data.DataObjectException - If the object is not found in the database.

getDiploma

public String getDiploma()
                  throws jobmatch.data.DataObjectException
Get Diploma of the LanguageCandidateDO
Returns:
Diploma of the LanguageCandidateDO
Throws:
jobmatch.data.DataObjectException - If the object is not found in the database.

setDiploma

public void setDiploma(String Diploma)
                throws jobmatch.data.DataObjectException
Set Diploma of the LanguageCandidateDO
Parameters:
Diploma - of the LanguageCandidateDO
Throws:
jobmatch.data.DataObjectException - If the object is not found in the database.

getWritten

public LanguagecapabilityDO getWritten()
                                throws jobmatch.data.DataObjectException
Get Written of the LanguageCandidateDO
Returns:
Written of the LanguageCandidateDO
Throws:
jobmatch.data.DataObjectException - If the object is not found in the database.

setWritten

public void setWritten(LanguagecapabilityDO Written)
                throws jobmatch.data.DataObjectException
Set Written of the LanguageCandidateDO
Parameters:
Written - of the LanguageCandidateDO
Throws:
jobmatch.data.DataObjectException - If the object is not found in the database.

getWrittenBDO

public LanguagecapabilityBDO getWrittenBDO()
                                    throws jobmatch.data.DataObjectException
Get BDO-wrapped Written of the LanguageCandidateDO
Returns:
BDO-wrapped Written of the LanguageCandidateDO
Throws:
jobmatch.data.DataObjectException - If the object is not found in the database.

setWritten

public void setWritten(LanguagecapabilityBDO Written)
                throws jobmatch.data.DataObjectException
Set Written of the LanguageCandidateDO
Parameters:
BDO-wrapped - Written of the LanguageCandidateDO
Throws:
jobmatch.data.DataObjectException - If the object is not found in the database.

getSpoken

public LanguagecapabilityDO getSpoken()
                               throws jobmatch.data.DataObjectException
Get Spoken of the LanguageCandidateDO
Returns:
Spoken of the LanguageCandidateDO
Throws:
jobmatch.data.DataObjectException - If the object is not found in the database.

setSpoken

public void setSpoken(LanguagecapabilityDO Spoken)
               throws jobmatch.data.DataObjectException
Set Spoken of the LanguageCandidateDO
Parameters:
Spoken - of the LanguageCandidateDO
Throws:
jobmatch.data.DataObjectException - If the object is not found in the database.

getSpokenBDO

public LanguagecapabilityBDO getSpokenBDO()
                                   throws jobmatch.data.DataObjectException
Get BDO-wrapped Spoken of the LanguageCandidateDO
Returns:
BDO-wrapped Spoken of the LanguageCandidateDO
Throws:
jobmatch.data.DataObjectException - If the object is not found in the database.

setSpoken

public void setSpoken(LanguagecapabilityBDO Spoken)
               throws jobmatch.data.DataObjectException
Set Spoken of the LanguageCandidateDO
Parameters:
BDO-wrapped - Spoken of the LanguageCandidateDO
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.

okToCommitCandidate

protected void okToCommitCandidate(CandidateDO member)
                            throws jobmatch.data.RefAssertionException
A stub method for implementing pre-commit assertions for the Candidate data member. Implement this stub to throw an RefAssertionException for cases where Candidate is not valid for writing to the database.

okToDeleteCandidate

protected void okToDeleteCandidate(CandidateDO member)
                            throws jobmatch.data.RefAssertionException
A stub method for implementing pre-delete assertions for the Candidate data member. Implement this stub to throw an RefAssertionException for cases where Candidate is not valid for deletion from the database.

okToCommitLanguage

protected void okToCommitLanguage(LanguageDO member)
                           throws jobmatch.data.RefAssertionException
A stub method for implementing pre-commit assertions for the Language data member. Implement this stub to throw an RefAssertionException for cases where Language is not valid for writing to the database.

okToDeleteLanguage

protected void okToDeleteLanguage(LanguageDO member)
                           throws jobmatch.data.RefAssertionException
A stub method for implementing pre-delete assertions for the Language data member. Implement this stub to throw an RefAssertionException for cases where Language is not valid for deletion from the database.

okToCommitWritten

protected void okToCommitWritten(LanguagecapabilityDO member)
                          throws jobmatch.data.RefAssertionException
A stub method for implementing pre-commit assertions for the Written data member. Implement this stub to throw an RefAssertionException for cases where Written is not valid for writing to the database.

okToDeleteWritten

protected void okToDeleteWritten(LanguagecapabilityDO member)
                          throws jobmatch.data.RefAssertionException
A stub method for implementing pre-delete assertions for the Written data member. Implement this stub to throw an RefAssertionException for cases where Written is not valid for deletion from the database.

okToCommitSpoken

protected void okToCommitSpoken(LanguagecapabilityDO member)
                         throws jobmatch.data.RefAssertionException
A stub method for implementing pre-commit assertions for the Spoken data member. Implement this stub to throw an RefAssertionException for cases where Spoken is not valid for writing to the database.

okToDeleteSpoken

protected void okToDeleteSpoken(LanguagecapabilityDO member)
                         throws jobmatch.data.RefAssertionException
A stub method for implementing pre-delete assertions for the Spoken data member. Implement this stub to throw an RefAssertionException for cases where Spoken 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.

PSE 2000 Group 4