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

732 lines
28 KiB
PHP

<?php
namespace Trinity\Bundle\MediaBundle\Model\om;
use \Criteria;
use \Exception;
use \ModelCriteria;
use \ModelJoin;
use \PDO;
use \Propel;
use \PropelCollection;
use \PropelException;
use \PropelObjectCollection;
use \PropelPDO;
use Trinity\Bundle\MediaBundle\Model\Category;
use Trinity\Bundle\MediaBundle\Model\Media;
use Trinity\Bundle\MediaBundle\Model\MediaPeer;
use Trinity\Bundle\MediaBundle\Model\MediaQuery;
use Trinity\Bundle\MediaBundle\Model\Type;
/**
* @method MediaQuery orderById($order = Criteria::ASC) Order by the id column
* @method MediaQuery orderByTypeId($order = Criteria::ASC) Order by the type_id column
* @method MediaQuery orderByCategoryId($order = Criteria::ASC) Order by the category_id column
* @method MediaQuery orderByCreatedAt($order = Criteria::ASC) Order by the created_at column
* @method MediaQuery orderByUpdatedAt($order = Criteria::ASC) Order by the updated_at column
* @method MediaQuery orderByFile($order = Criteria::ASC) Order by the file column
*
* @method MediaQuery groupById() Group by the id column
* @method MediaQuery groupByTypeId() Group by the type_id column
* @method MediaQuery groupByCategoryId() Group by the category_id column
* @method MediaQuery groupByCreatedAt() Group by the created_at column
* @method MediaQuery groupByUpdatedAt() Group by the updated_at column
* @method MediaQuery groupByFile() Group by the file column
*
* @method MediaQuery leftJoin($relation) Adds a LEFT JOIN clause to the query
* @method MediaQuery rightJoin($relation) Adds a RIGHT JOIN clause to the query
* @method MediaQuery innerJoin($relation) Adds a INNER JOIN clause to the query
*
* @method MediaQuery leftJoinType($relationAlias = null) Adds a LEFT JOIN clause to the query using the Type relation
* @method MediaQuery rightJoinType($relationAlias = null) Adds a RIGHT JOIN clause to the query using the Type relation
* @method MediaQuery innerJoinType($relationAlias = null) Adds a INNER JOIN clause to the query using the Type relation
*
* @method MediaQuery leftJoinCategory($relationAlias = null) Adds a LEFT JOIN clause to the query using the Category relation
* @method MediaQuery rightJoinCategory($relationAlias = null) Adds a RIGHT JOIN clause to the query using the Category relation
* @method MediaQuery innerJoinCategory($relationAlias = null) Adds a INNER JOIN clause to the query using the Category relation
*
* @method Media findOne(PropelPDO $con = null) Return the first Media matching the query
* @method Media findOneOrCreate(PropelPDO $con = null) Return the first Media matching the query, or a new Media object populated from the query conditions when no match is found
*
* @method Media findOneByTypeId(int $type_id) Return the first Media filtered by the type_id column
* @method Media findOneByCategoryId(int $category_id) Return the first Media filtered by the category_id column
* @method Media findOneByCreatedAt(string $created_at) Return the first Media filtered by the created_at column
* @method Media findOneByUpdatedAt(string $updated_at) Return the first Media filtered by the updated_at column
* @method Media findOneByFile(string $file) Return the first Media filtered by the file column
*
* @method array findById(int $id) Return Media objects filtered by the id column
* @method array findByTypeId(int $type_id) Return Media objects filtered by the type_id column
* @method array findByCategoryId(int $category_id) Return Media objects filtered by the category_id column
* @method array findByCreatedAt(string $created_at) Return Media objects filtered by the created_at column
* @method array findByUpdatedAt(string $updated_at) Return Media objects filtered by the updated_at column
* @method array findByFile(string $file) Return Media objects filtered by the file column
*/
abstract class BaseMediaQuery extends ModelCriteria
{
/**
* Initializes internal state of BaseMediaQuery object.
*
* @param string $dbName The dabase name
* @param string $modelName The phpName of a model, e.g. 'Book'
* @param string $modelAlias The alias for the model in this query, e.g. 'b'
*/
public function __construct($dbName = 'default', $modelName = 'Trinity\\Bundle\\MediaBundle\\Model\\Media', $modelAlias = null)
{
parent::__construct($dbName, $modelName, $modelAlias);
}
/**
* Returns a new MediaQuery object.
*
* @param string $modelAlias The alias of a model in the query
* @param MediaQuery|Criteria $criteria Optional Criteria to build the query from
*
* @return MediaQuery
*/
public static function create($modelAlias = null, $criteria = null)
{
if ($criteria instanceof MediaQuery) {
return $criteria;
}
$query = new MediaQuery();
if (null !== $modelAlias) {
$query->setModelAlias($modelAlias);
}
if ($criteria instanceof Criteria) {
$query->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.
*
* <code>
* $obj = $c->findPk(12, $con);
* </code>
*
* @param mixed $key Primary key to use for the query
* @param PropelPDO $con an optional connection object
*
* @return Media|Media[]|mixed the result, formatted by the current formatter
*/
public function findPk($key, $con = null)
{
if ($key === null) {
return null;
}
if ((null !== ($obj = MediaPeer::getInstanceFromPool((string) $key))) && !$this->formatter) {
// the object is alredy in the instance pool
return $obj;
}
if ($con === null) {
$con = Propel::getConnection(MediaPeer::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 Media A model object, or null if the key is not found
* @throws PropelException
*/
public function findOneById($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 Media A model object, or null if the key is not found
* @throws PropelException
*/
protected function findPkSimple($key, $con)
{
$sql = 'SELECT `id`, `type_id`, `category_id`, `created_at`, `updated_at`, `file` FROM `media_file` WHERE `id` = :p0';
try {
$stmt = $con->prepare($sql);
$stmt->bindValue(':p0', $key, PDO::PARAM_INT);
$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 Media();
$obj->hydrate($row);
MediaPeer::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 Media|Media[]|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
* <code>
* $objs = $c->findPks(array(12, 56, 832), $con);
* </code>
* @param array $keys Primary keys to use for the query
* @param PropelPDO $con an optional connection object
*
* @return PropelObjectCollection|Media[]|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 MediaQuery The current query, for fluid interface
*/
public function filterByPrimaryKey($key)
{
return $this->addUsingAlias(MediaPeer::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 MediaQuery The current query, for fluid interface
*/
public function filterByPrimaryKeys($keys)
{
return $this->addUsingAlias(MediaPeer::ID, $keys, Criteria::IN);
}
/**
* Filter the query on the id column
*
* Example usage:
* <code>
* $query->filterById(1234); // WHERE id = 1234
* $query->filterById(array(12, 34)); // WHERE id IN (12, 34)
* $query->filterById(array('min' => 12)); // WHERE id >= 12
* $query->filterById(array('max' => 12)); // WHERE id <= 12
* </code>
*
* @param mixed $id 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 MediaQuery The current query, for fluid interface
*/
public function filterById($id = null, $comparison = null)
{
if (is_array($id)) {
$useMinMax = false;
if (isset($id['min'])) {
$this->addUsingAlias(MediaPeer::ID, $id['min'], Criteria::GREATER_EQUAL);
$useMinMax = true;
}
if (isset($id['max'])) {
$this->addUsingAlias(MediaPeer::ID, $id['max'], Criteria::LESS_EQUAL);
$useMinMax = true;
}
if ($useMinMax) {
return $this;
}
if (null === $comparison) {
$comparison = Criteria::IN;
}
}
return $this->addUsingAlias(MediaPeer::ID, $id, $comparison);
}
/**
* Filter the query on the type_id column
*
* Example usage:
* <code>
* $query->filterByTypeId(1234); // WHERE type_id = 1234
* $query->filterByTypeId(array(12, 34)); // WHERE type_id IN (12, 34)
* $query->filterByTypeId(array('min' => 12)); // WHERE type_id >= 12
* $query->filterByTypeId(array('max' => 12)); // WHERE type_id <= 12
* </code>
*
* @see filterByType()
*
* @param mixed $typeId 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 MediaQuery The current query, for fluid interface
*/
public function filterByTypeId($typeId = null, $comparison = null)
{
if (is_array($typeId)) {
$useMinMax = false;
if (isset($typeId['min'])) {
$this->addUsingAlias(MediaPeer::TYPE_ID, $typeId['min'], Criteria::GREATER_EQUAL);
$useMinMax = true;
}
if (isset($typeId['max'])) {
$this->addUsingAlias(MediaPeer::TYPE_ID, $typeId['max'], Criteria::LESS_EQUAL);
$useMinMax = true;
}
if ($useMinMax) {
return $this;
}
if (null === $comparison) {
$comparison = Criteria::IN;
}
}
return $this->addUsingAlias(MediaPeer::TYPE_ID, $typeId, $comparison);
}
/**
* Filter the query on the category_id column
*
* Example usage:
* <code>
* $query->filterByCategoryId(1234); // WHERE category_id = 1234
* $query->filterByCategoryId(array(12, 34)); // WHERE category_id IN (12, 34)
* $query->filterByCategoryId(array('min' => 12)); // WHERE category_id >= 12
* $query->filterByCategoryId(array('max' => 12)); // WHERE category_id <= 12
* </code>
*
* @see filterByCategory()
*
* @param mixed $categoryId 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 MediaQuery The current query, for fluid interface
*/
public function filterByCategoryId($categoryId = null, $comparison = null)
{
if (is_array($categoryId)) {
$useMinMax = false;
if (isset($categoryId['min'])) {
$this->addUsingAlias(MediaPeer::CATEGORY_ID, $categoryId['min'], Criteria::GREATER_EQUAL);
$useMinMax = true;
}
if (isset($categoryId['max'])) {
$this->addUsingAlias(MediaPeer::CATEGORY_ID, $categoryId['max'], Criteria::LESS_EQUAL);
$useMinMax = true;
}
if ($useMinMax) {
return $this;
}
if (null === $comparison) {
$comparison = Criteria::IN;
}
}
return $this->addUsingAlias(MediaPeer::CATEGORY_ID, $categoryId, $comparison);
}
/**
* Filter the query on the created_at column
*
* Example usage:
* <code>
* $query->filterByCreatedAt('2011-03-14'); // WHERE created_at = '2011-03-14'
* $query->filterByCreatedAt('now'); // WHERE created_at = '2011-03-14'
* $query->filterByCreatedAt(array('max' => 'yesterday')); // WHERE created_at > '2011-03-13'
* </code>
*
* @param mixed $createdAt The value to use as filter.
* Values can be integers (unix timestamps), DateTime objects, or strings.
* Empty strings are treated as NULL.
* 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 MediaQuery The current query, for fluid interface
*/
public function filterByCreatedAt($createdAt = null, $comparison = null)
{
if (is_array($createdAt)) {
$useMinMax = false;
if (isset($createdAt['min'])) {
$this->addUsingAlias(MediaPeer::CREATED_AT, $createdAt['min'], Criteria::GREATER_EQUAL);
$useMinMax = true;
}
if (isset($createdAt['max'])) {
$this->addUsingAlias(MediaPeer::CREATED_AT, $createdAt['max'], Criteria::LESS_EQUAL);
$useMinMax = true;
}
if ($useMinMax) {
return $this;
}
if (null === $comparison) {
$comparison = Criteria::IN;
}
}
return $this->addUsingAlias(MediaPeer::CREATED_AT, $createdAt, $comparison);
}
/**
* Filter the query on the updated_at column
*
* Example usage:
* <code>
* $query->filterByUpdatedAt('2011-03-14'); // WHERE updated_at = '2011-03-14'
* $query->filterByUpdatedAt('now'); // WHERE updated_at = '2011-03-14'
* $query->filterByUpdatedAt(array('max' => 'yesterday')); // WHERE updated_at > '2011-03-13'
* </code>
*
* @param mixed $updatedAt The value to use as filter.
* Values can be integers (unix timestamps), DateTime objects, or strings.
* Empty strings are treated as NULL.
* 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 MediaQuery The current query, for fluid interface
*/
public function filterByUpdatedAt($updatedAt = null, $comparison = null)
{
if (is_array($updatedAt)) {
$useMinMax = false;
if (isset($updatedAt['min'])) {
$this->addUsingAlias(MediaPeer::UPDATED_AT, $updatedAt['min'], Criteria::GREATER_EQUAL);
$useMinMax = true;
}
if (isset($updatedAt['max'])) {
$this->addUsingAlias(MediaPeer::UPDATED_AT, $updatedAt['max'], Criteria::LESS_EQUAL);
$useMinMax = true;
}
if ($useMinMax) {
return $this;
}
if (null === $comparison) {
$comparison = Criteria::IN;
}
}
return $this->addUsingAlias(MediaPeer::UPDATED_AT, $updatedAt, $comparison);
}
/**
* Filter the query on the file column
*
* Example usage:
* <code>
* $query->filterByFile('fooValue'); // WHERE file = 'fooValue'
* $query->filterByFile('%fooValue%'); // WHERE file LIKE '%fooValue%'
* </code>
*
* @param string $file 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 MediaQuery The current query, for fluid interface
*/
public function filterByFile($file = null, $comparison = null)
{
if (null === $comparison) {
if (is_array($file)) {
$comparison = Criteria::IN;
} elseif (preg_match('/[\%\*]/', $file)) {
$file = str_replace('*', '%', $file);
$comparison = Criteria::LIKE;
}
}
return $this->addUsingAlias(MediaPeer::FILE, $file, $comparison);
}
/**
* Filter the query by a related Type object
*
* @param Type|PropelObjectCollection $type The related object(s) to use as filter
* @param string $comparison Operator to use for the column comparison, defaults to Criteria::EQUAL
*
* @return MediaQuery The current query, for fluid interface
* @throws PropelException - if the provided filter is invalid.
*/
public function filterByType($type, $comparison = null)
{
if ($type instanceof Type) {
return $this
->addUsingAlias(MediaPeer::TYPE_ID, $type->getId(), $comparison);
} elseif ($type instanceof PropelObjectCollection) {
if (null === $comparison) {
$comparison = Criteria::IN;
}
return $this
->addUsingAlias(MediaPeer::TYPE_ID, $type->toKeyValue('PrimaryKey', 'Id'), $comparison);
} else {
throw new PropelException('filterByType() only accepts arguments of type Type or PropelCollection');
}
}
/**
* Adds a JOIN clause to the query using the Type relation
*
* @param string $relationAlias optional alias for the relation
* @param string $joinType Accepted values are null, 'left join', 'right join', 'inner join'
*
* @return MediaQuery The current query, for fluid interface
*/
public function joinType($relationAlias = null, $joinType = Criteria::LEFT_JOIN)
{
$tableMap = $this->getTableMap();
$relationMap = $tableMap->getRelation('Type');
// create a ModelJoin object for this join
$join = new ModelJoin();
$join->setJoinType($joinType);
$join->setRelationMap($relationMap, $this->useAliasInSQL ? $this->getModelAlias() : null, $relationAlias);
if ($previousJoin = $this->getPreviousJoin()) {
$join->setPreviousJoin($previousJoin);
}
// add the ModelJoin to the current object
if ($relationAlias) {
$this->addAlias($relationAlias, $relationMap->getRightTable()->getName());
$this->addJoinObject($join, $relationAlias);
} else {
$this->addJoinObject($join, 'Type');
}
return $this;
}
/**
* Use the Type relation Type object
*
* @see useQuery()
*
* @param string $relationAlias optional alias for the relation,
* to be used as main alias in the secondary query
* @param string $joinType Accepted values are null, 'left join', 'right join', 'inner join'
*
* @return \Trinity\Bundle\MediaBundle\Model\TypeQuery A secondary query class using the current class as primary query
*/
public function useTypeQuery($relationAlias = null, $joinType = Criteria::LEFT_JOIN)
{
return $this
->joinType($relationAlias, $joinType)
->useQuery($relationAlias ? $relationAlias : 'Type', '\Trinity\Bundle\MediaBundle\Model\TypeQuery');
}
/**
* Filter the query by a related Category object
*
* @param Category|PropelObjectCollection $category The related object(s) to use as filter
* @param string $comparison Operator to use for the column comparison, defaults to Criteria::EQUAL
*
* @return MediaQuery The current query, for fluid interface
* @throws PropelException - if the provided filter is invalid.
*/
public function filterByCategory($category, $comparison = null)
{
if ($category instanceof Category) {
return $this
->addUsingAlias(MediaPeer::CATEGORY_ID, $category->getId(), $comparison);
} elseif ($category instanceof PropelObjectCollection) {
if (null === $comparison) {
$comparison = Criteria::IN;
}
return $this
->addUsingAlias(MediaPeer::CATEGORY_ID, $category->toKeyValue('PrimaryKey', 'Id'), $comparison);
} else {
throw new PropelException('filterByCategory() only accepts arguments of type Category or PropelCollection');
}
}
/**
* Adds a JOIN clause to the query using the Category relation
*
* @param string $relationAlias optional alias for the relation
* @param string $joinType Accepted values are null, 'left join', 'right join', 'inner join'
*
* @return MediaQuery The current query, for fluid interface
*/
public function joinCategory($relationAlias = null, $joinType = Criteria::LEFT_JOIN)
{
$tableMap = $this->getTableMap();
$relationMap = $tableMap->getRelation('Category');
// create a ModelJoin object for this join
$join = new ModelJoin();
$join->setJoinType($joinType);
$join->setRelationMap($relationMap, $this->useAliasInSQL ? $this->getModelAlias() : null, $relationAlias);
if ($previousJoin = $this->getPreviousJoin()) {
$join->setPreviousJoin($previousJoin);
}
// add the ModelJoin to the current object
if ($relationAlias) {
$this->addAlias($relationAlias, $relationMap->getRightTable()->getName());
$this->addJoinObject($join, $relationAlias);
} else {
$this->addJoinObject($join, 'Category');
}
return $this;
}
/**
* Use the Category relation Category object
*
* @see useQuery()
*
* @param string $relationAlias optional alias for the relation,
* to be used as main alias in the secondary query
* @param string $joinType Accepted values are null, 'left join', 'right join', 'inner join'
*
* @return \Trinity\Bundle\MediaBundle\Model\CategoryQuery A secondary query class using the current class as primary query
*/
public function useCategoryQuery($relationAlias = null, $joinType = Criteria::LEFT_JOIN)
{
return $this
->joinCategory($relationAlias, $joinType)
->useQuery($relationAlias ? $relationAlias : 'Category', '\Trinity\Bundle\MediaBundle\Model\CategoryQuery');
}
/**
* Exclude object from result
*
* @param Media $media Object to remove from the list of results
*
* @return MediaQuery The current query, for fluid interface
*/
public function prune($media = null)
{
if ($media) {
$this->addUsingAlias(MediaPeer::ID, $media->getId(), Criteria::NOT_EQUAL);
}
return $this;
}
// timestampable behavior
/**
* Filter by the latest updated
*
* @param int $nbDays Maximum age of the latest update in days
*
* @return MediaQuery The current query, for fluid interface
*/
public function recentlyUpdated($nbDays = 7)
{
return $this->addUsingAlias(MediaPeer::UPDATED_AT, time() - $nbDays * 24 * 60 * 60, Criteria::GREATER_EQUAL);
}
/**
* Order by update date desc
*
* @return MediaQuery The current query, for fluid interface
*/
public function lastUpdatedFirst()
{
return $this->addDescendingOrderByColumn(MediaPeer::UPDATED_AT);
}
/**
* Order by update date asc
*
* @return MediaQuery The current query, for fluid interface
*/
public function firstUpdatedFirst()
{
return $this->addAscendingOrderByColumn(MediaPeer::UPDATED_AT);
}
/**
* Filter by the latest created
*
* @param int $nbDays Maximum age of in days
*
* @return MediaQuery The current query, for fluid interface
*/
public function recentlyCreated($nbDays = 7)
{
return $this->addUsingAlias(MediaPeer::CREATED_AT, time() - $nbDays * 24 * 60 * 60, Criteria::GREATER_EQUAL);
}
/**
* Order by create date desc
*
* @return MediaQuery The current query, for fluid interface
*/
public function lastCreatedFirst()
{
return $this->addDescendingOrderByColumn(MediaPeer::CREATED_AT);
}
/**
* Order by create date asc
*
* @return MediaQuery The current query, for fluid interface
*/
public function firstCreatedFirst()
{
return $this->addAscendingOrderByColumn(MediaPeer::CREATED_AT);
}
}