/app/protected/core/models/RedBeanModel.php
PHP | 3320 lines | 2369 code | 158 blank | 793 comment | 324 complexity | 2d617da78d49a14c2fa04b349b3fa674 MD5 | raw file
Possible License(s): AGPL-3.0, BSD-3-Clause, GPL-2.0, LGPL-3.0, LGPL-2.1, BSD-2-Clause
- <?php
- /*********************************************************************************
- * Zurmo is a customer relationship management program developed by
- * Zurmo, Inc. Copyright (C) 2015 Zurmo Inc.
- *
- * Zurmo is free software; you can redistribute it and/or modify it under
- * the terms of the GNU Affero General Public License version 3 as published by the
- * Free Software Foundation with the addition of the following permission added
- * to Section 15 as permitted in Section 7(a): FOR ANY PART OF THE COVERED WORK
- * IN WHICH THE COPYRIGHT IS OWNED BY ZURMO, ZURMO DISCLAIMS THE WARRANTY
- * OF NON INFRINGEMENT OF THIRD PARTY RIGHTS.
- *
- * Zurmo is distributed in the hope that it will be useful, but WITHOUT
- * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
- * FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more
- * details.
- *
- * You should have received a copy of the GNU Affero General Public License along with
- * this program; if not, see http://www.gnu.org/licenses or write to the Free
- * Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
- * 02110-1301 USA.
- *
- * You can contact Zurmo, Inc. with a mailing address at 27 North Wacker Drive
- * Suite 370 Chicago, IL 60606. or at email address contact@zurmo.com.
- *
- * The interactive user interfaces in original and modified versions
- * of this program must display Appropriate Legal Notices, as required under
- * Section 5 of the GNU Affero General Public License version 3.
- *
- * In accordance with Section 7(b) of the GNU Affero General Public License version 3,
- * these Appropriate Legal Notices must retain the display of the Zurmo
- * logo and Zurmo copyright notice. If the display of the logo is not reasonably
- * feasible for technical reasons, the Appropriate Legal Notices must display the words
- * "Copyright Zurmo Inc. 2015. All rights reserved".
- ********************************************************************************/
- /**
- * Abstraction over the top of an application database accessed via
- * <a href="http://www.redbeanphp.com/">RedBean</a>. The base class for
- * an MVC model. Replaces the M part of MVC in Yii. Yii maps from the
- * database scheme to the objects, (good for database guys, not so good
- * for OO guys), this maps from objects to the database schema.
- *
- * A domain model is created by extending RedBeanModel and supplying
- * a getDefaultMetadata() method.
- *
- * Static getXxxx() methods can be supplied to query for the given domain
- * models, and instance methods should supply additional behaviour.
- *
- * getDefaultMetadata() returns an array of the class name mapped to
- * an array containing 'members' mapped to an array of member names,
- * (to be accessed as $model->memberName).
- *
- * It can then optionally have, 'relations' mapped
- * to an array of relation names, (to be accessed as $model->relationName),
- * mapped to its type, (the extending model class to which it relates).
- *
- * And it can then optionally have as well, 'rules' mapped to an array of
- * attribute names, (attributes are members and relations), a validator name,
- * and the parameters to the validator, if any, as per the Yii::CModel::rules()
- * method.See http://www.yiiframework.com/wiki/56/reference-model-rules-validation.
- *
- * These are used to automatically and dynamically create the database
- * schema on the fly as opposed to Yii's getting attributes from an
- * already existing schema.
- */
- abstract class RedBeanModel extends BeanModel implements Serializable
- {
- /**
- * Character used as delimiter when generating model identifiers
- */
- const MODEL_IDENTIFIER_DELIMITER = '_';
- /**
- * Models that have not been saved yet have no id as far
- * as the database is concerned. Until they are saved they are
- * assigned a negative id, so that they have identity.
- * @var integer
- */
- private static $nextPseudoId = -1;
- /**
- * Array of static models. Used by Observers @see ObservableComponent to add events to a class.
- * @var array
- */
- private static $_models = array();
- /*
- * The id of an unsaved model.
- * @var integer
- */
- private $pseudoId;
- /**
- * When creating the class heirarchy for bean creation and maintenence, which class is the last class in the
- * lineage to create a bean for? Normally the RedBeanModel is the lastClass in the line, and therefore there
- * will not be a table redbeanmodel. Some classes that extend RedBeanModel might want the line to stop before
- * RedBeanModel since creating a table with just an 'id' would be pointless. @see OwnedModel
- * @var string
- */
- protected static $lastClassInBeanHeirarchy = 'RedBeanModel';
- // A model maps to one or more beans. If Person extends RedBeanModel
- // there is one bean, but if User then extends Person a User model
- // has two beans, the one holding the person data and the one holding
- // the extended User data. In this way in inheritance hierarchy from
- // model is normalized over several tables, one for each extending
- // class.
- protected $modelClassNameToBean = array();
- protected $attributeNameToBeanAndClassName = array();
- protected $relationNameToRelatedModel = array();
- protected $unlinkedRelationNames = array();
- protected $unlinkedOwnedRelatedModelsToRemove = array();
- protected $validators = array();
- protected $attributeNameToErrors = array();
- protected $scenarioName = '';
- // An object is automatically savable if it is new or contains
- // modified members or related objects.
- // If it is newly created and has never had any data put into it
- // it can be saved explicitly but it wont be saved automatically
- // when it is a related model and will be redispensed next
- // time it is referenced.
- protected $modified = false;
- protected $deleted = false;
- protected $isInIsModified = false;
- protected $isInHasErrors = false;
- protected $isInGetErrors = false;
- protected $isValidating = false;
- protected $isSaving = false;
- protected $isDeleting = false;
- protected $isNewModel = false;
- protected $isCopied = false;
- /**
- * Can this model be saved when save is called from a related model? True if it can, false if it cannot.
- * Setting this value to false can reduce unnecessary queries to the database. If the models of a class do
- * not change often then it can make sense to set this to false. An example is @see Currency.
- * @var boolean
- */
- protected $isSavableFromRelation = true;
- // Mapping of Yii validators to validators doing things that
- // are either required for RedBean, or that simply implement
- // The semantics that we want.
- private static $yiiValidatorsToRedBeanValidators = array(
- 'CDefaultValueValidator' => 'RedBeanModelDefaultValueValidator',
- 'CNumberValidator' => 'RedBeanModelNumberValidator',
- 'CTypeValidator' => 'RedBeanModelTypeValidator',
- 'CRequiredValidator' => 'RedBeanModelRequiredValidator',
- 'CUniqueValidator' => 'RedBeanModelUniqueValidator',
- 'defaultCalculatedDate' => 'RedBeanModelDefaultCalculatedDateValidator',
- 'readOnly' => 'RedBeanModelReadOnlyValidator',
- 'dateTimeDefault' => 'RedBeanModelDateTimeDefaultValueValidator',
- 'probability' => 'RedBeanModelProbabilityValidator',
- );
- /**
- * Stores the attributeLabelsByLanguage
- * @var array
- */
- protected static $attributeLabelsByLanguage = array();
- /**
- * Returns the static model of the specified AR class.
- * The model returned is a static instance of the AR class.
- * It is provided for invoking class-level methods (something similar to static class methods.)
- *
- * EVERY derived AR class must override this method as follows,
- * <pre>
- * public static function model($className=__CLASS__)
- * {
- * return parent::model($className);
- * }
- * </pre>
- *
- * This method will make a model that does not run construction
- *
- * @param string $className active record class name.
- * @return CActiveRecord active record model instance.
- */
- public static function model($className = null)
- {
- if ($className == null)
- {
- $className = get_called_class();
- }
- if (isset(self::$_models[$className]))
- {
- return self::$_models[$className];
- }
- else
- {
- $model = self::$_models[$className] = new $className(false, null, false, false);
- return $model;
- }
- }
- /**
- * Gets all the models from the database of the named model type.
- * @param $orderBy TODO
- * @param $modelClassName Pass only when getting it at runtime
- * gets the wrong name.
- * @return An array of models of the type of the extending model.
- */
- public static function getAll($orderBy = null, $sortDescending = false, $modelClassName = null)
- {
- assert('$orderBy === null || is_string($orderBy) && $orderBy != ""');
- assert('is_bool($sortDescending)');
- assert('$modelClassName === null || is_string($modelClassName) && $modelClassName != ""');
- $quote = DatabaseCompatibilityUtil::getQuote();
- $orderBySql = null;
- if ($orderBy !== null)
- {
- $orderBySql = "$quote$orderBy$quote";
- if ($sortDescending)
- {
- $orderBySql .= ' desc';
- }
- }
- return static::getSubset(null, null, null, null, $orderBySql, $modelClassName);
- }
- /**
- * Gets a range of models from the database of the named model type.
- * @param $modelClassName
- * @param $joinTablesAdapter null or instance of joinTablesAdapter.
- * @param $offset The zero based index of the first model to be returned.
- * @param $count The number of models to be returned.
- * @param $where
- * @param $orderBy - sql string. Example 'a desc' or 'a.b desc'. Currently only supports non-related attributes
- * @param $modelClassName Pass only when getting it at runtime gets the wrong name.
- * @return An array of models of the type of the extending model.
- */
- public static function getSubset(RedBeanModelJoinTablesQueryAdapter $joinTablesAdapter = null,
- $offset = null, $count = null,
- $where = null, $orderBy = null,
- $modelClassName = null,
- $selectDistinct = false)
- {
- assert('$offset === null || is_integer($offset) && $offset >= 0');
- assert('$count === null || is_integer($count) && $count >= 1');
- assert('$where === null || is_string ($where) && $where != ""');
- assert('$orderBy === null || is_string ($orderBy) && $orderBy != ""');
- assert('$modelClassName === null || is_string($modelClassName) && $modelClassName != ""');
- if ($modelClassName === null)
- {
- $modelClassName = get_called_class();
- }
- $ids = self::getSubsetIds($joinTablesAdapter, $offset, $count, $where,
- $orderBy, $modelClassName, $selectDistinct);
- $tableName = $modelClassName::getTableName();
- $beans = ZurmoRedBean::batch ($tableName, $ids);
- return self::makeModels($beans, $modelClassName);
- }
- /**
- * Gets a range of model ids from the database of the named model type.
- * @param $modelClassName
- * @param $joinTablesAdapter null or instance of joinTablesAdapter.
- * @param $offset The zero based index of the first model to be returned.
- * @param $count The number of models to be returned.
- * @param $where
- * @param $orderBy - sql string. Example 'a desc' or 'a.b desc'. Currently only supports non-related attributes
- * @param $modelClassName Pass only when getting it at runtime gets the wrong name.
- * @return An array of models ids
- */
- public static function getSubsetIds(RedBeanModelJoinTablesQueryAdapter $joinTablesAdapter = null,
- $offset = null, $count = null,
- $where = null, $orderBy = null,
- $modelClassName = null,
- $selectDistinct = false)
- {
- assert('$offset === null || is_integer($offset) && $offset >= 0');
- assert('$count === null || is_integer($count) && $count >= 1');
- assert('$where === null || is_string ($where) && $where != ""');
- assert('$orderBy === null || is_string ($orderBy) && $orderBy != ""');
- assert('$modelClassName === null || is_string($modelClassName) && $modelClassName != ""');
- if ($modelClassName === null)
- {
- $modelClassName = get_called_class();
- }
- if ($joinTablesAdapter == null)
- {
- $joinTablesAdapter = new RedBeanModelJoinTablesQueryAdapter($modelClassName);
- }
- $tableName = $modelClassName::getTableName();
- $sql = static::makeSubsetOrCountSqlQuery($tableName, $joinTablesAdapter, $offset, $count, $where,
- $orderBy, false, $selectDistinct);
- $ids = ZurmoRedBean::getCol($sql);
- return $ids;
- }
- /**
- * @param boolean $selectCount If true then make this a count query. If false, select ids from rows.
- * @param array $quotedExtraSelectColumnNameAndAliases - extra columns to select.
- * @return string - sql statement.
- */
- public static function makeSubsetOrCountSqlQuery($tableName,
- RedBeanModelJoinTablesQueryAdapter $joinTablesAdapter,
- $offset = null, $count = null,
- $where = null, $orderBy = null,
- $selectCount = false,
- $selectDistinct = false,
- array $quotedExtraSelectColumnNameAndAliases = array())
- {
- assert('is_string($tableName) && $tableName != ""');
- assert('$offset === null || is_integer($offset) && $offset >= 0');
- assert('$count === null || is_integer($count) && $count >= 1');
- assert('$where === null || is_string ($where) && $where != ""');
- assert('$orderBy === null || is_string ($orderBy) && $orderBy != ""');
- assert('is_bool($selectCount)');
- assert('is_bool($selectDistinct)');
- $selectQueryAdapter = new RedBeanModelSelectQueryAdapter($selectDistinct);
- if ($selectCount)
- {
- $selectQueryAdapter->addCountClause($tableName);
- }
- else
- {
- $selectQueryAdapter->addClause($tableName, 'id', 'id');
- }
- foreach ($quotedExtraSelectColumnNameAndAliases as $columnName => $columnAlias)
- {
- $selectQueryAdapter->addClauseWithColumnNameOnlyAndNoEnclosure($columnName, $columnAlias);
- }
- return SQLQueryUtil::
- makeQuery($tableName, $selectQueryAdapter, $joinTablesAdapter, $offset, $count, $where, $orderBy);
- }
- /**
- * @param $modelClassName
- * @param $joinTablesAdapter null or instance of joinTablesAdapter.
- * @param $modelClassName Pass only when getting it at runtime gets the wrong name.
- */
- public static function getCount(RedBeanModelJoinTablesQueryAdapter $joinTablesAdapter = null,
- $where = null, $modelClassName = null, $selectDistinct = false)
- {
- assert('$where === null || is_string($where)');
- assert('$modelClassName === null || is_string($modelClassName) && $modelClassName != ""');
- if ($modelClassName === null)
- {
- $modelClassName = get_called_class();
- }
- if ($joinTablesAdapter == null)
- {
- $joinTablesAdapter = new RedBeanModelJoinTablesQueryAdapter($modelClassName);
- }
- $tableName = $modelClassName::getTableName();
- $sql = static::makeSubsetOrCountSqlQuery($tableName, $joinTablesAdapter, null, null, $where, null, true,
- $selectDistinct);
- $count = ZurmoRedBean::getCell($sql);
- if ($count === null || empty($count))
- {
- $count = 0;
- }
- return intval($count);
- }
- /**
- * Gets a model from the database by Id.
- * @param $id Integer Id.
- * @param $modelClassName Pass only when getting it at runtime
- * gets the wrong name.
- * @return A model of the type of the extending model.
- */
- public static function getById($id, $modelClassName = null)
- {
- assert('is_integer($id) && $id > 0');
- assert('$modelClassName === null || is_string($modelClassName) && $modelClassName != ""');
- // I would have thought it was correct to user ZurmoRedBean::load() and get
- // a null, or error or something if the bean doesn't exist, but
- // it still returns a bean. So until I've investigated further
- // I'm using Finder.
- if ($modelClassName === null)
- {
- $modelClassName = get_called_class();
- }
- $tableName = $modelClassName::getTableName();
- $beans = ZurmoRedBean::find($tableName, "id = '$id'");
- assert('count($beans) <= 1');
- if (count($beans) == 0)
- {
- throw new NotFoundException();
- }
- return static::makeModel(end($beans), $modelClassName);
- }
- public function getIsNewModel()
- {
- return $this->isNewModel;
- }
- /**
- * Constructs a new model.
- * Important:
- * Models are only constructed with beans by the RedBeanModel. Beans are
- * never used by the application directly.
- * The application can construct a new model object by constructing a
- * model without specifying a bean. In other words, if Php had
- * overloading a constructor with $setDefaults would be public, and
- * a constructor taking a $bean and $forceTreatAsCreation would be private.
- * @param $setDefaults. If false the default validators will not be run
- * on construction. The Yii way is that defaults are
- * filled in after the fact, which is counter the usual
- * for objects.
- * @param $bean A bean. Never specified by an application.
- * @param $forceTreatAsCreation. Never specified by an application.
- * @param $runConstruction. Sometimes a model is needed to hook in events and the construction logic
- * does not necessarily need to be run.
- * @see getById()
- * @see makeModel()
- * @see makeModels()
- */
- public function __construct($setDefaults = true, RedBean_OODBBean $bean = null, $forceTreatAsCreation = false,
- $runConstruction = true)
- {
- $this->pseudoId = self::$nextPseudoId--;
- $this->init();
- if (!$runConstruction)
- {
- return;
- }
- if ($bean === null)
- {
- foreach (array_reverse(RuntimeUtil::getClassHierarchy(get_class($this), static::$lastClassInBeanHeirarchy)) as $modelClassName)
- {
- if ($modelClassName::getCanHaveBean())
- {
- $tableName = $modelClassName::getTableName();
- $newBean = ZurmoRedBean::dispense($tableName);
- $this->modelClassNameToBean[$modelClassName] = $newBean;
- $this->mapAndCacheMetadataAndSetHints($modelClassName, $newBean);
- }
- }
- // The yii way of doing defaults is the the default validator
- // fills in the defaults on attributes that don't have values
- // when you validator, or save. This weird, since when you get
- // a model the things with defaults have not been defaulted!
- // We want that semantic.
- if ($setDefaults)
- {
- $this->runDefaultValidators();
- }
- $forceTreatAsCreation = true;
- }
- else
- {
- assert('$bean->id > 0');
- $first = true;
- foreach (RuntimeUtil::getClassHierarchy(get_class($this), static::$lastClassInBeanHeirarchy) as $modelClassName)
- {
- if ($modelClassName::getCanHaveBean())
- {
- if ($first)
- {
- $lastBean = $bean;
- $first = false;
- }
- else
- {
- $tableName = $modelClassName::getTableName();
- $lastBean = ZurmoRedBeanLinkManager::getBean($lastBean, $tableName);
- if ($lastBean === null)
- {
- throw new MissingBeanException();
- }
- assert('$lastBean->id > 0');
- }
- $this->modelClassNameToBean[$modelClassName] = $lastBean;
- $this->mapAndCacheMetadataAndSetHints($modelClassName, $lastBean);
- }
- }
- $this->modelClassNameToBean = array_reverse($this->modelClassNameToBean);
- }
- $this->constructDerived($bean, $setDefaults);
- if ($forceTreatAsCreation)
- {
- $this->onCreated();
- }
- else
- {
- $this->onLoaded();
- $modelClassName = get_called_class();
- if ($modelClassName::isCacheable())
- {
- RedBeanModelsCache::cacheModel($this);
- }
- }
- $this->modified = false;
- }
- /**
- * Delete all models
- */
- public static function deleteAll()
- {
- if (static::getCanHaveBean() && static::isTypeDeletable())
- {
- foreach (static::getAll() as $model)
- {
- if (!$model->delete())
- {
- throw new NotSupportedException("Unable to delete id# " . $model->id);
- }
- }
- // we could have used ZurmoRedBean::$writer->wipe() but that won't fire events related to delete.
- }
- else
- {
- throw new NotSupportedException(get_called_class() . "Can either not have bean or is not deletable");
- }
- }
- // Derived classes can insert additional steps into the construction.
- protected function constructDerived($bean, $setDefaults)
- {
- assert('$bean === null || $bean instanceof RedBean_OODBBean');
- assert('is_bool($setDefaults)');
- }
- /**
- * Utilized when pieces of information need to be constructed on an existing model, that can potentially be
- * missing. For example, if a model is created, then a custom field is added, it is possible the cached model
- * is missing the custom field customFieldData.
- * @param unknown_type $bean
- */
- protected function constructIncomplete($bean)
- {
- assert('$bean === null || $bean instanceof RedBean_OODBBean');
- $this->init();
- }
- public function serialize()
- {
- return serialize(array(
- $this->pseudoId,
- $this->modelClassNameToBean,
- $this->attributeNameToBeanAndClassName,
- $this->validators,
- ));
- }
- public function unserialize($data)
- {
- try
- {
- $data = unserialize($data);
- assert('is_array($data)');
- if (count($data) != 4)
- {
- return null;
- }
- $this->pseudoId = $data[0];
- $this->modelClassNameToBean = $data[1];
- $this->attributeNameToBeanAndClassName = $data[2];
- $this->validators = $data[3];
- $this->relationNameToRelatedModel = array();
- $this->unlinkedRelationNames = array();
- $this->unlinkedOwnedRelatedModelsToRemove = array();
- $this->attributeNameToErrors = array();
- $this->scenarioName = '';
- $this->modified = false;
- $this->deleted = false;
- $this->isInIsModified = false;
- $this->isInHasErrors = false;
- $this->isInGetErrors = false;
- $this->isValidating = false;
- $this->isSaving = false;
- $this->isDeleting = false;
- }
- catch (Exception $e)
- {
- return null;
- }
- }
- /**
- * Overriding constructors must call this function to ensure that
- * they leave the newly constructed instance not modified since
- * anything modifying the class during constructionm will set it
- * modified automatically.
- */
- protected function setNotModified()
- {
- $this->modified = false; // This sets this class to the right state.
- assert('!$this->isModified()'); // This tests that related classes are in the right state.
- }
- /**
- * By default the table name is the lowercased class name. If this
- * conflicts with a database keyword override to return true.
- * RedBean does not quote table names in most cases.
- */
- // Public for unit testing.
- public static function mangleTableName()
- {
- return false;
- }
- /**
- * Returns the table name for a class.
- * For use by RedBeanModelDataProvider. It will not
- * be of any use to an application. Applications
- * should not be doing anything table related.
- * Derived classes can refer directly to the
- * table name.
- */
- public static function getTableName()
- {
- // You could also call it on objects like: $model::getTableName() or
- // $model->getTableName() but it would be preferable to keep it accessed through class, statically.
- $modelClassName = get_called_class();
- $tableName = strtolower($modelClassName);
- if ($modelClassName::mangleTableName())
- {
- $tableName = '_' . $tableName;
- }
- return $tableName;
- }
- /**
- * Returns the table names for an array of classes.
- * For use by RedBeanModelDataProvider. It will not
- * be of any use to an application.
- */
- public static function getTableNames($classNames)
- {
- $tableNames = array();
- foreach ($classNames as $className)
- {
- $tableNames[] = $className::getTableName();
- }
- return $tableNames;
- }
- /**
- * Used by classes such as containers which use sql to
- * optimize getting models from the database.
- */
- public static function getForeignKeyName($modelClassName, $relationName)
- {
- assert('is_string($modelClassName)');
- assert('$modelClassName != ""');
- $metadata = $modelClassName::getMetadata();
- foreach ($metadata as $modelClassName => $modelClassMetadata)
- {
- if (isset($metadata[$modelClassName]["relations"]) &&
- array_key_exists($relationName, $metadata[$modelClassName]["relations"]))
- {
- $relatedModelClassName = $metadata[$modelClassName]['relations'][$relationName][1];
- self::resolveModelClassNameForClassesWithoutBeans($relatedModelClassName);
- $relatedModelTableName = $relatedModelClassName::getTableName();
- $linkType = null;
- $relationLinkName = null;
- self::resolveLinkTypeAndRelationLinkName($metadata[$modelClassName]['relations'][$relationName],
- $linkType,
- $relationLinkName);
- $linkName = self::makeCasedLinkName($metadata[$modelClassName]['relations'][$relationName][0],
- $linkType, $relationLinkName);
- if ($metadata[$modelClassName]['relations'][$relationName][0] == self::HAS_MANY ||
- $metadata[$modelClassName]['relations'][$relationName][0] == self::HAS_ONE_BELONGS_TO)
- {
- $columnName = $modelClassName::getTableName() . '_id';
- }
- else
- {
- $columnName = $relatedModelTableName . '_id';
- }
- $columnName = ZurmoRedBeanLinkManager::resolveColumnPrefix($linkName) . $columnName;
- return $columnName;
- }
- }
- throw new NotSupportedException;
- }
- /**
- * Called on construction when a new model is created.
- */
- protected function onCreated()
- {
- if ($this->hasEventHandler('onCreated'))
- {
- $event = new CModelEvent($this);
- $this->onCreated($event);
- }
- }
- /**
- * Called on construction when a model is loaded.
- */
- protected function onLoaded()
- {
- if ($this->hasEventHandler('onLoaded'))
- {
- $event = new CModelEvent($this);
- $this->onLoaded($event);
- }
- }
- /**
- * Called when a model is modified.
- */
- protected function onModified()
- {
- }
- protected static function makeCasedLinkName($relationType, $linkType, $relationLinkName)
- {
- assert('is_int($relationType)');
- assert('is_int($linkType)');
- assert('is_string($relationLinkName) || $relationLinkName == null');
- if (($relationType == self::HAS_ONE || $relationType == self::HAS_MANY ||
- $relationType == self::HAS_ONE_BELONGS_TO) && $linkType == self::LINK_TYPE_SPECIFIC)
- {
- return strtolower($relationLinkName);
- }
- }
- /**
- * Used for mixins.
- */
- protected function mapAndCacheMetadataAndSetHints($modelClassName, RedBean_OODBBean $bean)
- {
- assert('is_string($modelClassName)');
- assert('$modelClassName != ""');
- $metadata = $this->getMetadata();
- if (isset($metadata[$modelClassName]))
- {
- $hints = array();
- if (isset($metadata[$modelClassName]['members']))
- {
- foreach ($metadata[$modelClassName]['members'] as $memberName)
- {
- $this->attributeNameToBeanAndClassName[$memberName] = array($bean, $modelClassName);
- //$this->attributeNamesNotBelongsToOrManyMany[] = $memberName;
- if (substr($memberName, -2) == 'Id')
- {
- $columnName = strtolower($memberName);
- $hints[$columnName] = 'id';
- }
- }
- }
- if (isset($metadata[$modelClassName]['relations']))
- {
- foreach ($metadata[$modelClassName]['relations'] as $relationName => $relationTypeModelClassNameAndOwns)
- {
- assert('in_array(count($relationTypeModelClassNameAndOwns), array(2, 3, 4, 5))');
- $relationType = $relationTypeModelClassNameAndOwns[0];
- $relationModelClassName = $relationTypeModelClassNameAndOwns[1];
- if ($relationType == self::HAS_MANY_BELONGS_TO &&
- strtolower($relationName) != strtolower($relationModelClassName))
- {
- throw new NotSupportedException(Zurmo::t('Core', 'Relations of type HAS_MANY_BELONGS_TO must have the relation name ' .
- 'the same as the related model class name. Relation: {relationName} ' .
- 'Relation model class name: {relationModelClassName}',
- array('{relationName}' => $relationName,
- '{relationModelClassName}' => $relationModelClassName)));
- }
- if (count($relationTypeModelClassNameAndOwns) >= 3 &&
- $relationTypeModelClassNameAndOwns[2] == self::OWNED)
- {
- $owns = true;
- }
- else
- {
- $owns = false;
- }
- // $linkType = null;
- // $relationLinkName = null;
- // self::resolveLinkTypeAndRelationLinkName($relationTypeModelClassNameAndOwns, $linkType,
- // $relationLinkName);
- assert('in_array($relationType, array(self::HAS_ONE_BELONGS_TO, self::HAS_MANY_BELONGS_TO, ' .
- 'self::HAS_ONE, self::HAS_MANY, self::MANY_MANY))');
- $this->attributeNameToBeanAndClassName[$relationName] = array($bean, $modelClassName);
- /**
- $this->relationNameToRelationTypeModelClassNameAndOwns[$relationName] = array($relationType,
- $relationModelClassName,
- $owns,
- $linkType,
- $relationLinkName);
- * **/
- if (!in_array($relationType, array(self::HAS_ONE_BELONGS_TO, self::HAS_MANY_BELONGS_TO, self::MANY_MANY)))
- {
- //$this->attributeNamesNotBelongsToOrManyMany[] = $relationName;
- }
- }
- }
- // Add model validators. Parent validators are already applied.
- if (isset($metadata[$modelClassName]['rules']))
- {
- foreach ($metadata[$modelClassName]['rules'] as $validatorMetadata)
- {
- assert('isset($validatorMetadata[0])');
- assert('isset($validatorMetadata[1])');
- $attributeName = $validatorMetadata[0];
- // Each rule in RedBeanModel must specify one attribute name.
- // This was just better style, now it is mandatory.
- assert('strpos($attributeName, " ") === false');
- $validatorName = $validatorMetadata[1];
- $validatorParameters = array_slice($validatorMetadata, 2);
- if (isset(CValidator::$builtInValidators[$validatorName]))
- {
- $validatorName = CValidator::$builtInValidators[$validatorName];
- }
- if (isset(self::$yiiValidatorsToRedBeanValidators[$validatorName]))
- {
- $validatorName = self::$yiiValidatorsToRedBeanValidators[$validatorName];
- }
- $validator = CValidator::createValidator($validatorName, $this, $attributeName, $validatorParameters);
- switch ($validatorName)
- {
- case 'RedBeanModelTypeValidator':
- case 'TypeValidator':
- $columnName = strtolower($attributeName);
- if (array_key_exists($columnName, $hints))
- {
- unset($hints[$columnName]);
- }
- if (in_array($validator->type, array('date', 'datetime', 'blob', 'longblob', 'string', 'text', 'longtext')))
- {
- $hints[$columnName] = $validator->type;
- }
- break;
- case 'CBooleanValidator':
- $columnName = strtolower($attributeName);
- $hints[$columnName] = 'boolean';
- break;
- case 'RedBeanModelUniqueValidator':
- if (!static::isRelation($attributeName))
- {
- $bean->setMeta("buildcommand.unique", array(array($attributeName)));
- }
- else
- {
- $relationAndOwns = static::getRelationNameToRelationTypeModelClassNameAndOwnsForModel();
- $relatedModelClassName = $relationAndOwns[$attributeName][1];
- $relatedModelTableName = $relatedModelClassName::getTableName();
- $columnName = strtolower($attributeName);
- if ($columnName != $relatedModelTableName)
- {
- $columnName .= '_' . $relatedModelTableName;
- }
- $columnName .= '_id';
- $bean->setMeta("buildcommand.unique", array(array($columnName)));
- }
- break;
- }
- $this->validators[] = $validator;
- }
- // Check if we need to update string type to long string type, based on validators.
- if (isset($metadata[$modelClassName]['members']))
- {
- foreach ($metadata[$modelClassName]['members'] as $memberName)
- {
- $allValidators = $this->getValidators($memberName);
- if (!empty($allValidators))
- {
- foreach ($allValidators as $validator)
- {
- if ((get_class($validator) == 'RedBeanModelTypeValidator' ||
- get_class($validator) == 'TypeValidator') &&
- $validator->type == 'string')
- {
- $columnName = strtolower($validator->attributes[0]);
- if (count($allValidators) > 1)
- {
- $haveCStringValidator = false;
- foreach ($allValidators as $innerValidator)
- {
- if (get_class($innerValidator) == 'CStringValidator' &&
- isset($innerValidator->max) &&
- $innerValidator->max > 0)
- {
- if ($innerValidator->max > 65535)
- {
- $hints[$columnName] = 'longtext';
- }
- elseif ($innerValidator->max < 255)
- {
- $hints[$columnName] = "string({$innerValidator->max})";
- }
- else
- {
- $hints[$columnName] = 'text';
- }
- }
- if (get_class($innerValidator) == 'CStringValidator')
- {
- $haveCStringValidator = true;
- }
- }
- if (!$haveCStringValidator)
- {
- $hints[$columnName] = 'text';
- }
- }
- else
- {
- $hints[$columnName] = 'text';
- }
- }
- }
- }
- }
- }
- }
- $bean->setMeta('hint', $hints);
- }
- }
- /**
- * Used for mixins.
- */
- protected function runDefaultValidators()
- {
- foreach ($this->validators as $validator)
- {
- if ($validator instanceof CDefaultValueValidator)
- {
- $validator->validate($this);
- }
- }
- }
- /**
- * For use only by RedBeanModel and RedBeanModels. Beans are
- * never used by the application directly.
- */
- public function getPrimaryBean()
- {
- return end($this->modelClassNameToBean);
- }
- /**
- * Used for optimization.
- */
- public function getClassId($modelClassName)
- {
- assert('array_key_exists($modelClassName, $this->modelClassNameToBean)');
- return intval($this->getClassBean($modelClassName)->id); // Trying to combat the slop.
- }
- public function getClassBean($modelClassName)
- {
- assert('is_string($modelClassName)');
- assert('$modelClassName != ""');
- self::resolveModelClassNameForClassesWithoutBeans($modelClassName);
- assert('array_key_exists($modelClassName, $this->modelClassNameToBean)');
- return $this->modelClassNameToBean[$modelClassName];
- }
- /**
- * Used for mixins.
- */
- protected function setClassBean($modelClassName, RedBean_OODBBean $bean)
- {
- assert('is_string($modelClassName)');
- assert('$modelClassName != ""');
- assert('!array_key_exists($modelClassName, $this->modelClassNameToBean)');
- $this->modelClassNameToBean = array_merge(array($modelClassName => $bean),
- $this->modelClassNameToBean);
- }
- public function getModelIdentifier()
- {
- $className = get_class($this);
- $beanId = strval($this->getPrimaryBean()->id);
- $modelIdentifier = static::getModelIdentifierByClassNameAndBeanId($className, $beanId);
- return $modelIdentifier;
- }
- protected static function getModelIdentifierByClassNameAndBeanId($modelClassName, $beanId)
- {
- return $modelClassName . static::MODEL_IDENTIFIER_DELIMITER . $beanId;
- }
- public static function getModelClassNameByIdentifier($identifier)
- {
- $identifierTokens = explode(static::MODEL_IDENTIFIER_DELIMITER, $identifier);
- return $identifierTokens[0];
- }
- /**
- * Returns metadata for the model. Attempts to cache metadata, if it is not already cached.
- * @see getDefaultMetadata()
- * @returns An array of metadata.
- */
- public static function getMetadata()
- {
- try
- {
- // not using default value to save cpu cycles on requests that follow the first exception.
- return GeneralCache::getEntry(get_called_class() . 'Metadata');
- }
- catch (NotFoundException $e)
- {
- $className = get_called_Class();
- $defaultMetadata = $className::getDefaultMetadata();
- $metadata = array();
- foreach (array_reverse(RuntimeUtil::getClassHierarchy($className, static::$lastClassInBeanHeirarchy)) as $modelClassName)
- {
- if ($modelClassName::getCanHaveBean())
- {
- if ($modelClassName::canSaveMetadata())
- {
- try
- {
- $globalMetadata = GlobalMetadata::getByClassName($modelClassName);
- $metadata[$modelClassName] = unserialize($globalMetadata->serializedMetadata);
- }
- catch (NotFoundException $e)
- {
- if (isset($defaultMetadata[$modelClassName]))
- {
- $metadata[$modelClassName] = $defaultMetadata[$modelClassName];
- }
- }
- }
- else
- {
- if (isset($defaultMetadata[$modelClassName]))
- {
- $metadata[$modelClassName] = $defaultMetadata[$modelClassName];
- }
- }
- }
- }
- if (YII_DEBUG)
- {
- self::assertMetadataIsValid($metadata);
- }
- GeneralCache::cacheEntry(get_called_class() . 'Metadata', $metadata);
- return $metadata;
- }
- }
- /**
- * By default models cannot save their metadata, allowing
- * them to be loaded quickly because the loading of of
- * metadata can be avoided as much as possible.
- * To make a model able to save its metadata override
- * this method to return true. PUT it before the
- * getDefaultMetadata in the derived class.
- */
- public static function canSaveMetadata()
- {
- return false;
- }
- /**
- * Sets metadata for the model.
- * @see getDefaultMetadata()
- * @returns An array of metadata.
- */
- public static function setMetadata(array $metadata)
- {
- if (YII_DEBUG)
- {
- self::assertMetadataIsValid($metadata);
- }
- $className = get_called_class();
- foreach (array_reverse(RuntimeUtil::getClassHierarchy($className, static::$lastClassInBeanHeirarchy)) as $modelClassName)
- {
- if ($modelClassName::getCanHaveBean())
- {
- if ($modelClassName::canSaveMetadata())
- {
- if (isset($metadata[$modelClassName]))
- {
- try
- {
- $globalMetadata = GlobalMetadata::getByClassName($modelClassName);
- }
- catch (NotFoundException $e)
- {
- $globalMetadata = new GlobalMetadata();
- $globalMetadata->className = $modelClassName;
- }
- $globalMetadata->serializedMetadata = serialize($metadata[$modelClassName]);
- $saved = $globalMetadata->save();
- // TODO: decide how to deal with this properly if it fails.
- // ie: throw or return false, or something other than
- // this naughty assert.
- assert('$saved');
- }
- }
- }
- }
- self::forgetBeanModel(get_called_class());
- RedBeanModelsCache::forgetAllByModelType(get_called_class());
- GeneralCache::forgetEntry(get_called_class() . 'Metadata');
- }
- /**
- * Returns the default meta data for the class.
- * It must be appended to the meta data
- * from the parent model, if any.
- */
- public static function getDefaultMetadata()
- {
- return array();
- }
- protected static function assertMetadataIsValid(array $metadata)
- {
- $className = get_called_Class();
- foreach (RuntimeUtil::getClassHierarchy($className, static::$lastClassInBeanHeirarchy) as $modelClassName)
- {
- if ($modelClassName::getCanHaveBean())
- {
- if (isset($metadata[$modelClassName]['members']))
- {
- assert('is_array($metadata[$modelClassName]["members"])');
- foreach ($metadata[$modelClassName]["members"] as $memberName)
- {
- assert('ctype_lower($memberName{0})');
- }
- }
- if (isset($metadata[$modelClassName]['relations']))
- {
- assert('is_array($metadata[$modelClassName]["relations"])');
- foreach ($metadata[$modelClassName]["relations"] as $relationName => $notUsed)
- {
- assert('ctype_lower($relationName{0})');
- }
- }
- if (isset($metadata[$modelClassName]['indexes']))
- {
- assert('is_array($metadata[$modelClassName]["indexes"])');
- foreach ($metadata[$modelClassName]["indexes"] as $indexName => $notUsed)
- {
- assert('ctype_lower($indexName{0})');
- }
- }
- if (isset($metadata[$modelClassName]['rules']))
- {
- assert('is_array($metadata[$modelClassName]["rules"])');
- }
- if (isset($metadata[$modelClassName]['defaultSortAttribute']))
- {
- assert('is_string($metadata[$modelClassName]["defaultSortAttribute"])');
- }
- if (isset($metadata[$modelClassName]['rollupRelations']))
- {
- assert('is_array($metadata[$modelClassName]["rollupRelations"])');
- }
- }
- }
- }
- /**
- * Downcasting in general is a bad concept, but when pulling
- * a Person from the database it would require a lot of
- * jumping through hoops to make the RedBeanModel automatically
- * figure out if that person is really a User, Contact, Customer
- * or whatever might be derived from Person. So to avoid that
- * complication and performance hit where it is not necessary
- * this method can be used to convert a model to one of
- * a given set of derivatives. If model is not one
- * of those NotFoundException is thrown.
- */
- public function castDown(array $derivedModelClassNames)
- {
- $bean = $this->getPrimaryBean();
- $thisModelClassName = get_called_class();
- $key = strtolower($thisModelClassName) . '_id';
- foreach ($derivedModelClassNames as $modelClassNames)
- {
- if (is_string($modelClassNames))
- {
- $nextModelClassName = $modelClassNames;
- if (get_class($this) == $nextModelClassName)
- {
- return $this;
- }
- $nextBean = self::findNextDerivativeBean($bean, $thisModelClassName, $nextModelClassName);
- }
- else
- {
- assert('is_array($modelClassNames)');
- $targetModelClassName = end($modelClassNames);
- if (get_class($this) == $targetModelClassName)
- {
- return $this;
- }
- $currentModelClassName = $thisModelClassName;
- $nextBean = $bean;
- foreach ($modelClassNames as $nextModelClassName)
- {
- if ($nextModelClassName::getCanHaveBean())
- {
- $nextBean = self::findNextDerivativeBean($nextBean, $currentModelClassName, $nextModelClassName);
- if ($nextBean === null)
- {
- break;
- }
- $currentModelClassName = $nextModelClassName;
- }
- }
- }
- if ($nextBean !== null)
- {
- return self::makeModel($nextBean, $nextModelClassName);
- }
- }
- throw new NotFoundException();
- }
- private static function findNextDerivativeBean($bean, $modelClassName1, $modelClassName2)
- {
- if ($bean->id > 0)
- {
- $key = strtolower($modelClassName1) . '_id';
- $tableName = $modelClassName2::getTableName();
- $beans = ZurmoRedBean::find($tableName, "$key = :id", array('id' => $bean->id));
- if (count($beans) == 1)
- {
- return reset($beans);
- }
- }
- return null;
- }
- /**
- * Returns whether the given object is of the same type with the
- * same id.
- */
- public function isSame(RedBeanModel $model)
- {
- // The two models are the same if they have the
- // same root model, and if for that model they
- // have the same id.
- $rootId1 = reset($this ->modelClassNameToBean)->id;
- $rootId2 = reset($model->modelClassNameToBean)->id;
- if ($rootId1 == 0)
- {
- $rootId1 = $this->pseudoId;
- }
- if ($rootId2 == 0)
- {
- $rootId2 = $model->pseudoId;
- }
- return $rootId1 == $rootId2 && $rootId1 != 0 &&
- key($this ->modelClassNameToBean) ==
- key($model->modelClassNameToBean);
- }
- /**
- * Returns the displayable string for the class. Should be
- * overridden in any model that can provide a meaningful string
- * representation of itself.
- * @return A string.
- */
- public function __toString()
- {
- return Zurmo::t('Core', '(None)');
- }
- /**
- * Exposes the members and relations of the model as if
- * they were actual attributes of the model. See __set().
- * @param $attributeName A non-empty string that is the name of a
- * member or relation.
- * @see attributeNames()
- * @return A value or model of the type specified as valid for the
- * member or relation by the meta data supplied by the extending
- * class's getMetadata() method.
- */
- public function __get($attributeName)
- {
- return $this->unrestrictedGet($attributeName);
- }
- /**
- * A protected version of __get() for models to talk to themselves
- * to use their dynamically created members from 'members'
- * and 'relations' in its metadata.
- */
- protected function unrestrictedGet($attributeName)
- {
- assert('is_string($attributeName)');
- assert('$attributeName != ""');
- assert("property_exists(\$this, '$attributeName') || \$this->isAttribute('$attributeName')");
- if (property_exists($this, $attributeName))
- {
- return $this->$attributeName;
- }
- elseif ($attributeName == 'id')
- {
- $id = intval($this->getPrimaryBean()->id);
- assert('$id >= 0');
- if ($id == 0)
- {
- $id = $this->pseudoId;
- }
- return $id;
- }
- elseif ($this->isAttribute($attributeName))
- {
- list($bean, $attributeModelClassName) = $this->attributeNameToBeanAndClassName[$attributeName];
- if (!static::isRelation($attributeName))
- {
- $columnName = strtolower($attributeName);
- return $bean->$columnName;
- }
- else
- {
- if (!array_key_exists($attributeName, $this->relationNameToRelatedModel))
- {
- $relationAndOwns = static::getRelationNameToRelationTypeModelClassNameAndOwnsForModel();
- list($relationType, $relatedModelClassName, $owns, $linkType, $relationLinkName) =
- $relationAndOwns[$attributeName];
- $tempRelatedModelClassName = $relatedModelClassName;
- self::resolveModelClassNameForClassesWithoutBeans($tempRelatedModelClassName);
- $relatedTableName = $tempRelatedModelClassName::getTableName();
- switch ($relationType)
- {
- case self::HAS_ONE_BELONGS_TO:
- $linkName = strtolower(get_class($this));
- $columnName = $linkName . '_id';
- $relatedBeans = ZurmoRedBean::find($relatedTableName, $columnName . " = " . $bean->id);
- if (count($relatedBeans) > 1)
- {
- throw new NotFoundException();
- }
- elseif (count($relatedBeans) == 0)
- {
- $relatedModel = new $relatedModelClassName();
- }
- else
- {
- $relatedModel = self::makeModel(end($relatedBeans), $relatedModelClassName);
- }
- $this->relationNameToRelatedModel[$attributeName] = $relatedModel;
- break;
- case self::HAS_ONE:
- case self::HAS_MANY_BELONGS_TO:
- $linkName = self::makeCasedLinkName($relationType, $linkType, $relationLinkName);
- if ($bean->id > 0 && !in_array($attributeName, $this->unlinkedRelationNames))
- {
- $linkFieldName = ZurmoRedBeanLinkManager::getLinkField($relatedTableName, $linkName);
- if ((int)$bean->$linkFieldName > 0)
- {
- $beanIdentifier = $relatedTableName .(int)$bean->$linkFieldName;
- try
- {
- $relatedBean = RedBeansCache::getBean($beanIdentifier);
- }
- catch (NotFoundException $e)
- {
- $relatedBean = ZurmoRedBeanLinkManager::getBean($bean, $relatedTableName, $linkName);
- RedBeansCache::cacheBean($relatedBean, $beanIdentifier);
- }
- if ($relatedBean !== null && $relatedBean->id > 0)
- {
- $relatedModel = self::makeModel($relatedBean, $relatedModelClassName);
- }
- }
- }
- if (!isset($relatedModel))
- {
- $relatedModel = new $relatedModelClassName();
- }
- $this->relationNameToRelatedModel[$attributeName] = $relatedModel;
- break;
- case self::HAS_MANY:
- $this->relationNameToRelatedModel[$attributeName] =
- new RedBeanOneToManyRelatedModels($this,
- $bean,
- $relatedModelClassName,
- $attributeModelClassName,
- $attributeName,
- $owns,
- $linkType,
- $relationLinkName);
- break;
- case self::MANY_MANY:
- $this->relationNameToRelatedModel[$attributeName] =
- new RedBeanManyToManyRelatedModels($bean, $relatedModelClassName,
- $linkType, $relationLinkName);
- break;
- default:
- throw new NotSupportedException();
- }
- }
- return $this->relationNameToRelatedModel[$attributeName];
- }
- }
- else
- {
- throw new NotSupportedException('Invalid Attribute: ' . $attributeName);
- }
- }
- /**
- * Sets the members and relations of the model as if
- * they were actual attributes of the model. For example, if Account
- * extends RedBeanModel and its attributeNames() returns that one it has
- * a member 'name' and a relation 'owner' they are simply
- * accessed as:
- * @code
- * $account = new Account();
- * $account->name = 'International Corp';
- * $account->owner = User::getByUsername('bill');
- * $account->save();
- * @endcode
- * @param $attributeName A non-empty string that is the name of a
- * member or relation of the model.
- * @param $value A value or model of the type specified as valid for the
- * member or relation by the meta data supplied by the extending
- * class's getMetadata() method.
- */
- public function __set($attributeName, $value)
- {
- if ($attributeName == 'id' ||
- ($this->isAttributeReadOnly($attributeName) && !$this->isAllowedToSetReadOnlyAttribute($attributeName)))
- {
- $message = Zurmo::t('Core', 'It is not allowed to set read only attribute: {attributeName}.',
- array('{attributeName}' => $attributeName));
- throw new NotSupportedException($message);
- }
- else
- {
- if ($this->unrestrictedSet($attributeName, $value))
- {
- $this->modified = true;
- $this->onModified();
- }
- }
- }
- /**
- * A protected version of __set() for models to talk to themselves
- * to use their dynamically created members from 'members'
- * and 'relations' in its metadata.
- */
- protected function unrestrictedSet($attributeName, $value)
- {
- assert('is_string($attributeName)');
- assert('$attributeName != ""');
- assert("property_exists(\$this, '$attributeName') || \$this->isAttribute('$attributeName')");
- if (property_exists($this, $attributeName))
- {
- $this->$attributeName = $value;
- }
- elseif (static::isAnAttribute($attributeName))
- {
- if (!static::isRelation($attributeName))
- {
- $bean = $this->attributeNameToBeanAndClassName[$attributeName][0];
- $columnName = strtolower($attributeName);
- if ($bean->$columnName !== $value)
- {
- $bean->$columnName = $value;
- return true;
- }
- }
- else
- {
- $relationAndOwns = static::getRelationNameToRelationTypeModelClassNameAndOwnsForModel();
- list($relationType, $relatedModelClassName, $owns, $linkType, $relationLinkName) =
- $relationAndOwns[$attributeName];
- $relatedTableName = $relatedModelClassName::getTableName();
- switch ($relationType)
- {
- case self::HAS_MANY:
- case self::MANY_MANY:
- // The many sides of a relation cannot
- // be assigned, they are changed by the using the
- // RedBeanOneToManyRelatedModels or
- // RedBeanManyToManyRelatedModels object
- // on the 1 or other side of the relationship
- // respectively.
- throw new NotSupportedException();
- }
- // If the value is null we need to get the related model so that
- // if there is none we can ignore the null and if there is one
- // we can act on it.
- if ($value === null &&
- !in_array($attributeName, $this->unlinkedRelationNames) &&
- !isset($this->relationNameToRelatedModel[$attributeName]))
- {
- $this->unrestrictedGet($attributeName);
- }
- elseif ($value !== null && $owns == static::OWNED &&
- !in_array($attributeName, $this->unlinkedRelationNames) &&
- !isset($this->relationNameToRelatedModel[$attributeName]))
- {
- $this->unrestrictedGet($attributeName);
- }
- if (isset($this->relationNameToRelatedModel[$attributeName]) &&
- $value !== null &&
- $this->relationNameToRelatedModel[$attributeName]->isSame($value))
- {
- // If there is a current related model and it is the same
- // as the one being set then do nothing.
- }
- else
- {
- if (!in_array($attributeName, $this->unlinkedRelationNames) &&
- isset($this->relationNameToRelatedModel[$attributeName]))
- {
- $this->unlinkedRelationNames[] = $attributeName;
- if ($owns == static::OWNED)
- {
- $this->unlinkedOwnedRelatedModelsToRemove[$attributeName] =
- $this->relationNameToRelatedModel[$attributeName];
- }
- }
- if ($value === null)
- {
- unset($this->relationNameToRelatedModel[$attributeName]);
- }
- else
- {
- assert("\$value instanceof $relatedModelClassName");
- $this->relationNameToRelatedModel[$attributeName] = $value;
- }
- }
- return true;
- }
- }
- else
- {
- throw new NotSupportedException($attributeName);
- }
- return false;
- }
- /**
- * Allows testing of the members and relations of the model as if
- * they were actual attributes of the model.
- */
- public function __isset($attributeName)
- {
- assert('is_string($attributeName)');
- assert('$attributeName != ""');
- return $this->isAttribute($attributeName) &&
- $this->$attributeName !== null ||
- !$this->isAttribute($attributeName) &&
- isset($this->$attributeName);
- }
- /**
- * Allows unsetting of the members and relations of the model as if
- * they were actual attributes of the model.
- */
- public function __unset($attributeName)
- {
- assert('is_string($attributeName)');
- assert('$attributeName != ""');
- $this->$attributeName = null;
- }
- /**
- * Returns the member and relation names defined by the extending
- * class's getMetadata() method.
- */
- public function attributeNames()
- {
- return static::getAttributeNames();
- }
- /**
- * Returns true if the named attribute is one of the member or
- * relation names defined by the extending
- * class's getMetadata() method.
- */
- public function isAttribute($attributeName)
- {
- return static::isAnAttribute($attributeName);
- }
- /**
- * Check if attribute name exist, but ignore case sensitivity
- * This is used by designer to make difference for example between firstValue and firstvalue, because
- * regular isAttribute methoed doesn't make difference.
- * In most case you would want to use isAttribute method.
- * @param string $attributeName
- * @return bool
- */
- public function isAttributeWithLowerCaseConversion($attributeName)
- {
- $existingAttributeNames = static::getAttributeNames();
- $existingAttributeNames = array_map('strtolower', $existingAttributeNames);
- if (in_array(strtolower($attributeName), $existingAttributeNames))
- {
- return true;
- }
- }
- /**
- * Returns true if the attribute is read-only.
- */
- public function isAttributeReadOnly($attributeName)
- {
- assert("\$this->isAttribute(\"$attributeName\")");
- foreach ($this->validators as $validator)
- {
- if ($validator instanceof RedBeanModelReadOnlyValidator)
- {
- if (in_array($attributeName, $validator->attributes, true))
- {
- return true;
- }
- }
- }
- return false;
- }
- /**
- * Returns true if the attribute is formattted as probability
- */
- public function isAttributeFormattedAsProbability($attributeName)
- {
- assert("\$this->isAttribute(\"$attributeName\")");
- foreach ($this->validators as $validator)
- {
- if ($validator instanceof RedBeanModelProbabilityValidator)
- {
- if (in_array($attributeName, $validator->attributes, true))
- {
- return true;
- }
- }
- }
- return false;
- }
- /**
- * @param boolean $attributeName
- * @return true/false whether the attributeName specified, it is allowed to be set externally even though it is
- * a read-only attribute.
- */
- public function isAllowedToSetReadOnlyAttribute($attributeName)
- {
- return false;
- }
- /**
- * See the yii documentation. Not used by RedBeanModel.
- * @see getMetadata()
- */
- public function rules()
- {
- throw new NotImplementedException();
- }
- /**
- * See the yii documentation.
- */
- public function behaviors()
- {
- return array();
- }
- /**
- * See the yii documentation.
- * RedBeanModels utilize translatedAttributeLabels to store any attribute information.
- */
- public function attributeLabels()
- {
- return static::translatedAttributeLabels(Yii::app()->language);
- }
- /**
- * Public method
- */
- public function abbreviatedAttributeLabels()
- {
- return static::translatedAbbreviatedAttributeLabels(Yii::app()->language);
- }
- /**
- * Performs validation using the validators specified in the 'rules'
- * meta data by the extending class's getMetadata() method.
- * Validation occurs on a new model or a modified model, but only
- * proceeds to modified related models. Once validated a model
- * will pass validation without revalidating until it is modified.
- * Related models are only validated if the model validates.
- * Cyclic relationships are prevented from causing problems by the
- * validation either stopping at a non-validating model and only
- * proceeding to non-validated models.
- * @see RedBeanModel
- * @param $ignoreRequiredValidator - set to true in scenarios where you want to validate everything but the
- * the required validator. An example is a search form.
- */
- public function validate(array $attributeNames = null, $ignoreRequiredValidator = false)
- {
- if ($this->isValidating) // Prevent cycles.
- {
- return true;
- }
- $this->isValidating = true;
- try
- {
- $this->clearErrors();
- if ($this->beforeValidate())
- {
- $hasErrors = false;
- if ($attributeNames === null)
- {
- $attributeNames = static::getAttributeNamesNotBelongsToOrManyManyForModel();
- }
- foreach ($this->getValidators() as $validator)
- {
- if ($validator instanceof RedBeanModelRequiredValidator && $validator->applyTo($this->scenarioName))
- {
- if (!$ignoreRequiredValidator)
- {
- $validator->validate($this, $attributeNames);
- }
- }
- elseif (!$validator instanceof CDefaultValueValidator && $validator->applyTo($this->scenarioName))
- {
- $validator->validate($this, $attributeNames);
- }
- }
- $relatedModelsHaveErrors = false;
- foreach ($this->relationNameToRelatedModel as $relationName => $relatedModel)
- {
- if ((!$this->$relationName instanceof RedBeanModel) ||
- !$this->$relationName->isSame($this))
- {
- if (in_array($relationName, $attributeNames) &&
- ($this->$relationName->isModified() ||
- ($this->isAttributeRequired($relationName) && !$ignoreRequiredValidator) &&
- !$this->isSame($this->$relationName))) // Prevent cycles.
- {
- if (!$this->$relationName->validate(null, $ignoreRequiredValidator))
- {
- $hasErrors = true;
- }
- }
- }
- }
- $this->afterValidate();
- $hasErrors = $hasErrors || count($this->attributeNameToErrors) > 0;
- // Put these asserts back if there are suspitions about validate/hasErrors/getErrors
- // producing inconsistent results. But for now it is commented out because
- // it makes too big an impact.
- //assert('$hasErrors == (count($this->getErrors()) > 0)');
- //assert('$hasErrors == $this->hasErrors()');
- $this->isValidating = false;
- return !$hasErrors;
- }
- $this->isValidating = false;
- return false;
- }
- catch (Exception $e)
- {
- $this->isValidating = false;
- throw $e;
- }
- }
- /**
- * See the yii documentation.
- */
- protected function beforeValidate()
- {
- $event = new CModelEvent($this);
- $this->onBeforeValidate($event);
- return $event->isValid;
- }
- /**
- * See the yii documentation.
- */
- protected function afterValidate()
- {
- $this->onAfterValidate(new CEvent($this));
- }
- /**
- * See the yii documentation.
- */
- public function onBeforeValidate(CModelEvent $event)
- {
- $this->raiseEvent('onBeforeValidate', $event);
- }
- /**
- * See the yii documentation.
- */
- public function onAfterValidate($event)
- {
- $this->raiseEvent('onAfterValidate', $event);
- }
- /**
- * See the yii documentation.
- */
- public function getValidatorList()
- {
- return $this->validators;
- }
- /**
- * See the yii documentation.
- */
- public function getValidators($attributeName = null)
- {
- assert("\$attributeName === null || \$this->isAttribute('$attributeName')");
- $validators = array();
- $scenarioName = $this->scenarioName;
- foreach ($this->validators as $validator)
- {
- if ($scenarioName === null || $validator->applyTo($scenarioName))
- {
- if ($attributeName === null || in_array($attributeName, $validator->attributes, true))
- {
- $validators[] = $validator;
- }
- }
- }
- return $validators;
- }
- /**
- * Method to call to clear out validators from memory. Can help with performance. Used by async export
- * for example.
- */
- public function forgetValidators()
- {
- if (!empty($this->validators))
- {
- $this->validators = array();
- }
- }
- /**
- * See the yii documentation.
- */
- public function createValidators()
- {
- throw new NotImplementedException();
- }
- /**
- * Returns true if the attribute value does not already exist in
- * the database. This is used in the unique validator, but on saving
- * RedBean can still throw because the unique constraint on the column
- * has been violated because it was concurrently updated between the
- * Yii validator being called and the save actually occuring.
- */
- public function isUniqueAttributeValue($attributeName, $value)
- {
- assert("\$this->isAttribute('$attributeName')");
- assert('$value !== null');
- if (!static::isRelation($attributeName))
- {
- $modelClassName = $this->attributeNameToBeanAndClassName[$attributeName][1];
- $tableName = $modelClassName::getTableName();
- $rows = ZurmoRedBean::getAll('select id from ' . $tableName . " where $attributeName = ?", array($value));
- return count($rows) == 0 || count($rows) == 1 && $rows[0]['id'] == $this->id;
- }
- else
- {
- $model = $this->$attributeName;
- if ($model->id == 0)
- {
- return true;
- }
- $relationAndOwns = static::getRelationNameToRelationTypeModelClassNameAndOwnsForModel();
- $modelClassName = $relationAndOwns[$attributeName][1];
- $tableName = $modelClassName::getTableName();
- $rows = ZurmoRedBean::getAll('select id from ' . $tableName . ' where id = ?', array($model->id));
- return count($rows) == 0 || count($rows) == 1 && $rows[0]['id'] == $this->id;
- }
- }
- /**
- * Saves the model to the database. Models are only saved if they have been
- * modified and related models are saved before this model. If a related model
- * is modified and needs saving the deems the model to be modified and need
- * saving, which ensures that keys are updated.
- * Cyclic relationships are prevented from causing problems by the
- * save only proceeding to non-saved models.
- */
- public function save($runValidation = true, array $attributeNames = null)
- {
- if ($attributeNames !== null)
- {
- throw new NotSupportedException();
- }
- if ($this->isSaving) // Prevent cycles.
- {
- return true;
- }
- $this->isSaving = true;
- try
- {
- if (!$runValidation || $this->validate())
- {
- if ($this->beforeSave())
- {
- $beans = array_values($this->modelClassNameToBean);
- $this->linkBeans();
- // The breakLink/link is deferred until the save to avoid
- // disconnecting or creating an empty row if the model was
- // never actually saved.
- foreach ($this->unlinkedRelationNames as $key => $relationName)
- {
- $bean = $this->attributeNameToBeanAndClassName[$relationName][0];
- $relationAndOwns = static::getRelationNameToRelationTypeModelClassNameAndOwnsForModel();
- $relatedModelClassName = $relationAndOwns[$relationName][1];
- $tempRelatedModelClassName = $relatedModelClassName;
- self::resolveModelClassNameForClassesWithoutBeans($tempRelatedModelClassName);
- $relatedTableName = $tempRelatedModelClassName::getTableName();
- $linkName = strtolower($relationName);
- if (static::getRelationType($relationName) == self::HAS_ONE &&
- static::getRelationLinkType($relationName) == self::LINK_TYPE_SPECIFIC)
- {
- $linkName = strtolower(static::getRelationLinkName($relationName));
- }
- elseif ($linkName == strtolower($relatedModelClassName))
- {
- $linkName = null;
- }
- ZurmoRedBeanLinkManager::breakLink($bean, $relatedTableName, $linkName);
- //Check the $this->{$relationName} second in the if clause to avoid accidentially getting
- //a relation to now save. //todo: this needs to be properly handled.
- if (isset($this->unlinkedOwnedRelatedModelsToRemove[$relationName]) && $this->{$relationName} !== null)
- {
- //Remove hasOne owned related models that are no longer needed because they have
- //been replaced with another hasOne owned model.
- if ($this->unlinkedOwnedRelatedModelsToRemove[$relationName]->id > 0)
- {
- $this->unlinkedOwnedRelatedModelsToRemove[$relationName]->unrestrictedDelete();
- }
- unset($this->unlinkedOwnedRelatedModelsToRemove[$relationName]);
- }
- unset($this->unlinkedRelationNames[$key]);
- }
- assert('count($this->unlinkedRelationNames) == 0');
- foreach ($this->relationNameToRelatedModel as $relationName => $relatedModel)
- {
- $relationAndOwns = static::getRelationNameToRelationTypeModelClassNameAndOwnsForModel();
- $relationType = $relationAndOwns[$relationName][0];
- if (!in_array($relationType, array(self::HAS_ONE_BELONGS_TO,
- self::HAS_MANY_BELONGS_TO)))
- {
- if ($this->isRelatedModelReallyModified($relatedModel, $relationAndOwns[$relationName][0],
- $relationAndOwns[$relationName][2]) || $this->isAttributeRequired($relationName))
- {
- //If the attribute is required, but already exists and has not been modified we do
- //not have to worry about saving it.
- if ($this->isSavableFromRelation &&
- !($this->isAttributeRequired($relationName) &&
- !$relatedModel->isModified() &&
- $relatedModel->id > 0))
- {
- if (!$relatedModel->save(false))
- {
- $this->isSaving = false;
- return false;
- }
- }
- elseif ($relatedModel->isModified())
- {
- throw new NotSupportedException();
- }
- }
- }
- if ($relatedModel instanceof RedBeanModel)
- {
- $bean = $this->attributeNameToBeanAndClassName [$relationName][0];
- $relationAndOwns = static::getRelationNameToRelationTypeModelClassNameAndOwnsForModel();
- $relatedModelClassName = $relationAndOwns[$relationName][1];
- $linkName = strtolower($relationName);
- if ($relationType == self::HAS_ONE &&
- static::getRelationLinkType($relationName) == self::LINK_TYPE_SPECIFIC)
- {
- $linkName = strtolower(static::getRelationLinkName($relationName));
- }
- elseif (strtolower($linkName) == strtolower($relatedModelClassName) ||
- static::getRelationLinkType($relationName) == self::LINK_TYPE_ASSUMPTIVE)
- {
- $linkName = null;
- }
- elseif ($relationType == static::HAS_MANY_BELONGS_TO ||
- $relationType == static::HAS_ONE_BELONGS_TO)
- {
- throw new NotSupportedException(Zurmo::t('Core', 'Relations of type HAS_MANY_BELONGS_TO OR HAS_ONE_BELONGS_TO must have the relation name ' .
- 'the same as the related model class name. Relation: {relationName} ' .
- 'Relation model class name: {relationModelClassName}',
- array('{relationName}' => $linkName,
- '{relationModelClassName}' => $relatedModelClassName)));
- }
- //Needed to exclude HAS_ONE_BELONGS_TO because an additional column was being created
- //on the wrong side.
- if ($relationType != static::HAS_ONE_BELONGS_TO &&
- ($this->isRelatedModelReallyModified($relatedModel, $relationAndOwns[$relationName][0], $relationAndOwns[$relationName][2]) ||
- $relatedModel->id > 0 ||
- $this->isAttributeRequired($relationName)))
- {
- $relatedModel = $this->relationNameToRelatedModel[$relationName];
- $relatedBean = $relatedModel->getClassBean($relatedModelClassName);
- //Exclude HAS_MANY_BELONGS_TO because if the existing relation is unlinked, then
- //this link should not be reactivated, because it will improperly create the bean
- //in the database.
- if (!($relationType == static::HAS_MANY_BELONGS_TO && $this->{$relationName}->id < 0))
- {
- ZurmoRedBeanLinkManager::link($bean, $relatedBean, $linkName);
- }
- }
- }
- }
- $baseModelClassName = null;
- foreach ($this->modelClassNameToBean as $modelClassName => $bean)
- {
- ZurmoRedBean::store($bean);
- assert('$bean->id > 0');
- }
- $this->modified = false;
- $this->afterSave();
- $calledModelClassName = get_called_class();
- if ($calledModelClassName::isCacheable())
- {
- RedBeanModelsCache::cacheModel($this);
- }
- $this->isSaving = false;
- return true;
- }
- }
- $this->isSaving = false;
- return false;
- }
- catch (Exception $e)
- {
- $this->isSaving = false;
- throw $e;
- }
- }
- /**
- * See Stories #82063952 and #82699138
- * @see isReallyModified
- * @param $relatedModel
- * @param $relationType integer
- * @param $isOwned boolean
- * @return bool
- */
- public function isRelatedModelReallyModified($relatedModel, $relationType, $isOwned)
- {
- assert('is_int($relationType)');
- assert('is_bool($isOwned)');
- if ($relatedModel instanceof RedBeanModel)
- {
- return $relatedModel->isReallyModified($relationType, $isOwned);
- }
- else
- {
- return $relatedModel->isModified();
- }
- }
- /**
- * See Stories #82063952 and #82699138
- * Overridden in OwnedSecurableItem. This means the fix is scoped down to just classes that extend
- * OwnedSecurableItem, but the bug with isModified only manifests when there are default values on related
- * models, which has only occurred on subClasses of OwnedSecurableItem.
- *
- * This fix is probably temporarily until the way isModified() and save() methods work in RedBeanModel
- * is refactored. This would be a large refactoring.
- * @param $relationType integer
- * @param $isOwned boolean
- * @return bool
- */
- public function isReallyModified($relationType, $isOwned)
- {
- assert('is_int($relationType)');
- assert('is_bool($isOwned)');
- return $this->isModified();
- }
- /**
- * This method is invoked before saving a record (after validation, if any).
- * The default implementation raises the {@link onBeforeSave} event.
- * You may override this method to do any preparation work for record saving.
- * Use {@link isNewModel} to determine whether the saving is
- * for inserting or updating record.
- * Make sure you call the parent implementation so that the event is raised properly.
- * @return boolean whether the saving should be executed. Defaults to true.
- */
- protected function beforeSave()
- {
- if ($this->hasEventHandler('onBeforeSave'))
- {
- $event = new CModelEvent($this);
- $this->onBeforeSave($event);
- return $event->isValid;
- }
- else
- {
- return true;
- }
- }
- protected function afterSave()
- {
- $event = new CEvent($this);
- $this->onAfterSave($event);
- }
- /**
- * This event is raised before the record is saved.
- * By setting {@link CModelEvent::isValid} to be false, the normal {@link save()} process will be stopped.
- * @param CModelEvent $event the event parameter
- * @since 1.0.2
- */
- public function onBeforeSave($event)
- {
- $this->raiseEvent('onBeforeSave', $event);
- }
- /**
- * This event is raised after the record is saved.
- * @param CEvent $event the event parameter
- * @since 1.0.2
- */
- public function onAfterSave($event)
- {
- $this->raiseEvent('onAfterSave', $event);
- }
- /**
- * This event is raised on a RedBeanOneToManyRelatedModels change
- * @param $event
- */
- public function onRedBeanOneToManyRelatedModelsChange($event)
- {
- $this->raiseEvent('onRedBeanOneToManyRelatedModelsChange', $event);
- }
- /**
- * This event is raised before the record is deleted.
- * By setting {@link CModelEvent::isValid} to be false, the normal {@link delete()} process will be stopped.
- * @param CModelEvent $event the event parameter
- * @since 1.0.2
- */
- public function onBeforeDelete($event)
- {
- $this->raiseEvent('onBeforeDelete', $event);
- }
- /**
- * This event is raised after the record is deleted.
- * @param CEvent $event the event parameter
- * @since 1.0.2
- */
- public function onAfterDelete($event)
- {
- $this->raiseEvent('onAfterDelete', $event);
- }
- protected function linkBeans()
- {
- $baseBean = null;
- foreach ($this->modelClassNameToBean as $modelClassName => $bean)
- {
- if ($baseBean !== null)
- {
- ZurmoRedBeanLinkManager::link($bean, $baseBean);
- }
- $baseBean = $bean;
- }
- }
- /**
- * Returns true if the model has been modified since it was saved
- * or constructed.
- */
- public function isModified()
- {
- if ($this->modified)
- {
- return true;
- }
- if ($this->isInIsModified) // Prevent cycles.
- {
- return false;
- }
- $this->isInIsModified = true;
- try
- {
- foreach ($this->relationNameToRelatedModel as $relationName => $relatedModel)
- {
- if ((!$this->$relationName instanceof RedBeanModel) ||
- !$this->$relationName->isSame($this))
- {
- $relationAndOwns = static::getRelationNameToRelationTypeModelClassNameAndOwnsForModel();
- if (!in_array($relationAndOwns[$relationName][0],
- array(self::HAS_ONE_BELONGS_TO,
- self::HAS_MANY_BELONGS_TO)))
- {
- if ($this->$relationName->isModified())
- {
- $this->isInIsModified = false;
- return true;
- }
- }
- }
- }
- $this->isInIsModified = false;
- return false;
- }
- catch (Exception $e)
- {
- $this->isInIsModified = false;
- throw $e;
- }
- }
- /**
- * Deletes the model from the database.
- */
- public function delete()
- {
- if ($this->id < 0)
- {
- // If the model was never saved
- // then it doesn't need to be deleted.
- return false;
- }
- $modelClassName = get_called_class();
- if (!$modelClassName::isTypeDeletable() ||
- !$this->isDeletable())
- {
- // See comments below on isDeletable.
- throw new NotSupportedException();
- }
- if ($this->beforeDelete())
- {
- $this->isDeleting = true;
- $deleted = $this->unrestrictedDelete();
- $this->isDeleting = false;
- $this->afterDelete();
- return $deleted;
- }
- else
- {
- return false;
- }
- }
- /**
- * This method is invoked before deleting a record.
- * The default implementation raises the {@link onBeforeDelete} event.
- * You may override this method to do any preparation work for record deletion.
- * Make sure you call the parent implementation so that the event is raised properly.
- * @return boolean whether the record should be deleted. Defaults to true.
- */
- protected function beforeDelete()
- {
- if ($this->hasEventHandler('onBeforeDelete'))
- {
- $event = new CModelEvent($this);
- $this->onBeforeDelete($event);
- return $event->isValid;
- }
- else
- {
- return true;
- }
- }
- /**
- * This method is invoked after deleting a record.
- * The default implementation raises the {@link onAfterDelete} event.
- * You may override this method to do postprocessing after the record is deleted.
- * Make sure you call the parent implementation so that the event is raised properly.
- */
- protected function afterDelete()
- {
- if ($this->hasEventHandler('onAfterDelete'))
- {
- $this->onAfterDelete(new CEvent($this));
- }
- }
- protected function unrestrictedDelete()
- {
- $this->forget();
- // RedBeanModel only supports cascaded deletes on associations,
- // not on links. So for now at least they are done the slow way.
- foreach (RuntimeUtil::getClassHierarchy(get_class($this), static::$lastClassInBeanHeirarchy) as $modelClassName)
- {
- if ($modelClassName::getCanHaveBean())
- {
- $this->deleteOwnedRelatedModels ($modelClassName);
- $this->deleteForeignRelatedModels($modelClassName);
- $this->deleteManyManyRelations ($modelClassName);
- }
- }
- foreach ($this->modelClassNameToBean as $modelClassName => $bean)
- {
- ZurmoRedBean::trash($bean);
- }
- // The model cannot be used anymore.
- $this->deleted = true;
- return true;
- }
- public function isDeleted()
- {
- return $this->deleted;
- }
- protected function deleteOwnedRelatedModels($modelClassName)
- {
- foreach (static::getRelationNameToRelationTypeModelClassNameAndOwnsForModel() as $relationName => $relationTypeModelClassNameAndOwns)
- {
- assert('count($relationTypeModelClassNameAndOwns) > 2 && count($relationTypeModelClassNameAndOwns) < 6');
- $relationType = $relationTypeModelClassNameAndOwns[0];
- $owns = $relationTypeModelClassNameAndOwns[2];
- if ($owns)
- {
- if ((!$this->$relationName instanceof RedBeanModel) ||
- !$this->$relationName->isSame($this))
- {
- assert('in_array($relationType, array(self::HAS_ONE, self::HAS_MANY))');
- if ($relationType == self::HAS_ONE)
- {
- if ($this->$relationName->id > 0)
- {
- // we can't change these to delete() because its Owned, it can't be deleted from outside
- $this->$relationName->unrestrictedDelete();
- }
- }
- else
- {
- foreach ($this->$relationName as $model)
- {
- // we can't change this to delete() because its Owned, it can't be deleted from outside
- $model->unrestrictedDelete();
- }
- }
- }
- }
- }
- }
- protected function deleteForeignRelatedModels($modelClassName)
- {
- $metadata = $this->getMetadata();
- if (isset($metadata[$modelClassName]['foreignRelations']))
- {
- foreach ($metadata[$modelClassName]['foreignRelations'] as $relatedModelClassName)
- {
- $relatedModels = $relatedModelClassName::
- getByRelatedClassId($relatedModelClassName,
- $this->getClassId($modelClassName),
- $modelClassName);
- foreach ($relatedModels as $relatedModel)
- {
- $relatedModel->unrestrictedDelete();
- }
- }
- }
- }
- protected static function getByRelatedClassId($relatedModelClassName, $id, $modelClassName = null)
- {
- assert('is_string($relatedModelClassName)');
- assert('$relatedModelClassName != ""');
- assert('is_int($id)');
- //assert('$id > 0');
- assert('$modelClassName === null || is_string($modelClassName) && $modelClassName != ""');
- if ($modelClassName === null)
- {
- $modelClassName = get_called_class();
- }
- $tableName = $relatedModelClassName::getTableName();
- $foreignKeyName = strtolower($modelClassName) . '_id';
- $beans = ZurmoRedBean::find($tableName, "$foreignKeyName = $id");
- return self::makeModels($beans, $relatedModelClassName);
- }
- protected function deleteManyManyRelations($modelClassName)
- {
- $metadata = $this->getMetadata();
- if (isset($metadata[$modelClassName]['relations']))
- {
- foreach ($metadata[$modelClassName]['relations'] as $relationName => $relationTypeModelClassNameAndOwns)
- {
- assert('in_array(count($relationTypeModelClassNameAndOwns), array(2, 3, 4, 5))');
- $relationType = $relationTypeModelClassNameAndOwns[0];
- if ($relationType == self::MANY_MANY)
- {
- $this->{$relationName}->removeAll();
- $this->{$relationName}->save();
- }
- }
- }
- }
- /**
- * To be overriden on intermediate derived classes
- * to return false so that deletes are not done on
- * intermediate classes because the object relational
- * mapping will not clean up properly.
- * For example if User is a Person, and Person is
- * a RedBeanModel delete should be called only on User,
- * not on Person. So User must override isDeletable
- * to return false.
- */
- public static function isTypeDeletable()
- {
- return true;
- }
- /**
- * To be overridden by derived classes to prevent
- * deletion.
- */
- public function isDeletable()
- {
- return true;
- }
- /**
- * Forgets about all of the objects so that when they are retrieved
- * again they will be recreated from the database. For use in testing.
- */
- public static function forgetAll()
- {
- self::forgetAllBeanModels();
- self::$attributeLabelsByLanguage = array();
- RedBeanModelsCache::forgetAll();
- RedBeansCache::forgetAll();
- }
- /**
- * Forgets about the object so that if it is retrieved
- * again it will be recreated from the database. For use in testing.
- */
- public function forget()
- {
- self::forgetBeanModel(get_called_class());
- RedBeanModelsCache::forgetModel($this);
- RedBeansCache::forgetBean(static::getTableName() . $this->id);
- }
- /**
- * See the yii documentation.
- */
- public function isAttributeRequired($attributeName)
- {
- assert("\$this->isAttribute('$attributeName')");
- foreach ($this->getValidators($attributeName) as $validator)
- {
- if ($validator instanceof CRequiredValidator)
- {
- return true;
- }
- }
- return false;
- }
- /**
- * See the yii documentation.
- */
- public function isAttributeSafe($attributeName)
- {
- $attributeNames = $this->getSafeAttributeNames();
- return in_array($attributeName, $attributeNames);
- }
- public static function getModelLabelByTypeAndLanguage($type, $language = null)
- {
- assert('in_array($type, array("Singular", "SingularLowerCase", "Plural", "PluralLowerCase"))');
- if ($type == 'Singular')
- {
- return static::getLabel($language);
- }
- if ($type == 'SingularLowerCase')
- {
- return TextUtil::strToLowerWithDefaultEncoding(static::getLabel($language));
- }
- if ($type == 'Plural')
- {
- return static::getPluralLabel($language);
- }
- if ($type == 'PluralLowerCase')
- {
- return TextUtil::strToLowerWithDefaultEncoding(static::getPluralLabel($language));
- }
- }
- /**
- * Returns the display name for the model class. Defaults to the module label. Override if the model
- * label is not the module label. Make sure to return a translated label. Also provides fall back in
- * moduleClassName is null.
- * @param null | string $language
- * @return dynamic label name based on module.
- */
- protected static function getLabel($language = null)
- {
- if (null != $moduleClassName = static::getModuleClassName())
- {
- return $moduleClassName::getModuleLabelByTypeAndLanguage('Singular', $language);
- }
- return get_called_class();
- }
- /**
- * Returns the display name for plural of the model class. Defaults to the module label. Override if the model
- * label is not the module label. Make sure to return a translated label
- * @param null | string $language
- * @return dynamic label name based on module.
- */
- protected static function getPluralLabel($language = null)
- {
- if (null != $moduleClassName = static::getModuleClassName())
- {
- return $moduleClassName::getModuleLabelByTypeAndLanguage('Plural', $language);
- }
- return static::getLabel($language) . 's';
- }
- /**
- * See the yii documentation.
- */
- public function getAttributeLabel($attributeName)
- {
- return static::getAnAttributeLabel($attributeName);
- }
- /**
- * Static implementation of @see getAttributeLabel
- */
- public static function getAnAttributeLabel($attributeName)
- {
- return static::getAttributeLabelByLanguage($attributeName, Yii::app()->language);
- }
- /**
- * Given an attributeName and a language, retrieve the translated attribute label. Attempts to find a customized
- * label in the metadata first, before falling back on the standard attribute label for the specified attribute.
- * @return string - translated attribute label
- */
- protected static function getAttributeLabelByLanguage($attributeName, $language)
- {
- assert('is_string($attributeName)');
- assert('is_string($language)');
- if (isset(static::$attributeLabelsByLanguage[$language][get_called_class()][$attributeName]))
- {
- return static::$attributeLabelsByLanguage[$language][get_called_class()][$attributeName];
- }
- $labels = static::translatedAttributeLabels($language);
- $customLabel = static::getTranslatedCustomAttributeLabelByLanguage($attributeName, $language);
- if ($customLabel != null)
- {
- $label = $customLabel;
- }
- elseif (isset($labels[$attributeName]))
- {
- $label = $labels[$attributeName];
- }
- else
- {
- //This is a last resort if the translated attribute was not located. Make sure to define all
- //attributes in translatedAttributeLabels($language)
- $label = Zurmo::t('Core', static::generateAnAttributeLabel($attributeName), array(), null, $language);
- }
- static::$attributeLabelsByLanguage[$language][get_called_class()][$attributeName] = $label;
- return $label;
- }
- /**
- * Given an attributeName, attempt to find in the metadata a custom attribute label for the given language.
- * @return string - translated attribute label, if not found return null.
- */
- protected static function getTranslatedCustomAttributeLabelByLanguage($attributeName, $languageCode)
- {
- assert('is_string($attributeName)');
- assert('is_string($languageCode)');
- $metadata = static::getMetadata();
- foreach ($metadata as $notUsed => $modelClassMetadata)
- {
- if (isset($modelClassMetadata['labels']) &&
- isset($modelClassMetadata['labels'][$attributeName]) &&
- isset($modelClassMetadata['labels'][$attributeName][$languageCode]))
- {
- return $modelClassMetadata['labels'][$attributeName][$languageCode];
- }
- }
- return null;
- }
- /**
- * Given an attributeName, return an array of all attribute labels for each active language.
- * @return array - attribute labels by language for the given attributeName.
- */
- public function getAttributeLabelsForAllActiveLanguagesByAttributeName($attributeName)
- {
- assert('is_string($attributeName)');
- $attirbuteLabelData = array();
- foreach (Yii::app()->languageHelper->getActiveLanguagesData() as $languageCode => $languageData)
- {
- $attirbuteLabelData[$languageCode] = $this->getAttributeLabelByLanguage($attributeName, $languageCode);
- }
- return $attirbuteLabelData;
- }
- /**
- * See the yii documentation. The yii hasErrors() takes an optional
- * attribute name. RedBeanModel's hasErrors() takes an optional attribute
- * name or array of attribute names. See getErrors() for an explanation
- * of this difference.
- */
- public function hasErrors($attributeNameOrNames = null)
- {
- assert('$attributeNameOrNames === null || ' .
- 'is_string($attributeNameOrNames) || ' .
- 'is_array ($attributeNameOrNames) && AssertUtil::all($attributeNameOrNames, "is_string")');
- if ($this->isInHasErrors) // Prevent cycles.
- {
- return false;
- }
- $this->isInHasErrors = true;
- try
- {
- if (is_string($attributeNameOrNames))
- {
- $attributeName = $attributeNameOrNames;
- $relatedAttributeNames = null;
- }
- elseif (is_array($attributeNameOrNames))
- {
- $attributeName = $attributeNameOrNames[0];
- if (count($attributeNameOrNames) > 1)
- {
- $relatedAttributeNames = array_slice($attributeNameOrNames, 1);
- }
- else
- {
- $relatedAttributeNames = null;
- }
- }
- else
- {
- $attributeName = null;
- $relatedAttributeNames = null;
- }
- assert("\$attributeName === null || is_string('$attributeName')");
- assert('$relatedAttributeNames === null || is_array($relatedAttributeNames)');
- assert('!($attributeName === null && $relatedAttributeNames !== null)');
- if ($attributeName === null)
- {
- if (count($this->attributeNameToErrors) > 0)
- {
- $this->isInHasErrors = false;
- return true;
- }
- foreach ($this->relationNameToRelatedModel as $relationName => $relatedModelOrModels)
- {
- if ((!$this->$relationName instanceof RedBeanModel) ||
- !$this->$relationName->isSame($this))
- {
- if (in_array($relationName, static::getAttributeNamesNotBelongsToOrManyManyForModel()))
- {
- if ($relatedModelOrModels->hasErrors($relatedAttributeNames))
- {
- $this->isInHasErrors = false;
- return true;
- }
- }
- }
- }
- $this->isInHasErrors = false;
- return false;
- }
- else
- {
- if (!static::isRelation($attributeName))
- {
- $this->isInHasErrors = false;
- return array_key_exists($attributeName, $this->attributeNameToErrors);
- }
- else
- {
- if (in_array($attributeName, static::getAttributeNamesNotBelongsToOrManyManyForModel()))
- {
- $this->isInHasErrors = false;
- return isset($this->relationNameToRelatedModel[$attributeName]) &&
- count($this->relationNameToRelatedModel[$attributeName]->getErrors($relatedAttributeNames)) > 0;
- }
- }
- }
- $this->isInHasErrors = false;
- return false;
- }
- catch (Exception $e)
- {
- $this->isInHasErrors = false;
- throw $e;
- }
- }
- /**
- * See the yii documentation. The yii getErrors() takes an optional
- * attribute name. RedBeanModel's getErrors() takes an optional attribute
- * name or array of attribute names.
- * @param @attributeNameOrNames Either null, return all errors on the
- * model and its related models, an attribute name on the model, return
- * errors on that attribute, or an array of relation and attribute names,
- * return errors on a related model's attribute.
- */
- public function getErrors($attributeNameOrNames = null)
- {
- assert('$attributeNameOrNames === null || ' .
- 'is_string($attributeNameOrNames) || ' .
- 'is_array ($attributeNameOrNames) && AssertUtil::all($attributeNameOrNames, "is_string")');
- if ($this->isInGetErrors) // Prevent cycles.
- {
- return array();
- }
- $this->isInGetErrors = true;
- try
- {
- if (is_string($attributeNameOrNames))
- {
- $attributeName = $attributeNameOrNames;
- $relatedAttributeNames = null;
- }
- elseif (is_array($attributeNameOrNames))
- {
- $attributeName = $attributeNameOrNames[0];
- if (count($attributeNameOrNames) > 1)
- {
- $relatedAttributeNames = array_slice($attributeNameOrNames, 1);
- }
- else
- {
- $relatedAttributeNames = null;
- }
- }
- else
- {
- $attributeName = null;
- $relatedAttributeNames = null;
- }
- assert("\$attributeName === null || is_string('$attributeName')");
- assert('$relatedAttributeNames === null || is_array($relatedAttributeNames)');
- assert('!($attributeName === null && $relatedAttributeNames !== null)');
- if ($attributeName === null)
- {
- $errors = $this->attributeNameToErrors;
- foreach ($this->relationNameToRelatedModel as $relationName => $relatedModelOrModels)
- {
- if ((!$this->$relationName instanceof RedBeanModel) ||
- !$this->$relationName->isSame($this))
- {
- $relationAndOwns = static::getRelationNameToRelationTypeModelClassNameAndOwnsForModel();
- if (!in_array($relationAndOwns[$relationName][0],
- array(self::HAS_ONE_BELONGS_TO,
- self::HAS_MANY_BELONGS_TO,
- self::MANY_MANY)))
- {
- $relatedErrors = $relatedModelOrModels->getErrors($relatedAttributeNames);
- if (count($relatedErrors) > 0)
- {
- $errors[$relationName] = $relatedErrors;
- }
- }
- }
- }
- $this->isInGetErrors = false;
- return $errors;
- }
- else
- {
- if (isset($this->attributeNameToErrors[$attributeName]))
- {
- $this->isInGetErrors = false;
- return $this->attributeNameToErrors[$attributeName];
- }
- elseif (isset($this->relationNameToRelatedModel[$attributeName]))
- {
- $relationAndOwns = static::getRelationNameToRelationTypeModelClassNameAndOwnsForModel();
- if (!in_array($relationAndOwns[$attributeName][0],
- array(self::HAS_ONE_BELONGS_TO, self::HAS_MANY_BELONGS_TO)))
- {
- $this->isInGetErrors = false;
- return $this->relationNameToRelatedModel[$attributeName]->getErrors($relatedAttributeNames);
- }
- }
- }
- $this->isInGetErrors = false;
- return array();
- }
- catch (Exception $e)
- {
- $this->isInGetErrors = false;
- throw $e;
- }
- }
- /**
- * See the yii documentation.
- */
- public function getError($attributeName)
- {
- assert("\$this->isAttribute('$attributeName')");
- return isset($this->attributeNameToErrors[$attributeName]) ? reset($this->attributeNameToErrors[$attributeName]) : null;
- }
- /**
- * See the yii documentation.
- */
- public function addError($attributeName, $errorMessage)
- {
- assert("\$this->isAttribute('$attributeName')");
- if (!isset($this->attributeNameToErrors[$attributeName]))
- {
- $this->attributeNameToErrors[$attributeName] = array();
- }
- $this->attributeNameToErrors[$attributeName][] = $errorMessage;
- }
- /**
- * See the yii documentation.
- */
- public function addErrors(array $errors)
- {
- foreach ($errors as $attributeName => $error)
- {
- assert("\$this->isAttribute('$attributeName')");
- assert('is_array($error) || is_string($error)');
- if (is_array($error))
- {
- if (!isset($this->attributeNameToErrors[$attributeName]))
- {
- $this->attributeNameToErrors[$attributeName] = array();
- }
- $this->attributeNameToErrors[$attributeName] =
- array_merge($this->attributeNameToErrors[$attributeName], $error);
- }
- else
- {
- $this->attributeNameToErrors[$attributeName][] = $error;
- }
- }
- }
- /**
- * See the yii documentation.
- */
- public function clearErrors($attributeName = null)
- {
- assert("\$attributeName === null || \$this->isAttribute('$attributeName')");
- if ($attributeName === null)
- {
- $this->attributeNameToErrors = array();
- }
- else
- {
- unset($this->attributeNameToErrors[$attributeName]);
- }
- }
- /**
- * See the yii documentation.
- */
- public function generateAttributeLabel($attributeName)
- {
- $modelClassName = get_called_class();
- return $modelClassName::generateAnAttributeLabel($attributeName);
- }
- /**
- * See the yii documentation.
- */
- public function getAttributes(array $attributeNames = null)
- {
- $values = array();
- if (is_array($attributeNames))
- {
- $values2 = array();
- $allModelAttributeNames = $this->attributeNames();
- foreach ($attributeNames as $attributeName)
- {
- if (in_array($attributeName, $allModelAttributeNames))
- {
- $values2[$attributeName] = $this->$attributeName;
- }
- }
- return $values2;
- }
- else
- {
- foreach ($this->attributeNames() as $attributeName)
- {
- $values[$attributeName] = $this->$attributeName;
- }
- return $values;
- }
- }
- /**
- * See the yii documentation.
- */
- public function setAttributes(array $values, $safeOnly = true)
- {
- assert('is_bool($safeOnly)');
- $attributeNames = array_flip($safeOnly ? $this->getSafeAttributeNames() : $this->attributeNames());
- foreach ($values as $attributeName => $value)
- {
- if ($value !== null)
- {
- if (!is_array($value))
- {
- assert('$attributeName != "id"');
- if ($attributeName != 'id' && $this->isAttribute($attributeName))
- {
- if ($this->isAttributeSafe($attributeName) || !$safeOnly)
- {
- $this->$attributeName = $value;
- }
- else
- {
- $this->onUnsafeAttribute($attributeName, $value);
- }
- }
- }
- else
- {
- if (static::isRelation($attributeName))
- {
- if (count($value) == 1 && array_key_exists('id', $value))
- {
- if (empty($value['id']))
- {
- $this->$attributeName = null;
- }
- else
- {
- $relationAndOwns = static::getRelationNameToRelationTypeModelClassNameAndOwnsForModel();
- $relatedModelClassName = $relationAndOwns[$attributeName][1];
- $this->$attributeName = $relatedModelClassName::getById(intval($value['id']), $relatedModelClassName);
- }
- }
- else
- {
- $setAttributeMethodName = 'set' . ucfirst($attributeName);
- if ($this->$attributeName instanceof RedBeanOneToManyRelatedModels &&
- method_exists($this, $setAttributeMethodName))
- {
- $this->$setAttributeMethodName($value);
- }
- else
- {
- $this->$attributeName->setAttributes($value);
- }
- }
- }
- }
- }
- }
- }
- /**
- * See the yii documentation.
- */
- public function unsetAttributes($attributeNames = null)
- {
- if ($attributeNames === null)
- {
- $attributeNames = $this->attributeNames();
- }
- foreach ($attributeNames as $attributeName)
- {
- $this->$attributeNames = null;
- }
- }
- /**
- * See the yii documentation.
- */
- public function onUnsafeAttribute($name, $value)
- {
- if (YII_DEBUG)
- {
- Yii::log(Zurmo::t('Core', 'Failed to set unsafe attribute "{attribute}".', array('{attribute}' => $name)),
- CLogger::LEVEL_WARNING);
- }
- }
- /**
- * See the yii documentation.
- */
- public function getScenario()
- {
- return $this->scenarioName;
- }
- /**
- * See the yii documentation.
- */
- public function setScenario($scenarioName)
- {
- assert('is_string($scenarioName)');
- $this->scenarioName = $scenarioName;
- }
- /**
- * See the yii documentation.
- */
- public function getSafeAttributeNames()
- {
- $attributeNamesToIsSafe = array();
- $unsafeAttributeNames = array();
- foreach ($this->getValidators() as $validator)
- {
- if (!$validator->safe)
- {
- foreach ($validator->attributes as $attributeName)
- {
- $unsafeAttributeNames[] = $attributeName;
- }
- }
- else
- {
- foreach ($validator->attributes as $attributeName)
- {
- $attributeNamesToIsSafe[$attributeName] = true;
- }
- }
- }
- foreach ($unsafeAttributeNames as $attributeName)
- {
- unset($attributeNamesToIsSafe[$attributeName]);
- }
- return array_keys($attributeNamesToIsSafe);
- }
- /**
- * See the yii documentation.
- */
- public function getIterator()
- {
- throw new NotImplementedException();
- }
- /**
- * See the yii documentation.
- */
- public function offsetExists($offset)
- {
- throw new NotImplementedException();
- }
- /**
- * See the yii documentation.
- */
- public function offsetGet($offset)
- {
- throw new NotImplementedException();
- }
- /**
- * See the yii documentation.
- */
- public function offsetSet($offset, $item)
- {
- throw new NotImplementedException();
- }
- /**
- * See the yii documentation.
- */
- public function offsetUnset($offset)
- {
- throw new NotImplementedException();
- }
- /**
- * Creates an instance of the extending model wrapping the given
- * bean. For use only by models. Beans are never used by the
- * application directly.
- * @param $bean A <a href="http://www.redbeanphp.com/">RedBean</a>
- * bean.
- * @param $modelClassName Pass only when getting it at runtime
- * gets the wrong name.
- * @return An instance of the type of the extending model.
- */
- public static function makeModel(RedBean_OODBBean $bean, $modelClassName = null)
- {
- assert('$modelClassName === null || is_string($modelClassName) && $modelClassName != ""');
- if ($modelClassName === null)
- {
- $modelClassName = get_called_class();
- }
- $modelIdentifier = static::getModelIdentifierByClassNameAndBeanId($modelClassName, strval($bean->id));
- try
- {
- $model = RedBeanModelsCache::getModel($modelIdentifier);
- $model->constructIncomplete($bean, false);
- return $model;
- }
- catch (NotFoundException $e)
- {
- return new $modelClassName(false, $bean);
- //return new $modelClassName(true, $bean, $forceTreatAsCreation); //no need to set defaults here and force creation since it is always false and the bean already exists
- }
- }
- /**
- * Creates an array of instances of the named model type wrapping the
- * given beans. For use only by models. Beans are never used by the
- * application directly.
- * @param $beans An array of <a href="http://www.redbeanphp.com/">RedBean</a>
- * beans.
- * @param $modelClassName Pass only when getting it at runtime
- * gets the wrong name.
- * @return An array of instances of the type of the extending model.
- */
- public static function makeModels(array $beans, $modelClassName = null)
- {
- if ($modelClassName === null)
- {
- $modelClassName = get_called_class();
- }
- $models = array();
- foreach ($beans as $bean)
- {
- assert('$bean instanceof RedBean_OODBBean');
- try
- {
- $models[] = self::makeModel($bean, $modelClassName);
- }
- catch (MissingBeanException $e)
- {
- }
- }
- return $models;
- }
- public static function getModuleClassName()
- {
- return null;
- }
- /**
- * Given an array of data, create stringified content.
- * @param array $values
- */
- public function stringifyOneToManyRelatedModelsValues($values)
- {
- assert('is_array($values)');
- return ArrayUtil::stringify($values);
- }
- /**
- * Resolve and get model class name used for table retrieval factoring in when a class does
- * not have a bean and must use a parent class
- * @param string $modelClassName
- */
- protected static function resolveModelClassNameForClassesWithoutBeans(& $modelClassName)
- {
- assert('is_string($modelClassName)');
- if (!$modelClassName::getCanHaveBean())
- {
- $modelClassName = get_parent_class($modelClassName);
- if (!$modelClassName::getCanHaveBean())
- {
- //For the moment, only support a single class in a chain of classes not having a bean.
- //Expand this support as needed.
- throw new NotSupportedException();
- }
- }
- return $modelClassName;
- }
- public static function getLastClassInBeanHeirarchy()
- {
- return static::$lastClassInBeanHeirarchy;
- }
- /**
- * Returns a list of attributes to be added when sorting by the attribute
- * @param string $attribute
- * @return array
- */
- public static function getSortAttributesByAttribute($attribute)
- {
- return array($attribute);
- }
- /**
- * Utilized by copy mechanism, helps elements, views, understand the model better before the new model is saved.
- */
- public function setIsCopied()
- {
- $this->isCopied = true;
- }
- /**
- * @return bool
- */
- public function isCopied()
- {
- return $this->isCopied;
- }
- /**
- * @return bool
- */
- public static function isCacheable()
- {
- return true;
- }
- public static function getYiiValidatorsToRedBeanValidators()
- {
- return static::$yiiValidatorsToRedBeanValidators;
- }
- /**
- * Wrapper for CValidator::createValidator
- * @param $attribute
- * @param $validator
- * @param array $params
- */
- public function addValidator($attribute, $validator, $params = array())
- {
- if ($attribute != null && $validator != null)
- {
- $this->validators[] = CValidator::createValidator($validator, $this, $attribute, $params);
- }
- }
- public static function getHasManyOpposingRelationName(RedBeanModel $model, $precedingModelClassName, $precedingRelation)
- {
- assert('is_string($precedingModelClassName)');
- assert('is_string($precedingRelation)');
- foreach ($model->attributeNames() as $attributeName)
- {
- if ($model->isRelation($attributeName) &&
- ($model->getRelationType($attributeName) == RedBeanModel::HAS_ONE ||
- $model->getRelationType($attributeName) == RedBeanModel::HAS_MANY_BELONGS_TO) &&
- static::relationLinksToPrecedingRelation(get_class($model), $attributeName,
- $precedingModelClassName, $precedingRelation))
- {
- return $attributeName;
- }
- }
- }
- /**
- * @param string $modelClassName
- * @param string $relation
- * @param null|string $precedingModelClassName
- * @param null|string $precedingRelation
- * @return bool
- */
- public static function relationLinksToPrecedingRelation($modelClassName, $relation,
- $precedingModelClassName = null,
- $precedingRelation = null)
- {
- assert('is_string($modelClassName)');
- assert('is_string($relation)');
- assert('is_string($precedingModelClassName) || $precedingModelClassName == null');
- assert('is_string($precedingRelation) || $precedingRelation == null');
- if ($precedingModelClassName == null || $precedingRelation == null)
- {
- return false;
- }
- //Check if the relation is a derived relation in which case return false because it is handled by
- //@see self::inferredRelationLinksToPrecedingRelation
- if (!$precedingModelClassName::isAnAttribute($precedingRelation))
- {
- return false;
- }
- if ($precedingModelClassName != $modelClassName::getRelationModelClassName($relation))
- {
- return false;
- }
- if ( $precedingModelClassName::getRelationLinkType($precedingRelation) == RedBeanModel::LINK_TYPE_ASSUMPTIVE &&
- $modelClassName::getRelationLinkType($relation) == RedBeanModel::LINK_TYPE_ASSUMPTIVE)
- {
- return true;
- }
- //Check for LINK_TYPE_SPECIFIC
- if ( $precedingModelClassName::getRelationLinkType($precedingRelation) == RedBeanModel::LINK_TYPE_SPECIFIC &&
- $modelClassName::getRelationLinkType($relation) == RedBeanModel::LINK_TYPE_SPECIFIC &&
- $precedingModelClassName::getRelationLinkName($precedingRelation) == $modelClassName::getRelationLinkName($relation))
- {
- return true;
- }
- return false;
- }
- /**
- * Whether or not this model instances should be cached in memcache
- * @return bool
- */
- public static function allowMemcacheCache()
- {
- return true;
- }
- }
- ?>