/**
* Instantiate a NarroPermission from a Database Row.
* Takes in an optional strAliasPrefix, used in case another Object::InstantiateDbRow
* is calling this NarroPermission::InstantiateDbRow in order to perform
* early binding on referenced objects.
* @param DatabaseRowBase $objDbRow
* @param string $strAliasPrefix
* @param string $strExpandAsArrayNodes
* @param QBaseClass $arrPreviousItem
* @param string[] $strColumnAliasArray
* @return NarroPermission
*/
public static function InstantiateDbRow($objDbRow, $strAliasPrefix = null, $strExpandAsArrayNodes = null, $arrPreviousItems = 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 . 'permission_id';
$strAliasName = array_key_exists($strAlias, $strColumnAliasArray) ? $strColumnAliasArray[$strAlias] : $strAlias;
if ($strExpandAsArrayNodes && is_array($arrPreviousItems) && count($arrPreviousItems)) {
foreach ($arrPreviousItems as $objPreviousItem) {
if ($objPreviousItem->intPermissionId == $objDbRow->GetColumn($strAliasName, 'Integer')) {
// We are. Now, prepare to check for ExpandAsArray clauses
$blnExpandedViaArray = false;
if (!$strAliasPrefix) {
$strAliasPrefix = 'narro_permission__';
}
// Expanding reverse references: NarroRolePermissionAsPermission
$strAlias = $strAliasPrefix . 'narrorolepermissionaspermission__role_permission_id';
$strAliasName = array_key_exists($strAlias, $strColumnAliasArray) ? $strColumnAliasArray[$strAlias] : $strAlias;
if (array_key_exists($strAlias, $strExpandAsArrayNodes) && !is_null($objDbRow->GetColumn($strAliasName))) {
if (null === $objPreviousItem->_objNarroRolePermissionAsPermissionArray) {
$objPreviousItem->_objNarroRolePermissionAsPermissionArray = array();
}
if ($intPreviousChildItemCount = count($objPreviousItem->_objNarroRolePermissionAsPermissionArray)) {
$objPreviousChildItems = $objPreviousItem->_objNarroRolePermissionAsPermissionArray;
$objChildItem = NarroRolePermission::InstantiateDbRow($objDbRow, $strAliasPrefix . 'narrorolepermissionaspermission__', $strExpandAsArrayNodes, $objPreviousChildItems, $strColumnAliasArray);
if ($objChildItem) {
$objPreviousItem->_objNarroRolePermissionAsPermissionArray[] = $objChildItem;
}
} else {
$objPreviousItem->_objNarroRolePermissionAsPermissionArray[] = NarroRolePermission::InstantiateDbRow($objDbRow, $strAliasPrefix . 'narrorolepermissionaspermission__', $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 == 'narro_permission__') {
$strAliasPrefix = null;
}
}
}
}
}
// Create a new instance of the NarroPermission object
$objToReturn = new NarroPermission();
$objToReturn->__blnRestored = true;
$strAlias = $strAliasPrefix . 'permission_id';
$strAliasName = array_key_exists($strAlias, $strColumnAliasArray) ? $strColumnAliasArray[$strAlias] : $strAlias;
$objToReturn->intPermissionId = $objDbRow->GetColumn($strAliasName, 'Integer');
$strAlias = $strAliasPrefix . 'permission_name';
$strAliasName = array_key_exists($strAlias, $strColumnAliasArray) ? $strColumnAliasArray[$strAlias] : $strAlias;
$objToReturn->strPermissionName = $objDbRow->GetColumn($strAliasName, 'VarChar');
if (isset($arrPreviousItems) && is_array($arrPreviousItems)) {
foreach ($arrPreviousItems as $objPreviousItem) {
if ($objToReturn->PermissionId != $objPreviousItem->PermissionId) {
continue;
}
$prevCnt = count($objPreviousItem->_objNarroRolePermissionAsPermissionArray);
$cnt = count($objToReturn->_objNarroRolePermissionAsPermissionArray);
if ($prevCnt != $cnt) {
continue;
}
if ($prevCnt == 0 || $cnt == 0 || !array_diff($objPreviousItem->_objNarroRolePermissionAsPermissionArray, $objToReturn->_objNarroRolePermissionAsPermissionArray)) {
continue;
}
// complete match - all primary key columns are the same
return null;
}
}
// Instantiate Virtual Attributes
$strVirtualPrefix = $strAliasPrefix . '__';
$strVirtualPrefixLength = strlen($strVirtualPrefix);
foreach ($objDbRow->GetColumnNameArray() as $strColumnName => $mixValue) {
if (strncmp($strColumnName, $strVirtualPrefix, $strVirtualPrefixLength) == 0) {
$objToReturn->__strVirtualAttributeArray[substr($strColumnName, $strVirtualPrefixLength)] = $mixValue;
}
}
// Prepare to Check for Early/Virtual Binding
if (!$strAliasPrefix) {
$strAliasPrefix = 'narro_permission__';
}
// Check for NarroRolePermissionAsPermission Virtual Binding
$strAlias = $strAliasPrefix . 'narrorolepermissionaspermission__role_permission_id';
$strAliasName = array_key_exists($strAlias, $strColumnAliasArray) ? $strColumnAliasArray[$strAlias] : $strAlias;
$blnExpanded = $strExpandAsArrayNodes && array_key_exists($strAlias, $strExpandAsArrayNodes);
if ($blnExpanded && null === $objToReturn->_objNarroRolePermissionAsPermissionArray) {
$objToReturn->_objNarroRolePermissionAsPermissionArray = array();
}
if (!is_null($objDbRow->GetColumn($strAliasName))) {
if ($blnExpanded) {
$objToReturn->_objNarroRolePermissionAsPermissionArray[] = NarroRolePermission::InstantiateDbRow($objDbRow, $strAliasPrefix . 'narrorolepermissionaspermission__', $strExpandAsArrayNodes, null, $strColumnAliasArray);
} else {
$objToReturn->_objNarroRolePermissionAsPermission = NarroRolePermission::InstantiateDbRow($objDbRow, $strAliasPrefix . 'narrorolepermissionaspermission__', $strExpandAsArrayNodes, null, $strColumnAliasArray);
}
}
return $objToReturn;
}
/**
* Instantiate a single NarroRolePermission 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 NarroRolePermission 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 NarroRolePermission::InstantiateDbRow($objDbRow, null, $strExpandAsArrayNodes, null, $strColumnAliasArray);
}
