. */ /** * Doctrine_Configurable * the base for Doctrine_Table, Doctrine_Manager and Doctrine_Connection * * * @package Doctrine * @license http://www.opensource.org/licenses/lgpl-license.php LGPL * @category Object Relational Mapping * @link www.phpdoctrine.com * @since 1.0 * @version $Revision$ * @author Konsta Vesterinen */ abstract class Doctrine_Configurable { /** * @var array $attributes an array of containing all attributes */ protected $attributes = array(); /** * @var $parent the parents of this component */ protected $parent; /** * setAttribute * sets a given attribute * * * $manager->setAttribute(Doctrine::ATTR_PORTABILITY, Doctrine::PORTABILITY_ALL); * * // or * * $manager->setAttribute('portability', Doctrine::PORTABILITY_ALL); * * * @param mixed $attribute either a Doctrine::ATTR_* integer constant or a string * corresponding to a constant * @param mixed $value the value of the attribute * @see Doctrine::ATTR_* constants * @throws Doctrine_Exception if the value is invalid * @return void */ public function setAttribute($attribute,$value) { switch ($attribute) { case Doctrine::ATTR_FETCHMODE: if ($value < 0) { throw new Doctrine_Exception("Unknown fetchmode. See Doctrine::FETCH_* constants."); } break; case Doctrine::ATTR_LISTENER: $this->setEventListener($value); break; case Doctrine::ATTR_LOCKMODE: if ($this instanceof Doctrine_Connection) { if ($this->transaction->getState() != Doctrine_Transaction::STATE_SLEEP) { throw new Doctrine_Exception("Couldn't set lockmode. There are transactions open."); } } elseif ($this instanceof Doctrine_Manager) { foreach ($this as $connection) { if ($connection->transaction->getState() != Doctrine_Transaction::STATE_SLEEP) { throw new Doctrine_Exception("Couldn't set lockmode. There are transactions open."); } } } else { throw new Doctrine_Exception("Lockmode attribute can only be set at the global or connection level."); } break; case Doctrine::ATTR_CREATE_TABLES: $attribute = Doctrine::ATTR_EXPORT; if ($value) { $value = Doctrine::EXPORT_TABLES; } else { $value = Doctrine::EXPORT_NONE; } break; case Doctrine::ATTR_ACCESSORS: throw new Doctrine_Exception("Get / Set filtering is deprecated (slowed down Doctrine too much)."); break; case Doctrine::ATTR_COLL_LIMIT: if ($value < 1) { throw new Doctrine_Exception("Collection limit should be a value greater than or equal to 1."); } break; case Doctrine::ATTR_COLL_KEY: if ( ! ($this instanceof Doctrine_Table)) { throw new Doctrine_Exception("This attribute can only be set at table level."); } if ($value !== null && ! $this->hasColumn($value)) { throw new Doctrine_Exception("Couldn't set collection key attribute. No such column '$value'"); } break; case Doctrine::ATTR_DQL_CACHE: case Doctrine::ATTR_DQL_PARSER_CACHE: case Doctrine::ATTR_SQL_CACHE: if ($value !== null) { if ( ! ($value instanceof Doctrine_Cache_Interface)) { throw new Doctrine_Exception('Cache driver should implement Doctrine_Cache_Interface'); } } break; case Doctrine::ATTR_VLD: case Doctrine::ATTR_AUTO_LENGTH_VLD: case Doctrine::ATTR_AUTO_TYPE_VLD: case Doctrine::ATTR_QUERY_LIMIT: case Doctrine::ATTR_QUOTE_IDENTIFIER: case Doctrine::ATTR_PORTABILITY: case Doctrine::ATTR_DEFAULT_TABLE_TYPE: case Doctrine::ATTR_ACCESSOR_PREFIX_GET: case Doctrine::ATTR_ACCESSOR_PREFIX_SET: case Doctrine::ATTR_EMULATE_DATABASE: case Doctrine::ATTR_DEFAULT_SEQUENCE: case Doctrine::ATTR_EXPORT: case Doctrine::ATTR_DECIMAL_PLACES: case Doctrine::ATTR_LOAD_REFERENCES: break; case Doctrine::ATTR_SEQCOL_NAME: if ( ! is_string($value)) { throw new Doctrine_Exception('Sequence column name attribute only accepts string values'); } break; case Doctrine::ATTR_FIELD_CASE: if ($value != 0 && $value != CASE_LOWER && $value != CASE_UPPER) throw new Doctrine_Exception('Field case attribute should be either 0, CASE_LOWER or CASE_UPPER constant.'); break; case Doctrine::ATTR_SEQNAME_FORMAT: case Doctrine::ATTR_IDXNAME_FORMAT: if ($this instanceof Doctrine_Table) { throw new Doctrine_Exception('Sequence / index name format attributes cannot be set' . 'at table level (only at connection or global level).'); } break; default: throw new Doctrine_Exception("Unknown attribute."); }; $this->attributes[$attribute] = $value; } /** * @param Doctrine_EventListener $listener * @return void */ public function setEventListener($listener) { return $this->setListener($listener); } /** * addListener * * @param Doctrine_EventListener_Interface|Doctrine_Overloadable $listener * @return Doctrine_Connection_Informix|Doctrine_Connection_Mssql|Doctrine_Connection_Oracle| * Doctrine_Connection_Db2|Doctrine_Connection_Firebird|Doctrine_Connection_Common| * Doctrine_Manager|Doctrine_Connection|Doctrine_Table */ public function addListener($listener, $name = null) { if ( ! isset($this->attributes[Doctrine::ATTR_LISTENER]) || ! ($this->attributes[Doctrine::ATTR_LISTENER] instanceof Doctrine_EventListener_Chain)) { $this->attributes[Doctrine::ATTR_LISTENER] = new Doctrine_EventListener_Chain(); } $this->attributes[Doctrine::ATTR_LISTENER]->add($listener, $name); return $this; } /** * getListener * * @return Doctrine_EventListener_Interface|Doctrine_Overloadable */ public function getListener() { if ( ! isset($this->attributes[Doctrine::ATTR_LISTENER])) { if (isset($this->parent)) { return $this->parent->getListener(); } return null; } return $this->attributes[Doctrine::ATTR_LISTENER]; } /** * setListener * * @param Doctrine_EventListener_Interface|Doctrine_Overloadable $listener * @return Doctrine_Connection_Informix|Doctrine_Connection_Mssql|Doctrine_Connection_Oracle| * Doctrine_Connection_Db2|Doctrine_Connection_Firebird|Doctrine_Connection_Common| * Doctrine_Manager|Doctrine_Connection|Doctrine_Table */ public function setListener($listener) { if ( ! ($listener instanceof Doctrine_EventListener_Interface) && ! ($listener instanceof Doctrine_Overloadable) ) { throw new Doctrine_EventListener_Exception("Couldn't set eventlistener. EventListeners should implement either Doctrine_EventListener_Interface or Doctrine_Overloadable"); } $this->attributes[Doctrine::ATTR_LISTENER] = $listener; return $this; } /** * returns the value of an attribute * * @param integer $attribute * @return mixed */ public function getAttribute($attribute) { $attribute = (int) $attribute; if ($attribute < 0) { throw new Doctrine_Exception('Unknown attribute.'); } if ( ! isset($this->attributes[$attribute])) { if (isset($this->parent)) { return $this->parent->getAttribute($attribute); } return null; } return $this->attributes[$attribute]; } /** * getAttributes * returns all attributes as an array * * @return array */ public function getAttributes() { return $this->attributes; } /** * sets a parent for this configurable component * the parent must be configurable component itself * * @param Doctrine_Configurable $component * @return void */ public function setParent(Doctrine_Configurable $component) { $this->parent = $component; } /** * getParent * returns the parent of this component * * @return Doctrine_Configurable */ public function getParent() { return $this->parent; } }