deblan.tv/vendor/trinity/src/Trinity/Bundle/NewsletterBundle/Model/om/BaseNewsletterPeer.php
2015-03-02 21:57:49 +01:00

1054 lines
42 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\ModelPeer;
use Trinity\Bundle\NewsletterBundle\Model\Newsletter;
use Trinity\Bundle\NewsletterBundle\Model\NewsletterPeer;
use Trinity\Bundle\NewsletterBundle\Model\map\NewsletterTableMap;
abstract class BaseNewsletterPeer
{
/** the default database name for this class */
const DATABASE_NAME = 'default';
/** the table name for this class */
const TABLE_NAME = 'nws_newsletter';
/** the related Propel class for this table */
const OM_CLASS = 'Trinity\\Bundle\\NewsletterBundle\\Model\\Newsletter';
/** the related TableMap class for this table */
const TM_CLASS = 'Trinity\\Bundle\\NewsletterBundle\\Model\\map\\NewsletterTableMap';
/** 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_newsletter.id';
/** the column name for the name field */
const NAME = 'nws_newsletter.name';
/** the column name for the sender_name field */
const SENDER_NAME = 'nws_newsletter.sender_name';
/** the column name for the sender_email field */
const SENDER_EMAIL = 'nws_newsletter.sender_email';
/** the column name for the model_id field */
const MODEL_ID = 'nws_newsletter.model_id';
/** the column name for the email_listing field */
const EMAIL_LISTING = 'nws_newsletter.email_listing';
/** the column name for the sent_at field */
const SENT_AT = 'nws_newsletter.sent_at';
/** the column name for the created_at field */
const CREATED_AT = 'nws_newsletter.created_at';
/** the column name for the updated_at field */
const UPDATED_AT = 'nws_newsletter.updated_at';
/** 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 Newsletter objects.
* This must be public so that other peer classes can access this when hydrating from JOIN
* queries.
* @var array Newsletter[]
*/
public static $instances = array();
/**
* holds an array of fieldnames
*
* first dimension keys are the type constants
* e.g. NewsletterPeer::$fieldNames[NewsletterPeer::TYPE_PHPNAME][0] = 'Id'
*/
protected static $fieldNames = array (
BasePeer::TYPE_PHPNAME => array ('Id', 'Name', 'SenderName', 'SenderEmail', 'ModelId', 'EmailListing', 'SentAt', 'CreatedAt', 'UpdatedAt', ),
BasePeer::TYPE_STUDLYPHPNAME => array ('id', 'name', 'senderName', 'senderEmail', 'modelId', 'emailListing', 'sentAt', 'createdAt', 'updatedAt', ),
BasePeer::TYPE_COLNAME => array (NewsletterPeer::ID, NewsletterPeer::NAME, NewsletterPeer::SENDER_NAME, NewsletterPeer::SENDER_EMAIL, NewsletterPeer::MODEL_ID, NewsletterPeer::EMAIL_LISTING, NewsletterPeer::SENT_AT, NewsletterPeer::CREATED_AT, NewsletterPeer::UPDATED_AT, ),
BasePeer::TYPE_RAW_COLNAME => array ('ID', 'NAME', 'SENDER_NAME', 'SENDER_EMAIL', 'MODEL_ID', 'EMAIL_LISTING', 'SENT_AT', 'CREATED_AT', 'UPDATED_AT', ),
BasePeer::TYPE_FIELDNAME => array ('id', 'name', 'sender_name', 'sender_email', 'model_id', 'email_listing', 'sent_at', 'created_at', 'updated_at', ),
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. NewsletterPeer::$fieldNames[BasePeer::TYPE_PHPNAME]['Id'] = 0
*/
protected static $fieldKeys = array (
BasePeer::TYPE_PHPNAME => array ('Id' => 0, 'Name' => 1, 'SenderName' => 2, 'SenderEmail' => 3, 'ModelId' => 4, 'EmailListing' => 5, 'SentAt' => 6, 'CreatedAt' => 7, 'UpdatedAt' => 8, ),
BasePeer::TYPE_STUDLYPHPNAME => array ('id' => 0, 'name' => 1, 'senderName' => 2, 'senderEmail' => 3, 'modelId' => 4, 'emailListing' => 5, 'sentAt' => 6, 'createdAt' => 7, 'updatedAt' => 8, ),
BasePeer::TYPE_COLNAME => array (NewsletterPeer::ID => 0, NewsletterPeer::NAME => 1, NewsletterPeer::SENDER_NAME => 2, NewsletterPeer::SENDER_EMAIL => 3, NewsletterPeer::MODEL_ID => 4, NewsletterPeer::EMAIL_LISTING => 5, NewsletterPeer::SENT_AT => 6, NewsletterPeer::CREATED_AT => 7, NewsletterPeer::UPDATED_AT => 8, ),
BasePeer::TYPE_RAW_COLNAME => array ('ID' => 0, 'NAME' => 1, 'SENDER_NAME' => 2, 'SENDER_EMAIL' => 3, 'MODEL_ID' => 4, 'EMAIL_LISTING' => 5, 'SENT_AT' => 6, 'CREATED_AT' => 7, 'UPDATED_AT' => 8, ),
BasePeer::TYPE_FIELDNAME => array ('id' => 0, 'name' => 1, 'sender_name' => 2, 'sender_email' => 3, 'model_id' => 4, 'email_listing' => 5, 'sent_at' => 6, 'created_at' => 7, 'updated_at' => 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 = NewsletterPeer::getFieldNames($toType);
$key = isset(NewsletterPeer::$fieldKeys[$fromType][$name]) ? NewsletterPeer::$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(NewsletterPeer::$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, NewsletterPeer::$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 NewsletterPeer::$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. NewsletterPeer::COLUMN_NAME).
* @return string
*/
public static function alias($alias, $column)
{
return str_replace(NewsletterPeer::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(NewsletterPeer::ID);
$criteria->addSelectColumn(NewsletterPeer::NAME);
$criteria->addSelectColumn(NewsletterPeer::SENDER_NAME);
$criteria->addSelectColumn(NewsletterPeer::SENDER_EMAIL);
$criteria->addSelectColumn(NewsletterPeer::MODEL_ID);
$criteria->addSelectColumn(NewsletterPeer::EMAIL_LISTING);
$criteria->addSelectColumn(NewsletterPeer::SENT_AT);
$criteria->addSelectColumn(NewsletterPeer::CREATED_AT);
$criteria->addSelectColumn(NewsletterPeer::UPDATED_AT);
} else {
$criteria->addSelectColumn($alias . '.id');
$criteria->addSelectColumn($alias . '.name');
$criteria->addSelectColumn($alias . '.sender_name');
$criteria->addSelectColumn($alias . '.sender_email');
$criteria->addSelectColumn($alias . '.model_id');
$criteria->addSelectColumn($alias . '.email_listing');
$criteria->addSelectColumn($alias . '.sent_at');
$criteria->addSelectColumn($alias . '.created_at');
$criteria->addSelectColumn($alias . '.updated_at');
}
}
/**
* 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(NewsletterPeer::TABLE_NAME);
if ($distinct && !in_array(Criteria::DISTINCT, $criteria->getSelectModifiers())) {
$criteria->setDistinct();
}
if (!$criteria->hasSelectClause()) {
NewsletterPeer::addSelectColumns($criteria);
}
$criteria->clearOrderByColumns(); // ORDER BY won't ever affect the count
$criteria->setDbName(NewsletterPeer::DATABASE_NAME); // Set the correct dbName
if ($con === null) {
$con = Propel::getConnection(NewsletterPeer::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 Newsletter
* @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 = NewsletterPeer::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 NewsletterPeer::populateObjects(NewsletterPeer::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(NewsletterPeer::DATABASE_NAME, Propel::CONNECTION_READ);
}
if (!$criteria->hasSelectClause()) {
$criteria = clone $criteria;
NewsletterPeer::addSelectColumns($criteria);
}
// Set the correct dbName
$criteria->setDbName(NewsletterPeer::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 Newsletter $obj A Newsletter 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
NewsletterPeer::$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 Newsletter 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 Newsletter) {
$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 Newsletter object; got " . (is_object($value) ? get_class($value) . ' object.' : var_export($value,true)));
throw $e;
}
unset(NewsletterPeer::$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 Newsletter 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(NewsletterPeer::$instances[$key])) {
return NewsletterPeer::$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 (NewsletterPeer::$instances as $instance) {
$instance->clearAllReferences(true);
}
}
NewsletterPeer::$instances = array();
}
/**
* Method to invalidate the instance pool of all tables related to nws_newsletter
* 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 (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();
// set the class once to avoid overhead in the loop
$cls = NewsletterPeer::getOMClass();
// populate the object(s)
while ($row = $stmt->fetch(PDO::FETCH_NUM)) {
$key = NewsletterPeer::getPrimaryKeyHashFromRow($row, 0);
if (null !== ($obj = NewsletterPeer::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;
NewsletterPeer::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 (Newsletter object, last column rank)
*/
public static function populateObject($row, $startcol = 0)
{
$key = NewsletterPeer::getPrimaryKeyHashFromRow($row, $startcol);
if (null !== ($obj = NewsletterPeer::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 + NewsletterPeer::NUM_HYDRATE_COLUMNS;
} else {
$cls = NewsletterPeer::getOMClass($row, $startcol);
$obj = new $cls();
$col = $obj->hydrate($row, $startcol);
NewsletterPeer::addInstanceToPool($obj, $key);
}
return array($obj, $col);
}
/**
* Returns the number of rows matching criteria, joining the related Model table
*
* @param Criteria $criteria
* @param boolean $distinct Whether to select only distinct columns; deprecated: use Criteria->setDistinct() instead.
* @param PropelPDO $con
* @param String $join_behavior the type of joins to use, defaults to Criteria::LEFT_JOIN
* @return int Number of matching rows.
*/
public static function doCountJoinModel(Criteria $criteria, $distinct = false, PropelPDO $con = null, $join_behavior = Criteria::LEFT_JOIN)
{
// we're going to 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(NewsletterPeer::TABLE_NAME);
if ($distinct && !in_array(Criteria::DISTINCT, $criteria->getSelectModifiers())) {
$criteria->setDistinct();
}
if (!$criteria->hasSelectClause()) {
NewsletterPeer::addSelectColumns($criteria);
}
$criteria->clearOrderByColumns(); // ORDER BY won't ever affect the count
// Set the correct dbName
$criteria->setDbName(NewsletterPeer::DATABASE_NAME);
if ($con === null) {
$con = Propel::getConnection(NewsletterPeer::DATABASE_NAME, Propel::CONNECTION_READ);
}
$criteria->addJoin(NewsletterPeer::MODEL_ID, ModelPeer::ID, $join_behavior);
$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 a collection of Newsletter objects pre-filled with their Model objects.
* @param Criteria $criteria
* @param PropelPDO $con
* @param String $join_behavior the type of joins to use, defaults to Criteria::LEFT_JOIN
* @return array Array of Newsletter objects.
* @throws PropelException Any exceptions caught during processing will be
* rethrown wrapped into a PropelException.
*/
public static function doSelectJoinModel(Criteria $criteria, $con = null, $join_behavior = Criteria::LEFT_JOIN)
{
$criteria = clone $criteria;
// Set the correct dbName if it has not been overridden
if ($criteria->getDbName() == Propel::getDefaultDB()) {
$criteria->setDbName(NewsletterPeer::DATABASE_NAME);
}
NewsletterPeer::addSelectColumns($criteria);
$startcol = NewsletterPeer::NUM_HYDRATE_COLUMNS;
ModelPeer::addSelectColumns($criteria);
$criteria->addJoin(NewsletterPeer::MODEL_ID, ModelPeer::ID, $join_behavior);
$stmt = BasePeer::doSelect($criteria, $con);
$results = array();
while ($row = $stmt->fetch(PDO::FETCH_NUM)) {
$key1 = NewsletterPeer::getPrimaryKeyHashFromRow($row, 0);
if (null !== ($obj1 = NewsletterPeer::getInstanceFromPool($key1))) {
// We no longer rehydrate the object, since this can cause data loss.
// See http://www.propelorm.org/ticket/509
// $obj1->hydrate($row, 0, true); // rehydrate
} else {
$cls = NewsletterPeer::getOMClass();
$obj1 = new $cls();
$obj1->hydrate($row);
NewsletterPeer::addInstanceToPool($obj1, $key1);
} // if $obj1 already loaded
$key2 = ModelPeer::getPrimaryKeyHashFromRow($row, $startcol);
if ($key2 !== null) {
$obj2 = ModelPeer::getInstanceFromPool($key2);
if (!$obj2) {
$omClass = ModelPeer::getOMClass($row, $startcol);
$cls = substr('.'.$omClass, strrpos('.'.$omClass, '.') + 1);
$obj2 = new $cls();
$obj2->hydrate($row, $startcol);
ModelPeer::addInstanceToPool($obj2, $key2);
} // if obj2 already loaded
// Add the $obj1 (Newsletter) to $obj2 (Model)
$obj2->addNewsletter($obj1);
} // if joined row was not null
$results[] = $obj1;
}
$stmt->closeCursor();
return $results;
}
/**
* Returns the number of rows matching criteria, joining all related tables
*
* @param Criteria $criteria
* @param boolean $distinct Whether to select only distinct columns; deprecated: use Criteria->setDistinct() instead.
* @param PropelPDO $con
* @param String $join_behavior the type of joins to use, defaults to Criteria::LEFT_JOIN
* @return int Number of matching rows.
*/
public static function doCountJoinAll(Criteria $criteria, $distinct = false, PropelPDO $con = null, $join_behavior = Criteria::LEFT_JOIN)
{
// we're going to 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(NewsletterPeer::TABLE_NAME);
if ($distinct && !in_array(Criteria::DISTINCT, $criteria->getSelectModifiers())) {
$criteria->setDistinct();
}
if (!$criteria->hasSelectClause()) {
NewsletterPeer::addSelectColumns($criteria);
}
$criteria->clearOrderByColumns(); // ORDER BY won't ever affect the count
// Set the correct dbName
$criteria->setDbName(NewsletterPeer::DATABASE_NAME);
if ($con === null) {
$con = Propel::getConnection(NewsletterPeer::DATABASE_NAME, Propel::CONNECTION_READ);
}
$criteria->addJoin(NewsletterPeer::MODEL_ID, ModelPeer::ID, $join_behavior);
$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 a collection of Newsletter objects pre-filled with all related objects.
*
* @param Criteria $criteria
* @param PropelPDO $con
* @param String $join_behavior the type of joins to use, defaults to Criteria::LEFT_JOIN
* @return array Array of Newsletter objects.
* @throws PropelException Any exceptions caught during processing will be
* rethrown wrapped into a PropelException.
*/
public static function doSelectJoinAll(Criteria $criteria, $con = null, $join_behavior = Criteria::LEFT_JOIN)
{
$criteria = clone $criteria;
// Set the correct dbName if it has not been overridden
if ($criteria->getDbName() == Propel::getDefaultDB()) {
$criteria->setDbName(NewsletterPeer::DATABASE_NAME);
}
NewsletterPeer::addSelectColumns($criteria);
$startcol2 = NewsletterPeer::NUM_HYDRATE_COLUMNS;
ModelPeer::addSelectColumns($criteria);
$startcol3 = $startcol2 + ModelPeer::NUM_HYDRATE_COLUMNS;
$criteria->addJoin(NewsletterPeer::MODEL_ID, ModelPeer::ID, $join_behavior);
$stmt = BasePeer::doSelect($criteria, $con);
$results = array();
while ($row = $stmt->fetch(PDO::FETCH_NUM)) {
$key1 = NewsletterPeer::getPrimaryKeyHashFromRow($row, 0);
if (null !== ($obj1 = NewsletterPeer::getInstanceFromPool($key1))) {
// We no longer rehydrate the object, since this can cause data loss.
// See http://www.propelorm.org/ticket/509
// $obj1->hydrate($row, 0, true); // rehydrate
} else {
$cls = NewsletterPeer::getOMClass();
$obj1 = new $cls();
$obj1->hydrate($row);
NewsletterPeer::addInstanceToPool($obj1, $key1);
} // if obj1 already loaded
// Add objects for joined Model rows
$key2 = ModelPeer::getPrimaryKeyHashFromRow($row, $startcol2);
if ($key2 !== null) {
$obj2 = ModelPeer::getInstanceFromPool($key2);
if (!$obj2) {
$omClass = ModelPeer::getOMClass($row, $startcol2);
$cls = substr('.'.$omClass, strrpos('.'.$omClass, '.') + 1);
$obj2 = new $cls();
$obj2->hydrate($row, $startcol2);
ModelPeer::addInstanceToPool($obj2, $key2);
} // if obj2 loaded
// Add the $obj1 (Newsletter) to the collection in $obj2 (Model)
$obj2->addNewsletter($obj1);
} // if joined row not null
$results[] = $obj1;
}
$stmt->closeCursor();
return $results;
}
/**
* 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(NewsletterPeer::DATABASE_NAME)->getTable(NewsletterPeer::TABLE_NAME);
}
/**
* Add a TableMap instance to the database for this peer class.
*/
public static function buildTableMap()
{
$dbMap = Propel::getDatabaseMap(BaseNewsletterPeer::DATABASE_NAME);
if (!$dbMap->hasTable(BaseNewsletterPeer::TABLE_NAME)) {
$dbMap->addTableObject(new \Trinity\Bundle\NewsletterBundle\Model\map\NewsletterTableMap());
}
}
/**
* The class that the Peer will make instances of.
*
*
* @return string ClassName
*/
public static function getOMClass($row = 0, $colnum = 0)
{
$event = new DetectOMClassEvent(NewsletterPeer::OM_CLASS);
EventDispatcherProxy::trigger('om.detect', $event);
if($event->isDetected()){
return $event->getDetectedClass();
}
return NewsletterPeer::OM_CLASS;
}
/**
* Performs an INSERT on the database, given a Newsletter or Criteria object.
*
* @param mixed $values Criteria or Newsletter 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(NewsletterPeer::DATABASE_NAME, Propel::CONNECTION_WRITE);
}
if ($values instanceof Criteria) {
$criteria = clone $values; // rename for clarity
} else {
$criteria = $values->buildCriteria(); // build Criteria from Newsletter object
}
if ($criteria->containsKey(NewsletterPeer::ID) && $criteria->keyContainsValue(NewsletterPeer::ID) ) {
throw new PropelException('Cannot insert a value for auto-increment primary key ('.NewsletterPeer::ID.')');
}
// Set the correct dbName
$criteria->setDbName(NewsletterPeer::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 Newsletter or Criteria object.
*
* @param mixed $values Criteria or Newsletter 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(NewsletterPeer::DATABASE_NAME, Propel::CONNECTION_WRITE);
}
$selectCriteria = new Criteria(NewsletterPeer::DATABASE_NAME);
if ($values instanceof Criteria) {
$criteria = clone $values; // rename for clarity
$comparison = $criteria->getComparison(NewsletterPeer::ID);
$value = $criteria->remove(NewsletterPeer::ID);
if ($value) {
$selectCriteria->add(NewsletterPeer::ID, $value, $comparison);
} else {
$selectCriteria->setPrimaryTableName(NewsletterPeer::TABLE_NAME);
}
} else { // $values is Newsletter object
$criteria = $values->buildCriteria(); // gets full criteria
$selectCriteria = $values->buildPkeyCriteria(); // gets criteria w/ primary key(s)
}
// set the correct dbName
$criteria->setDbName(NewsletterPeer::DATABASE_NAME);
return BasePeer::doUpdate($selectCriteria, $criteria, $con);
}
/**
* Deletes all rows from the nws_newsletter 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(NewsletterPeer::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(NewsletterPeer::TABLE_NAME, $con, NewsletterPeer::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).
NewsletterPeer::clearInstancePool();
NewsletterPeer::clearRelatedInstancePool();
$con->commit();
return $affectedRows;
} catch (Exception $e) {
$con->rollBack();
throw $e;
}
}
/**
* Performs a DELETE on the database, given a Newsletter or Criteria object OR a primary key value.
*
* @param mixed $values Criteria or Newsletter 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(NewsletterPeer::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.
NewsletterPeer::clearInstancePool();
// rename for clarity
$criteria = clone $values;
} elseif ($values instanceof Newsletter) { // it's a model object
// invalidate the cache for this single object
NewsletterPeer::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(NewsletterPeer::DATABASE_NAME);
$criteria->add(NewsletterPeer::ID, (array) $values, Criteria::IN);
// invalidate the cache for this object(s)
foreach ((array) $values as $singleval) {
NewsletterPeer::removeInstanceFromPool($singleval);
}
}
// Set the correct dbName
$criteria->setDbName(NewsletterPeer::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);
NewsletterPeer::clearRelatedInstancePool();
$con->commit();
return $affectedRows;
} catch (Exception $e) {
$con->rollBack();
throw $e;
}
}
/**
* Validates all modified columns of given Newsletter 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 Newsletter $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(NewsletterPeer::DATABASE_NAME);
$tableMap = $dbMap->getTable(NewsletterPeer::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(NewsletterPeer::DATABASE_NAME, NewsletterPeer::TABLE_NAME, $columns);
}
/**
* Retrieve a single object by pkey.
*
* @param int $pk the primary key.
* @param PropelPDO $con the connection to use
* @return Newsletter
*/
public static function retrieveByPK($pk, PropelPDO $con = null)
{
if (null !== ($obj = NewsletterPeer::getInstanceFromPool((string) $pk))) {
return $obj;
}
if ($con === null) {
$con = Propel::getConnection(NewsletterPeer::DATABASE_NAME, Propel::CONNECTION_READ);
}
$criteria = new Criteria(NewsletterPeer::DATABASE_NAME);
$criteria->add(NewsletterPeer::ID, $pk);
$v = NewsletterPeer::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 Newsletter[]
* @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(NewsletterPeer::DATABASE_NAME, Propel::CONNECTION_READ);
}
$objs = null;
if (empty($pks)) {
$objs = array();
} else {
$criteria = new Criteria(NewsletterPeer::DATABASE_NAME);
$criteria->add(NewsletterPeer::ID, $pks, Criteria::IN);
$objs = NewsletterPeer::doSelect($criteria, $con);
}
return $objs;
}
} // BaseNewsletterPeer
// This is the static code needed to register the TableMap for this table with the main Propel class.
//
BaseNewsletterPeer::buildTableMap();
EventDispatcherProxy::trigger(array('construct','peer.construct'), new PeerEvent('Trinity\Bundle\NewsletterBundle\Model\om\BaseNewsletterPeer'));