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. * * * $obj = $c->findPk(12, $con); * * * @param mixed $key Primary key to use for the query * @param ConnectionInterface $con an optional connection object * * @return ChildSelectionImage|array|mixed the result, formatted by the current formatter */ public function findPk($key, $con = null) { if ($key === null) { return null; } if ((null !== ($obj = SelectionImageTableMap::getInstanceFromPool((string) $key))) && !$this->formatter) { // the object is already in the instance pool return $obj; } if ($con === null) { $con = Propel::getServiceContainer()->getReadConnection(SelectionImageTableMap::DATABASE_NAME); } $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); } } /** * 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 ConnectionInterface $con A connection object * * @return ChildSelectionImage A model object, or null if the key is not found */ protected function findPkSimple($key, $con) { $sql = 'SELECT ID, SELECTION_ID, FILE, VISIBLE, POSITION, CREATED_AT, UPDATED_AT FROM selection_image 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), 0, $e); } $obj = null; if ($row = $stmt->fetch(\PDO::FETCH_NUM)) { $obj = new ChildSelectionImage(); $obj->hydrate($row); SelectionImageTableMap::addInstanceToPool($obj, (string) $key); } $stmt->closeCursor(); return $obj; } /** * Find object by primary key. * * @param mixed $key Primary key to use for the query * @param ConnectionInterface $con A connection object * * @return ChildSelectionImage|array|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; $dataFetcher = $criteria ->filterByPrimaryKey($key) ->doSelect($con); return $criteria->getFormatter()->init($criteria)->formatOne($dataFetcher); } /** * Find objects by primary key * * $objs = $c->findPks(array(12, 56, 832), $con); * * @param array $keys Primary keys to use for the query * @param ConnectionInterface $con an optional connection object * * @return ObjectCollection|array|mixed the list of results, formatted by the current formatter */ public function findPks($keys, $con = null) { if (null === $con) { $con = Propel::getServiceContainer()->getReadConnection($this->getDbName()); } $this->basePreSelect($con); $criteria = $this->isKeepQuery() ? clone $this : $this; $dataFetcher = $criteria ->filterByPrimaryKeys($keys) ->doSelect($con); return $criteria->getFormatter()->init($criteria)->format($dataFetcher); } /** * Filter the query by primary key * * @param mixed $key Primary key to use for the query * * @return ChildSelectionImageQuery The current query, for fluid interface */ public function filterByPrimaryKey($key) { return $this->addUsingAlias(SelectionImageTableMap::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 ChildSelectionImageQuery The current query, for fluid interface */ public function filterByPrimaryKeys($keys) { return $this->addUsingAlias(SelectionImageTableMap::ID, $keys, Criteria::IN); } /** * Filter the query on the id column * * Example usage: * * $query->filterById(1234); // WHERE id = 1234 * $query->filterById(array(12, 34)); // WHERE id IN (12, 34) * $query->filterById(array('min' => 12)); // WHERE id > 12 * * * @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 ChildSelectionImageQuery 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(SelectionImageTableMap::ID, $id['min'], Criteria::GREATER_EQUAL); $useMinMax = true; } if (isset($id['max'])) { $this->addUsingAlias(SelectionImageTableMap::ID, $id['max'], Criteria::LESS_EQUAL); $useMinMax = true; } if ($useMinMax) { return $this; } if (null === $comparison) { $comparison = Criteria::IN; } } return $this->addUsingAlias(SelectionImageTableMap::ID, $id, $comparison); } /** * Filter the query on the selection_id column * * Example usage: * * $query->filterBySelectionId(1234); // WHERE selection_id = 1234 * $query->filterBySelectionId(array(12, 34)); // WHERE selection_id IN (12, 34) * $query->filterBySelectionId(array('min' => 12)); // WHERE selection_id > 12 * * * @see filterBySelection() * * @param mixed $selectionId 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 ChildSelectionImageQuery The current query, for fluid interface */ public function filterBySelectionId($selectionId = null, $comparison = null) { if (is_array($selectionId)) { $useMinMax = false; if (isset($selectionId['min'])) { $this->addUsingAlias(SelectionImageTableMap::SELECTION_ID, $selectionId['min'], Criteria::GREATER_EQUAL); $useMinMax = true; } if (isset($selectionId['max'])) { $this->addUsingAlias(SelectionImageTableMap::SELECTION_ID, $selectionId['max'], Criteria::LESS_EQUAL); $useMinMax = true; } if ($useMinMax) { return $this; } if (null === $comparison) { $comparison = Criteria::IN; } } return $this->addUsingAlias(SelectionImageTableMap::SELECTION_ID, $selectionId, $comparison); } /** * Filter the query on the file column * * Example usage: * * $query->filterByFile('fooValue'); // WHERE file = 'fooValue' * $query->filterByFile('%fooValue%'); // WHERE file LIKE '%fooValue%' * * * @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 ChildSelectionImageQuery 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(SelectionImageTableMap::FILE, $file, $comparison); } /** * Filter the query on the visible column * * Example usage: * * $query->filterByVisible(1234); // WHERE visible = 1234 * $query->filterByVisible(array(12, 34)); // WHERE visible IN (12, 34) * $query->filterByVisible(array('min' => 12)); // WHERE visible > 12 * * * @param mixed $visible 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 ChildSelectionImageQuery The current query, for fluid interface */ public function filterByVisible($visible = null, $comparison = null) { if (is_array($visible)) { $useMinMax = false; if (isset($visible['min'])) { $this->addUsingAlias(SelectionImageTableMap::VISIBLE, $visible['min'], Criteria::GREATER_EQUAL); $useMinMax = true; } if (isset($visible['max'])) { $this->addUsingAlias(SelectionImageTableMap::VISIBLE, $visible['max'], Criteria::LESS_EQUAL); $useMinMax = true; } if ($useMinMax) { return $this; } if (null === $comparison) { $comparison = Criteria::IN; } } return $this->addUsingAlias(SelectionImageTableMap::VISIBLE, $visible, $comparison); } /** * Filter the query on the position column * * Example usage: * * $query->filterByPosition(1234); // WHERE position = 1234 * $query->filterByPosition(array(12, 34)); // WHERE position IN (12, 34) * $query->filterByPosition(array('min' => 12)); // WHERE position > 12 * * * @param mixed $position 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 ChildSelectionImageQuery The current query, for fluid interface */ public function filterByPosition($position = null, $comparison = null) { if (is_array($position)) { $useMinMax = false; if (isset($position['min'])) { $this->addUsingAlias(SelectionImageTableMap::POSITION, $position['min'], Criteria::GREATER_EQUAL); $useMinMax = true; } if (isset($position['max'])) { $this->addUsingAlias(SelectionImageTableMap::POSITION, $position['max'], Criteria::LESS_EQUAL); $useMinMax = true; } if ($useMinMax) { return $this; } if (null === $comparison) { $comparison = Criteria::IN; } } return $this->addUsingAlias(SelectionImageTableMap::POSITION, $position, $comparison); } /** * Filter the query on the created_at column * * Example usage: * * $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' * * * @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 ChildSelectionImageQuery 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(SelectionImageTableMap::CREATED_AT, $createdAt['min'], Criteria::GREATER_EQUAL); $useMinMax = true; } if (isset($createdAt['max'])) { $this->addUsingAlias(SelectionImageTableMap::CREATED_AT, $createdAt['max'], Criteria::LESS_EQUAL); $useMinMax = true; } if ($useMinMax) { return $this; } if (null === $comparison) { $comparison = Criteria::IN; } } return $this->addUsingAlias(SelectionImageTableMap::CREATED_AT, $createdAt, $comparison); } /** * Filter the query on the updated_at column * * Example usage: * * $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' * * * @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 ChildSelectionImageQuery 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(SelectionImageTableMap::UPDATED_AT, $updatedAt['min'], Criteria::GREATER_EQUAL); $useMinMax = true; } if (isset($updatedAt['max'])) { $this->addUsingAlias(SelectionImageTableMap::UPDATED_AT, $updatedAt['max'], Criteria::LESS_EQUAL); $useMinMax = true; } if ($useMinMax) { return $this; } if (null === $comparison) { $comparison = Criteria::IN; } } return $this->addUsingAlias(SelectionImageTableMap::UPDATED_AT, $updatedAt, $comparison); } /** * Filter the query by a related \Selection\Model\Selection object * * @param \Selection\Model\Selection|ObjectCollection $selection The related object(s) to use as filter * @param string $comparison Operator to use for the column comparison, defaults to Criteria::EQUAL * * @return ChildSelectionImageQuery The current query, for fluid interface */ public function filterBySelection($selection, $comparison = null) { if ($selection instanceof \Selection\Model\Selection) { return $this ->addUsingAlias(SelectionImageTableMap::SELECTION_ID, $selection->getId(), $comparison); } elseif ($selection instanceof ObjectCollection) { if (null === $comparison) { $comparison = Criteria::IN; } return $this ->addUsingAlias(SelectionImageTableMap::SELECTION_ID, $selection->toKeyValue('PrimaryKey', 'Id'), $comparison); } else { throw new PropelException('filterBySelection() only accepts arguments of type \Selection\Model\Selection or Collection'); } } /** * Adds a JOIN clause to the query using the Selection relation * * @param string $relationAlias optional alias for the relation * @param string $joinType Accepted values are null, 'left join', 'right join', 'inner join' * * @return ChildSelectionImageQuery The current query, for fluid interface */ public function joinSelection($relationAlias = null, $joinType = Criteria::INNER_JOIN) { $tableMap = $this->getTableMap(); $relationMap = $tableMap->getRelation('Selection'); // 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, 'Selection'); } return $this; } /** * Use the Selection relation Selection 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 \Selection\Model\SelectionQuery A secondary query class using the current class as primary query */ public function useSelectionQuery($relationAlias = null, $joinType = Criteria::INNER_JOIN) { return $this ->joinSelection($relationAlias, $joinType) ->useQuery($relationAlias ? $relationAlias : 'Selection', '\Selection\Model\SelectionQuery'); } /** * Filter the query by a related \Selection\Model\SelectionImageI18n object * * @param \Selection\Model\SelectionImageI18n|ObjectCollection $selectionImageI18n the related object to use as filter * @param string $comparison Operator to use for the column comparison, defaults to Criteria::EQUAL * * @return ChildSelectionImageQuery The current query, for fluid interface */ public function filterBySelectionImageI18n($selectionImageI18n, $comparison = null) { if ($selectionImageI18n instanceof \Selection\Model\SelectionImageI18n) { return $this ->addUsingAlias(SelectionImageTableMap::ID, $selectionImageI18n->getId(), $comparison); } elseif ($selectionImageI18n instanceof ObjectCollection) { return $this ->useSelectionImageI18nQuery() ->filterByPrimaryKeys($selectionImageI18n->getPrimaryKeys()) ->endUse(); } else { throw new PropelException('filterBySelectionImageI18n() only accepts arguments of type \Selection\Model\SelectionImageI18n or Collection'); } } /** * Adds a JOIN clause to the query using the SelectionImageI18n relation * * @param string $relationAlias optional alias for the relation * @param string $joinType Accepted values are null, 'left join', 'right join', 'inner join' * * @return ChildSelectionImageQuery The current query, for fluid interface */ public function joinSelectionImageI18n($relationAlias = null, $joinType = 'LEFT JOIN') { $tableMap = $this->getTableMap(); $relationMap = $tableMap->getRelation('SelectionImageI18n'); // 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, 'SelectionImageI18n'); } return $this; } /** * Use the SelectionImageI18n relation SelectionImageI18n 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 \Selection\Model\SelectionImageI18nQuery A secondary query class using the current class as primary query */ public function useSelectionImageI18nQuery($relationAlias = null, $joinType = 'LEFT JOIN') { return $this ->joinSelectionImageI18n($relationAlias, $joinType) ->useQuery($relationAlias ? $relationAlias : 'SelectionImageI18n', '\Selection\Model\SelectionImageI18nQuery'); } /** * Exclude object from result * * @param ChildSelectionImage $selectionImage Object to remove from the list of results * * @return ChildSelectionImageQuery The current query, for fluid interface */ public function prune($selectionImage = null) { if ($selectionImage) { $this->addUsingAlias(SelectionImageTableMap::ID, $selectionImage->getId(), Criteria::NOT_EQUAL); } return $this; } /** * Deletes all rows from the selection_image table. * * @param ConnectionInterface $con the connection to use * @return int The number of affected rows (if supported by underlying database driver). */ public function doDeleteAll(ConnectionInterface $con = null) { if (null === $con) { $con = Propel::getServiceContainer()->getWriteConnection(SelectionImageTableMap::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 += parent::doDeleteAll($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). SelectionImageTableMap::clearInstancePool(); SelectionImageTableMap::clearRelatedInstancePool(); $con->commit(); } catch (PropelException $e) { $con->rollBack(); throw $e; } return $affectedRows; } /** * Performs a DELETE on the database, given a ChildSelectionImage or Criteria object OR a primary key value. * * @param mixed $values Criteria or ChildSelectionImage object or primary key or array of primary keys * which is used to create the DELETE statement * @param ConnectionInterface $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 function delete(ConnectionInterface $con = null) { if (null === $con) { $con = Propel::getServiceContainer()->getWriteConnection(SelectionImageTableMap::DATABASE_NAME); } $criteria = $this; // Set the correct dbName $criteria->setDbName(SelectionImageTableMap::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(); SelectionImageTableMap::removeInstanceFromPool($criteria); $affectedRows += ModelCriteria::delete($con); SelectionImageTableMap::clearRelatedInstancePool(); $con->commit(); return $affectedRows; } catch (PropelException $e) { $con->rollBack(); throw $e; } } // timestampable behavior /** * Filter by the latest updated * * @param int $nbDays Maximum age of the latest update in days * * @return ChildSelectionImageQuery The current query, for fluid interface */ public function recentlyUpdated($nbDays = 7) { return $this->addUsingAlias(SelectionImageTableMap::UPDATED_AT, time() - $nbDays * 24 * 60 * 60, Criteria::GREATER_EQUAL); } /** * Filter by the latest created * * @param int $nbDays Maximum age of in days * * @return ChildSelectionImageQuery The current query, for fluid interface */ public function recentlyCreated($nbDays = 7) { return $this->addUsingAlias(SelectionImageTableMap::CREATED_AT, time() - $nbDays * 24 * 60 * 60, Criteria::GREATER_EQUAL); } /** * Order by update date desc * * @return ChildSelectionImageQuery The current query, for fluid interface */ public function lastUpdatedFirst() { return $this->addDescendingOrderByColumn(SelectionImageTableMap::UPDATED_AT); } /** * Order by update date asc * * @return ChildSelectionImageQuery The current query, for fluid interface */ public function firstUpdatedFirst() { return $this->addAscendingOrderByColumn(SelectionImageTableMap::UPDATED_AT); } /** * Order by create date desc * * @return ChildSelectionImageQuery The current query, for fluid interface */ public function lastCreatedFirst() { return $this->addDescendingOrderByColumn(SelectionImageTableMap::CREATED_AT); } /** * Order by create date asc * * @return ChildSelectionImageQuery The current query, for fluid interface */ public function firstCreatedFirst() { return $this->addAscendingOrderByColumn(SelectionImageTableMap::CREATED_AT); } // i18n behavior /** * Adds a JOIN clause to the query using the i18n relation * * @param string $locale Locale to use for the join condition, e.g. 'fr_FR' * @param string $relationAlias optional alias for the relation * @param string $joinType Accepted values are null, 'left join', 'right join', 'inner join'. Defaults to left join. * * @return ChildSelectionImageQuery The current query, for fluid interface */ public function joinI18n($locale = 'en_US', $relationAlias = null, $joinType = Criteria::LEFT_JOIN) { $relationName = $relationAlias ? $relationAlias : 'SelectionImageI18n'; return $this ->joinSelectionImageI18n($relationAlias, $joinType) ->addJoinCondition($relationName, $relationName . '.Locale = ?', $locale); } /** * Adds a JOIN clause to the query and hydrates the related I18n object. * Shortcut for $c->joinI18n($locale)->with() * * @param string $locale Locale to use for the join condition, e.g. 'fr_FR' * @param string $joinType Accepted values are null, 'left join', 'right join', 'inner join'. Defaults to left join. * * @return ChildSelectionImageQuery The current query, for fluid interface */ public function joinWithI18n($locale = 'en_US', $joinType = Criteria::LEFT_JOIN) { $this ->joinI18n($locale, null, $joinType) ->with('SelectionImageI18n'); $this->with['SelectionImageI18n']->setIsWithOneToMany(false); return $this; } /** * Use the I18n relation query object * * @see useQuery() * * @param string $locale Locale to use for the join condition, e.g. 'fr_FR' * @param string $relationAlias optional alias for the relation * @param string $joinType Accepted values are null, 'left join', 'right join', 'inner join'. Defaults to left join. * * @return ChildSelectionImageI18nQuery A secondary query class using the current class as primary query */ public function useI18nQuery($locale = 'en_US', $relationAlias = null, $joinType = Criteria::LEFT_JOIN) { return $this ->joinI18n($locale, $relationAlias, $joinType) ->useQuery($relationAlias ? $relationAlias : 'SelectionImageI18n', '\Selection\Model\SelectionImageI18nQuery'); } } // SelectionImageQuery