916 lines
36 KiB
PHP
916 lines
36 KiB
PHP
<?php
|
|
|
|
namespace Trinity\Bundle\NewsletterBundle\Model\om;
|
|
|
|
use \BasePeer;
|
|
use \Criteria;
|
|
use \PDO;
|
|
use \PDOStatement;
|
|
use \Propel;
|
|
use \PropelException;
|
|
use \PropelPDO;
|
|
use Glorpen\Propel\PropelBundle\Dispatcher\EventDispatcherProxy;
|
|
use Glorpen\Propel\PropelBundle\Events\DetectOMClassEvent;
|
|
use Glorpen\Propel\PropelBundle\Events\PeerEvent;
|
|
use Trinity\Bundle\NewsletterBundle\Model\BlockPeer;
|
|
use Trinity\Bundle\NewsletterBundle\Model\Model;
|
|
use Trinity\Bundle\NewsletterBundle\Model\ModelPeer;
|
|
use Trinity\Bundle\NewsletterBundle\Model\ModelVersionPeer;
|
|
use Trinity\Bundle\NewsletterBundle\Model\map\ModelTableMap;
|
|
|
|
abstract class BaseModelPeer
|
|
{
|
|
|
|
/** the default database name for this class */
|
|
const DATABASE_NAME = 'default';
|
|
|
|
/** the table name for this class */
|
|
const TABLE_NAME = 'nws_model';
|
|
|
|
/** the related Propel class for this table */
|
|
const OM_CLASS = 'Trinity\\Bundle\\NewsletterBundle\\Model\\Model';
|
|
|
|
/** the related TableMap class for this table */
|
|
const TM_CLASS = 'Trinity\\Bundle\\NewsletterBundle\\Model\\map\\ModelTableMap';
|
|
|
|
/** The total number of columns. */
|
|
const NUM_COLUMNS = 9;
|
|
|
|
/** The number of lazy-loaded columns. */
|
|
const NUM_LAZY_LOAD_COLUMNS = 0;
|
|
|
|
/** The number of columns to hydrate (NUM_COLUMNS - NUM_LAZY_LOAD_COLUMNS) */
|
|
const NUM_HYDRATE_COLUMNS = 9;
|
|
|
|
/** the column name for the id field */
|
|
const ID = 'nws_model.id';
|
|
|
|
/** the column name for the name field */
|
|
const NAME = 'nws_model.name';
|
|
|
|
/** the column name for the template field */
|
|
const TEMPLATE = 'nws_model.template';
|
|
|
|
/** the column name for the class_key field */
|
|
const CLASS_KEY = 'nws_model.class_key';
|
|
|
|
/** the column name for the created_at field */
|
|
const CREATED_AT = 'nws_model.created_at';
|
|
|
|
/** the column name for the updated_at field */
|
|
const UPDATED_AT = 'nws_model.updated_at';
|
|
|
|
/** the column name for the version field */
|
|
const VERSION = 'nws_model.version';
|
|
|
|
/** the column name for the version_created_at field */
|
|
const VERSION_CREATED_AT = 'nws_model.version_created_at';
|
|
|
|
/** the column name for the version_created_by field */
|
|
const VERSION_CREATED_BY = 'nws_model.version_created_by';
|
|
|
|
/** The default string format for model objects of the related table **/
|
|
const DEFAULT_STRING_FORMAT = 'YAML';
|
|
|
|
/**
|
|
* An identity map to hold any loaded instances of Model objects.
|
|
* This must be public so that other peer classes can access this when hydrating from JOIN
|
|
* queries.
|
|
* @var array Model[]
|
|
*/
|
|
public static $instances = array();
|
|
|
|
|
|
// versionable behavior
|
|
|
|
/**
|
|
* Whether the versioning is enabled
|
|
*/
|
|
static $isVersioningEnabled = true;
|
|
|
|
/**
|
|
* holds an array of fieldnames
|
|
*
|
|
* first dimension keys are the type constants
|
|
* e.g. ModelPeer::$fieldNames[ModelPeer::TYPE_PHPNAME][0] = 'Id'
|
|
*/
|
|
protected static $fieldNames = array (
|
|
BasePeer::TYPE_PHPNAME => array ('Id', 'Name', 'Template', 'ClassKey', 'CreatedAt', 'UpdatedAt', 'Version', 'VersionCreatedAt', 'VersionCreatedBy', ),
|
|
BasePeer::TYPE_STUDLYPHPNAME => array ('id', 'name', 'template', 'classKey', 'createdAt', 'updatedAt', 'version', 'versionCreatedAt', 'versionCreatedBy', ),
|
|
BasePeer::TYPE_COLNAME => array (ModelPeer::ID, ModelPeer::NAME, ModelPeer::TEMPLATE, ModelPeer::CLASS_KEY, ModelPeer::CREATED_AT, ModelPeer::UPDATED_AT, ModelPeer::VERSION, ModelPeer::VERSION_CREATED_AT, ModelPeer::VERSION_CREATED_BY, ),
|
|
BasePeer::TYPE_RAW_COLNAME => array ('ID', 'NAME', 'TEMPLATE', 'CLASS_KEY', 'CREATED_AT', 'UPDATED_AT', 'VERSION', 'VERSION_CREATED_AT', 'VERSION_CREATED_BY', ),
|
|
BasePeer::TYPE_FIELDNAME => array ('id', 'name', 'template', 'class_key', 'created_at', 'updated_at', 'version', 'version_created_at', 'version_created_by', ),
|
|
BasePeer::TYPE_NUM => array (0, 1, 2, 3, 4, 5, 6, 7, 8, )
|
|
);
|
|
|
|
/**
|
|
* holds an array of keys for quick access to the fieldnames array
|
|
*
|
|
* first dimension keys are the type constants
|
|
* e.g. ModelPeer::$fieldNames[BasePeer::TYPE_PHPNAME]['Id'] = 0
|
|
*/
|
|
protected static $fieldKeys = array (
|
|
BasePeer::TYPE_PHPNAME => array ('Id' => 0, 'Name' => 1, 'Template' => 2, 'ClassKey' => 3, 'CreatedAt' => 4, 'UpdatedAt' => 5, 'Version' => 6, 'VersionCreatedAt' => 7, 'VersionCreatedBy' => 8, ),
|
|
BasePeer::TYPE_STUDLYPHPNAME => array ('id' => 0, 'name' => 1, 'template' => 2, 'classKey' => 3, 'createdAt' => 4, 'updatedAt' => 5, 'version' => 6, 'versionCreatedAt' => 7, 'versionCreatedBy' => 8, ),
|
|
BasePeer::TYPE_COLNAME => array (ModelPeer::ID => 0, ModelPeer::NAME => 1, ModelPeer::TEMPLATE => 2, ModelPeer::CLASS_KEY => 3, ModelPeer::CREATED_AT => 4, ModelPeer::UPDATED_AT => 5, ModelPeer::VERSION => 6, ModelPeer::VERSION_CREATED_AT => 7, ModelPeer::VERSION_CREATED_BY => 8, ),
|
|
BasePeer::TYPE_RAW_COLNAME => array ('ID' => 0, 'NAME' => 1, 'TEMPLATE' => 2, 'CLASS_KEY' => 3, 'CREATED_AT' => 4, 'UPDATED_AT' => 5, 'VERSION' => 6, 'VERSION_CREATED_AT' => 7, 'VERSION_CREATED_BY' => 8, ),
|
|
BasePeer::TYPE_FIELDNAME => array ('id' => 0, 'name' => 1, 'template' => 2, 'class_key' => 3, 'created_at' => 4, 'updated_at' => 5, 'version' => 6, 'version_created_at' => 7, 'version_created_by' => 8, ),
|
|
BasePeer::TYPE_NUM => array (0, 1, 2, 3, 4, 5, 6, 7, 8, )
|
|
);
|
|
|
|
/**
|
|
* 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 = ModelPeer::getFieldNames($toType);
|
|
$key = isset(ModelPeer::$fieldKeys[$fromType][$name]) ? ModelPeer::$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(ModelPeer::$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, ModelPeer::$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 ModelPeer::$fieldNames[$type];
|
|
}
|
|
|
|
/**
|
|
* Convenience method which changes table.column to alias.column.
|
|
*
|
|
* Using this method you can maintain SQL abstraction while using column aliases.
|
|
* <code>
|
|
* $c->addAlias("alias1", TablePeer::TABLE_NAME);
|
|
* $c->addJoin(TablePeer::alias("alias1", TablePeer::PRIMARY_KEY_COLUMN), TablePeer::PRIMARY_KEY_COLUMN);
|
|
* </code>
|
|
* @param string $alias The alias for the current table.
|
|
* @param string $column The column name for current table. (i.e. ModelPeer::COLUMN_NAME).
|
|
* @return string
|
|
*/
|
|
public static function alias($alias, $column)
|
|
{
|
|
return str_replace(ModelPeer::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(ModelPeer::ID);
|
|
$criteria->addSelectColumn(ModelPeer::NAME);
|
|
$criteria->addSelectColumn(ModelPeer::TEMPLATE);
|
|
$criteria->addSelectColumn(ModelPeer::CLASS_KEY);
|
|
$criteria->addSelectColumn(ModelPeer::CREATED_AT);
|
|
$criteria->addSelectColumn(ModelPeer::UPDATED_AT);
|
|
$criteria->addSelectColumn(ModelPeer::VERSION);
|
|
$criteria->addSelectColumn(ModelPeer::VERSION_CREATED_AT);
|
|
$criteria->addSelectColumn(ModelPeer::VERSION_CREATED_BY);
|
|
} else {
|
|
$criteria->addSelectColumn($alias . '.id');
|
|
$criteria->addSelectColumn($alias . '.name');
|
|
$criteria->addSelectColumn($alias . '.template');
|
|
$criteria->addSelectColumn($alias . '.class_key');
|
|
$criteria->addSelectColumn($alias . '.created_at');
|
|
$criteria->addSelectColumn($alias . '.updated_at');
|
|
$criteria->addSelectColumn($alias . '.version');
|
|
$criteria->addSelectColumn($alias . '.version_created_at');
|
|
$criteria->addSelectColumn($alias . '.version_created_by');
|
|
}
|
|
}
|
|
|
|
/**
|
|
* 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(ModelPeer::TABLE_NAME);
|
|
|
|
if ($distinct && !in_array(Criteria::DISTINCT, $criteria->getSelectModifiers())) {
|
|
$criteria->setDistinct();
|
|
}
|
|
|
|
if (!$criteria->hasSelectClause()) {
|
|
ModelPeer::addSelectColumns($criteria);
|
|
}
|
|
|
|
$criteria->clearOrderByColumns(); // ORDER BY won't ever affect the count
|
|
$criteria->setDbName(ModelPeer::DATABASE_NAME); // Set the correct dbName
|
|
|
|
if ($con === null) {
|
|
$con = Propel::getConnection(ModelPeer::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 Model
|
|
* @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 = ModelPeer::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 ModelPeer::populateObjects(ModelPeer::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(ModelPeer::DATABASE_NAME, Propel::CONNECTION_READ);
|
|
}
|
|
|
|
if (!$criteria->hasSelectClause()) {
|
|
$criteria = clone $criteria;
|
|
ModelPeer::addSelectColumns($criteria);
|
|
}
|
|
|
|
// Set the correct dbName
|
|
$criteria->setDbName(ModelPeer::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 Model $obj A Model 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->getId();
|
|
} // if key === null
|
|
ModelPeer::$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 Model 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 Model) {
|
|
$key = (string) $value->getId();
|
|
} 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 Model object; got " . (is_object($value) ? get_class($value) . ' object.' : var_export($value,true)));
|
|
throw $e;
|
|
}
|
|
|
|
unset(ModelPeer::$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 Model 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(ModelPeer::$instances[$key])) {
|
|
return ModelPeer::$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 (ModelPeer::$instances as $instance) {
|
|
$instance->clearAllReferences(true);
|
|
}
|
|
}
|
|
ModelPeer::$instances = array();
|
|
}
|
|
|
|
/**
|
|
* Method to invalidate the instance pool of all tables related to nws_model
|
|
* by a foreign key with ON DELETE CASCADE
|
|
*/
|
|
public static function clearRelatedInstancePool()
|
|
{
|
|
// Invalidate objects in BlockPeer instance pool,
|
|
// since one or more of them may be deleted by ON DELETE CASCADE/SETNULL rule.
|
|
BlockPeer::clearInstancePool();
|
|
// Invalidate objects in ModelVersionPeer instance pool,
|
|
// since one or more of them may be deleted by ON DELETE CASCADE/SETNULL rule.
|
|
ModelVersionPeer::clearInstancePool();
|
|
}
|
|
|
|
/**
|
|
* 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 (int) $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();
|
|
|
|
// populate the object(s)
|
|
while ($row = $stmt->fetch(PDO::FETCH_NUM)) {
|
|
$key = ModelPeer::getPrimaryKeyHashFromRow($row, 0);
|
|
if (null !== ($obj = ModelPeer::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 {
|
|
// class must be set each time from the record row
|
|
$cls = ModelPeer::getOMClass($row, 0);
|
|
$cls = substr('.'.$cls, strrpos('.'.$cls, '.') + 1);
|
|
$obj = new $cls();
|
|
$obj->hydrate($row);
|
|
$results[] = $obj;
|
|
ModelPeer::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 (Model object, last column rank)
|
|
*/
|
|
public static function populateObject($row, $startcol = 0)
|
|
{
|
|
$key = ModelPeer::getPrimaryKeyHashFromRow($row, $startcol);
|
|
if (null !== ($obj = ModelPeer::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 + ModelPeer::NUM_HYDRATE_COLUMNS;
|
|
} else {
|
|
$cls = ModelPeer::getOMClass($row, $startcol);
|
|
$obj = new $cls();
|
|
$col = $obj->hydrate($row, $startcol);
|
|
ModelPeer::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(ModelPeer::DATABASE_NAME)->getTable(ModelPeer::TABLE_NAME);
|
|
}
|
|
|
|
/**
|
|
* Add a TableMap instance to the database for this peer class.
|
|
*/
|
|
public static function buildTableMap()
|
|
{
|
|
$dbMap = Propel::getDatabaseMap(BaseModelPeer::DATABASE_NAME);
|
|
if (!$dbMap->hasTable(BaseModelPeer::TABLE_NAME)) {
|
|
$dbMap->addTableObject(new \Trinity\Bundle\NewsletterBundle\Model\map\ModelTableMap());
|
|
}
|
|
}
|
|
|
|
/**
|
|
* The returned Class will contain objects of the default type or
|
|
* objects that inherit from the default.
|
|
*
|
|
* @param array $row PropelPDO result row.
|
|
* @param int $colnum Column to examine for OM class information (first is 0).
|
|
* @throws PropelException Any exceptions caught during processing will be
|
|
* rethrown wrapped into a PropelException.
|
|
*/
|
|
public static function getOMClass($row = 0, $colnum = 0)
|
|
{
|
|
try {
|
|
|
|
$omClass = $row[$colnum + 3];
|
|
$omClass = substr('.'.$omClass, strrpos('.'.$omClass, '.') + 1);
|
|
|
|
} catch (Exception $e) {
|
|
throw new PropelException('Unable to get OM class.', $e);
|
|
}
|
|
|
|
|
|
$event = new DetectOMClassEvent($omClass);
|
|
EventDispatcherProxy::trigger('om.detect', $event);
|
|
if($event->isDetected()){
|
|
return $event->getDetectedClass();
|
|
}
|
|
|
|
return $omClass;
|
|
}
|
|
|
|
/**
|
|
* Performs an INSERT on the database, given a Model or Criteria object.
|
|
*
|
|
* @param mixed $values Criteria or Model 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(ModelPeer::DATABASE_NAME, Propel::CONNECTION_WRITE);
|
|
}
|
|
|
|
if ($values instanceof Criteria) {
|
|
$criteria = clone $values; // rename for clarity
|
|
} else {
|
|
$criteria = $values->buildCriteria(); // build Criteria from Model object
|
|
}
|
|
|
|
if ($criteria->containsKey(ModelPeer::ID) && $criteria->keyContainsValue(ModelPeer::ID) ) {
|
|
throw new PropelException('Cannot insert a value for auto-increment primary key ('.ModelPeer::ID.')');
|
|
}
|
|
|
|
|
|
// Set the correct dbName
|
|
$criteria->setDbName(ModelPeer::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 Model or Criteria object.
|
|
*
|
|
* @param mixed $values Criteria or Model 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(ModelPeer::DATABASE_NAME, Propel::CONNECTION_WRITE);
|
|
}
|
|
|
|
$selectCriteria = new Criteria(ModelPeer::DATABASE_NAME);
|
|
|
|
if ($values instanceof Criteria) {
|
|
$criteria = clone $values; // rename for clarity
|
|
|
|
$comparison = $criteria->getComparison(ModelPeer::ID);
|
|
$value = $criteria->remove(ModelPeer::ID);
|
|
if ($value) {
|
|
$selectCriteria->add(ModelPeer::ID, $value, $comparison);
|
|
} else {
|
|
$selectCriteria->setPrimaryTableName(ModelPeer::TABLE_NAME);
|
|
}
|
|
|
|
} else { // $values is Model object
|
|
$criteria = $values->buildCriteria(); // gets full criteria
|
|
$selectCriteria = $values->buildPkeyCriteria(); // gets criteria w/ primary key(s)
|
|
}
|
|
|
|
// set the correct dbName
|
|
$criteria->setDbName(ModelPeer::DATABASE_NAME);
|
|
|
|
return BasePeer::doUpdate($selectCriteria, $criteria, $con);
|
|
}
|
|
|
|
/**
|
|
* Deletes all rows from the nws_model 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(ModelPeer::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 += ModelPeer::doOnDeleteCascade(new Criteria(ModelPeer::DATABASE_NAME), $con);
|
|
$affectedRows += BasePeer::doDeleteAll(ModelPeer::TABLE_NAME, $con, ModelPeer::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).
|
|
ModelPeer::clearInstancePool();
|
|
ModelPeer::clearRelatedInstancePool();
|
|
$con->commit();
|
|
|
|
return $affectedRows;
|
|
} catch (Exception $e) {
|
|
$con->rollBack();
|
|
throw $e;
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Performs a DELETE on the database, given a Model or Criteria object OR a primary key value.
|
|
*
|
|
* @param mixed $values Criteria or Model 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(ModelPeer::DATABASE_NAME, Propel::CONNECTION_WRITE);
|
|
}
|
|
|
|
if ($values instanceof Criteria) {
|
|
// rename for clarity
|
|
$criteria = clone $values;
|
|
} elseif ($values instanceof Model) { // it's a model object
|
|
// create criteria based on pk values
|
|
$criteria = $values->buildPkeyCriteria();
|
|
} else { // it's a primary key, or an array of pks
|
|
$criteria = new Criteria(ModelPeer::DATABASE_NAME);
|
|
$criteria->add(ModelPeer::ID, (array) $values, Criteria::IN);
|
|
}
|
|
|
|
// Set the correct dbName
|
|
$criteria->setDbName(ModelPeer::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();
|
|
|
|
// cloning the Criteria in case it's modified by doSelect() or doSelectStmt()
|
|
$c = clone $criteria;
|
|
$affectedRows += ModelPeer::doOnDeleteCascade($c, $con);
|
|
|
|
// 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).
|
|
if ($values instanceof Criteria) {
|
|
ModelPeer::clearInstancePool();
|
|
} elseif ($values instanceof Model) { // it's a model object
|
|
ModelPeer::removeInstanceFromPool($values);
|
|
} else { // it's a primary key, or an array of pks
|
|
foreach ((array) $values as $singleval) {
|
|
ModelPeer::removeInstanceFromPool($singleval);
|
|
}
|
|
}
|
|
|
|
$affectedRows += BasePeer::doDelete($criteria, $con);
|
|
ModelPeer::clearRelatedInstancePool();
|
|
$con->commit();
|
|
|
|
return $affectedRows;
|
|
} catch (Exception $e) {
|
|
$con->rollBack();
|
|
throw $e;
|
|
}
|
|
}
|
|
|
|
/**
|
|
* This is a method for emulating ON DELETE CASCADE for DBs that don't support this
|
|
* feature (like MySQL or SQLite).
|
|
*
|
|
* This method is not very speedy because it must perform a query first to get
|
|
* the implicated records and then perform the deletes by calling those Peer classes.
|
|
*
|
|
* This method should be used within a transaction if possible.
|
|
*
|
|
* @param Criteria $criteria
|
|
* @param PropelPDO $con
|
|
* @return int The number of affected rows (if supported by underlying database driver).
|
|
*/
|
|
protected static function doOnDeleteCascade(Criteria $criteria, PropelPDO $con)
|
|
{
|
|
// initialize var to track total num of affected rows
|
|
$affectedRows = 0;
|
|
|
|
// first find the objects that are implicated by the $criteria
|
|
$objects = ModelPeer::doSelect($criteria, $con);
|
|
foreach ($objects as $obj) {
|
|
|
|
|
|
// delete related Block objects
|
|
$criteria = new Criteria(BlockPeer::DATABASE_NAME);
|
|
|
|
$criteria->add(BlockPeer::MODEL_ID, $obj->getId());
|
|
$affectedRows += BlockPeer::doDelete($criteria, $con);
|
|
|
|
// delete related ModelVersion objects
|
|
$criteria = new Criteria(ModelVersionPeer::DATABASE_NAME);
|
|
|
|
$criteria->add(ModelVersionPeer::ID, $obj->getId());
|
|
$affectedRows += ModelVersionPeer::doDelete($criteria, $con);
|
|
}
|
|
|
|
return $affectedRows;
|
|
}
|
|
|
|
/**
|
|
* Validates all modified columns of given Model 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 Model $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(ModelPeer::DATABASE_NAME);
|
|
$tableMap = $dbMap->getTable(ModelPeer::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(ModelPeer::DATABASE_NAME, ModelPeer::TABLE_NAME, $columns);
|
|
}
|
|
|
|
/**
|
|
* Retrieve a single object by pkey.
|
|
*
|
|
* @param int $pk the primary key.
|
|
* @param PropelPDO $con the connection to use
|
|
* @return Model
|
|
*/
|
|
public static function retrieveByPK($pk, PropelPDO $con = null)
|
|
{
|
|
|
|
if (null !== ($obj = ModelPeer::getInstanceFromPool((string) $pk))) {
|
|
return $obj;
|
|
}
|
|
|
|
if ($con === null) {
|
|
$con = Propel::getConnection(ModelPeer::DATABASE_NAME, Propel::CONNECTION_READ);
|
|
}
|
|
|
|
$criteria = new Criteria(ModelPeer::DATABASE_NAME);
|
|
$criteria->add(ModelPeer::ID, $pk);
|
|
|
|
$v = ModelPeer::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 Model[]
|
|
* @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(ModelPeer::DATABASE_NAME, Propel::CONNECTION_READ);
|
|
}
|
|
|
|
$objs = null;
|
|
if (empty($pks)) {
|
|
$objs = array();
|
|
} else {
|
|
$criteria = new Criteria(ModelPeer::DATABASE_NAME);
|
|
$criteria->add(ModelPeer::ID, $pks, Criteria::IN);
|
|
$objs = ModelPeer::doSelect($criteria, $con);
|
|
}
|
|
|
|
return $objs;
|
|
}
|
|
|
|
// versionable behavior
|
|
|
|
/**
|
|
* Checks whether versioning is enabled
|
|
*
|
|
* @return boolean
|
|
*/
|
|
public static function isVersioningEnabled()
|
|
{
|
|
return self::$isVersioningEnabled;
|
|
}
|
|
|
|
/**
|
|
* Enables versioning
|
|
*/
|
|
public static function enableVersioning()
|
|
{
|
|
self::$isVersioningEnabled = true;
|
|
}
|
|
|
|
/**
|
|
* Disables versioning
|
|
*/
|
|
public static function disableVersioning()
|
|
{
|
|
self::$isVersioningEnabled = false;
|
|
}
|
|
|
|
} // BaseModelPeer
|
|
|
|
// This is the static code needed to register the TableMap for this table with the main Propel class.
|
|
//
|
|
BaseModelPeer::buildTableMap();
|
|
|
|
EventDispatcherProxy::trigger(array('construct','peer.construct'), new PeerEvent('Trinity\Bundle\NewsletterBundle\Model\om\BaseModelPeer'));
|