Id, $intId) ); } /** * Load all Addresses * @param QQClause[] $objOptionalClauses additional optional QQClause objects for this query * @return Address[] */ public static function LoadAll($objOptionalClauses = null) { // Call Address::QueryArray to perform the LoadAll query try { return Address::QueryArray(QQ::All(), $objOptionalClauses); } catch (QCallerException $objExc) { $objExc->IncrementOffset(); throw $objExc; } } /** * Count all Addresses * @return int */ public static function CountAll() { // Call Address::QueryCount to perform the CountAll query return Address::QueryCount(QQ::All()); } /////////////////////////////// // QCODO QUERY-RELATED METHODS /////////////////////////////// /** * Internally called method to assist with calling Qcodo Query for this class * on load methods. * @param QQueryBuilder &$objQueryBuilder the QueryBuilder object that will be created * @param QQCondition $objConditions any conditions on the query, itself * @param QQClause[] $objOptionalClausees additional optional QQClause object or array of QQClause objects for this query * @param mixed[] $mixParameterArray a array of name-value pairs to perform PrepareStatement with (sending in null will skip the PrepareStatement step) * @param boolean $blnCountOnly only select a rowcount * @return string the query statement */ protected static function BuildQueryStatement(&$objQueryBuilder, QQCondition $objConditions, $objOptionalClauses, $mixParameterArray, $blnCountOnly) { // Get the Database Object for this Class $objDatabase = Address::GetDatabase(); // Create/Build out the QueryBuilder object with Address-specific SELET and FROM fields $objQueryBuilder = new QQueryBuilder($objDatabase, 'address'); Address::GetSelectFields($objQueryBuilder); $objQueryBuilder->AddFromItem('address'); // Set "CountOnly" option (if applicable) if ($blnCountOnly) $objQueryBuilder->SetCountOnlyFlag(); // Apply Any Conditions if ($objConditions) try { $objConditions->UpdateQueryBuilder($objQueryBuilder); } catch (QCallerException $objExc) { $objExc->IncrementOffset(); throw $objExc; } // Iterate through all the Optional Clauses (if any) and perform accordingly if ($objOptionalClauses) { if ($objOptionalClauses instanceof QQClause) $objOptionalClauses->UpdateQueryBuilder($objQueryBuilder); else if (is_array($objOptionalClauses)) foreach ($objOptionalClauses as $objClause) $objClause->UpdateQueryBuilder($objQueryBuilder); else throw new QCallerException('Optional Clauses must be a QQClause object or an array of QQClause objects'); } // Get the SQL Statement $strQuery = $objQueryBuilder->GetStatement(); // Prepare the Statement with the Query Parameters (if applicable) if ($mixParameterArray) { if (is_array($mixParameterArray)) { if (count($mixParameterArray)) $strQuery = $objDatabase->PrepareStatement($strQuery, $mixParameterArray); // Ensure that there are no other Unresolved Named Parameters if (strpos($strQuery, chr(QQNamedValue::DelimiterCode) . '{') !== false) throw new QCallerException('Unresolved named parameters in the query'); } else throw new QCallerException('Parameter Array must be an array of name-value parameter pairs'); } // Return the Objects return $strQuery; } /** * Static Qcodo Query method to query for a single Address object. * Uses BuildQueryStatment to perform most of the work. * @param QQCondition $objConditions any conditions on the query, itself * @param QQClause[] $objOptionalClausees additional optional QQClause objects for this query * @param mixed[] $mixParameterArray a array of name-value pairs to perform PrepareStatement with * @return Address the queried object */ public static function QuerySingle(QQCondition $objConditions, $objOptionalClauses = null, $mixParameterArray = null) { // Get the Query Statement try { $strQuery = Address::BuildQueryStatement($objQueryBuilder, $objConditions, $objOptionalClauses, $mixParameterArray, false); } catch (QCallerException $objExc) { $objExc->IncrementOffset(); throw $objExc; } // Perform the Query, Get the First Row, and Instantiate a new Address object $objDbResult = $objQueryBuilder->Database->Query($strQuery); return Address::InstantiateDbRow($objDbResult->GetNextRow(), null, null, null, $objQueryBuilder->ColumnAliasArray); } /** * Static Qcodo Query method to query for an array of Address objects. * Uses BuildQueryStatment to perform most of the work. * @param QQCondition $objConditions any conditions on the query, itself * @param QQClause[] $objOptionalClausees additional optional QQClause objects for this query * @param mixed[] $mixParameterArray a array of name-value pairs to perform PrepareStatement with * @return Address[] the queried objects as an array */ public static function QueryArray(QQCondition $objConditions, $objOptionalClauses = null, $mixParameterArray = null) { // Get the Query Statement try { $strQuery = Address::BuildQueryStatement($objQueryBuilder, $objConditions, $objOptionalClauses, $mixParameterArray, false); } catch (QCallerException $objExc) { $objExc->IncrementOffset(); throw $objExc; } // Perform the Query and Instantiate the Array Result $objDbResult = $objQueryBuilder->Database->Query($strQuery); return Address::InstantiateDbResult($objDbResult, $objQueryBuilder->ExpandAsArrayNodes, $objQueryBuilder->ColumnAliasArray); } /** * Static Qcodo Query method to query for a count of Address objects. * Uses BuildQueryStatment to perform most of the work. * @param QQCondition $objConditions any conditions on the query, itself * @param QQClause[] $objOptionalClausees additional optional QQClause objects for this query * @param mixed[] $mixParameterArray a array of name-value pairs to perform PrepareStatement with * @return integer the count of queried objects as an integer */ public static function QueryCount(QQCondition $objConditions, $objOptionalClauses = null, $mixParameterArray = null) { // Get the Query Statement try { $strQuery = Address::BuildQueryStatement($objQueryBuilder, $objConditions, $objOptionalClauses, $mixParameterArray, true); } catch (QCallerException $objExc) { $objExc->IncrementOffset(); throw $objExc; } // Perform the Query and return the row_count $objDbResult = $objQueryBuilder->Database->Query($strQuery); // Figure out if the query is using GroupBy $blnGrouped = false; if ($objOptionalClauses) foreach ($objOptionalClauses as $objClause) { if ($objClause instanceof QQGroupBy) { $blnGrouped = true; break; } } if ($blnGrouped) // Groups in this query - return the count of Groups (which is the count of all rows) return $objDbResult->CountRows(); else { // No Groups - return the sql-calculated count(*) value $strDbRow = $objDbResult->FetchRow(); return QType::Cast($strDbRow[0], QType::Integer); } } /* public static function QueryArrayCached($strConditions, $mixParameterArray = null) { // Get the Database Object for this Class $objDatabase = Address::GetDatabase(); // Lookup the QCache for This Query Statement $objCache = new QCache('query', 'address_' . serialize($strConditions)); if (!($strQuery = $objCache->GetData())) { // Not Found -- Go ahead and Create/Build out a new QueryBuilder object with Address-specific fields $objQueryBuilder = new QQueryBuilder($objDatabase); Address::GetSelectFields($objQueryBuilder); Address::GetFromFields($objQueryBuilder); // Ensure the Passed-in Conditions is a string try { $strConditions = QType::Cast($strConditions, QType::String); } catch (QCallerException $objExc) { $objExc->IncrementOffset(); throw $objExc; } // Create the Conditions object, and apply it $objConditions = eval('return ' . $strConditions . ';'); // Apply Any Conditions if ($objConditions) $objConditions->UpdateQueryBuilder($objQueryBuilder); // Get the SQL Statement $strQuery = $objQueryBuilder->GetStatement(); // Save the SQL Statement in the Cache $objCache->SaveData($strQuery); } // Prepare the Statement with the Parameters if ($mixParameterArray) $strQuery = $objDatabase->PrepareStatement($strQuery, $mixParameterArray); // Perform the Query and Instantiate the Array Result $objDbResult = $objDatabase->Query($strQuery); return Address::InstantiateDbResult($objDbResult); }*/ /** * Updates a QQueryBuilder with the SELECT fields for this Address * @param QQueryBuilder $objBuilder the Query Builder object to update * @param string $strPrefix optional prefix to add to the SELECT fields */ public static function GetSelectFields(QQueryBuilder $objBuilder, $strPrefix = null) { if ($strPrefix) { $strTableName = $strPrefix; $strAliasPrefix = $strPrefix . '__'; } else { $strTableName = 'address'; $strAliasPrefix = ''; } $objBuilder->AddSelectItem($strTableName, 'id', $strAliasPrefix . 'id'); $objBuilder->AddSelectItem($strTableName, 'title', $strAliasPrefix . 'title'); $objBuilder->AddSelectItem($strTableName, 'person_id', $strAliasPrefix . 'person_id'); $objBuilder->AddSelectItem($strTableName, 'street_1', $strAliasPrefix . 'street_1'); $objBuilder->AddSelectItem($strTableName, 'street_2', $strAliasPrefix . 'street_2'); $objBuilder->AddSelectItem($strTableName, 'suburb', $strAliasPrefix . 'suburb'); $objBuilder->AddSelectItem($strTableName, 'city', $strAliasPrefix . 'city'); $objBuilder->AddSelectItem($strTableName, 'county', $strAliasPrefix . 'county'); $objBuilder->AddSelectItem($strTableName, 'zone_id', $strAliasPrefix . 'zone_id'); $objBuilder->AddSelectItem($strTableName, 'country_id', $strAliasPrefix . 'country_id'); $objBuilder->AddSelectItem($strTableName, 'postal_code', $strAliasPrefix . 'postal_code'); $objBuilder->AddSelectItem($strTableName, 'is_current', $strAliasPrefix . 'is_current'); $objBuilder->AddSelectItem($strTableName, 'type_id', $strAliasPrefix . 'type_id'); $objBuilder->AddSelectItem($strTableName, 'creation_date', $strAliasPrefix . 'creation_date'); $objBuilder->AddSelectItem($strTableName, 'last_modification', $strAliasPrefix . 'last_modification'); } /////////////////////////////// // INSTANTIATION-RELATED METHODS /////////////////////////////// /** * Instantiate a Address from a Database Row. * Takes in an optional strAliasPrefix, used in case another Object::InstantiateDbRow * is calling this Address::InstantiateDbRow in order to perform * early binding on referenced objects. * @param DatabaseRowBase $objDbRow * @param string $strAliasPrefix * @param string $strExpandAsArrayNodes * @param QBaseClass $objPreviousItem * @param string[] $strColumnAliasArray * @return Address */ public static function InstantiateDbRow($objDbRow, $strAliasPrefix = null, $strExpandAsArrayNodes = null, $objPreviousItem = null, $strColumnAliasArray = array()) { // If blank row, return null if (!$objDbRow) return null; // Create a new instance of the Address object $objToReturn = new Address(); $objToReturn->__blnRestored = true; $strAliasName = array_key_exists($strAliasPrefix . 'id', $strColumnAliasArray) ? $strColumnAliasArray[$strAliasPrefix . 'id'] : $strAliasPrefix . 'id'; $objToReturn->intId = $objDbRow->GetColumn($strAliasName, 'Integer'); $strAliasName = array_key_exists($strAliasPrefix . 'title', $strColumnAliasArray) ? $strColumnAliasArray[$strAliasPrefix . 'title'] : $strAliasPrefix . 'title'; $objToReturn->strTitle = $objDbRow->GetColumn($strAliasName, 'VarChar'); $strAliasName = array_key_exists($strAliasPrefix . 'person_id', $strColumnAliasArray) ? $strColumnAliasArray[$strAliasPrefix . 'person_id'] : $strAliasPrefix . 'person_id'; $objToReturn->intPersonId = $objDbRow->GetColumn($strAliasName, 'Integer'); $strAliasName = array_key_exists($strAliasPrefix . 'street_1', $strColumnAliasArray) ? $strColumnAliasArray[$strAliasPrefix . 'street_1'] : $strAliasPrefix . 'street_1'; $objToReturn->strStreet1 = $objDbRow->GetColumn($strAliasName, 'VarChar'); $strAliasName = array_key_exists($strAliasPrefix . 'street_2', $strColumnAliasArray) ? $strColumnAliasArray[$strAliasPrefix . 'street_2'] : $strAliasPrefix . 'street_2'; $objToReturn->strStreet2 = $objDbRow->GetColumn($strAliasName, 'VarChar'); $strAliasName = array_key_exists($strAliasPrefix . 'suburb', $strColumnAliasArray) ? $strColumnAliasArray[$strAliasPrefix . 'suburb'] : $strAliasPrefix . 'suburb'; $objToReturn->strSuburb = $objDbRow->GetColumn($strAliasName, 'VarChar'); $strAliasName = array_key_exists($strAliasPrefix . 'city', $strColumnAliasArray) ? $strColumnAliasArray[$strAliasPrefix . 'city'] : $strAliasPrefix . 'city'; $objToReturn->strCity = $objDbRow->GetColumn($strAliasName, 'VarChar'); $strAliasName = array_key_exists($strAliasPrefix . 'county', $strColumnAliasArray) ? $strColumnAliasArray[$strAliasPrefix . 'county'] : $strAliasPrefix . 'county'; $objToReturn->strCounty = $objDbRow->GetColumn($strAliasName, 'VarChar'); $strAliasName = array_key_exists($strAliasPrefix . 'zone_id', $strColumnAliasArray) ? $strColumnAliasArray[$strAliasPrefix . 'zone_id'] : $strAliasPrefix . 'zone_id'; $objToReturn->intZoneId = $objDbRow->GetColumn($strAliasName, 'Integer'); $strAliasName = array_key_exists($strAliasPrefix . 'country_id', $strColumnAliasArray) ? $strColumnAliasArray[$strAliasPrefix . 'country_id'] : $strAliasPrefix . 'country_id'; $objToReturn->intCountryId = $objDbRow->GetColumn($strAliasName, 'Integer'); $strAliasName = array_key_exists($strAliasPrefix . 'postal_code', $strColumnAliasArray) ? $strColumnAliasArray[$strAliasPrefix . 'postal_code'] : $strAliasPrefix . 'postal_code'; $objToReturn->strPostalCode = $objDbRow->GetColumn($strAliasName, 'VarChar'); $strAliasName = array_key_exists($strAliasPrefix . 'is_current', $strColumnAliasArray) ? $strColumnAliasArray[$strAliasPrefix . 'is_current'] : $strAliasPrefix . 'is_current'; $objToReturn->blnIsCurrent = $objDbRow->GetColumn($strAliasName, 'Bit'); $strAliasName = array_key_exists($strAliasPrefix . 'type_id', $strColumnAliasArray) ? $strColumnAliasArray[$strAliasPrefix . 'type_id'] : $strAliasPrefix . 'type_id'; $objToReturn->intTypeId = $objDbRow->GetColumn($strAliasName, 'Integer'); $strAliasName = array_key_exists($strAliasPrefix . 'creation_date', $strColumnAliasArray) ? $strColumnAliasArray[$strAliasPrefix . 'creation_date'] : $strAliasPrefix . 'creation_date'; $objToReturn->strCreationDate = $objDbRow->GetColumn($strAliasName, 'VarChar'); $strAliasName = array_key_exists($strAliasPrefix . 'last_modification', $strColumnAliasArray) ? $strColumnAliasArray[$strAliasPrefix . 'last_modification'] : $strAliasPrefix . 'last_modification'; $objToReturn->strLastModification = $objDbRow->GetColumn($strAliasName, 'VarChar'); // Instantiate Virtual Attributes foreach ($objDbRow->GetColumnNameArray() as $strColumnName => $mixValue) { $strVirtualPrefix = $strAliasPrefix . '__'; $strVirtualPrefixLength = strlen($strVirtualPrefix); if (substr($strColumnName, 0, $strVirtualPrefixLength) == $strVirtualPrefix) $objToReturn->__strVirtualAttributeArray[substr($strColumnName, $strVirtualPrefixLength)] = $mixValue; } // Prepare to Check for Early/Virtual Binding if (!$strAliasPrefix) $strAliasPrefix = 'address__'; // Check for Person Early Binding $strAlias = $strAliasPrefix . 'person_id__id'; $strAliasName = array_key_exists($strAlias, $strColumnAliasArray) ? $strColumnAliasArray[$strAlias] : $strAlias; if (!is_null($objDbRow->GetColumn($strAliasName))) $objToReturn->objPerson = Person::InstantiateDbRow($objDbRow, $strAliasPrefix . 'person_id__', $strExpandAsArrayNodes, null, $strColumnAliasArray); return $objToReturn; } /** * Instantiate an array of Addresses from a Database Result * @param DatabaseResultBase $objDbResult * @param string $strExpandAsArrayNodes * @param string[] $strColumnAliasArray * @return Address[] */ public static function InstantiateDbResult(QDatabaseResultBase $objDbResult, $strExpandAsArrayNodes = null, $strColumnAliasArray = null) { $objToReturn = array(); if (!$strColumnAliasArray) $strColumnAliasArray = array(); // If blank resultset, then return empty array if (!$objDbResult) return $objToReturn; // Load up the return array with each row if ($strExpandAsArrayNodes) { $objLastRowItem = null; while ($objDbRow = $objDbResult->GetNextRow()) { $objItem = Address::InstantiateDbRow($objDbRow, null, $strExpandAsArrayNodes, $objLastRowItem, $strColumnAliasArray); if ($objItem) { $objToReturn[] = $objItem; $objLastRowItem = $objItem; } } } else { while ($objDbRow = $objDbResult->GetNextRow()) $objToReturn[] = Address::InstantiateDbRow($objDbRow, null, null, null, $strColumnAliasArray); } return $objToReturn; } /////////////////////////////////////////////////// // INDEX-BASED LOAD METHODS (Single Load and Array) /////////////////////////////////////////////////// /** * Load a single Address object, * by Id Index(es) * @param integer $intId * @return Address */ public static function LoadById($intId) { return Address::QuerySingle( QQ::Equal(QQN::Address()->Id, $intId) ); } /** * Load an array of Address objects, * by TypeId Index(es) * @param integer $intTypeId * @param QQClause[] $objOptionalClauses additional optional QQClause objects for this query * @return Address[] */ public static function LoadArrayByTypeId($intTypeId, $objOptionalClauses = null) { // Call Address::QueryArray to perform the LoadArrayByTypeId query try { return Address::QueryArray( QQ::Equal(QQN::Address()->TypeId, $intTypeId), $objOptionalClauses); } catch (QCallerException $objExc) { $objExc->IncrementOffset(); throw $objExc; } } /** * Count Addresses * by TypeId Index(es) * @param integer $intTypeId * @return int */ public static function CountByTypeId($intTypeId) { // Call Address::QueryCount to perform the CountByTypeId query return Address::QueryCount( QQ::Equal(QQN::Address()->TypeId, $intTypeId) ); } /** * Load an array of Address objects, * by ZoneId Index(es) * @param integer $intZoneId * @param QQClause[] $objOptionalClauses additional optional QQClause objects for this query * @return Address[] */ public static function LoadArrayByZoneId($intZoneId, $objOptionalClauses = null) { // Call Address::QueryArray to perform the LoadArrayByZoneId query try { return Address::QueryArray( QQ::Equal(QQN::Address()->ZoneId, $intZoneId), $objOptionalClauses); } catch (QCallerException $objExc) { $objExc->IncrementOffset(); throw $objExc; } } /** * Count Addresses * by ZoneId Index(es) * @param integer $intZoneId * @return int */ public static function CountByZoneId($intZoneId) { // Call Address::QueryCount to perform the CountByZoneId query return Address::QueryCount( QQ::Equal(QQN::Address()->ZoneId, $intZoneId) ); } /** * Load an array of Address objects, * by CountryId Index(es) * @param integer $intCountryId * @param QQClause[] $objOptionalClauses additional optional QQClause objects for this query * @return Address[] */ public static function LoadArrayByCountryId($intCountryId, $objOptionalClauses = null) { // Call Address::QueryArray to perform the LoadArrayByCountryId query try { return Address::QueryArray( QQ::Equal(QQN::Address()->CountryId, $intCountryId), $objOptionalClauses); } catch (QCallerException $objExc) { $objExc->IncrementOffset(); throw $objExc; } } /** * Count Addresses * by CountryId Index(es) * @param integer $intCountryId * @return int */ public static function CountByCountryId($intCountryId) { // Call Address::QueryCount to perform the CountByCountryId query return Address::QueryCount( QQ::Equal(QQN::Address()->CountryId, $intCountryId) ); } /** * Load an array of Address objects, * by PersonId Index(es) * @param integer $intPersonId * @param QQClause[] $objOptionalClauses additional optional QQClause objects for this query * @return Address[] */ public static function LoadArrayByPersonId($intPersonId, $objOptionalClauses = null) { // Call Address::QueryArray to perform the LoadArrayByPersonId query try { return Address::QueryArray( QQ::Equal(QQN::Address()->PersonId, $intPersonId), $objOptionalClauses); } catch (QCallerException $objExc) { $objExc->IncrementOffset(); throw $objExc; } } /** * Count Addresses * by PersonId Index(es) * @param integer $intPersonId * @return int */ public static function CountByPersonId($intPersonId) { // Call Address::QueryCount to perform the CountByPersonId query return Address::QueryCount( QQ::Equal(QQN::Address()->PersonId, $intPersonId) ); } //////////////////////////////////////////////////// // INDEX-BASED LOAD METHODS (Array via Many to Many) //////////////////////////////////////////////////// ////////////////////////// // SAVE, DELETE AND RELOAD ////////////////////////// /** * Save this Address * @param bool $blnForceInsert * @param bool $blnForceUpdate * @return int */ public function Save($blnForceInsert = false, $blnForceUpdate = false) { // Get the Database Object for this Class $objDatabase = Address::GetDatabase(); $mixToReturn = null; try { if ((!$this->__blnRestored) || ($blnForceInsert)) { // Perform an INSERT query $objDatabase->NonQuery(' INSERT INTO `address` ( `title`, `person_id`, `street_1`, `street_2`, `suburb`, `city`, `county`, `zone_id`, `country_id`, `postal_code`, `is_current`, `type_id` ) VALUES ( ' . $objDatabase->SqlVariable($this->strTitle) . ', ' . $objDatabase->SqlVariable($this->intPersonId) . ', ' . $objDatabase->SqlVariable($this->strStreet1) . ', ' . $objDatabase->SqlVariable($this->strStreet2) . ', ' . $objDatabase->SqlVariable($this->strSuburb) . ', ' . $objDatabase->SqlVariable($this->strCity) . ', ' . $objDatabase->SqlVariable($this->strCounty) . ', ' . $objDatabase->SqlVariable($this->intZoneId) . ', ' . $objDatabase->SqlVariable($this->intCountryId) . ', ' . $objDatabase->SqlVariable($this->strPostalCode) . ', ' . $objDatabase->SqlVariable($this->blnIsCurrent) . ', ' . $objDatabase->SqlVariable($this->intTypeId) . ' ) '); // Update Identity column and return its value $mixToReturn = $this->intId = $objDatabase->InsertId('address', 'id'); } else { // Perform an UPDATE query // First checking for Optimistic Locking constraints (if applicable) if (!$blnForceUpdate) { // Perform the Optimistic Locking check $objResult = $objDatabase->Query(' SELECT `creation_date` FROM `address` WHERE `id` = ' . $objDatabase->SqlVariable($this->intId) . ' '); $objRow = $objResult->FetchArray(); if ($objRow[0] != $this->strCreationDate) throw new QOptimisticLockingException('Address'); } if (!$blnForceUpdate) { // Perform the Optimistic Locking check $objResult = $objDatabase->Query(' SELECT `last_modification` FROM `address` WHERE `id` = ' . $objDatabase->SqlVariable($this->intId) . ' '); $objRow = $objResult->FetchArray(); if ($objRow[0] != $this->strLastModification) throw new QOptimisticLockingException('Address'); } // Perform the UPDATE query $objDatabase->NonQuery(' UPDATE `address` SET `title` = ' . $objDatabase->SqlVariable($this->strTitle) . ', `person_id` = ' . $objDatabase->SqlVariable($this->intPersonId) . ', `street_1` = ' . $objDatabase->SqlVariable($this->strStreet1) . ', `street_2` = ' . $objDatabase->SqlVariable($this->strStreet2) . ', `suburb` = ' . $objDatabase->SqlVariable($this->strSuburb) . ', `city` = ' . $objDatabase->SqlVariable($this->strCity) . ', `county` = ' . $objDatabase->SqlVariable($this->strCounty) . ', `zone_id` = ' . $objDatabase->SqlVariable($this->intZoneId) . ', `country_id` = ' . $objDatabase->SqlVariable($this->intCountryId) . ', `postal_code` = ' . $objDatabase->SqlVariable($this->strPostalCode) . ', `is_current` = ' . $objDatabase->SqlVariable($this->blnIsCurrent) . ', `type_id` = ' . $objDatabase->SqlVariable($this->intTypeId) . ' WHERE `id` = ' . $objDatabase->SqlVariable($this->intId) . ' '); } } catch (QCallerException $objExc) { $objExc->IncrementOffset(); throw $objExc; } // Update __blnRestored and any Non-Identity PK Columns (if applicable) $this->__blnRestored = true; // Update Local Timestamp $objResult = $objDatabase->Query(' SELECT `creation_date` FROM `address` WHERE `id` = ' . $objDatabase->SqlVariable($this->intId) . ' '); $objRow = $objResult->FetchArray(); $this->strCreationDate = $objRow[0]; // Update Local Timestamp $objResult = $objDatabase->Query(' SELECT `last_modification` FROM `address` WHERE `id` = ' . $objDatabase->SqlVariable($this->intId) . ' '); $objRow = $objResult->FetchArray(); $this->strLastModification = $objRow[0]; // Return return $mixToReturn; } /** * Delete this Address * @return void */ public function Delete() { if ((is_null($this->intId))) throw new QUndefinedPrimaryKeyException('Cannot delete this Address with an unset primary key.'); // Get the Database Object for this Class $objDatabase = Address::GetDatabase(); // Perform the SQL Query $objDatabase->NonQuery(' DELETE FROM `address` WHERE `id` = ' . $objDatabase->SqlVariable($this->intId) . ''); } /** * Delete all Addresses * @return void */ public static function DeleteAll() { // Get the Database Object for this Class $objDatabase = Address::GetDatabase(); // Perform the Query $objDatabase->NonQuery(' DELETE FROM `address`'); } /** * Truncate address table * @return void */ public static function Truncate() { // Get the Database Object for this Class $objDatabase = Address::GetDatabase(); // Perform the Query $objDatabase->NonQuery(' TRUNCATE `address`'); } /** * Reload this Address from the database. * @return void */ public function Reload() { // Make sure we are actually Restored from the database if (!$this->__blnRestored) throw new QCallerException('Cannot call Reload() on a new, unsaved Address object.'); // Reload the Object $objReloaded = Address::Load($this->intId); // Update $this's local variables to match $this->strTitle = $objReloaded->strTitle; $this->PersonId = $objReloaded->PersonId; $this->strStreet1 = $objReloaded->strStreet1; $this->strStreet2 = $objReloaded->strStreet2; $this->strSuburb = $objReloaded->strSuburb; $this->strCity = $objReloaded->strCity; $this->strCounty = $objReloaded->strCounty; $this->ZoneId = $objReloaded->ZoneId; $this->CountryId = $objReloaded->CountryId; $this->strPostalCode = $objReloaded->strPostalCode; $this->blnIsCurrent = $objReloaded->blnIsCurrent; $this->TypeId = $objReloaded->TypeId; $this->strCreationDate = $objReloaded->strCreationDate; $this->strLastModification = $objReloaded->strLastModification; } //////////////////// // GETTORS AND SETTORS //////////////////// /** * Lookup a VirtualAttribute value (if applicable). Returns NULL if none found. * @param string $strName * @return string */ public function GetVirtualAttribute($strName) { if (array_key_exists($strName, $this->__strVirtualAttributeArray)) return $this->__strVirtualAttributeArray[$strName]; return null; } /** * Override method to perform a property "Get" * This will get the value of $strName * * @param string $strName Name of the property to get * @return mixed */ public function __get($strName) { switch ($strName) { /////////////////// // Member Variables /////////////////// case 'Id': /** * Gets the value for intId (Read-Only PK) * @return integer */ return $this->intId; case 'Title': /** * Gets the value for strTitle * @return string */ return $this->strTitle; case 'PersonId': /** * Gets the value for intPersonId (Not Null) * @return integer */ return $this->intPersonId; case 'Street1': /** * Gets the value for strStreet1 * @return string */ return $this->strStreet1; case 'Street2': /** * Gets the value for strStreet2 * @return string */ return $this->strStreet2; case 'Suburb': /** * Gets the value for strSuburb * @return string */ return $this->strSuburb; case 'City': /** * Gets the value for strCity * @return string */ return $this->strCity; case 'County': /** * Gets the value for strCounty * @return string */ return $this->strCounty; case 'ZoneId': /** * Gets the value for intZoneId (Not Null) * @return integer */ return $this->intZoneId; case 'CountryId': /** * Gets the value for intCountryId (Not Null) * @return integer */ return $this->intCountryId; case 'PostalCode': /** * Gets the value for strPostalCode * @return string */ return $this->strPostalCode; case 'IsCurrent': /** * Gets the value for blnIsCurrent (Not Null) * @return boolean */ return $this->blnIsCurrent; case 'TypeId': /** * Gets the value for intTypeId (Not Null) * @return integer */ return $this->intTypeId; case 'CreationDate': /** * Gets the value for strCreationDate (Read-Only Timestamp) * @return string */ return $this->strCreationDate; case 'LastModification': /** * Gets the value for strLastModification (Read-Only Timestamp) * @return string */ return $this->strLastModification; /////////////////// // Member Objects /////////////////// case 'Person': /** * Gets the value for the Person object referenced by intPersonId (Not Null) * @return Person */ try { if ((!$this->objPerson) && (!is_null($this->intPersonId))) $this->objPerson = Person::Load($this->intPersonId); return $this->objPerson; } catch (QCallerException $objExc) { $objExc->IncrementOffset(); throw $objExc; } //////////////////////////// // Virtual Object References (Many to Many and Reverse References) // (If restored via a "Many-to" expansion) //////////////////////////// case '__Restored': return $this->__blnRestored; default: try { return parent::__get($strName); } catch (QCallerException $objExc) { $objExc->IncrementOffset(); throw $objExc; } } } /** * Override method to perform a property "Set" * This will set the property $strName to be $mixValue * * @param string $strName Name of the property to set * @param string $mixValue New value of the property * @return mixed */ public function __set($strName, $mixValue) { switch ($strName) { /////////////////// // Member Variables /////////////////// case 'Title': /** * Sets the value for strTitle * @param string $mixValue * @return string */ try { return ($this->strTitle = QType::Cast($mixValue, QType::String)); } catch (QCallerException $objExc) { $objExc->IncrementOffset(); throw $objExc; } case 'PersonId': /** * Sets the value for intPersonId (Not Null) * @param integer $mixValue * @return integer */ try { $this->objPerson = null; return ($this->intPersonId = QType::Cast($mixValue, QType::Integer)); } catch (QCallerException $objExc) { $objExc->IncrementOffset(); throw $objExc; } case 'Street1': /** * Sets the value for strStreet1 * @param string $mixValue * @return string */ try { return ($this->strStreet1 = QType::Cast($mixValue, QType::String)); } catch (QCallerException $objExc) { $objExc->IncrementOffset(); throw $objExc; } case 'Street2': /** * Sets the value for strStreet2 * @param string $mixValue * @return string */ try { return ($this->strStreet2 = QType::Cast($mixValue, QType::String)); } catch (QCallerException $objExc) { $objExc->IncrementOffset(); throw $objExc; } case 'Suburb': /** * Sets the value for strSuburb * @param string $mixValue * @return string */ try { return ($this->strSuburb = QType::Cast($mixValue, QType::String)); } catch (QCallerException $objExc) { $objExc->IncrementOffset(); throw $objExc; } case 'City': /** * Sets the value for strCity * @param string $mixValue * @return string */ try { return ($this->strCity = QType::Cast($mixValue, QType::String)); } catch (QCallerException $objExc) { $objExc->IncrementOffset(); throw $objExc; } case 'County': /** * Sets the value for strCounty * @param string $mixValue * @return string */ try { return ($this->strCounty = QType::Cast($mixValue, QType::String)); } catch (QCallerException $objExc) { $objExc->IncrementOffset(); throw $objExc; } case 'ZoneId': /** * Sets the value for intZoneId (Not Null) * @param integer $mixValue * @return integer */ try { return ($this->intZoneId = QType::Cast($mixValue, QType::Integer)); } catch (QCallerException $objExc) { $objExc->IncrementOffset(); throw $objExc; } case 'CountryId': /** * Sets the value for intCountryId (Not Null) * @param integer $mixValue * @return integer */ try { return ($this->intCountryId = QType::Cast($mixValue, QType::Integer)); } catch (QCallerException $objExc) { $objExc->IncrementOffset(); throw $objExc; } case 'PostalCode': /** * Sets the value for strPostalCode * @param string $mixValue * @return string */ try { return ($this->strPostalCode = QType::Cast($mixValue, QType::String)); } catch (QCallerException $objExc) { $objExc->IncrementOffset(); throw $objExc; } case 'IsCurrent': /** * Sets the value for blnIsCurrent (Not Null) * @param boolean $mixValue * @return boolean */ try { return ($this->blnIsCurrent = QType::Cast($mixValue, QType::Boolean)); } catch (QCallerException $objExc) { $objExc->IncrementOffset(); throw $objExc; } case 'TypeId': /** * Sets the value for intTypeId (Not Null) * @param integer $mixValue * @return integer */ try { return ($this->intTypeId = QType::Cast($mixValue, QType::Integer)); } catch (QCallerException $objExc) { $objExc->IncrementOffset(); throw $objExc; } /////////////////// // Member Objects /////////////////// case 'Person': /** * Sets the value for the Person object referenced by intPersonId (Not Null) * @param Person $mixValue * @return Person */ if (is_null($mixValue)) { $this->intPersonId = null; $this->objPerson = null; return null; } else { // Make sure $mixValue actually is a Person object try { $mixValue = QType::Cast($mixValue, 'Person'); } catch (QInvalidCastException $objExc) { $objExc->IncrementOffset(); throw $objExc; } // Make sure $mixValue is a SAVED Person object if (is_null($mixValue->Id)) throw new QCallerException('Unable to set an unsaved Person for this Address'); // Update Local Member Variables $this->objPerson = $mixValue; $this->intPersonId = $mixValue->Id; // Return $mixValue return $mixValue; } break; default: try { return parent::__set($strName, $mixValue); } catch (QCallerException $objExc) { $objExc->IncrementOffset(); throw $objExc; } } } /////////////////////////////// // ASSOCIATED OBJECTS' METHODS /////////////////////////////// } ///////////////////////////////////// // ADDITIONAL CLASSES for QCODO QUERY ///////////////////////////////////// class QQNodeAddress extends QQNode { protected $strTableName = 'address'; protected $strPrimaryKey = 'id'; protected $strClassName = 'Address'; public function __get($strName) { switch ($strName) { case 'Id': return new QQNode('id', 'Id', 'integer', $this); case 'Title': return new QQNode('title', 'Title', 'string', $this); case 'PersonId': return new QQNode('person_id', 'PersonId', 'integer', $this); case 'Person': return new QQNodePerson('person_id', 'Person', 'integer', $this); case 'Street1': return new QQNode('street_1', 'Street1', 'string', $this); case 'Street2': return new QQNode('street_2', 'Street2', 'string', $this); case 'Suburb': return new QQNode('suburb', 'Suburb', 'string', $this); case 'City': return new QQNode('city', 'City', 'string', $this); case 'County': return new QQNode('county', 'County', 'string', $this); case 'ZoneId': return new QQNode('zone_id', 'ZoneId', 'integer', $this); case 'CountryId': return new QQNode('country_id', 'CountryId', 'integer', $this); case 'PostalCode': return new QQNode('postal_code', 'PostalCode', 'string', $this); case 'IsCurrent': return new QQNode('is_current', 'IsCurrent', 'boolean', $this); case 'TypeId': return new QQNode('type_id', 'TypeId', 'integer', $this); case 'CreationDate': return new QQNode('creation_date', 'CreationDate', 'string', $this); case 'LastModification': return new QQNode('last_modification', 'LastModification', 'string', $this); case '_PrimaryKeyNode': return new QQNode('id', 'Id', 'integer', $this); default: try { return parent::__get($strName); } catch (QCallerException $objExc) { $objExc->IncrementOffset(); throw $objExc; } } } } class QQReverseReferenceNodeAddress extends QQReverseReferenceNode { protected $strTableName = 'address'; protected $strPrimaryKey = 'id'; protected $strClassName = 'Address'; public function __get($strName) { switch ($strName) { case 'Id': return new QQNode('id', 'Id', 'integer', $this); case 'Title': return new QQNode('title', 'Title', 'string', $this); case 'PersonId': return new QQNode('person_id', 'PersonId', 'integer', $this); case 'Person': return new QQNodePerson('person_id', 'Person', 'integer', $this); case 'Street1': return new QQNode('street_1', 'Street1', 'string', $this); case 'Street2': return new QQNode('street_2', 'Street2', 'string', $this); case 'Suburb': return new QQNode('suburb', 'Suburb', 'string', $this); case 'City': return new QQNode('city', 'City', 'string', $this); case 'County': return new QQNode('county', 'County', 'string', $this); case 'ZoneId': return new QQNode('zone_id', 'ZoneId', 'integer', $this); case 'CountryId': return new QQNode('country_id', 'CountryId', 'integer', $this); case 'PostalCode': return new QQNode('postal_code', 'PostalCode', 'string', $this); case 'IsCurrent': return new QQNode('is_current', 'IsCurrent', 'boolean', $this); case 'TypeId': return new QQNode('type_id', 'TypeId', 'integer', $this); case 'CreationDate': return new QQNode('creation_date', 'CreationDate', 'string', $this); case 'LastModification': return new QQNode('last_modification', 'LastModification', 'string', $this); case '_PrimaryKeyNode': return new QQNode('id', 'Id', 'integer', $this); default: try { return parent::__get($strName); } catch (QCallerException $objExc) { $objExc->IncrementOffset(); throw $objExc; } } } } ?>