PSE 2000 Group 4

jobmatch.data
Class PersonDO

jobmatch.data.PersonDO

public class PersonDO
implements Serializable

Data core class, used to set, retrieve the PersonDO information.

Since:
jobmatch
Version:
$Revision: 1.4 $
See Also:
Serialized Form

Field Summary
static jobmatch.data.RDBColumn Adress
           
static jobmatch.data.RDBColumn Birthdate
           
static jobmatch.data.RDBColumn Email
           
static jobmatch.data.RDBColumn Fax
           
static jobmatch.data.RDBColumn Fname
           
protected static boolean isView
           
static jobmatch.data.RDBColumn Lname
           
static jobmatch.data.RDBColumn Natel
           
static jobmatch.data.RDBColumn Nationality
           
static jobmatch.data.RDBColumn Phone
           
static jobmatch.data.RDBColumn Picture
           
static jobmatch.data.RDBColumn PrimaryKey
           
static jobmatch.data.RDBColumn Residence
           
static jobmatch.data.RDBColumn Sex
           
static jobmatch.data.RDBTable table
          static final data members name the table and columns for this DO.
static jobmatch.data.RDBColumn URL
           
 
Constructor Summary
protected PersonDO()
          Protected constructor.
protected PersonDO(boolean is_view)
          Protected constructor.
protected PersonDO(jobmatch.data.ObjectId id)
          Protected constructor used by createExisting(ObjectId) above.
protected PersonDO(ResultSet rs)
          Protected constructor.
 
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 PersonDO createCopy(PersonDataStruct data)
          createCopy() Creates a DO that has no ObjectId but has a copy of an existing DO's data.
static PersonDO createCopy(PersonDO orig)
          createCopy() Creates a DO that has no ObjectId but has a copy of an existing DO's data.
static PersonDO createExisting(BigDecimal bd)
          createExisting( BigDecimal ) Factory method creates a PersonDO object by searching for it in the database using the passed BigDecimal value as the primary key.
protected static PersonDO createExisting(jobmatch.data.ObjectId id)
          createExisting( ObjectId ) Factory method creates a PersonDO object by searching for it in the database using the passed ObjectID value as the primary key.
protected static PersonDO createExisting(jobmatch.data.RDBColumnValue pk)
          createExisting( RDBColumnValue ) Factory method creates a PersonDO object by searching for it in the database using the passed PersonDO.PrimaryKey.
protected static PersonDO createExisting(jobmatch.data.RDBRow row)
          createExisting( RDBRow ) Factory method creates a PersonDO object by searching for it in the database using the PersonDO.PrimaryKey value in the passed RDBRow.
protected static PersonDO createExisting(ResultSet rs)
          createExisting( ResultSet ) Factory method used to create an instance of this class to represent a Data Object already existing in the database.
static PersonDO createExisting(String handle)
          The createExisting method is used to create a PersonDO from a string handle.
static PersonDO createVirgin()
          createVirgin() Creates a DO that has no ObjectId or data.
 void delete()
          Deletes the DO from its table.
 void delete(jobmatch.data.DBTransaction dbt)
          Deletes the DO from its table.
 AdressDO getAdress()
          Get Adress of the Person
 Date getBirthdate()
          Get Birthdate of the Person
 PreparedStatement getDeleteStatement(jobmatch.data.DBConnection conn)
          Prepares the statement used to delete this object from the database.
 String getEmail()
          Get Email of the Person
 String getFax()
          Get Fax of the Person
 String getFname()
          Get Fname of the Person
 String getHandle()
          The methods getHandle hasMatchingHandle are used by Presentation Objects that need to populate HTML select lists with Data Objects as options.
 PreparedStatement getInsertStatement(jobmatch.data.DBConnection conn)
          Prepares the statement used to insert this object into the database.
 String getLname()
          Get Lname of the Person
 String getNatel()
          Get Natel of the Person
 CountryDO getNationality()
          Get Nationality of the Person
 String getPhone()
          Get Phone of the Person
 PictureDO getPicture()
          Get Picture of the Person
 String getResidence()
          Get Residence of the Person
 String getSex()
          Get Sex of the Person
protected  String getTableName()
          Return Person as the name of the table in the database which contains PersonDO objects.
 PreparedStatement getUpdateStatement(jobmatch.data.DBConnection conn)
          Prepares the statement used to update this object in the database.
 String getURL()
          Get URL of the Person
 boolean hasMatchingHandle(String handle)
          hasMatchingHandle
 boolean isLoaded()
          isLoaded() Returns true if the data for this objects has been retrieved from the database.
 boolean isReadOnly()
          isReadOnly() Returns true if the data for this object has been marked read-only.
 void loadData()
          loadData() Load the fields for the DO from the database.
protected  void makeIdentical(PersonDO orig)
          makeIdentical() Assigns the DataStruct of an existing DO to this DO.
protected  void modifyDO(jobmatch.data.DBTransaction dbt, boolean delete)
          Modifies the DO within its table.
protected  void okToCommit()
          A stub method for implementing pre-commit assertions for this PersonDO.
protected  void okToCommitAdress(AdressDO member)
          A stub method for implementing pre-commit assertions for the Adress data member.
protected  void okToCommitNationality(CountryDO member)
          A stub method for implementing pre-commit assertions for the Nationality data member.
protected  void okToCommitPicture(PictureDO member)
          A stub method for implementing pre-commit assertions for the Picture data member.
protected  void okToDelete()
          A stub method for implementing pre-delete assertions for this PersonDO.
protected  void okToDeleteAdress(AdressDO member)
          A stub method for implementing pre-delete assertions for the Adress data member.
protected  void okToDeleteNationality(CountryDO member)
          A stub method for implementing pre-delete assertions for the Nationality data member.
protected  void okToDeletePicture(PictureDO member)
          A stub method for implementing pre-delete assertions for the Picture data member.
 void reload()
          reload() Causes the DO to refresh itself from the database the next time a set or get method is called.
 void setAdress(AdressDO Adress)
          Set Adress of the Person
 void setBirthdate(Date Birthdate)
          Set Birthdate of the Person
 void setEmail(String Email)
          Set Email of the Person
 void setFax(String Fax)
          Set Fax of the Person
 void setFname(String Fname)
          Set Fname of the Person
 void setLname(String Lname)
          Set Lname of the Person
 void setNatel(String Natel)
          Set Natel of the Person
 void setNationality(CountryDO Nationality)
          Set Nationality of the Person
 void setPhone(String Phone)
          Set Phone of the Person
 void setPicture(PictureDO Picture)
          Set Picture of the Person
 void setResidence(String Residence)
          Set Residence of the Person
 void setSex(String Sex)
          Set Sex of the Person
 void setURL(String URL)
          Set URL of the Person
 String toString()
           
 String toString(int indentCount)
           
 

Field Detail

table

public static final jobmatch.data.RDBTable table
static final data members name the table and columns for this DO. By using these members with an instance of the QueryBuilder class, an application can perform straight SQL queries while retaining compile-time checking of table and column usage. Example: List the Cities containing Persons named Bob: Using straight SQL with QueryBuilder: Pro: code runs faster because you create fewer objects Con: code is less clear Vector fields = new Vector(); fields.addElement( AddressDO.City ); QueryBuilder qb = new QueryBuilder( fields ); qb.addWhere( PersonDO.FirstName, "Bob" ); qb.addWhere( PersonDO.PrimaryKey, AddressDO.Person ); RDBRow row; while ( null != ( row = qb.getNextRow() ) ) { String city = row.get( AddressDO.City ).getString(); } Using Query/DO classes: Pro: code is (often) clearer Con: code runs slower because you create more objects PersonQuery pq = new PersonQuery(); pq.setQueryFirstName( "Bob" ); PersonDO[] bobs = pq.getDOArray(); for ( int i = 0; i < bobs.length; i++ ) { AddressQuery aq = new AddressQuery(); aq.setQueryPerson( bobs[i] ); AddressDO addr = aq.getNextDO(); String city = addr.getCity(); }

PrimaryKey

public static final jobmatch.data.RDBColumn PrimaryKey

isView

protected static final boolean isView

Picture

public static final jobmatch.data.RDBColumn Picture

Email

public static final jobmatch.data.RDBColumn Email

Fax

public static final jobmatch.data.RDBColumn Fax

Adress

public static final jobmatch.data.RDBColumn Adress

Fname

public static final jobmatch.data.RDBColumn Fname

Lname

public static final jobmatch.data.RDBColumn Lname

Natel

public static final jobmatch.data.RDBColumn Natel

Phone

public static final jobmatch.data.RDBColumn Phone

Residence

public static final jobmatch.data.RDBColumn Residence

Sex

public static final jobmatch.data.RDBColumn Sex

Birthdate

public static final jobmatch.data.RDBColumn Birthdate

Nationality

public static final jobmatch.data.RDBColumn Nationality

URL

public static final jobmatch.data.RDBColumn URL
Constructor Detail

PersonDO

protected PersonDO(boolean is_view)
            throws jobmatch.data.ObjectIdException,
                   jobmatch.data.DatabaseManagerException
Protected constructor. Only derived classes should call it.
Throws:
jobmatch.data.DatabaseManagerException - If a connection to the database cannot be established, etc.
com.lutris.appserver.server.sql.ObjectIdException - If an object id can't be allocated for this object.

PersonDO

protected PersonDO()
            throws jobmatch.data.ObjectIdException,
                   jobmatch.data.DatabaseManagerException
Protected constructor. Only derived classes should call it.
Throws:
jobmatch.data.DatabaseManagerException - If a connection to the database cannot be established, etc.
com.lutris.appserver.server.sql.ObjectIdException - If an object id can't be allocated for this object.

PersonDO

protected PersonDO(jobmatch.data.ObjectId id)
            throws SQLException,
                   jobmatch.data.ObjectIdException,
                   jobmatch.data.DataObjectException,
                   jobmatch.data.DatabaseManagerException
Protected constructor used by createExisting(ObjectId) above. Historical note (delete at will): Formerly, createExisting(ObjectId) invoked the no-args GenericDO ctor, which allocated a new ObjectId. Then, createExisting(ObjectId) would call setOId(id), discarding the newly allocated ObjectId; this resulted in an ObjectId "leak" (needless consumption of oid's.)
Parameters:
id - The ObjectId for the object.
Throws:
jobmatch.data.DataObjectException - If the object is not found in the database.
com.lutris.appserver.server.sql.ObjectIdException - If an object id can't be allocated for this object.
jobmatch.data.DatabaseManagerException - If a connection to the database cannot be established, etc.
SQLException - Should never see this exception since GenericDO.ctor(ObjectId) never accesses the database.

PersonDO

protected PersonDO(ResultSet rs)
            throws SQLException,
                   jobmatch.data.ObjectIdException,
                   jobmatch.data.DataObjectException,
                   jobmatch.data.DatabaseManagerException
Protected constructor.
Parameters:
rs - Result set from which to obtain product data.
Throws:
jobmatch.data.DataObjectException - If the object is not found in the database.
com.lutris.appserver.server.sql.ObjectIdException - If an object id can't be allocated for this object.
jobmatch.data.DatabaseManagerException - If a connection to the database cannot be established, etc.
SQLException - If the database rejects the SQL generated to retrieve data for this object, or if the table contains a bad foreign key, etc.
Method Detail

getTableName

protected String getTableName()
Return Person as the name of the table in the database which contains PersonDO objects. This method overrides CoreDO.getTableName() and is used by CoreDO.executeUpdate() during error handling.
Returns:
the database table name
See Also:
CoreDO

isReadOnly

public boolean isReadOnly()
isReadOnly() Returns true if the data for this object has been marked read-only.

isLoaded

public boolean isLoaded()
isLoaded() Returns true if the data for this objects has been retrieved from the database.

loadData

public void loadData()
              throws SQLException,
                     jobmatch.data.ObjectIdException,
                     jobmatch.data.DataObjectException
loadData() Load the fields for the DO from the database.
Throws:
com.lutris.appserver.server.sql.ObjectIdException - If an object id can't be allocated for this object.
jobmatch.data.DataObjectException - If the object is not found in the database.
SQLException - If the database rejects the SQL generated to retrieve data for this object, or if the table contains a bad foreign key, etc.

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()

createVirgin

public static PersonDO createVirgin()
                             throws jobmatch.data.DatabaseManagerException,
                                    jobmatch.data.ObjectIdException
createVirgin() Creates a DO that has no ObjectId or data. Such a DO is used to insert a new database entry after its data has been set.
Throws:
com.lutris.appserver.server.sql.ObjectIdException - If an object id can't be allocated for this object.
jobmatch.data.DatabaseManagerException - If a connection to the database cannot be established, etc.

createExisting

public static PersonDO createExisting(BigDecimal bd)
                               throws SQLException,
                                      jobmatch.data.ObjectIdException,
                                      jobmatch.data.DataObjectException,
                                      jobmatch.data.DatabaseManagerException
createExisting( BigDecimal ) Factory method creates a PersonDO object by searching for it in the database using the passed BigDecimal value as the primary key. Creates a DO that represents an existing entry in the database. Such a DO is used to examine and possibly update such an entry. createExisting() is called only from the code that retrieves an ObjectId from a ResultSet (database query result). createExisting() is protected because no other DO or BO should ever need to call it. FIX unfortunately the createExisting(BigDecimal) form *does* need to be public because it is called by the public ctors of other DOs. For example, AaaDO contains a ref to a BbbDO, so there is a method AaaDO.setBbb(BbbDO). In the ctor AaaDO(ResultSet), we have the call setBbb( BbbDO.createExisting( rs.getBigDecimal( "bbb", 0 ))); Since AaaDO is not in the same package as BbbDO, BbbDO.createExisting(BigDecimal) must be public, not protected. Java needs the C++ 'friend' idea.
Parameters:
bd - The BigDecimal representation of the ObjectId for the object.
Throws:
jobmatch.data.DataObjectException - If the object is not found in the database.
com.lutris.appserver.server.sql.ObjectIdException - If an object id can't be allocated for this object.
jobmatch.data.DatabaseManagerException - If a connection to the database cannot be established, etc.
SQLException - If the database rejects the SQL generated to retrieve data for this object, or if the table contains a bad foreign key, etc.

createExisting

public static PersonDO createExisting(String handle)
The createExisting method is used to create a PersonDO from a string handle.

createExisting

protected static PersonDO createExisting(jobmatch.data.ObjectId id)
                                  throws SQLException,
                                         jobmatch.data.ObjectIdException,
                                         jobmatch.data.DataObjectException,
                                         jobmatch.data.DatabaseManagerException
createExisting( ObjectId ) Factory method creates a PersonDO object by searching for it in the database using the passed ObjectID value as the primary key.
Parameters:
id - The ObjectId for the object.
Throws:
jobmatch.data.DataObjectException - If the object is not found in the database.
com.lutris.appserver.server.sql.ObjectIdException - If an object id can't be allocated for this object.
jobmatch.data.DatabaseManagerException - If a connection to the database cannot be established, etc.
SQLException - If the database rejects the SQL generated to retrieve data for this object, or if the table contains a bad foreign key, etc.

createExisting

protected static PersonDO createExisting(ResultSet rs)
                                  throws SQLException,
                                         jobmatch.data.ObjectIdException,
                                         jobmatch.data.DataObjectException,
                                         jobmatch.data.DatabaseManagerException
createExisting( ResultSet ) Factory method used to create an instance of this class to represent a Data Object already existing in the database.
Parameters:
rs - The ResultSet returned by the Query class for an existing Data Object stored in the database.
Throws:
jobmatch.data.DataObjectException - If the object is not found in the database.
com.lutris.appserver.server.sql.ObjectIdException - If an object id can't be allocated for this object.
jobmatch.data.DatabaseManagerException - If a connection to the database cannot be established, etc.
SQLException - If the database rejects the SQL generated to retrieve data for this object, or if the table contains a bad foreign key, etc.

createExisting

protected static PersonDO createExisting(jobmatch.data.RDBRow row)
                                  throws SQLException,
                                         jobmatch.data.ObjectIdException,
                                         jobmatch.data.DataObjectException,
                                         jobmatch.data.DatabaseManagerException
createExisting( RDBRow ) Factory method creates a PersonDO object by searching for it in the database using the PersonDO.PrimaryKey value in the passed RDBRow.
Parameters:
RDBRow - A row returned by QueryBuilder.getNextRow().
Throws:
jobmatch.data.DataObjectException - If the RDBRow does not contain a PersonDO.PrimaryKey. If the object is not found in the database.
com.lutris.appserver.server.sql.ObjectIdException - If an object id can't be allocated for this object.
jobmatch.data.DatabaseManagerException - If a connection to the database cannot be established, etc.
SQLException - If the database rejects the SQL generated to retrieve data for this object, or if the table contains a bad foreign key, etc.

createExisting

protected static PersonDO createExisting(jobmatch.data.RDBColumnValue pk)
                                  throws SQLException,
                                         jobmatch.data.ObjectIdException,
                                         jobmatch.data.DataObjectException,
                                         jobmatch.data.DatabaseManagerException
createExisting( RDBColumnValue ) Factory method creates a PersonDO object by searching for it in the database using the passed PersonDO.PrimaryKey.
Parameters:
RDBColumnValue - a PrimaryKey column value from a row that was returned by QueryBuilder.getNextRow().
Throws:
jobmatch.data.DataObjectException - If the RDBColumnValue does not contain a PersonDO.PrimaryKey. If the object is not found in the database.
com.lutris.appserver.server.sql.ObjectIdException - If an object id can't be allocated for this object.
jobmatch.data.DatabaseManagerException - If a connection to the database cannot be established, etc.
SQLException - If the database rejects the SQL generated to retrieve data for this object, or if the table contains a bad foreign key, etc.

createCopy

public static PersonDO createCopy(PersonDataStruct data)
                           throws jobmatch.data.DatabaseManagerException,
                                  jobmatch.data.ObjectIdException
createCopy() Creates a DO that has no ObjectId but has a copy of an existing DO's data. Such a DO is used to insert a new database entry that is largely similar to an existing entry.
Parameters:
data - The data struct to copy values from.
Throws:
com.lutris.appserver.server.sql.ObjectIdException - If an object id can't be allocated for this object.
jobmatch.data.DatabaseManagerException - If a connection to the database cannot be established, etc.

createCopy

public static PersonDO createCopy(PersonDO orig)
                           throws jobmatch.data.DatabaseManagerException,
                                  jobmatch.data.ObjectIdException
createCopy() Creates a DO that has no ObjectId but has a copy of an existing DO's data. Such a DO is used to insert a new database entry that is largely similar to an existing entry.
Parameters:
orig - The original DO to copy.
Throws:
com.lutris.appserver.server.sql.ObjectIdException - If an object id can't be allocated for this object.
jobmatch.data.DatabaseManagerException - If a connection to the database cannot be established, etc.

reload

public void reload()
reload() Causes the DO to refresh itself from the database the next time a set or get method is called.

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 Data 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.
Returns:
id of this DO 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)
hasMatchingHandle
Parameters:
handle - String version of DO id
Returns:
boolean True if the string version of the id of this DO matches passed handle
See Also:
getHandle

makeIdentical

protected void makeIdentical(PersonDO orig)
makeIdentical() Assigns the DataStruct of an existing DO to this DO. Does not duplicate data. Just assigns the reference.
Parameters:
orig - The original DO.

getPicture

public PictureDO getPicture()
                     throws jobmatch.data.DataObjectException
Get Picture of the Person
Returns:
Picture of the Person
Throws:
jobmatch.data.DataObjectException - If the object is not found in the database.

setPicture

public void setPicture(PictureDO Picture)
                throws jobmatch.data.DataObjectException
Set Picture of the Person
Parameters:
Picture - of the Person
Throws:
jobmatch.data.DataObjectException - If the object is not found in the database.

getEmail

public String getEmail()
                throws jobmatch.data.DataObjectException
Get Email of the Person
Returns:
Email of the Person
Throws:
jobmatch.data.DataObjectException - If the object is not found in the database.

setEmail

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

getFax

public String getFax()
              throws jobmatch.data.DataObjectException
Get Fax of the Person
Returns:
Fax of the Person
Throws:
jobmatch.data.DataObjectException - If the object is not found in the database.

setFax

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

getAdress

public AdressDO getAdress()
                   throws jobmatch.data.DataObjectException
Get Adress of the Person
Returns:
Adress of the Person
Throws:
jobmatch.data.DataObjectException - If the object is not found in the database.

setAdress

public void setAdress(AdressDO Adress)
               throws jobmatch.data.DataObjectException
Set Adress of the Person
Parameters:
Adress - of the Person
Throws:
jobmatch.data.DataObjectException - If the object is not found in the database.

getFname

public String getFname()
                throws jobmatch.data.DataObjectException
Get Fname of the Person
Returns:
Fname of the Person
Throws:
jobmatch.data.DataObjectException - If the object is not found in the database.

setFname

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

getLname

public String getLname()
                throws jobmatch.data.DataObjectException
Get Lname of the Person
Returns:
Lname of the Person
Throws:
jobmatch.data.DataObjectException - If the object is not found in the database.

setLname

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

getNatel

public String getNatel()
                throws jobmatch.data.DataObjectException
Get Natel of the Person
Returns:
Natel of the Person
Throws:
jobmatch.data.DataObjectException - If the object is not found in the database.

setNatel

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

getPhone

public String getPhone()
                throws jobmatch.data.DataObjectException
Get Phone of the Person
Returns:
Phone of the Person
Throws:
jobmatch.data.DataObjectException - If the object is not found in the database.

setPhone

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

getResidence

public String getResidence()
                    throws jobmatch.data.DataObjectException
Get Residence of the Person
Returns:
Residence of the Person
Throws:
jobmatch.data.DataObjectException - If the object is not found in the database.

setResidence

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

getSex

public String getSex()
              throws jobmatch.data.DataObjectException
Get Sex of the Person
Returns:
Sex of the Person
Throws:
jobmatch.data.DataObjectException - If the object is not found in the database.

setSex

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

getBirthdate

public Date getBirthdate()
                  throws jobmatch.data.DataObjectException
Get Birthdate of the Person
Returns:
Birthdate of the Person
Throws:
jobmatch.data.DataObjectException - If the object is not found in the database.

setBirthdate

public void setBirthdate(Date Birthdate)
                  throws jobmatch.data.DataObjectException
Set Birthdate of the Person
Parameters:
Birthdate - of the Person
Throws:
jobmatch.data.DataObjectException - If the object is not found in the database.

getNationality

public CountryDO getNationality()
                         throws jobmatch.data.DataObjectException
Get Nationality of the Person
Returns:
Nationality of the Person
Throws:
jobmatch.data.DataObjectException - If the object is not found in the database.

setNationality

public void setNationality(CountryDO Nationality)
                    throws jobmatch.data.DataObjectException
Set Nationality of the Person
Parameters:
Nationality - of the Person
Throws:
jobmatch.data.DataObjectException - If the object is not found in the database.

getURL

public String getURL()
              throws jobmatch.data.DataObjectException
Get URL of the Person
Returns:
URL of the Person
Throws:
jobmatch.data.DataObjectException - If the object is not found in the database.

setURL

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

getInsertStatement

public PreparedStatement getInsertStatement(jobmatch.data.DBConnection conn)
                                     throws SQLException
Prepares the statement used to insert this object into the database.
Parameters:
conn - the database connection.
Returns:
the insert statement.
Throws:
SQLException - if an error occurs.

getUpdateStatement

public PreparedStatement getUpdateStatement(jobmatch.data.DBConnection conn)
                                     throws SQLException
Prepares the statement used to update this object in the database.
Parameters:
conn - the database connection
Returns:
the update statement.
Throws:
SQLException - if an error occurs.

getDeleteStatement

public PreparedStatement getDeleteStatement(jobmatch.data.DBConnection conn)
                                     throws SQLException
Prepares the statement used to delete this object from the database.
Parameters:
conn - the database connection
Returns:
the delete statement.
Throws:
SQLException - if an error occurs.

toString

public String toString()

toString

public String toString(int indentCount)

okToCommit

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

okToDelete

protected void okToDelete()
                   throws jobmatch.data.RefAssertionException
A stub method for implementing pre-delete assertions for this PersonDO. Implement this stub to throw an RefAssertionException for cases where this object is not valid for deletion from 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 DO which 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.
com.lutris.appserver.server.sql.DBRowUpdateException - if a version error occurs.
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 DO which 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.
com.lutris.appserver.server.sql.DBRowUpdateException - if a version error occurs.
jobmatch.data.RefAssertionException - thrown by okTo method.
SQLException - if any SQL errors occur.

okToCommitPicture

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

okToDeletePicture

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

okToCommitAdress

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

okToDeleteAdress

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

okToCommitNationality

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

okToDeleteNationality

protected void okToDeleteNationality(CountryDO member)
                              throws jobmatch.data.RefAssertionException
A stub method for implementing pre-delete assertions for the Nationality data member. Implement this stub to throw an RefAssertionException for cases where Nationality 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.
com.lutris.appserver.server.sql.DBRowUpdateException - if a version error occurs.
jobmatch.data.RefAssertionException - thrown by okTo method.
SQLException - if any SQL errors occur.

PSE 2000 Group 4