From 001466f8fd1074ecfb6dfdcfb94872effc3fc9e9 Mon Sep 17 00:00:00 2001 From: Jonas L Date: Tue, 30 May 2023 22:25:50 +0200 Subject: [PATCH] feat(legacy): move session store to database (#2523) --- .../migrations/0045_add_sessions_table.py | 34 + .../legacy/migrations/__init__.py | 2 +- .../legacy/migrations/sql/schema.sql | 15 + legacy/application/Bootstrap.php | 24 +- .../configs/classmap-airtime-conf.php | 7 + legacy/application/models/Auth.php | 4 +- .../application/models/airtime/Sessions.php | 12 + .../models/airtime/SessionsPeer.php | 12 + .../models/airtime/SessionsQuery.php | 12 + .../models/airtime/map/SessionsTableMap.php | 55 ++ .../models/airtime/om/BaseSessions.php | 926 ++++++++++++++++++ .../models/airtime/om/BaseSessionsPeer.php | 766 +++++++++++++++ .../models/airtime/om/BaseSessionsQuery.php | 388 ++++++++ legacy/build/schema.xml | 7 + 14 files changed, 2259 insertions(+), 5 deletions(-) create mode 100644 api/libretime_api/legacy/migrations/0045_add_sessions_table.py create mode 100644 legacy/application/models/airtime/Sessions.php create mode 100644 legacy/application/models/airtime/SessionsPeer.php create mode 100644 legacy/application/models/airtime/SessionsQuery.php create mode 100644 legacy/application/models/airtime/map/SessionsTableMap.php create mode 100644 legacy/application/models/airtime/om/BaseSessions.php create mode 100644 legacy/application/models/airtime/om/BaseSessionsPeer.php create mode 100644 legacy/application/models/airtime/om/BaseSessionsQuery.php diff --git a/api/libretime_api/legacy/migrations/0045_add_sessions_table.py b/api/libretime_api/legacy/migrations/0045_add_sessions_table.py new file mode 100644 index 000000000..229a75692 --- /dev/null +++ b/api/libretime_api/legacy/migrations/0045_add_sessions_table.py @@ -0,0 +1,34 @@ +# pylint: disable=invalid-name + +from django.db import migrations + +from ._migrations import legacy_migration_factory + +UP = """ +CREATE TABLE "sessions" +( + "id" CHAR(32) NOT NULL, + "modified" INTEGER, + "lifetime" INTEGER, + "data" TEXT, + PRIMARY KEY ("id") +); +""" + +DOWN = """ +DROP TABLE IF EXISTS "sessions" CASCADE; +""" + + +class Migration(migrations.Migration): + dependencies = [ + ("legacy", "0044_add_track_types_analyzer_options"), + ] + operations = [ + migrations.RunPython( + code=legacy_migration_factory( + target="45", + sql=UP, + ) + ) + ] diff --git a/api/libretime_api/legacy/migrations/__init__.py b/api/libretime_api/legacy/migrations/__init__.py index 6a250adf5..9082ae2e3 100644 --- a/api/libretime_api/legacy/migrations/__init__.py +++ b/api/libretime_api/legacy/migrations/__init__.py @@ -1,2 +1,2 @@ # The schema version is defined using the migration file prefix number -LEGACY_SCHEMA_VERSION = "44" +LEGACY_SCHEMA_VERSION = "45" diff --git a/api/libretime_api/legacy/migrations/sql/schema.sql b/api/libretime_api/legacy/migrations/sql/schema.sql index a07a6ceed..ca90da4b7 100644 --- a/api/libretime_api/legacy/migrations/sql/schema.sql +++ b/api/libretime_api/legacy/migrations/sql/schema.sql @@ -686,6 +686,21 @@ CREATE TABLE "podcast_episodes" PRIMARY KEY ("id") ); +----------------------------------------------------------------------- +-- sessions +----------------------------------------------------------------------- + +DROP TABLE IF EXISTS "sessions" CASCADE; + +CREATE TABLE "sessions" +( + "id" CHAR(32) NOT NULL, + "modified" INTEGER, + "lifetime" INTEGER, + "data" TEXT, + PRIMARY KEY ("id") +); + ALTER TABLE "cc_files" ADD CONSTRAINT "cc_files_owner_fkey" FOREIGN KEY ("owner_id") REFERENCES "cc_subjs" ("id"); diff --git a/legacy/application/Bootstrap.php b/legacy/application/Bootstrap.php index a9882feca..8f002666c 100644 --- a/legacy/application/Bootstrap.php +++ b/legacy/application/Bootstrap.php @@ -14,7 +14,29 @@ if (!isset($configRun) || !$configRun) { Logging::setLogPath(LIBRETIME_LOG_FILEPATH); -Zend_Session::setOptions(['strict' => true]); +if (APPLICATION_ENV != 'testing') { + Zend_Session::setOptions([ + 'strict' => true, + 'serialize_handler' => 'php_serialize', + ]); + + $db = Zend_Db::factory('PDO_' . $CC_CONFIG['dsn']['phptype'], [ + 'host' => $CC_CONFIG['dsn']['host'], + 'port' => $CC_CONFIG['dsn']['port'], + 'username' => $CC_CONFIG['dsn']['username'], + 'password' => $CC_CONFIG['dsn']['password'], + 'dbname' => $CC_CONFIG['dsn']['database'], + ]); + Zend_Db_Table_Abstract::setDefaultAdapter($db); + Zend_Session::setSaveHandler(new Zend_Session_SaveHandler_DbTable([ + 'name' => 'sessions', + 'primary' => 'id', + 'modifiedColumn' => 'modified', + 'dataColumn' => 'data', + 'lifetimeColumn' => 'lifetime', + ])); +} + Config::setAirtimeVersion(); require_once CONFIG_PATH . '/navigation.php'; diff --git a/legacy/application/configs/classmap-airtime-conf.php b/legacy/application/configs/classmap-airtime-conf.php index fb0013c29..6be12b522 100644 --- a/legacy/application/configs/classmap-airtime-conf.php +++ b/legacy/application/configs/classmap-airtime-conf.php @@ -98,6 +98,9 @@ return [ 'BasePodcastEpisodesQuery' => 'airtime/om/BasePodcastEpisodesQuery.php', 'BasePodcastPeer' => 'airtime/om/BasePodcastPeer.php', 'BasePodcastQuery' => 'airtime/om/BasePodcastQuery.php', + 'BaseSessions' => 'airtime/om/BaseSessions.php', + 'BaseSessionsPeer' => 'airtime/om/BaseSessionsPeer.php', + 'BaseSessionsQuery' => 'airtime/om/BaseSessionsQuery.php', 'BaseStationPodcast' => 'airtime/om/BaseStationPodcast.php', 'BaseStationPodcastPeer' => 'airtime/om/BaseStationPodcastPeer.php', 'BaseStationPodcastQuery' => 'airtime/om/BaseStationPodcastQuery.php', @@ -232,6 +235,10 @@ return [ 'PodcastPeer' => 'airtime/PodcastPeer.php', 'PodcastQuery' => 'airtime/PodcastQuery.php', 'PodcastTableMap' => 'airtime/map/PodcastTableMap.php', + 'Sessions' => 'airtime/Sessions.php', + 'SessionsPeer' => 'airtime/SessionsPeer.php', + 'SessionsQuery' => 'airtime/SessionsQuery.php', + 'SessionsTableMap' => 'airtime/map/SessionsTableMap.php', 'StationPodcast' => 'airtime/StationPodcast.php', 'StationPodcastPeer' => 'airtime/StationPodcastPeer.php', 'StationPodcastQuery' => 'airtime/StationPodcastQuery.php', diff --git a/legacy/application/models/Auth.php b/legacy/application/models/Auth.php index f500f071a..5786c1e0a 100644 --- a/legacy/application/models/Auth.php +++ b/legacy/application/models/Auth.php @@ -136,8 +136,6 @@ class Application_Model_Auth */ public static function pinSessionToClient($auth) { - $session_id = PRODUCT_NAME . '-'; - $session_id .= bin2hex(Config::getPublicUrl()); - $auth->setStorage(new Zend_Auth_Storage_Session($session_id)); + $auth->setStorage(new Zend_Auth_Storage_Session('libretime')); } } diff --git a/legacy/application/models/airtime/Sessions.php b/legacy/application/models/airtime/Sessions.php new file mode 100644 index 000000000..0d7f29b91 --- /dev/null +++ b/legacy/application/models/airtime/Sessions.php @@ -0,0 +1,12 @@ +setName('sessions'); + $this->setPhpName('Sessions'); + $this->setClassname('Sessions'); + $this->setPackage('airtime'); + $this->setUseIdGenerator(false); + // columns + $this->addPrimaryKey('id', 'DbId', 'CHAR', true, 32, null); + $this->addColumn('modified', 'DbModified', 'INTEGER', false, null, null); + $this->addColumn('lifetime', 'DbLifetime', 'INTEGER', false, null, null); + $this->addColumn('data', 'DbData', 'LONGVARCHAR', false, null, null); + // validators + } // initialize() + + /** + * Build the RelationMap objects for this table relationships + */ + public function buildRelations() + { + } // buildRelations() + +} // SessionsTableMap diff --git a/legacy/application/models/airtime/om/BaseSessions.php b/legacy/application/models/airtime/om/BaseSessions.php new file mode 100644 index 000000000..4b1d72884 --- /dev/null +++ b/legacy/application/models/airtime/om/BaseSessions.php @@ -0,0 +1,926 @@ +id; + } + + /** + * Get the [modified] column value. + * + * @return int + */ + public function getDbModified() + { + + return $this->modified; + } + + /** + * Get the [lifetime] column value. + * + * @return int + */ + public function getDbLifetime() + { + + return $this->lifetime; + } + + /** + * Get the [data] column value. + * + * @return string + */ + public function getDbData() + { + + return $this->data; + } + + /** + * Set the value of [id] column. + * + * @param string $v new value + * @return Sessions The current object (for fluent API support) + */ + public function setDbId($v) + { + if ($v !== null) { + $v = (string) $v; + } + + if ($this->id !== $v) { + $this->id = $v; + $this->modifiedColumns[] = SessionsPeer::ID; + } + + + return $this; + } // setDbId() + + /** + * Set the value of [modified] column. + * + * @param int $v new value + * @return Sessions The current object (for fluent API support) + */ + public function setDbModified($v) + { + if ($v !== null && is_numeric($v)) { + $v = (int) $v; + } + + if ($this->modified !== $v) { + $this->modified = $v; + $this->modifiedColumns[] = SessionsPeer::MODIFIED; + } + + + return $this; + } // setDbModified() + + /** + * Set the value of [lifetime] column. + * + * @param int $v new value + * @return Sessions The current object (for fluent API support) + */ + public function setDbLifetime($v) + { + if ($v !== null && is_numeric($v)) { + $v = (int) $v; + } + + if ($this->lifetime !== $v) { + $this->lifetime = $v; + $this->modifiedColumns[] = SessionsPeer::LIFETIME; + } + + + return $this; + } // setDbLifetime() + + /** + * Set the value of [data] column. + * + * @param string $v new value + * @return Sessions The current object (for fluent API support) + */ + public function setDbData($v) + { + if ($v !== null) { + $v = (string) $v; + } + + if ($this->data !== $v) { + $this->data = $v; + $this->modifiedColumns[] = SessionsPeer::DATA; + } + + + return $this; + } // setDbData() + + /** + * Indicates whether the columns in this object are only set to default values. + * + * This method can be used in conjunction with isModified() to indicate whether an object is both + * modified _and_ has some values set which are non-default. + * + * @return boolean Whether the columns in this object are only been set with default values. + */ + public function hasOnlyDefaultValues() + { + // otherwise, everything was equal, so return true + return true; + } // hasOnlyDefaultValues() + + /** + * Hydrates (populates) the object variables with values from the database resultset. + * + * An offset (0-based "start column") is specified so that objects can be hydrated + * with a subset of the columns in the resultset rows. This is needed, for example, + * for results of JOIN queries where the resultset row includes columns from two or + * more tables. + * + * @param array $row The row returned by PDOStatement->fetch(PDO::FETCH_NUM) + * @param int $startcol 0-based offset column which indicates which resultset column to start with. + * @param boolean $rehydrate Whether this object is being re-hydrated from the database. + * @return int next starting column + * @throws PropelException - Any caught Exception will be rewrapped as a PropelException. + */ + public function hydrate($row, $startcol = 0, $rehydrate = false) + { + try { + + $this->id = ($row[$startcol + 0] !== null) ? (string) $row[$startcol + 0] : null; + $this->modified = ($row[$startcol + 1] !== null) ? (int) $row[$startcol + 1] : null; + $this->lifetime = ($row[$startcol + 2] !== null) ? (int) $row[$startcol + 2] : null; + $this->data = ($row[$startcol + 3] !== null) ? (string) $row[$startcol + 3] : null; + $this->resetModified(); + + $this->setNew(false); + + if ($rehydrate) { + $this->ensureConsistency(); + } + $this->postHydrate($row, $startcol, $rehydrate); + + return $startcol + 4; // 4 = SessionsPeer::NUM_HYDRATE_COLUMNS. + + } catch (Exception $e) { + throw new PropelException("Error populating Sessions object", $e); + } + } + + /** + * Checks and repairs the internal consistency of the object. + * + * This method is executed after an already-instantiated object is re-hydrated + * from the database. It exists to check any foreign keys to make sure that + * the objects related to the current object are correct based on foreign key. + * + * You can override this method in the stub class, but you should always invoke + * the base method from the overridden method (i.e. parent::ensureConsistency()), + * in case your model changes. + * + * @throws PropelException + */ + public function ensureConsistency() + { + + } // ensureConsistency + + /** + * Reloads this object from datastore based on primary key and (optionally) resets all associated objects. + * + * This will only work if the object has been saved and has a valid primary key set. + * + * @param boolean $deep (optional) Whether to also de-associated any related objects. + * @param PropelPDO $con (optional) The PropelPDO connection to use. + * @return void + * @throws PropelException - if this object is deleted, unsaved or doesn't have pk match in db + */ + public function reload($deep = false, PropelPDO $con = null) + { + if ($this->isDeleted()) { + throw new PropelException("Cannot reload a deleted object."); + } + + if ($this->isNew()) { + throw new PropelException("Cannot reload an unsaved object."); + } + + if ($con === null) { + $con = Propel::getConnection(SessionsPeer::DATABASE_NAME, Propel::CONNECTION_READ); + } + + // We don't need to alter the object instance pool; we're just modifying this instance + // already in the pool. + + $stmt = SessionsPeer::doSelectStmt($this->buildPkeyCriteria(), $con); + $row = $stmt->fetch(PDO::FETCH_NUM); + $stmt->closeCursor(); + if (!$row) { + throw new PropelException('Cannot find matching row in the database to reload object values.'); + } + $this->hydrate($row, 0, true); // rehydrate + + if ($deep) { // also de-associate any related objects? + + } // if (deep) + } + + /** + * Removes this object from datastore and sets delete attribute. + * + * @param PropelPDO $con + * @return void + * @throws PropelException + * @throws Exception + * @see BaseObject::setDeleted() + * @see BaseObject::isDeleted() + */ + public function delete(PropelPDO $con = null) + { + if ($this->isDeleted()) { + throw new PropelException("This object has already been deleted."); + } + + if ($con === null) { + $con = Propel::getConnection(SessionsPeer::DATABASE_NAME, Propel::CONNECTION_WRITE); + } + + $con->beginTransaction(); + try { + $deleteQuery = SessionsQuery::create() + ->filterByPrimaryKey($this->getPrimaryKey()); + $ret = $this->preDelete($con); + if ($ret) { + $deleteQuery->delete($con); + $this->postDelete($con); + $con->commit(); + $this->setDeleted(true); + } else { + $con->commit(); + } + } catch (Exception $e) { + $con->rollBack(); + throw $e; + } + } + + /** + * Persists this object to the database. + * + * If the object is new, it inserts it; otherwise an update is performed. + * All modified related objects will also be persisted in the doSave() + * method. This method wraps all precipitate database operations in a + * single transaction. + * + * @param PropelPDO $con + * @return int The number of rows affected by this insert/update and any referring fk objects' save() operations. + * @throws PropelException + * @throws Exception + * @see doSave() + */ + public function save(PropelPDO $con = null) + { + if ($this->isDeleted()) { + throw new PropelException("You cannot save an object that has been deleted."); + } + + if ($con === null) { + $con = Propel::getConnection(SessionsPeer::DATABASE_NAME, Propel::CONNECTION_WRITE); + } + + $con->beginTransaction(); + $isInsert = $this->isNew(); + try { + $ret = $this->preSave($con); + if ($isInsert) { + $ret = $ret && $this->preInsert($con); + } else { + $ret = $ret && $this->preUpdate($con); + } + if ($ret) { + $affectedRows = $this->doSave($con); + if ($isInsert) { + $this->postInsert($con); + } else { + $this->postUpdate($con); + } + $this->postSave($con); + SessionsPeer::addInstanceToPool($this); + } else { + $affectedRows = 0; + } + $con->commit(); + + return $affectedRows; + } catch (Exception $e) { + $con->rollBack(); + throw $e; + } + } + + /** + * Performs the work of inserting or updating the row in the database. + * + * If the object is new, it inserts it; otherwise an update is performed. + * All related objects are also updated in this method. + * + * @param PropelPDO $con + * @return int The number of rows affected by this insert/update and any referring fk objects' save() operations. + * @throws PropelException + * @see save() + */ + protected function doSave(PropelPDO $con) + { + $affectedRows = 0; // initialize var to track total num of affected rows + if (!$this->alreadyInSave) { + $this->alreadyInSave = true; + + if ($this->isNew() || $this->isModified()) { + // persist changes + if ($this->isNew()) { + $this->doInsert($con); + } else { + $this->doUpdate($con); + } + $affectedRows += 1; + $this->resetModified(); + } + + $this->alreadyInSave = false; + + } + + return $affectedRows; + } // doSave() + + /** + * Insert the row in the database. + * + * @param PropelPDO $con + * + * @throws PropelException + * @see doSave() + */ + protected function doInsert(PropelPDO $con) + { + $modifiedColumns = array(); + $index = 0; + + + // check the columns in natural order for more readable SQL queries + if ($this->isColumnModified(SessionsPeer::ID)) { + $modifiedColumns[':p' . $index++] = '"id"'; + } + if ($this->isColumnModified(SessionsPeer::MODIFIED)) { + $modifiedColumns[':p' . $index++] = '"modified"'; + } + if ($this->isColumnModified(SessionsPeer::LIFETIME)) { + $modifiedColumns[':p' . $index++] = '"lifetime"'; + } + if ($this->isColumnModified(SessionsPeer::DATA)) { + $modifiedColumns[':p' . $index++] = '"data"'; + } + + $sql = sprintf( + 'INSERT INTO "sessions" (%s) VALUES (%s)', + implode(', ', $modifiedColumns), + implode(', ', array_keys($modifiedColumns)) + ); + + try { + $stmt = $con->prepare($sql); + foreach ($modifiedColumns as $identifier => $columnName) { + switch ($columnName) { + case '"id"': + $stmt->bindValue($identifier, $this->id, PDO::PARAM_STR); + break; + case '"modified"': + $stmt->bindValue($identifier, $this->modified, PDO::PARAM_INT); + break; + case '"lifetime"': + $stmt->bindValue($identifier, $this->lifetime, PDO::PARAM_INT); + break; + case '"data"': + $stmt->bindValue($identifier, $this->data, PDO::PARAM_STR); + break; + } + } + $stmt->execute(); + } catch (Exception $e) { + Propel::log($e->getMessage(), Propel::LOG_ERR); + throw new PropelException(sprintf('Unable to execute INSERT statement [%s]', $sql), $e); + } + + $this->setNew(false); + } + + /** + * Update the row in the database. + * + * @param PropelPDO $con + * + * @see doSave() + */ + protected function doUpdate(PropelPDO $con) + { + $selectCriteria = $this->buildPkeyCriteria(); + $valuesCriteria = $this->buildCriteria(); + BasePeer::doUpdate($selectCriteria, $valuesCriteria, $con); + } + + /** + * Array of ValidationFailed objects. + * @var array ValidationFailed[] + */ + protected $validationFailures = array(); + + /** + * Gets any ValidationFailed objects that resulted from last call to validate(). + * + * + * @return array ValidationFailed[] + * @see validate() + */ + public function getValidationFailures() + { + return $this->validationFailures; + } + + /** + * Validates the objects modified field values and all objects related to this table. + * + * If $columns is either a column name or an array of column names + * only those columns are validated. + * + * @param mixed $columns Column name or an array of column names. + * @return boolean Whether all columns pass validation. + * @see doValidate() + * @see getValidationFailures() + */ + public function validate($columns = null) + { + $res = $this->doValidate($columns); + if ($res === true) { + $this->validationFailures = array(); + + return true; + } + + $this->validationFailures = $res; + + return false; + } + + /** + * This function performs the validation work for complex object models. + * + * In addition to checking the current object, all related objects will + * also be validated. If all pass then true is returned; otherwise + * an aggregated array of ValidationFailed objects will be returned. + * + * @param array $columns Array of column names to validate. + * @return mixed true if all validations pass; array of ValidationFailed objects otherwise. + */ + protected function doValidate($columns = null) + { + if (!$this->alreadyInValidation) { + $this->alreadyInValidation = true; + $retval = null; + + $failureMap = array(); + + + if (($retval = SessionsPeer::doValidate($this, $columns)) !== true) { + $failureMap = array_merge($failureMap, $retval); + } + + + + $this->alreadyInValidation = false; + } + + return (!empty($failureMap) ? $failureMap : true); + } + + /** + * Retrieves a field from the object by name passed in as a string. + * + * @param string $name name + * @param string $type The type of fieldname the $name is of: + * one of the class type constants BasePeer::TYPE_PHPNAME, BasePeer::TYPE_STUDLYPHPNAME + * BasePeer::TYPE_COLNAME, BasePeer::TYPE_FIELDNAME, BasePeer::TYPE_NUM. + * Defaults to BasePeer::TYPE_PHPNAME + * @return mixed Value of field. + */ + public function getByName($name, $type = BasePeer::TYPE_PHPNAME) + { + $pos = SessionsPeer::translateFieldName($name, $type, BasePeer::TYPE_NUM); + $field = $this->getByPosition($pos); + + return $field; + } + + /** + * Retrieves a field from the object by Position as specified in the xml schema. + * Zero-based. + * + * @param int $pos position in xml schema + * @return mixed Value of field at $pos + */ + public function getByPosition($pos) + { + switch ($pos) { + case 0: + return $this->getDbId(); + break; + case 1: + return $this->getDbModified(); + break; + case 2: + return $this->getDbLifetime(); + break; + case 3: + return $this->getDbData(); + break; + default: + return null; + break; + } // switch() + } + + /** + * Exports the object as an array. + * + * You can specify the key type of the array by passing one of the class + * type constants. + * + * @param string $keyType (optional) One of the class type constants BasePeer::TYPE_PHPNAME, BasePeer::TYPE_STUDLYPHPNAME, + * BasePeer::TYPE_COLNAME, BasePeer::TYPE_FIELDNAME, BasePeer::TYPE_NUM. + * Defaults to BasePeer::TYPE_PHPNAME. + * @param boolean $includeLazyLoadColumns (optional) Whether to include lazy loaded columns. Defaults to true. + * @param array $alreadyDumpedObjects List of objects to skip to avoid recursion + * + * @return array an associative array containing the field names (as keys) and field values + */ + public function toArray($keyType = BasePeer::TYPE_PHPNAME, $includeLazyLoadColumns = true, $alreadyDumpedObjects = array()) + { + if (isset($alreadyDumpedObjects['Sessions'][$this->getPrimaryKey()])) { + return '*RECURSION*'; + } + $alreadyDumpedObjects['Sessions'][$this->getPrimaryKey()] = true; + $keys = SessionsPeer::getFieldNames($keyType); + $result = array( + $keys[0] => $this->getDbId(), + $keys[1] => $this->getDbModified(), + $keys[2] => $this->getDbLifetime(), + $keys[3] => $this->getDbData(), + ); + $virtualColumns = $this->virtualColumns; + foreach ($virtualColumns as $key => $virtualColumn) { + $result[$key] = $virtualColumn; + } + + + return $result; + } + + /** + * Sets a field from the object by name passed in as a string. + * + * @param string $name peer name + * @param mixed $value field value + * @param string $type The type of fieldname the $name is of: + * one of the class type constants BasePeer::TYPE_PHPNAME, BasePeer::TYPE_STUDLYPHPNAME + * BasePeer::TYPE_COLNAME, BasePeer::TYPE_FIELDNAME, BasePeer::TYPE_NUM. + * Defaults to BasePeer::TYPE_PHPNAME + * @return void + */ + public function setByName($name, $value, $type = BasePeer::TYPE_PHPNAME) + { + $pos = SessionsPeer::translateFieldName($name, $type, BasePeer::TYPE_NUM); + + $this->setByPosition($pos, $value); + } + + /** + * Sets a field from the object by Position as specified in the xml schema. + * Zero-based. + * + * @param int $pos position in xml schema + * @param mixed $value field value + * @return void + */ + public function setByPosition($pos, $value) + { + switch ($pos) { + case 0: + $this->setDbId($value); + break; + case 1: + $this->setDbModified($value); + break; + case 2: + $this->setDbLifetime($value); + break; + case 3: + $this->setDbData($value); + break; + } // switch() + } + + /** + * Populates the object using an array. + * + * This is particularly useful when populating an object from one of the + * request arrays (e.g. $_POST). This method goes through the column + * names, checking to see whether a matching key exists in populated + * array. If so the setByName() method is called for that column. + * + * You can specify the key type of the array by additionally passing one + * of the class type constants BasePeer::TYPE_PHPNAME, BasePeer::TYPE_STUDLYPHPNAME, + * BasePeer::TYPE_COLNAME, BasePeer::TYPE_FIELDNAME, BasePeer::TYPE_NUM. + * The default key type is the column's BasePeer::TYPE_PHPNAME + * + * @param array $arr An array to populate the object from. + * @param string $keyType The type of keys the array uses. + * @return void + */ + public function fromArray($arr, $keyType = BasePeer::TYPE_PHPNAME) + { + $keys = SessionsPeer::getFieldNames($keyType); + + if (array_key_exists($keys[0], $arr)) $this->setDbId($arr[$keys[0]]); + if (array_key_exists($keys[1], $arr)) $this->setDbModified($arr[$keys[1]]); + if (array_key_exists($keys[2], $arr)) $this->setDbLifetime($arr[$keys[2]]); + if (array_key_exists($keys[3], $arr)) $this->setDbData($arr[$keys[3]]); + } + + /** + * Build a Criteria object containing the values of all modified columns in this object. + * + * @return Criteria The Criteria object containing all modified values. + */ + public function buildCriteria() + { + $criteria = new Criteria(SessionsPeer::DATABASE_NAME); + + if ($this->isColumnModified(SessionsPeer::ID)) $criteria->add(SessionsPeer::ID, $this->id); + if ($this->isColumnModified(SessionsPeer::MODIFIED)) $criteria->add(SessionsPeer::MODIFIED, $this->modified); + if ($this->isColumnModified(SessionsPeer::LIFETIME)) $criteria->add(SessionsPeer::LIFETIME, $this->lifetime); + if ($this->isColumnModified(SessionsPeer::DATA)) $criteria->add(SessionsPeer::DATA, $this->data); + + return $criteria; + } + + /** + * Builds a Criteria object containing the primary key for this object. + * + * Unlike buildCriteria() this method includes the primary key values regardless + * of whether or not they have been modified. + * + * @return Criteria The Criteria object containing value(s) for primary key(s). + */ + public function buildPkeyCriteria() + { + $criteria = new Criteria(SessionsPeer::DATABASE_NAME); + $criteria->add(SessionsPeer::ID, $this->id); + + return $criteria; + } + + /** + * Returns the primary key for this object (row). + * @return string + */ + public function getPrimaryKey() + { + return $this->getDbId(); + } + + /** + * Generic method to set the primary key (id column). + * + * @param string $key Primary key. + * @return void + */ + public function setPrimaryKey($key) + { + $this->setDbId($key); + } + + /** + * Returns true if the primary key for this object is null. + * @return boolean + */ + public function isPrimaryKeyNull() + { + + return null === $this->getDbId(); + } + + /** + * Sets contents of passed object to values from current object. + * + * If desired, this method can also make copies of all associated (fkey referrers) + * objects. + * + * @param object $copyObj An object of Sessions (or compatible) type. + * @param boolean $deepCopy Whether to also copy all rows that refer (by fkey) to the current row. + * @param boolean $makeNew Whether to reset autoincrement PKs and make the object new. + * @throws PropelException + */ + public function copyInto($copyObj, $deepCopy = false, $makeNew = true) + { + $copyObj->setDbModified($this->getDbModified()); + $copyObj->setDbLifetime($this->getDbLifetime()); + $copyObj->setDbData($this->getDbData()); + if ($makeNew) { + $copyObj->setNew(true); + $copyObj->setDbId(NULL); // this is a auto-increment column, so set to default value + } + } + + /** + * Makes a copy of this object that will be inserted as a new row in table when saved. + * It creates a new object filling in the simple attributes, but skipping any primary + * keys that are defined for the table. + * + * If desired, this method can also make copies of all associated (fkey referrers) + * objects. + * + * @param boolean $deepCopy Whether to also copy all rows that refer (by fkey) to the current row. + * @return Sessions Clone of current object. + * @throws PropelException + */ + public function copy($deepCopy = false) + { + // we use get_class(), because this might be a subclass + $clazz = get_class($this); + $copyObj = new $clazz(); + $this->copyInto($copyObj, $deepCopy); + + return $copyObj; + } + + /** + * Returns a peer instance associated with this om. + * + * Since Peer classes are not to have any instance attributes, this method returns the + * same instance for all member of this class. The method could therefore + * be static, but this would prevent one from overriding the behavior. + * + * @return SessionsPeer + */ + public function getPeer() + { + if (self::$peer === null) { + self::$peer = new SessionsPeer(); + } + + return self::$peer; + } + + /** + * Clears the current object and sets all attributes to their default values + */ + public function clear() + { + $this->id = null; + $this->modified = null; + $this->lifetime = null; + $this->data = null; + $this->alreadyInSave = false; + $this->alreadyInValidation = false; + $this->alreadyInClearAllReferencesDeep = false; + $this->clearAllReferences(); + $this->resetModified(); + $this->setNew(true); + $this->setDeleted(false); + } + + /** + * Resets all references to other model objects or collections of model objects. + * + * This method is a user-space workaround for PHP's inability to garbage collect + * objects with circular references (even in PHP 5.3). This is currently necessary + * when using Propel in certain daemon or large-volume/high-memory operations. + * + * @param boolean $deep Whether to also clear the references on all referrer objects. + */ + public function clearAllReferences($deep = false) + { + if ($deep && !$this->alreadyInClearAllReferencesDeep) { + $this->alreadyInClearAllReferencesDeep = true; + + $this->alreadyInClearAllReferencesDeep = false; + } // if ($deep) + + } + + /** + * return the string representation of this object + * + * @return string + */ + public function __toString() + { + return (string) $this->exportTo(SessionsPeer::DEFAULT_STRING_FORMAT); + } + + /** + * return true is the object is in saving state + * + * @return boolean + */ + public function isAlreadyInSave() + { + return $this->alreadyInSave; + } + +} diff --git a/legacy/application/models/airtime/om/BaseSessionsPeer.php b/legacy/application/models/airtime/om/BaseSessionsPeer.php new file mode 100644 index 000000000..ed704c6b7 --- /dev/null +++ b/legacy/application/models/airtime/om/BaseSessionsPeer.php @@ -0,0 +1,766 @@ + array ('DbId', 'DbModified', 'DbLifetime', 'DbData', ), + BasePeer::TYPE_STUDLYPHPNAME => array ('dbId', 'dbModified', 'dbLifetime', 'dbData', ), + BasePeer::TYPE_COLNAME => array (SessionsPeer::ID, SessionsPeer::MODIFIED, SessionsPeer::LIFETIME, SessionsPeer::DATA, ), + BasePeer::TYPE_RAW_COLNAME => array ('ID', 'MODIFIED', 'LIFETIME', 'DATA', ), + BasePeer::TYPE_FIELDNAME => array ('id', 'modified', 'lifetime', 'data', ), + BasePeer::TYPE_NUM => array (0, 1, 2, 3, ) + ); + + /** + * holds an array of keys for quick access to the fieldnames array + * + * first dimension keys are the type constants + * e.g. SessionsPeer::$fieldNames[BasePeer::TYPE_PHPNAME]['Id'] = 0 + */ + protected static $fieldKeys = array ( + BasePeer::TYPE_PHPNAME => array ('DbId' => 0, 'DbModified' => 1, 'DbLifetime' => 2, 'DbData' => 3, ), + BasePeer::TYPE_STUDLYPHPNAME => array ('dbId' => 0, 'dbModified' => 1, 'dbLifetime' => 2, 'dbData' => 3, ), + BasePeer::TYPE_COLNAME => array (SessionsPeer::ID => 0, SessionsPeer::MODIFIED => 1, SessionsPeer::LIFETIME => 2, SessionsPeer::DATA => 3, ), + BasePeer::TYPE_RAW_COLNAME => array ('ID' => 0, 'MODIFIED' => 1, 'LIFETIME' => 2, 'DATA' => 3, ), + BasePeer::TYPE_FIELDNAME => array ('id' => 0, 'modified' => 1, 'lifetime' => 2, 'data' => 3, ), + BasePeer::TYPE_NUM => array (0, 1, 2, 3, ) + ); + + /** + * Translates a fieldname to another type + * + * @param string $name field name + * @param string $fromType One of the class type constants BasePeer::TYPE_PHPNAME, BasePeer::TYPE_STUDLYPHPNAME + * BasePeer::TYPE_COLNAME, BasePeer::TYPE_FIELDNAME, BasePeer::TYPE_NUM + * @param string $toType One of the class type constants + * @return string translated name of the field. + * @throws PropelException - if the specified name could not be found in the fieldname mappings. + */ + public static function translateFieldName($name, $fromType, $toType) + { + $toNames = SessionsPeer::getFieldNames($toType); + $key = isset(SessionsPeer::$fieldKeys[$fromType][$name]) ? SessionsPeer::$fieldKeys[$fromType][$name] : null; + if ($key === null) { + throw new PropelException("'$name' could not be found in the field names of type '$fromType'. These are: " . print_r(SessionsPeer::$fieldKeys[$fromType], true)); + } + + return $toNames[$key]; + } + + /** + * Returns an array of field names. + * + * @param string $type The type of fieldnames to return: + * One of the class type constants BasePeer::TYPE_PHPNAME, BasePeer::TYPE_STUDLYPHPNAME + * BasePeer::TYPE_COLNAME, BasePeer::TYPE_FIELDNAME, BasePeer::TYPE_NUM + * @return array A list of field names + * @throws PropelException - if the type is not valid. + */ + public static function getFieldNames($type = BasePeer::TYPE_PHPNAME) + { + if (!array_key_exists($type, SessionsPeer::$fieldNames)) { + throw new PropelException('Method getFieldNames() expects the parameter $type to be one of the class constants BasePeer::TYPE_PHPNAME, BasePeer::TYPE_STUDLYPHPNAME, BasePeer::TYPE_COLNAME, BasePeer::TYPE_FIELDNAME, BasePeer::TYPE_NUM. ' . $type . ' was given.'); + } + + return SessionsPeer::$fieldNames[$type]; + } + + /** + * Convenience method which changes table.column to alias.column. + * + * Using this method you can maintain SQL abstraction while using column aliases. + * + * $c->addAlias("alias1", TablePeer::TABLE_NAME); + * $c->addJoin(TablePeer::alias("alias1", TablePeer::PRIMARY_KEY_COLUMN), TablePeer::PRIMARY_KEY_COLUMN); + * + * @param string $alias The alias for the current table. + * @param string $column The column name for current table. (i.e. SessionsPeer::COLUMN_NAME). + * @return string + */ + public static function alias($alias, $column) + { + return str_replace(SessionsPeer::TABLE_NAME.'.', $alias.'.', $column); + } + + /** + * Add all the columns needed to create a new object. + * + * Note: any columns that were marked with lazyLoad="true" in the + * XML schema will not be added to the select list and only loaded + * on demand. + * + * @param Criteria $criteria object containing the columns to add. + * @param string $alias optional table alias + * @throws PropelException Any exceptions caught during processing will be + * rethrown wrapped into a PropelException. + */ + public static function addSelectColumns(Criteria $criteria, $alias = null) + { + if (null === $alias) { + $criteria->addSelectColumn(SessionsPeer::ID); + $criteria->addSelectColumn(SessionsPeer::MODIFIED); + $criteria->addSelectColumn(SessionsPeer::LIFETIME); + $criteria->addSelectColumn(SessionsPeer::DATA); + } else { + $criteria->addSelectColumn($alias . '.id'); + $criteria->addSelectColumn($alias . '.modified'); + $criteria->addSelectColumn($alias . '.lifetime'); + $criteria->addSelectColumn($alias . '.data'); + } + } + + /** + * Returns the number of rows matching criteria. + * + * @param Criteria $criteria + * @param boolean $distinct Whether to select only distinct columns; deprecated: use Criteria->setDistinct() instead. + * @param PropelPDO $con + * @return int Number of matching rows. + */ + public static function doCount(Criteria $criteria, $distinct = false, PropelPDO $con = null) + { + // we may modify criteria, so copy it first + $criteria = clone $criteria; + + // We need to set the primary table name, since in the case that there are no WHERE columns + // it will be impossible for the BasePeer::createSelectSql() method to determine which + // tables go into the FROM clause. + $criteria->setPrimaryTableName(SessionsPeer::TABLE_NAME); + + if ($distinct && !in_array(Criteria::DISTINCT, $criteria->getSelectModifiers())) { + $criteria->setDistinct(); + } + + if (!$criteria->hasSelectClause()) { + SessionsPeer::addSelectColumns($criteria); + } + + $criteria->clearOrderByColumns(); // ORDER BY won't ever affect the count + $criteria->setDbName(SessionsPeer::DATABASE_NAME); // Set the correct dbName + + if ($con === null) { + $con = Propel::getConnection(SessionsPeer::DATABASE_NAME, Propel::CONNECTION_READ); + } + // BasePeer returns a PDOStatement + $stmt = BasePeer::doCount($criteria, $con); + + if ($row = $stmt->fetch(PDO::FETCH_NUM)) { + $count = (int) $row[0]; + } else { + $count = 0; // no rows returned; we infer that means 0 matches. + } + $stmt->closeCursor(); + + return $count; + } + /** + * Selects one object from the DB. + * + * @param Criteria $criteria object used to create the SELECT statement. + * @param PropelPDO $con + * @return Sessions + * @throws PropelException Any exceptions caught during processing will be + * rethrown wrapped into a PropelException. + */ + public static function doSelectOne(Criteria $criteria, PropelPDO $con = null) + { + $critcopy = clone $criteria; + $critcopy->setLimit(1); + $objects = SessionsPeer::doSelect($critcopy, $con); + if ($objects) { + return $objects[0]; + } + + return null; + } + /** + * Selects several row from the DB. + * + * @param Criteria $criteria The Criteria object used to build the SELECT statement. + * @param PropelPDO $con + * @return array Array of selected Objects + * @throws PropelException Any exceptions caught during processing will be + * rethrown wrapped into a PropelException. + */ + public static function doSelect(Criteria $criteria, PropelPDO $con = null) + { + return SessionsPeer::populateObjects(SessionsPeer::doSelectStmt($criteria, $con)); + } + /** + * Prepares the Criteria object and uses the parent doSelect() method to execute a PDOStatement. + * + * Use this method directly if you want to work with an executed statement directly (for example + * to perform your own object hydration). + * + * @param Criteria $criteria The Criteria object used to build the SELECT statement. + * @param PropelPDO $con The connection to use + * @throws PropelException Any exceptions caught during processing will be + * rethrown wrapped into a PropelException. + * @return PDOStatement The executed PDOStatement object. + * @see BasePeer::doSelect() + */ + public static function doSelectStmt(Criteria $criteria, PropelPDO $con = null) + { + if ($con === null) { + $con = Propel::getConnection(SessionsPeer::DATABASE_NAME, Propel::CONNECTION_READ); + } + + if (!$criteria->hasSelectClause()) { + $criteria = clone $criteria; + SessionsPeer::addSelectColumns($criteria); + } + + // Set the correct dbName + $criteria->setDbName(SessionsPeer::DATABASE_NAME); + + // BasePeer returns a PDOStatement + return BasePeer::doSelect($criteria, $con); + } + /** + * Adds an object to the instance pool. + * + * Propel keeps cached copies of objects in an instance pool when they are retrieved + * from the database. In some cases -- especially when you override doSelect*() + * methods in your stub classes -- you may need to explicitly add objects + * to the cache in order to ensure that the same objects are always returned by doSelect*() + * and retrieveByPK*() calls. + * + * @param Sessions $obj A Sessions object. + * @param string $key (optional) key to use for instance map (for performance boost if key was already calculated externally). + */ + public static function addInstanceToPool($obj, $key = null) + { + if (Propel::isInstancePoolingEnabled()) { + if ($key === null) { + $key = (string) $obj->getDbId(); + } // if key === null + SessionsPeer::$instances[$key] = $obj; + } + } + + /** + * Removes an object from the instance pool. + * + * Propel keeps cached copies of objects in an instance pool when they are retrieved + * from the database. In some cases -- especially when you override doDelete + * methods in your stub classes -- you may need to explicitly remove objects + * from the cache in order to prevent returning objects that no longer exist. + * + * @param mixed $value A Sessions object or a primary key value. + * + * @return void + * @throws PropelException - if the value is invalid. + */ + public static function removeInstanceFromPool($value) + { + if (Propel::isInstancePoolingEnabled() && $value !== null) { + if (is_object($value) && $value instanceof Sessions) { + $key = (string) $value->getDbId(); + } elseif (is_scalar($value)) { + // assume we've been passed a primary key + $key = (string) $value; + } else { + $e = new PropelException("Invalid value passed to removeInstanceFromPool(). Expected primary key or Sessions object; got " . (is_object($value) ? get_class($value) . ' object.' : var_export($value,true))); + throw $e; + } + + unset(SessionsPeer::$instances[$key]); + } + } // removeInstanceFromPool() + + /** + * Retrieves a string version of the primary key from the DB resultset row that can be used to uniquely identify a row in this table. + * + * For tables with a single-column primary key, that simple pkey value will be returned. For tables with + * a multi-column primary key, a serialize()d version of the primary key will be returned. + * + * @param string $key The key (@see getPrimaryKeyHash()) for this instance. + * @return Sessions Found object or null if 1) no instance exists for specified key or 2) instance pooling has been disabled. + * @see getPrimaryKeyHash() + */ + public static function getInstanceFromPool($key) + { + if (Propel::isInstancePoolingEnabled()) { + if (isset(SessionsPeer::$instances[$key])) { + return SessionsPeer::$instances[$key]; + } + } + + return null; // just to be explicit + } + + /** + * Clear the instance pool. + * + * @return void + */ + public static function clearInstancePool($and_clear_all_references = false) + { + if ($and_clear_all_references) { + foreach (SessionsPeer::$instances as $instance) { + $instance->clearAllReferences(true); + } + } + SessionsPeer::$instances = array(); + } + + /** + * Method to invalidate the instance pool of all tables related to sessions + * by a foreign key with ON DELETE CASCADE + */ + public static function clearRelatedInstancePool() + { + } + + /** + * Retrieves a string version of the primary key from the DB resultset row that can be used to uniquely identify a row in this table. + * + * For tables with a single-column primary key, that simple pkey value will be returned. For tables with + * a multi-column primary key, a serialize()d version of the primary key will be returned. + * + * @param array $row PropelPDO resultset row. + * @param int $startcol The 0-based offset for reading from the resultset row. + * @return string A string version of PK or null if the components of primary key in result array are all null. + */ + public static function getPrimaryKeyHashFromRow($row, $startcol = 0) + { + // If the PK cannot be derived from the row, return null. + if ($row[$startcol] === null) { + return null; + } + + return (string) $row[$startcol]; + } + + /** + * Retrieves the primary key from the DB resultset row + * For tables with a single-column primary key, that simple pkey value will be returned. For tables with + * a multi-column primary key, an array of the primary key columns will be returned. + * + * @param array $row PropelPDO resultset row. + * @param int $startcol The 0-based offset for reading from the resultset row. + * @return mixed The primary key of the row + */ + public static function getPrimaryKeyFromRow($row, $startcol = 0) + { + + return (string) $row[$startcol]; + } + + /** + * The returned array will contain objects of the default type or + * objects that inherit from the default. + * + * @throws PropelException Any exceptions caught during processing will be + * rethrown wrapped into a PropelException. + */ + public static function populateObjects(PDOStatement $stmt) + { + $results = array(); + + // set the class once to avoid overhead in the loop + $cls = SessionsPeer::getOMClass(); + // populate the object(s) + while ($row = $stmt->fetch(PDO::FETCH_NUM)) { + $key = SessionsPeer::getPrimaryKeyHashFromRow($row, 0); + if (null !== ($obj = SessionsPeer::getInstanceFromPool($key))) { + // We no longer rehydrate the object, since this can cause data loss. + // See http://www.propelorm.org/ticket/509 + // $obj->hydrate($row, 0, true); // rehydrate + $results[] = $obj; + } else { + $obj = new $cls(); + $obj->hydrate($row); + $results[] = $obj; + SessionsPeer::addInstanceToPool($obj, $key); + } // if key exists + } + $stmt->closeCursor(); + + return $results; + } + /** + * Populates an object of the default type or an object that inherit from the default. + * + * @param array $row PropelPDO resultset row. + * @param int $startcol The 0-based offset for reading from the resultset row. + * @throws PropelException Any exceptions caught during processing will be + * rethrown wrapped into a PropelException. + * @return array (Sessions object, last column rank) + */ + public static function populateObject($row, $startcol = 0) + { + $key = SessionsPeer::getPrimaryKeyHashFromRow($row, $startcol); + if (null !== ($obj = SessionsPeer::getInstanceFromPool($key))) { + // We no longer rehydrate the object, since this can cause data loss. + // See http://www.propelorm.org/ticket/509 + // $obj->hydrate($row, $startcol, true); // rehydrate + $col = $startcol + SessionsPeer::NUM_HYDRATE_COLUMNS; + } else { + $cls = SessionsPeer::OM_CLASS; + $obj = new $cls(); + $col = $obj->hydrate($row, $startcol); + SessionsPeer::addInstanceToPool($obj, $key); + } + + return array($obj, $col); + } + + /** + * Returns the TableMap related to this peer. + * This method is not needed for general use but a specific application could have a need. + * @return TableMap + * @throws PropelException Any exceptions caught during processing will be + * rethrown wrapped into a PropelException. + */ + public static function getTableMap() + { + return Propel::getDatabaseMap(SessionsPeer::DATABASE_NAME)->getTable(SessionsPeer::TABLE_NAME); + } + + /** + * Add a TableMap instance to the database for this peer class. + */ + public static function buildTableMap() + { + $dbMap = Propel::getDatabaseMap(BaseSessionsPeer::DATABASE_NAME); + if (!$dbMap->hasTable(BaseSessionsPeer::TABLE_NAME)) { + $dbMap->addTableObject(new \SessionsTableMap()); + } + } + + /** + * The class that the Peer will make instances of. + * + * + * @return string ClassName + */ + public static function getOMClass($row = 0, $colnum = 0) + { + return SessionsPeer::OM_CLASS; + } + + /** + * Performs an INSERT on the database, given a Sessions or Criteria object. + * + * @param mixed $values Criteria or Sessions object containing data that is used to create the INSERT statement. + * @param PropelPDO $con the PropelPDO connection to use + * @return mixed The new primary key. + * @throws PropelException Any exceptions caught during processing will be + * rethrown wrapped into a PropelException. + */ + public static function doInsert($values, PropelPDO $con = null) + { + if ($con === null) { + $con = Propel::getConnection(SessionsPeer::DATABASE_NAME, Propel::CONNECTION_WRITE); + } + + if ($values instanceof Criteria) { + $criteria = clone $values; // rename for clarity + } else { + $criteria = $values->buildCriteria(); // build Criteria from Sessions object + } + + + // Set the correct dbName + $criteria->setDbName(SessionsPeer::DATABASE_NAME); + + try { + // use transaction because $criteria could contain info + // for more than one table (I guess, conceivably) + $con->beginTransaction(); + $pk = BasePeer::doInsert($criteria, $con); + $con->commit(); + } catch (Exception $e) { + $con->rollBack(); + throw $e; + } + + return $pk; + } + + /** + * Performs an UPDATE on the database, given a Sessions or Criteria object. + * + * @param mixed $values Criteria or Sessions object containing data that is used to create the UPDATE statement. + * @param PropelPDO $con The connection to use (specify PropelPDO connection object to exert more control over transactions). + * @return int The number of affected rows (if supported by underlying database driver). + * @throws PropelException Any exceptions caught during processing will be + * rethrown wrapped into a PropelException. + */ + public static function doUpdate($values, PropelPDO $con = null) + { + if ($con === null) { + $con = Propel::getConnection(SessionsPeer::DATABASE_NAME, Propel::CONNECTION_WRITE); + } + + $selectCriteria = new Criteria(SessionsPeer::DATABASE_NAME); + + if ($values instanceof Criteria) { + $criteria = clone $values; // rename for clarity + + $comparison = $criteria->getComparison(SessionsPeer::ID); + $value = $criteria->remove(SessionsPeer::ID); + if ($value) { + $selectCriteria->add(SessionsPeer::ID, $value, $comparison); + } else { + $selectCriteria->setPrimaryTableName(SessionsPeer::TABLE_NAME); + } + + } else { // $values is Sessions object + $criteria = $values->buildCriteria(); // gets full criteria + $selectCriteria = $values->buildPkeyCriteria(); // gets criteria w/ primary key(s) + } + + // set the correct dbName + $criteria->setDbName(SessionsPeer::DATABASE_NAME); + + return BasePeer::doUpdate($selectCriteria, $criteria, $con); + } + + /** + * Deletes all rows from the sessions table. + * + * @param PropelPDO $con the connection to use + * @return int The number of affected rows (if supported by underlying database driver). + * @throws PropelException + */ + public static function doDeleteAll(PropelPDO $con = null) + { + if ($con === null) { + $con = Propel::getConnection(SessionsPeer::DATABASE_NAME, Propel::CONNECTION_WRITE); + } + $affectedRows = 0; // initialize var to track total num of affected rows + try { + // use transaction because $criteria could contain info + // for more than one table or we could emulating ON DELETE CASCADE, etc. + $con->beginTransaction(); + $affectedRows += BasePeer::doDeleteAll(SessionsPeer::TABLE_NAME, $con, SessionsPeer::DATABASE_NAME); + // Because this db requires some delete cascade/set null emulation, we have to + // clear the cached instance *after* the emulation has happened (since + // instances get re-added by the select statement contained therein). + SessionsPeer::clearInstancePool(); + SessionsPeer::clearRelatedInstancePool(); + $con->commit(); + + return $affectedRows; + } catch (Exception $e) { + $con->rollBack(); + throw $e; + } + } + + /** + * Performs a DELETE on the database, given a Sessions or Criteria object OR a primary key value. + * + * @param mixed $values Criteria or Sessions object or primary key or array of primary keys + * which is used to create the DELETE statement + * @param PropelPDO $con the connection to use + * @return int The number of affected rows (if supported by underlying database driver). This includes CASCADE-related rows + * if supported by native driver or if emulated using Propel. + * @throws PropelException Any exceptions caught during processing will be + * rethrown wrapped into a PropelException. + */ + public static function doDelete($values, PropelPDO $con = null) + { + if ($con === null) { + $con = Propel::getConnection(SessionsPeer::DATABASE_NAME, Propel::CONNECTION_WRITE); + } + + if ($values instanceof Criteria) { + // invalidate the cache for all objects of this type, since we have no + // way of knowing (without running a query) what objects should be invalidated + // from the cache based on this Criteria. + SessionsPeer::clearInstancePool(); + // rename for clarity + $criteria = clone $values; + } elseif ($values instanceof Sessions) { // it's a model object + // invalidate the cache for this single object + SessionsPeer::removeInstanceFromPool($values); + // create criteria based on pk values + $criteria = $values->buildPkeyCriteria(); + } else { // it's a primary key, or an array of pks + $criteria = new Criteria(SessionsPeer::DATABASE_NAME); + $criteria->add(SessionsPeer::ID, (array) $values, Criteria::IN); + // invalidate the cache for this object(s) + foreach ((array) $values as $singleval) { + SessionsPeer::removeInstanceFromPool($singleval); + } + } + + // Set the correct dbName + $criteria->setDbName(SessionsPeer::DATABASE_NAME); + + $affectedRows = 0; // initialize var to track total num of affected rows + + try { + // use transaction because $criteria could contain info + // for more than one table or we could emulating ON DELETE CASCADE, etc. + $con->beginTransaction(); + + $affectedRows += BasePeer::doDelete($criteria, $con); + SessionsPeer::clearRelatedInstancePool(); + $con->commit(); + + return $affectedRows; + } catch (Exception $e) { + $con->rollBack(); + throw $e; + } + } + + /** + * Validates all modified columns of given Sessions object. + * If parameter $columns is either a single column name or an array of column names + * than only those columns are validated. + * + * NOTICE: This does not apply to primary or foreign keys for now. + * + * @param Sessions $obj The object to validate. + * @param mixed $cols Column name or array of column names. + * + * @return mixed TRUE if all columns are valid or the error message of the first invalid column. + */ + public static function doValidate($obj, $cols = null) + { + $columns = array(); + + if ($cols) { + $dbMap = Propel::getDatabaseMap(SessionsPeer::DATABASE_NAME); + $tableMap = $dbMap->getTable(SessionsPeer::TABLE_NAME); + + if (! is_array($cols)) { + $cols = array($cols); + } + + foreach ($cols as $colName) { + if ($tableMap->hasColumn($colName)) { + $get = 'get' . $tableMap->getColumn($colName)->getPhpName(); + $columns[$colName] = $obj->$get(); + } + } + } else { + + } + + return BasePeer::doValidate(SessionsPeer::DATABASE_NAME, SessionsPeer::TABLE_NAME, $columns); + } + + /** + * Retrieve a single object by pkey. + * + * @param string $pk the primary key. + * @param PropelPDO $con the connection to use + * @return Sessions + */ + public static function retrieveByPK($pk, PropelPDO $con = null) + { + + if (null !== ($obj = SessionsPeer::getInstanceFromPool((string) $pk))) { + return $obj; + } + + if ($con === null) { + $con = Propel::getConnection(SessionsPeer::DATABASE_NAME, Propel::CONNECTION_READ); + } + + $criteria = new Criteria(SessionsPeer::DATABASE_NAME); + $criteria->add(SessionsPeer::ID, $pk); + + $v = SessionsPeer::doSelect($criteria, $con); + + return !empty($v) > 0 ? $v[0] : null; + } + + /** + * Retrieve multiple objects by pkey. + * + * @param array $pks List of primary keys + * @param PropelPDO $con the connection to use + * @return Sessions[] + * @throws PropelException Any exceptions caught during processing will be + * rethrown wrapped into a PropelException. + */ + public static function retrieveByPKs($pks, PropelPDO $con = null) + { + if ($con === null) { + $con = Propel::getConnection(SessionsPeer::DATABASE_NAME, Propel::CONNECTION_READ); + } + + $objs = null; + if (empty($pks)) { + $objs = array(); + } else { + $criteria = new Criteria(SessionsPeer::DATABASE_NAME); + $criteria->add(SessionsPeer::ID, $pks, Criteria::IN); + $objs = SessionsPeer::doSelect($criteria, $con); + } + + return $objs; + } + +} // BaseSessionsPeer + +// This is the static code needed to register the TableMap for this table with the main Propel class. +// +BaseSessionsPeer::buildTableMap(); diff --git a/legacy/application/models/airtime/om/BaseSessionsQuery.php b/legacy/application/models/airtime/om/BaseSessionsQuery.php new file mode 100644 index 000000000..13f10bd64 --- /dev/null +++ b/legacy/application/models/airtime/om/BaseSessionsQuery.php @@ -0,0 +1,388 @@ +mergeWith($criteria); + } + + return $query; + } + + /** + * Find object by primary key. + * Propel uses the instance pool to skip the database if the object exists. + * Go fast if the query is untouched. + * + * + * $obj = $c->findPk(12, $con); + * + * + * @param mixed $key Primary key to use for the query + * @param PropelPDO $con an optional connection object + * + * @return Sessions|Sessions[]|mixed the result, formatted by the current formatter + */ + public function findPk($key, $con = null) + { + if ($key === null) { + return null; + } + if ((null !== ($obj = SessionsPeer::getInstanceFromPool((string) $key))) && !$this->formatter) { + // the object is already in the instance pool + return $obj; + } + if ($con === null) { + $con = Propel::getConnection(SessionsPeer::DATABASE_NAME, Propel::CONNECTION_READ); + } + $this->basePreSelect($con); + if ($this->formatter || $this->modelAlias || $this->with || $this->select + || $this->selectColumns || $this->asColumns || $this->selectModifiers + || $this->map || $this->having || $this->joins) { + return $this->findPkComplex($key, $con); + } else { + return $this->findPkSimple($key, $con); + } + } + + /** + * Alias of findPk to use instance pooling + * + * @param mixed $key Primary key to use for the query + * @param PropelPDO $con A connection object + * + * @return Sessions A model object, or null if the key is not found + * @throws PropelException + */ + public function findOneByDbId($key, $con = null) + { + return $this->findPk($key, $con); + } + + /** + * Find object by primary key using raw SQL to go fast. + * Bypass doSelect() and the object formatter by using generated code. + * + * @param mixed $key Primary key to use for the query + * @param PropelPDO $con A connection object + * + * @return Sessions A model object, or null if the key is not found + * @throws PropelException + */ + protected function findPkSimple($key, $con) + { + $sql = 'SELECT "id", "modified", "lifetime", "data" FROM "sessions" WHERE "id" = :p0'; + try { + $stmt = $con->prepare($sql); + $stmt->bindValue(':p0', $key, PDO::PARAM_STR); + $stmt->execute(); + } catch (Exception $e) { + Propel::log($e->getMessage(), Propel::LOG_ERR); + throw new PropelException(sprintf('Unable to execute SELECT statement [%s]', $sql), $e); + } + $obj = null; + if ($row = $stmt->fetch(PDO::FETCH_NUM)) { + $obj = new Sessions(); + $obj->hydrate($row); + SessionsPeer::addInstanceToPool($obj, (string) $key); + } + $stmt->closeCursor(); + + return $obj; + } + + /** + * Find object by primary key. + * + * @param mixed $key Primary key to use for the query + * @param PropelPDO $con A connection object + * + * @return Sessions|Sessions[]|mixed the result, formatted by the current formatter + */ + protected function findPkComplex($key, $con) + { + // As the query uses a PK condition, no limit(1) is necessary. + $criteria = $this->isKeepQuery() ? clone $this : $this; + $stmt = $criteria + ->filterByPrimaryKey($key) + ->doSelect($con); + + return $criteria->getFormatter()->init($criteria)->formatOne($stmt); + } + + /** + * Find objects by primary key + * + * $objs = $c->findPks(array(12, 56, 832), $con); + * + * @param array $keys Primary keys to use for the query + * @param PropelPDO $con an optional connection object + * + * @return PropelObjectCollection|Sessions[]|mixed the list of results, formatted by the current formatter + */ + public function findPks($keys, $con = null) + { + if ($con === null) { + $con = Propel::getConnection($this->getDbName(), Propel::CONNECTION_READ); + } + $this->basePreSelect($con); + $criteria = $this->isKeepQuery() ? clone $this : $this; + $stmt = $criteria + ->filterByPrimaryKeys($keys) + ->doSelect($con); + + return $criteria->getFormatter()->init($criteria)->format($stmt); + } + + /** + * Filter the query by primary key + * + * @param mixed $key Primary key to use for the query + * + * @return SessionsQuery The current query, for fluid interface + */ + public function filterByPrimaryKey($key) + { + + return $this->addUsingAlias(SessionsPeer::ID, $key, Criteria::EQUAL); + } + + /** + * Filter the query by a list of primary keys + * + * @param array $keys The list of primary key to use for the query + * + * @return SessionsQuery The current query, for fluid interface + */ + public function filterByPrimaryKeys($keys) + { + + return $this->addUsingAlias(SessionsPeer::ID, $keys, Criteria::IN); + } + + /** + * Filter the query on the id column + * + * Example usage: + * + * $query->filterByDbId('fooValue'); // WHERE id = 'fooValue' + * $query->filterByDbId('%fooValue%'); // WHERE id LIKE '%fooValue%' + * + * + * @param string $dbId The value to use as filter. + * Accepts wildcards (* and % trigger a LIKE) + * @param string $comparison Operator to use for the column comparison, defaults to Criteria::EQUAL + * + * @return SessionsQuery The current query, for fluid interface + */ + public function filterByDbId($dbId = null, $comparison = null) + { + if (null === $comparison) { + if (is_array($dbId)) { + $comparison = Criteria::IN; + } elseif (preg_match('/[\%\*]/', $dbId)) { + $dbId = str_replace('*', '%', $dbId); + $comparison = Criteria::LIKE; + } + } + + return $this->addUsingAlias(SessionsPeer::ID, $dbId, $comparison); + } + + /** + * Filter the query on the modified column + * + * Example usage: + * + * $query->filterByDbModified(1234); // WHERE modified = 1234 + * $query->filterByDbModified(array(12, 34)); // WHERE modified IN (12, 34) + * $query->filterByDbModified(array('min' => 12)); // WHERE modified >= 12 + * $query->filterByDbModified(array('max' => 12)); // WHERE modified <= 12 + * + * + * @param mixed $dbModified The value to use as filter. + * Use scalar values for equality. + * Use array values for in_array() equivalent. + * Use associative array('min' => $minValue, 'max' => $maxValue) for intervals. + * @param string $comparison Operator to use for the column comparison, defaults to Criteria::EQUAL + * + * @return SessionsQuery The current query, for fluid interface + */ + public function filterByDbModified($dbModified = null, $comparison = null) + { + if (is_array($dbModified)) { + $useMinMax = false; + if (isset($dbModified['min'])) { + $this->addUsingAlias(SessionsPeer::MODIFIED, $dbModified['min'], Criteria::GREATER_EQUAL); + $useMinMax = true; + } + if (isset($dbModified['max'])) { + $this->addUsingAlias(SessionsPeer::MODIFIED, $dbModified['max'], Criteria::LESS_EQUAL); + $useMinMax = true; + } + if ($useMinMax) { + return $this; + } + if (null === $comparison) { + $comparison = Criteria::IN; + } + } + + return $this->addUsingAlias(SessionsPeer::MODIFIED, $dbModified, $comparison); + } + + /** + * Filter the query on the lifetime column + * + * Example usage: + * + * $query->filterByDbLifetime(1234); // WHERE lifetime = 1234 + * $query->filterByDbLifetime(array(12, 34)); // WHERE lifetime IN (12, 34) + * $query->filterByDbLifetime(array('min' => 12)); // WHERE lifetime >= 12 + * $query->filterByDbLifetime(array('max' => 12)); // WHERE lifetime <= 12 + * + * + * @param mixed $dbLifetime The value to use as filter. + * Use scalar values for equality. + * Use array values for in_array() equivalent. + * Use associative array('min' => $minValue, 'max' => $maxValue) for intervals. + * @param string $comparison Operator to use for the column comparison, defaults to Criteria::EQUAL + * + * @return SessionsQuery The current query, for fluid interface + */ + public function filterByDbLifetime($dbLifetime = null, $comparison = null) + { + if (is_array($dbLifetime)) { + $useMinMax = false; + if (isset($dbLifetime['min'])) { + $this->addUsingAlias(SessionsPeer::LIFETIME, $dbLifetime['min'], Criteria::GREATER_EQUAL); + $useMinMax = true; + } + if (isset($dbLifetime['max'])) { + $this->addUsingAlias(SessionsPeer::LIFETIME, $dbLifetime['max'], Criteria::LESS_EQUAL); + $useMinMax = true; + } + if ($useMinMax) { + return $this; + } + if (null === $comparison) { + $comparison = Criteria::IN; + } + } + + return $this->addUsingAlias(SessionsPeer::LIFETIME, $dbLifetime, $comparison); + } + + /** + * Filter the query on the data column + * + * Example usage: + * + * $query->filterByDbData('fooValue'); // WHERE data = 'fooValue' + * $query->filterByDbData('%fooValue%'); // WHERE data LIKE '%fooValue%' + * + * + * @param string $dbData The value to use as filter. + * Accepts wildcards (* and % trigger a LIKE) + * @param string $comparison Operator to use for the column comparison, defaults to Criteria::EQUAL + * + * @return SessionsQuery The current query, for fluid interface + */ + public function filterByDbData($dbData = null, $comparison = null) + { + if (null === $comparison) { + if (is_array($dbData)) { + $comparison = Criteria::IN; + } elseif (preg_match('/[\%\*]/', $dbData)) { + $dbData = str_replace('*', '%', $dbData); + $comparison = Criteria::LIKE; + } + } + + return $this->addUsingAlias(SessionsPeer::DATA, $dbData, $comparison); + } + + /** + * Exclude object from result + * + * @param Sessions $sessions Object to remove from the list of results + * + * @return SessionsQuery The current query, for fluid interface + */ + public function prune($sessions = null) + { + if ($sessions) { + $this->addUsingAlias(SessionsPeer::ID, $sessions->getDbId(), Criteria::NOT_EQUAL); + } + + return $this; + } + +} diff --git a/legacy/build/schema.xml b/legacy/build/schema.xml index 8e5beecf0..47dce104a 100644 --- a/legacy/build/schema.xml +++ b/legacy/build/schema.xml @@ -565,4 +565,11 @@ + + + + + + +