/** * Instantiate a single RecurringDonation object from a query cursor (e.g. a DB ResultSet). * Cursor is automatically moved to the "next row" of the result set. * Will return NULL if no cursor or if the cursor has no more rows in the resultset. * @param QDatabaseResultBase $objDbResult cursor resource * @return RecurringDonation next row resulting from the query */ public static function InstantiateCursor(QDatabaseResultBase $objDbResult) { // If blank resultset, then return empty result if (!$objDbResult) { return null; } // If empty resultset, then return empty result $objDbRow = $objDbResult->GetNextRow(); if (!$objDbRow) { return null; } // We need the Column Aliases $strColumnAliasArray = $objDbResult->QueryBuilder->ColumnAliasArray; if (!$strColumnAliasArray) { $strColumnAliasArray = array(); } // Pull Expansions (if applicable) $strExpandAsArrayNodes = $objDbResult->QueryBuilder->ExpandAsArrayNodes; // Load up the return result with a row and return it return RecurringDonation::InstantiateDbRow($objDbRow, null, $strExpandAsArrayNodes, null, $strColumnAliasArray); }
/** * Instantiate a RecurringPayments from a Database Row. * Takes in an optional strAliasPrefix, used in case another Object::InstantiateDbRow * is calling this RecurringPayments::InstantiateDbRow in order to perform * early binding on referenced objects. * @param QDatabaseRowBase $objDbRow * @param string $strAliasPrefix * @param string $strExpandAsArrayNodes * @param QBaseClass $objPreviousItem * @param string[] $strColumnAliasArray * @return RecurringPayments */ public static function InstantiateDbRow($objDbRow, $strAliasPrefix = null, $strExpandAsArrayNodes = null, $objPreviousItem = null, $strColumnAliasArray = array()) { // If blank row, return null if (!$objDbRow) { return null; } // See if we're doing an array expansion on the previous item $strAlias = $strAliasPrefix . 'id'; $strAliasName = array_key_exists($strAlias, $strColumnAliasArray) ? $strColumnAliasArray[$strAlias] : $strAlias; if ($strExpandAsArrayNodes && $objPreviousItem && $objPreviousItem->intId == $objDbRow->GetColumn($strAliasName, 'Integer')) { // We are. Now, prepare to check for ExpandAsArray clauses $blnExpandedViaArray = false; if (!$strAliasPrefix) { $strAliasPrefix = 'recurring_payments__'; } $strAlias = $strAliasPrefix . 'onlinedonationasrecurringpayment__id'; $strAliasName = array_key_exists($strAlias, $strColumnAliasArray) ? $strColumnAliasArray[$strAlias] : $strAlias; if (array_key_exists($strAlias, $strExpandAsArrayNodes) && !is_null($objDbRow->GetColumn($strAliasName))) { if ($intPreviousChildItemCount = count($objPreviousItem->_objOnlineDonationAsRecurringPaymentArray)) { $objPreviousChildItem = $objPreviousItem->_objOnlineDonationAsRecurringPaymentArray[$intPreviousChildItemCount - 1]; $objChildItem = OnlineDonation::InstantiateDbRow($objDbRow, $strAliasPrefix . 'onlinedonationasrecurringpayment__', $strExpandAsArrayNodes, $objPreviousChildItem, $strColumnAliasArray); if ($objChildItem) { $objPreviousItem->_objOnlineDonationAsRecurringPaymentArray[] = $objChildItem; } } else { $objPreviousItem->_objOnlineDonationAsRecurringPaymentArray[] = OnlineDonation::InstantiateDbRow($objDbRow, $strAliasPrefix . 'onlinedonationasrecurringpayment__', $strExpandAsArrayNodes, null, $strColumnAliasArray); } $blnExpandedViaArray = true; } // Either return false to signal array expansion, or check-to-reset the Alias prefix and move on if ($blnExpandedViaArray) { return false; } else { if ($strAliasPrefix == 'recurring_payments__') { $strAliasPrefix = null; } } } // Create a new instance of the RecurringPayments object $objToReturn = new RecurringPayments(); $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 . 'name', $strColumnAliasArray) ? $strColumnAliasArray[$strAliasPrefix . 'name'] : $strAliasPrefix . 'name'; $objToReturn->strName = $objDbRow->GetColumn($strAliasName, 'VarChar'); $strAliasName = array_key_exists($strAliasPrefix . 'payment_period_id', $strColumnAliasArray) ? $strColumnAliasArray[$strAliasPrefix . 'payment_period_id'] : $strAliasPrefix . 'payment_period_id'; $objToReturn->intPaymentPeriodId = $objDbRow->GetColumn($strAliasName, 'Integer'); $strAliasName = array_key_exists($strAliasPrefix . 'amount', $strColumnAliasArray) ? $strColumnAliasArray[$strAliasPrefix . 'amount'] : $strAliasPrefix . 'amount'; $objToReturn->fltAmount = $objDbRow->GetColumn($strAliasName, 'Float'); $strAliasName = array_key_exists($strAliasPrefix . 'start_date', $strColumnAliasArray) ? $strColumnAliasArray[$strAliasPrefix . 'start_date'] : $strAliasPrefix . 'start_date'; $objToReturn->dttStartDate = $objDbRow->GetColumn($strAliasName, 'Date'); $strAliasName = array_key_exists($strAliasPrefix . 'end_date', $strColumnAliasArray) ? $strColumnAliasArray[$strAliasPrefix . 'end_date'] : $strAliasPrefix . 'end_date'; $objToReturn->dttEndDate = $objDbRow->GetColumn($strAliasName, 'Date'); $strAliasName = array_key_exists($strAliasPrefix . 'authorize_flag', $strColumnAliasArray) ? $strColumnAliasArray[$strAliasPrefix . 'authorize_flag'] : $strAliasPrefix . 'authorize_flag'; $objToReturn->blnAuthorizeFlag = $objDbRow->GetColumn($strAliasName, 'Bit'); $strAliasName = array_key_exists($strAliasPrefix . 'card_holder_name', $strColumnAliasArray) ? $strColumnAliasArray[$strAliasPrefix . 'card_holder_name'] : $strAliasPrefix . 'card_holder_name'; $objToReturn->strCardHolderName = $objDbRow->GetColumn($strAliasName, 'VarChar'); $strAliasName = array_key_exists($strAliasPrefix . 'address1', $strColumnAliasArray) ? $strColumnAliasArray[$strAliasPrefix . 'address1'] : $strAliasPrefix . 'address1'; $objToReturn->strAddress1 = $objDbRow->GetColumn($strAliasName, 'VarChar'); $strAliasName = array_key_exists($strAliasPrefix . 'address2', $strColumnAliasArray) ? $strColumnAliasArray[$strAliasPrefix . 'address2'] : $strAliasPrefix . 'address2'; $objToReturn->strAddress2 = $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 . 'state', $strColumnAliasArray) ? $strColumnAliasArray[$strAliasPrefix . 'state'] : $strAliasPrefix . 'state'; $objToReturn->strState = $objDbRow->GetColumn($strAliasName, 'VarChar'); $strAliasName = array_key_exists($strAliasPrefix . 'zip', $strColumnAliasArray) ? $strColumnAliasArray[$strAliasPrefix . 'zip'] : $strAliasPrefix . 'zip'; $objToReturn->strZip = $objDbRow->GetColumn($strAliasName, 'VarChar'); $strAliasName = array_key_exists($strAliasPrefix . 'credit_card_type_id', $strColumnAliasArray) ? $strColumnAliasArray[$strAliasPrefix . 'credit_card_type_id'] : $strAliasPrefix . 'credit_card_type_id'; $objToReturn->intCreditCardTypeId = $objDbRow->GetColumn($strAliasName, 'Integer'); $strAliasName = array_key_exists($strAliasPrefix . 'account_number', $strColumnAliasArray) ? $strColumnAliasArray[$strAliasPrefix . 'account_number'] : $strAliasPrefix . 'account_number'; $objToReturn->strAccountNumber = $objDbRow->GetColumn($strAliasName, 'VarChar'); $strAliasName = array_key_exists($strAliasPrefix . 'expiration_date', $strColumnAliasArray) ? $strColumnAliasArray[$strAliasPrefix . 'expiration_date'] : $strAliasPrefix . 'expiration_date'; $objToReturn->strExpirationDate = $objDbRow->GetColumn($strAliasName, 'VarChar'); $strAliasName = array_key_exists($strAliasPrefix . 'security_code', $strColumnAliasArray) ? $strColumnAliasArray[$strAliasPrefix . 'security_code'] : $strAliasPrefix . 'security_code'; $objToReturn->strSecurityCode = $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 = 'recurring_payments__'; } // Check for PaymentPeriod Early Binding $strAlias = $strAliasPrefix . 'payment_period_id__id'; $strAliasName = array_key_exists($strAlias, $strColumnAliasArray) ? $strColumnAliasArray[$strAlias] : $strAlias; if (!is_null($objDbRow->GetColumn($strAliasName))) { $objToReturn->objPaymentPeriod = PaymentPeriod::InstantiateDbRow($objDbRow, $strAliasPrefix . 'payment_period_id__', $strExpandAsArrayNodes, null, $strColumnAliasArray); } // Check for RecurringDonationAsRecurringPayment Unique ReverseReference Binding $strAlias = $strAliasPrefix . 'recurringdonationasrecurringpayment__id'; $strAliasName = array_key_exists($strAlias, $strColumnAliasArray) ? $strColumnAliasArray[$strAlias] : $strAlias; if ($objDbRow->ColumnExists($strAliasName)) { if (!is_null($objDbRow->GetColumn($strAliasName))) { $objToReturn->objRecurringDonationAsRecurringPayment = RecurringDonation::InstantiateDbRow($objDbRow, $strAliasPrefix . 'recurringdonationasrecurringpayment__', $strExpandAsArrayNodes, null, $strColumnAliasArray); } else { // We ATTEMPTED to do an Early Bind but the Object Doesn't Exist // Let's set to FALSE so that the object knows not to try and re-query again $objToReturn->objRecurringDonationAsRecurringPayment = false; } } // Check for OnlineDonationAsRecurringPayment Virtual Binding $strAlias = $strAliasPrefix . 'onlinedonationasrecurringpayment__id'; $strAliasName = array_key_exists($strAlias, $strColumnAliasArray) ? $strColumnAliasArray[$strAlias] : $strAlias; if (!is_null($objDbRow->GetColumn($strAliasName))) { if ($strExpandAsArrayNodes && array_key_exists($strAlias, $strExpandAsArrayNodes)) { $objToReturn->_objOnlineDonationAsRecurringPaymentArray[] = OnlineDonation::InstantiateDbRow($objDbRow, $strAliasPrefix . 'onlinedonationasrecurringpayment__', $strExpandAsArrayNodes, null, $strColumnAliasArray); } else { $objToReturn->_objOnlineDonationAsRecurringPayment = OnlineDonation::InstantiateDbRow($objDbRow, $strAliasPrefix . 'onlinedonationasrecurringpayment__', $strExpandAsArrayNodes, null, $strColumnAliasArray); } } return $objToReturn; }
/** * Instantiate a RecurringDonationItems from a Database Row. * Takes in an optional strAliasPrefix, used in case another Object::InstantiateDbRow * is calling this RecurringDonationItems::InstantiateDbRow in order to perform * early binding on referenced objects. * @param QDatabaseRowBase $objDbRow * @param string $strAliasPrefix * @param string $strExpandAsArrayNodes * @param QBaseClass $objPreviousItem * @param string[] $strColumnAliasArray * @return RecurringDonationItems */ 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 RecurringDonationItems object $objToReturn = new RecurringDonationItems(); $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 . 'recurring_donation_id', $strColumnAliasArray) ? $strColumnAliasArray[$strAliasPrefix . 'recurring_donation_id'] : $strAliasPrefix . 'recurring_donation_id'; $objToReturn->intRecurringDonationId = $objDbRow->GetColumn($strAliasName, 'Integer'); $strAliasName = array_key_exists($strAliasPrefix . 'amount', $strColumnAliasArray) ? $strColumnAliasArray[$strAliasPrefix . 'amount'] : $strAliasPrefix . 'amount'; $objToReturn->fltAmount = $objDbRow->GetColumn($strAliasName, 'Float'); $strAliasName = array_key_exists($strAliasPrefix . 'donation_flag', $strColumnAliasArray) ? $strColumnAliasArray[$strAliasPrefix . 'donation_flag'] : $strAliasPrefix . 'donation_flag'; $objToReturn->blnDonationFlag = $objDbRow->GetColumn($strAliasName, 'Bit'); $strAliasName = array_key_exists($strAliasPrefix . 'stewardship_fund_id', $strColumnAliasArray) ? $strColumnAliasArray[$strAliasPrefix . 'stewardship_fund_id'] : $strAliasPrefix . 'stewardship_fund_id'; $objToReturn->intStewardshipFundId = $objDbRow->GetColumn($strAliasName, 'Integer'); $strAliasName = array_key_exists($strAliasPrefix . 'other', $strColumnAliasArray) ? $strColumnAliasArray[$strAliasPrefix . 'other'] : $strAliasPrefix . 'other'; $objToReturn->strOther = $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 = 'recurring_donation_items__'; } // Check for RecurringDonation Early Binding $strAlias = $strAliasPrefix . 'recurring_donation_id__id'; $strAliasName = array_key_exists($strAlias, $strColumnAliasArray) ? $strColumnAliasArray[$strAlias] : $strAlias; if (!is_null($objDbRow->GetColumn($strAliasName))) { $objToReturn->objRecurringDonation = RecurringDonation::InstantiateDbRow($objDbRow, $strAliasPrefix . 'recurring_donation_id__', $strExpandAsArrayNodes, null, $strColumnAliasArray); } // Check for StewardshipFund Early Binding $strAlias = $strAliasPrefix . 'stewardship_fund_id__id'; $strAliasName = array_key_exists($strAlias, $strColumnAliasArray) ? $strColumnAliasArray[$strAlias] : $strAlias; if (!is_null($objDbRow->GetColumn($strAliasName))) { $objToReturn->objStewardshipFund = StewardshipFund::InstantiateDbRow($objDbRow, $strAliasPrefix . 'stewardship_fund_id__', $strExpandAsArrayNodes, null, $strColumnAliasArray); } return $objToReturn; }