|
PSE 2000 Group 4 | |||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object | +--jobmatch.data.SchooltypeBDO
SchooltypeBDO contains the same set and get methods as the SchooltypeDO 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.
Field Summary | |
protected SchooltypeDO |
DO
The SchooltypeDO object upon which the set and get methods operate. |
Constructor Summary | |
SchooltypeBDO()
Constructor required by SchooltypeBDO.create methods. |
|
SchooltypeBDO(SchooltypeDO DO)
Constructor for use by classes derived from SchooltypeBDO . |
Method Summary | |
void |
addSchoolBDO(SchoolBDO rbdo)
Add (set & commit) a SchoolBDO object whose SchoolDO refers to the DO held by this BDO. |
void |
addSchoolBDO(SchoolBDO rbdo,
jobmatch.data.DBTransaction tran)
Add (set & commit) a SchoolBDO object whose SchoolDO 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 SchooltypeBDO |
createExisting(SchooltypeDO DO)
The createExisting method is used to create a SchooltypeBDO
from a SchooltypeDO that was returned by
the SchooltypeQuery class. |
static SchooltypeBDO |
createVirgin()
Like the class SchooltypeDO ,
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 SchooltypeBDO[] |
getBDOarray()
The getBDOarray method performs a database query to return an array of SchooltypeBDO objects
representing all the rows in the Schooltype table. |
String |
getDescription()
Get Description of the SchooltypeDO |
SchooltypeDO |
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 SchooltypeBDO objects as options. |
SchoolBDO |
getSchoolBDO()
Get the single SchoolBDO object holding a SchoolDO object that refers to the DO held by this BDO. |
SchoolBDO[] |
getSchoolBDOArray()
Get array of SchoolBDO objects holding SchoolDO objects that refer to the DO held by this BDO. |
SchoolDO |
getSchoolDO()
Get the single SchoolDO object that refers to the DO held by this BDO. |
SchoolDO[] |
getSchoolDOArray()
Get array of SchoolDO objects that refer to the DO held by this BDO. |
boolean |
hasMatchingHandle(String handle)
|
protected void |
modifyDO(jobmatch.data.DBTransaction dbt,
boolean delete)
Modifies the DO within its table. |
void |
removeSchoolBDO(SchoolBDO rbdo)
Remove (delete) a SchoolBDO object whose SchoolDO refers to the DO held by this BDO. |
void |
removeSchoolBDO(SchoolBDO rbdo,
jobmatch.data.DBTransaction tran)
Remove (delete) a SchoolBDO object whose SchoolDO refers to the DO held by this BDO. |
void |
setDescription(String Description)
Set Description of the SchooltypeDO |
String |
toString()
for debugging |
Methods inherited from class java.lang.Object |
|
Field Detail |
protected SchooltypeDO DO
Constructor Detail |
public SchooltypeBDO(SchooltypeDO DO)
SchooltypeBDO
.
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 );
}
}
public SchooltypeBDO() throws Exception
SchooltypeBDO.create
methods.Method Detail |
public SchooltypeDO getDO()
public static SchooltypeBDO createVirgin() throws Exception
SchooltypeDO
,
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.public static SchooltypeBDO createExisting(SchooltypeDO DO)
SchooltypeBDO
from a SchooltypeDO
that was returned by
the SchooltypeQuery
class.public static SchooltypeBDO[] getBDOarray() throws jobmatch.data.DataObjectException
SchooltypeBDO
objects
representing all the rows in the Schooltype
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 SchooltypeDO
which was
marked as "Can be queried" in the DODS Attribute Editor.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 String getHandle() throws jobmatch.data.DatabaseManagerException
getHandle
hasMatchingHandle
are used by Presentation Objects that need to populate
HTML select lists with SchooltypeBDO
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 SchooltypeBDO object holds a reference to a SchooltypeDO object.
The id of this SchooltypeBDO is the id of its SchooltypeDO.
- 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.
public boolean hasMatchingHandle(String handle)
handle
- String
representation of the id for this BDOgetHandle
public String toString()
public String getDescription() throws jobmatch.data.DataObjectException
public void setDescription(String Description) throws jobmatch.data.DataObjectException
Description
- of the SchooltypeDOpublic SchoolDO[] getSchoolDOArray() throws jobmatch.data.DataObjectException, jobmatch.data.QueryException
public SchoolDO getSchoolDO() throws jobmatch.data.DataObjectException, jobmatch.data.NonUniqueQueryException, jobmatch.data.QueryException
public SchoolBDO[] getSchoolBDOArray() throws jobmatch.data.DataObjectException, jobmatch.data.QueryException
public SchoolBDO getSchoolBDO() throws jobmatch.data.DataObjectException, jobmatch.data.NonUniqueQueryException, jobmatch.data.QueryException
public void addSchoolBDO(SchoolBDO rbdo) throws SQLException, jobmatch.data.DatabaseManagerException, jobmatch.data.DataObjectException, jobmatch.data.RefAssertionException, jobmatch.data.DBRowUpdateException, jobmatch.data.QueryException
rbdo
- SchoolBDO to be set to point to this BDO and committed.public void addSchoolBDO(SchoolBDO rbdo, jobmatch.data.DBTransaction tran) throws SQLException, jobmatch.data.DatabaseManagerException, jobmatch.data.DataObjectException, jobmatch.data.RefAssertionException, jobmatch.data.DBRowUpdateException, jobmatch.data.QueryException
rbdo
- SchoolBDO 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.public void removeSchoolBDO(SchoolBDO rbdo) throws SQLException, jobmatch.data.DatabaseManagerException, jobmatch.data.DataObjectException, jobmatch.data.RefAssertionException, jobmatch.data.DBRowUpdateException, jobmatch.data.QueryException
r
- SchoolBDO to be deleted.public void removeSchoolBDO(SchoolBDO rbdo, jobmatch.data.DBTransaction tran) throws SQLException, jobmatch.data.DatabaseManagerException, jobmatch.data.DataObjectException, jobmatch.data.RefAssertionException, jobmatch.data.DBRowUpdateException, jobmatch.data.QueryException
r
- SchoolBDO to be deleted.tran
- The transaction to be used for the commit.
If null, a new transaction is created.public void commit() throws SQLException, jobmatch.data.DatabaseManagerException, jobmatch.data.DataObjectException, jobmatch.data.RefAssertionException, jobmatch.data.DBRowUpdateException, jobmatch.data.QueryException
public void commit(jobmatch.data.DBTransaction dbt) throws SQLException, jobmatch.data.DatabaseManagerException, jobmatch.data.DataObjectException, jobmatch.data.RefAssertionException, jobmatch.data.DBRowUpdateException, jobmatch.data.QueryException
dbt
- The transaction object to use for this operation.public void delete() throws SQLException, jobmatch.data.DatabaseManagerException, jobmatch.data.DataObjectException, jobmatch.data.RefAssertionException, jobmatch.data.DBRowUpdateException, jobmatch.data.QueryException
public void delete(jobmatch.data.DBTransaction dbt) throws SQLException, jobmatch.data.DatabaseManagerException, jobmatch.data.DataObjectException, jobmatch.data.RefAssertionException, jobmatch.data.DBRowUpdateException, jobmatch.data.QueryException
dbt
- The transaction object to use for this operation.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
dbt
- The transaction object to use for this operation.delete
- True if doing a delete, otherwise doing insert/update.
|
PSE 2000 Group 4 | |||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |