jobmatch.data
Class CompanyAccountBDO

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

Direct Known Subclasses:

CompanyAccount

public class CompanyAccountBDO

extends Object

implements Serializable

CompanyAccountBDO contains the same set and get methods as the CompanyAccountDO 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.7 $

See Also:

Serialized Form

Field Summary

protected CompanyAccountDO

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

Constructor Summary

CompanyAccountBDO()
Constructor required by CompanyAccountBDO.create methods.

CompanyAccountBDO(CompanyAccountDO DO)
Constructor for use by classes derived from CompanyAccountBDO.

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 CompanyAccountBDO	createExisting(CompanyAccountDO DO) The createExisting method is used to create a CompanyAccountBDO from a CompanyAccountDO that was returned by the CompanyAccountQuery class.
static CompanyAccountBDO	createVirgin() Like the class CompanyAccountDO, 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 CompanyAccountBDO[]	getBDOarray() The getBDOarray method performs a database query to return an array of CompanyAccountBDO objects representing all the rows in the CompanyAccount table.
CompanyDO	getCompany() Get Company of the CompanyAccountDO
CompanyBDO	getCompanyBDO() Get BDO-wrapped Company of the CompanyAccountDO
CompanyAccountDO	getDO() Note: This method is intended for use only by other BDO classes.
String	getEmail() Get Email of the CompanyAccountDO
String	getHandle() The methods getHandle hasMatchingHandle are used by Presentation Objects that need to populate HTML select lists with CompanyAccountBDO objects as options.
String	getLastHost() Get LastHost of the CompanyAccountDO
String	getLastIP() Get LastIP of the CompanyAccountDO
Timestamp	getLastLogin() Get LastLogin of the CompanyAccountDO
int	getLoginReminder() Get LoginReminder of the CompanyAccountDO
String	getPassphrase() Get Passphrase of the CompanyAccountDO
String	getUsername() Get Username of the CompanyAccountDO
boolean	hasMatchingHandle(String handle)
protected void	modifyDO(jobmatch.data.DBTransaction dbt, boolean delete) Modifies the DO within its table.
protected void	okToCommitCompany(CompanyDO member) A stub method for implementing pre-commit assertions for the Company data member.
protected void	okToDeleteCompany(CompanyDO member) A stub method for implementing pre-delete assertions for the Company data member.
void	setCompany(CompanyBDO Company) Set Company of the CompanyAccountDO
void	setCompany(CompanyDO Company) Set Company of the CompanyAccountDO
void	setEmail(String Email) Set Email of the CompanyAccountDO
void	setLastHost(String LastHost) Set LastHost of the CompanyAccountDO
void	setLastIP(String LastIP) Set LastIP of the CompanyAccountDO
void	setLastLogin(Timestamp LastLogin) Set LastLogin of the CompanyAccountDO
void	setLoginReminder(int LoginReminder) Set LoginReminder of the CompanyAccountDO
void	setPassphrase(String Passphrase) Set Passphrase of the CompanyAccountDO
void	setUsername(String Username) Set Username of the CompanyAccountDO
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 CompanyAccountDO DO

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

Constructor Detail

CompanyAccountBDO

public CompanyAccountBDO(CompanyAccountDO DO)

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

CompanyAccountBDO

public CompanyAccountBDO()
                  throws Exception

Constructor required by CompanyAccountBDO.create methods.

Method Detail

getDO

public CompanyAccountDO 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 CompanyAccountBDO createVirgin()
                                      throws Exception

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

The createExisting method is used to create a CompanyAccountBDO from a CompanyAccountDO that was returned by the CompanyAccountQuery class.

getBDOarray

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

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

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

getUsername

public String getUsername()
                   throws jobmatch.data.DataObjectException

Get Username of the CompanyAccountDO

Returns:

Username of the CompanyAccountDO

Throws:

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

setUsername

public void setUsername(String Username)
                 throws jobmatch.data.DataObjectException

Set Username of the CompanyAccountDO

Parameters:

Username - of the CompanyAccountDO

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 CompanyAccountDO

Returns:

Email of the CompanyAccountDO

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 CompanyAccountDO

Parameters:

Email - of the CompanyAccountDO

Throws:

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

getLastLogin

public Timestamp getLastLogin()
                       throws jobmatch.data.DataObjectException

Get LastLogin of the CompanyAccountDO

Returns:

LastLogin of the CompanyAccountDO

Throws:

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

setLastLogin

public void setLastLogin(Timestamp LastLogin)
                  throws jobmatch.data.DataObjectException

Set LastLogin of the CompanyAccountDO

Parameters:

LastLogin - of the CompanyAccountDO

Throws:

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

getLoginReminder

public int getLoginReminder()
                     throws jobmatch.data.DataObjectException

Get LoginReminder of the CompanyAccountDO

Returns:

LoginReminder of the CompanyAccountDO

Throws:

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

setLoginReminder

public void setLoginReminder(int LoginReminder)
                      throws jobmatch.data.DataObjectException

Set LoginReminder of the CompanyAccountDO

Parameters:

LoginReminder - of the CompanyAccountDO

Throws:

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

getPassphrase

public String getPassphrase()
                     throws jobmatch.data.DataObjectException

Get Passphrase of the CompanyAccountDO

Returns:

Passphrase of the CompanyAccountDO

Throws:

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

setPassphrase

public void setPassphrase(String Passphrase)
                   throws jobmatch.data.DataObjectException

Set Passphrase of the CompanyAccountDO

Parameters:

Passphrase - of the CompanyAccountDO

Throws:

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

getLastIP

public String getLastIP()
                 throws jobmatch.data.DataObjectException

Get LastIP of the CompanyAccountDO

Returns:

LastIP of the CompanyAccountDO

Throws:

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

setLastIP

public void setLastIP(String LastIP)
               throws jobmatch.data.DataObjectException

Set LastIP of the CompanyAccountDO

Parameters:

LastIP - of the CompanyAccountDO

Throws:

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

getLastHost

public String getLastHost()
                   throws jobmatch.data.DataObjectException

Get LastHost of the CompanyAccountDO

Returns:

LastHost of the CompanyAccountDO

Throws:

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

setLastHost

public void setLastHost(String LastHost)
                 throws jobmatch.data.DataObjectException

Set LastHost of the CompanyAccountDO

Parameters:

LastHost - of the CompanyAccountDO

Throws:

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

getCompany

public CompanyDO getCompany()
                     throws jobmatch.data.DataObjectException

Get Company of the CompanyAccountDO

Returns:

Company of the CompanyAccountDO

Throws:

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

setCompany

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

Set Company of the CompanyAccountDO

Parameters:

Company - of the CompanyAccountDO

Throws:

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

getCompanyBDO

public CompanyBDO getCompanyBDO()
                         throws jobmatch.data.DataObjectException

Get BDO-wrapped Company of the CompanyAccountDO

Returns:

BDO-wrapped Company of the CompanyAccountDO

Throws:

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

setCompany

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

Set Company of the CompanyAccountDO

Parameters:

BDO-wrapped - Company of the CompanyAccountDO

Throws:

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

commit

public void commit()
            throws SQLException,
                   jobmatch.data.DatabaseManagerException,
                   jobmatch.data.DataObjectException,
                   jobmatch.data.RefAssertionException,
                   jobmatch.data.DBRowUpdateException,
                   jobmatch.data.QueryException

Inserts/Updates the DO into its table.

Throws:

com.lutris.appserver.server.sql.DatabaseManagerException - if a Transaction can not be created.

jobmatch.data.RefAssertionException - thrown by okTo method.

SQLException - if any SQL errors occur.

commit

public void commit(jobmatch.data.DBTransaction dbt)
            throws SQLException,
                   jobmatch.data.DatabaseManagerException,
                   jobmatch.data.DataObjectException,
                   jobmatch.data.RefAssertionException,
                   jobmatch.data.DBRowUpdateException,
                   jobmatch.data.QueryException

Inserts/Updates the DO into its table. The transaction is likely provided by the commit() method of another BDO whose DO references this DO.

Parameters:

dbt - The transaction object to use for this operation.

Throws:

com.lutris.appserver.server.sql.DatabaseManagerException - if a Transaction can not be created.

jobmatch.data.RefAssertionException - thrown by okTo method.

SQLException - if any SQL errors occur.

delete

public void delete()
            throws SQLException,
                   jobmatch.data.DatabaseManagerException,
                   jobmatch.data.DataObjectException,
                   jobmatch.data.RefAssertionException,
                   jobmatch.data.DBRowUpdateException,
                   jobmatch.data.QueryException

Deletes the DO from its table.

Throws:

com.lutris.appserver.server.sql.DatabaseManagerException - if a Transaction can not be created.

jobmatch.data.RefAssertionException - thrown by okTo method.

SQLException - if any SQL errors occur.

delete

public void delete(jobmatch.data.DBTransaction dbt)
            throws SQLException,
                   jobmatch.data.DatabaseManagerException,
                   jobmatch.data.DataObjectException,
                   jobmatch.data.RefAssertionException,
                   jobmatch.data.DBRowUpdateException,
                   jobmatch.data.QueryException

Deletes the DO from its table. The transaction is likely provided by the delete() method of another BDO whose DO references this DO.

Parameters:

dbt - The transaction object to use for this operation.

Throws:

com.lutris.appserver.server.sql.DatabaseManagerException - if a Transaction can not be created.

jobmatch.data.RefAssertionException - thrown by okTo method.

SQLException - if any SQL errors occur.

okToCommitCompany

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

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

okToDeleteCompany

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

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

modifyDO

protected void modifyDO(jobmatch.data.DBTransaction dbt,
                        boolean delete)
                 throws SQLException,
                        jobmatch.data.DatabaseManagerException,
                        jobmatch.data.DataObjectException,
                        jobmatch.data.RefAssertionException,
                        jobmatch.data.DBRowUpdateException,
                        jobmatch.data.QueryException

Modifies the DO within its table. Performs recursive commit/delete on referenced DOs; all operations occur within a single transaction to allow rollback in the event of error. Only the creator of the transaction releases it.

Parameters:

dbt - The transaction object to use for this operation.

delete - True if doing a delete, otherwise doing insert/update.

Throws:

com.lutris.appserver.server.sql.DatabaseManagerException - if a Transaction can not be created.

jobmatch.data.RefAssertionException - thrown by okTo method.

SQLException - if any SQL errors occur.