|
PSE 2000 Group 4 | |||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
jobmatch.data.PersonDO
Data core class, used to set, retrieve the PersonDO information.
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 |
public static final jobmatch.data.RDBTable table
public static final jobmatch.data.RDBColumn PrimaryKey
protected static final boolean isView
public static final jobmatch.data.RDBColumn Picture
public static final jobmatch.data.RDBColumn Email
public static final jobmatch.data.RDBColumn Fax
public static final jobmatch.data.RDBColumn Adress
public static final jobmatch.data.RDBColumn Fname
public static final jobmatch.data.RDBColumn Lname
public static final jobmatch.data.RDBColumn Natel
public static final jobmatch.data.RDBColumn Phone
public static final jobmatch.data.RDBColumn Residence
public static final jobmatch.data.RDBColumn Sex
public static final jobmatch.data.RDBColumn Birthdate
public static final jobmatch.data.RDBColumn Nationality
public static final jobmatch.data.RDBColumn URL
Constructor Detail |
protected PersonDO(boolean is_view) throws jobmatch.data.ObjectIdException, jobmatch.data.DatabaseManagerException
protected PersonDO() throws jobmatch.data.ObjectIdException, jobmatch.data.DatabaseManagerException
protected PersonDO(jobmatch.data.ObjectId id) throws SQLException, jobmatch.data.ObjectIdException, jobmatch.data.DataObjectException, jobmatch.data.DatabaseManagerException
id
- The ObjectId for the object.protected PersonDO(ResultSet rs) throws SQLException, jobmatch.data.ObjectIdException, jobmatch.data.DataObjectException, jobmatch.data.DatabaseManagerException
rs
- Result set from which to obtain product data.Method Detail |
protected String getTableName()
CoreDO
public boolean isReadOnly()
public boolean isLoaded()
public void loadData() throws SQLException, jobmatch.data.ObjectIdException, jobmatch.data.DataObjectException
protected void beforeAnyGet()
beforeAnyGet
beforeAnySet
afterAnySet
to handle any general assertions or cleanup needed
for get
and set
methods.protected void beforeAnySet() throws Exception
protected void afterAnySet()
public static PersonDO createVirgin() throws jobmatch.data.DatabaseManagerException, jobmatch.data.ObjectIdException
public static PersonDO createExisting(BigDecimal bd) throws SQLException, jobmatch.data.ObjectIdException, jobmatch.data.DataObjectException, jobmatch.data.DatabaseManagerException
bd
- The BigDecimal representation of the ObjectId for the object.public static PersonDO createExisting(String handle)
PersonDO
from a string handle.protected static PersonDO createExisting(jobmatch.data.ObjectId id) throws SQLException, jobmatch.data.ObjectIdException, jobmatch.data.DataObjectException, jobmatch.data.DatabaseManagerException
id
- The ObjectId for the object.protected static PersonDO createExisting(ResultSet rs) throws SQLException, jobmatch.data.ObjectIdException, jobmatch.data.DataObjectException, jobmatch.data.DatabaseManagerException
rs
- The ResultSet returned by the Query class for
an existing Data Object stored in the database.protected static PersonDO createExisting(jobmatch.data.RDBRow row) throws SQLException, jobmatch.data.ObjectIdException, jobmatch.data.DataObjectException, jobmatch.data.DatabaseManagerException
RDBRow
- A row returned by QueryBuilder.getNextRow().protected static PersonDO createExisting(jobmatch.data.RDBColumnValue pk) throws SQLException, jobmatch.data.ObjectIdException, jobmatch.data.DataObjectException, jobmatch.data.DatabaseManagerException
RDBColumnValue
- a PrimaryKey column value from a row
that was returned by QueryBuilder.getNextRow().public static PersonDO createCopy(PersonDataStruct data) throws jobmatch.data.DatabaseManagerException, jobmatch.data.ObjectIdException
data
- The data struct to copy values from.public static PersonDO createCopy(PersonDO orig) throws jobmatch.data.DatabaseManagerException, jobmatch.data.ObjectIdException
orig
- The original DO to copy.public void reload()
public String getHandle() throws jobmatch.data.DatabaseManagerException
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.
Overview
Package
Class
Use
Tree
Deprecated
Index
Help
PSE 2000 Group 4
PREV CLASS
NEXT CLASS
FRAMES
NO FRAMES
SUMMARY: INNER | FIELD | CONSTR | METHOD
DETAIL: FIELD | CONSTR | METHOD