3001 lines
102 KiB
PHP
3001 lines
102 KiB
PHP
<?php
|
|
|
|
namespace Contest\Model\Base;
|
|
|
|
use \DateTime;
|
|
use \Exception;
|
|
use \PDO;
|
|
use Contest\Model\Answer as ChildAnswer;
|
|
use Contest\Model\AnswerQuery as ChildAnswerQuery;
|
|
use Contest\Model\AnswerVersionQuery as ChildAnswerVersionQuery;
|
|
use Contest\Model\Game as ChildGame;
|
|
use Contest\Model\GameQuery as ChildGameQuery;
|
|
use Contest\Model\GameVersionQuery as ChildGameVersionQuery;
|
|
use Contest\Model\Question as ChildQuestion;
|
|
use Contest\Model\QuestionI18n as ChildQuestionI18n;
|
|
use Contest\Model\QuestionI18nQuery as ChildQuestionI18nQuery;
|
|
use Contest\Model\QuestionQuery as ChildQuestionQuery;
|
|
use Contest\Model\QuestionVersion as ChildQuestionVersion;
|
|
use Contest\Model\QuestionVersionQuery as ChildQuestionVersionQuery;
|
|
use Contest\Model\Map\AnswerVersionTableMap;
|
|
use Contest\Model\Map\QuestionTableMap;
|
|
use Contest\Model\Map\QuestionVersionTableMap;
|
|
use Propel\Runtime\Propel;
|
|
use Propel\Runtime\ActiveQuery\Criteria;
|
|
use Propel\Runtime\ActiveQuery\ModelCriteria;
|
|
use Propel\Runtime\ActiveRecord\ActiveRecordInterface;
|
|
use Propel\Runtime\Collection\Collection;
|
|
use Propel\Runtime\Collection\ObjectCollection;
|
|
use Propel\Runtime\Connection\ConnectionInterface;
|
|
use Propel\Runtime\Exception\BadMethodCallException;
|
|
use Propel\Runtime\Exception\PropelException;
|
|
use Propel\Runtime\Map\TableMap;
|
|
use Propel\Runtime\Parser\AbstractParser;
|
|
use Propel\Runtime\Util\PropelDateTime;
|
|
|
|
abstract class Question implements ActiveRecordInterface
|
|
{
|
|
/**
|
|
* TableMap class name
|
|
*/
|
|
const TABLE_MAP = '\\Contest\\Model\\Map\\QuestionTableMap';
|
|
|
|
|
|
/**
|
|
* attribute to determine if this object has previously been saved.
|
|
* @var boolean
|
|
*/
|
|
protected $new = true;
|
|
|
|
/**
|
|
* attribute to determine whether this object has been deleted.
|
|
* @var boolean
|
|
*/
|
|
protected $deleted = false;
|
|
|
|
/**
|
|
* The columns that have been modified in current object.
|
|
* Tracking modified columns allows us to only update modified columns.
|
|
* @var array
|
|
*/
|
|
protected $modifiedColumns = array();
|
|
|
|
/**
|
|
* The (virtual) columns that are added at runtime
|
|
* The formatters can add supplementary columns based on a resultset
|
|
* @var array
|
|
*/
|
|
protected $virtualColumns = array();
|
|
|
|
/**
|
|
* The value for the id field.
|
|
* @var int
|
|
*/
|
|
protected $id;
|
|
|
|
/**
|
|
* The value for the visible field.
|
|
* Note: this column has a database default value of: 0
|
|
* @var int
|
|
*/
|
|
protected $visible;
|
|
|
|
/**
|
|
* The value for the game_id field.
|
|
* @var int
|
|
*/
|
|
protected $game_id;
|
|
|
|
/**
|
|
* The value for the created_at field.
|
|
* @var string
|
|
*/
|
|
protected $created_at;
|
|
|
|
/**
|
|
* The value for the updated_at field.
|
|
* @var string
|
|
*/
|
|
protected $updated_at;
|
|
|
|
/**
|
|
* The value for the version field.
|
|
* Note: this column has a database default value of: 0
|
|
* @var int
|
|
*/
|
|
protected $version;
|
|
|
|
/**
|
|
* The value for the version_created_at field.
|
|
* @var string
|
|
*/
|
|
protected $version_created_at;
|
|
|
|
/**
|
|
* The value for the version_created_by field.
|
|
* @var string
|
|
*/
|
|
protected $version_created_by;
|
|
|
|
/**
|
|
* @var Game
|
|
*/
|
|
protected $aGame;
|
|
|
|
/**
|
|
* @var ObjectCollection|ChildAnswer[] Collection to store aggregation of ChildAnswer objects.
|
|
*/
|
|
protected $collAnswers;
|
|
protected $collAnswersPartial;
|
|
|
|
/**
|
|
* @var ObjectCollection|ChildQuestionI18n[] Collection to store aggregation of ChildQuestionI18n objects.
|
|
*/
|
|
protected $collQuestionI18ns;
|
|
protected $collQuestionI18nsPartial;
|
|
|
|
/**
|
|
* @var ObjectCollection|ChildQuestionVersion[] Collection to store aggregation of ChildQuestionVersion objects.
|
|
*/
|
|
protected $collQuestionVersions;
|
|
protected $collQuestionVersionsPartial;
|
|
|
|
/**
|
|
* Flag to prevent endless save loop, if this object is referenced
|
|
* by another object which falls in this transaction.
|
|
*
|
|
* @var boolean
|
|
*/
|
|
protected $alreadyInSave = false;
|
|
|
|
// i18n behavior
|
|
|
|
/**
|
|
* Current locale
|
|
* @var string
|
|
*/
|
|
protected $currentLocale = 'en_US';
|
|
|
|
/**
|
|
* Current translation objects
|
|
* @var array[ChildQuestionI18n]
|
|
*/
|
|
protected $currentTranslations;
|
|
|
|
// versionable behavior
|
|
|
|
|
|
/**
|
|
* @var bool
|
|
*/
|
|
protected $enforceVersion = false;
|
|
|
|
/**
|
|
* An array of objects scheduled for deletion.
|
|
* @var ObjectCollection
|
|
*/
|
|
protected $answersScheduledForDeletion = null;
|
|
|
|
/**
|
|
* An array of objects scheduled for deletion.
|
|
* @var ObjectCollection
|
|
*/
|
|
protected $questionI18nsScheduledForDeletion = null;
|
|
|
|
/**
|
|
* An array of objects scheduled for deletion.
|
|
* @var ObjectCollection
|
|
*/
|
|
protected $questionVersionsScheduledForDeletion = null;
|
|
|
|
/**
|
|
* Applies default values to this object.
|
|
* This method should be called from the object's constructor (or
|
|
* equivalent initialization method).
|
|
* @see __construct()
|
|
*/
|
|
public function applyDefaultValues()
|
|
{
|
|
$this->visible = 0;
|
|
$this->version = 0;
|
|
}
|
|
|
|
/**
|
|
* Initializes internal state of Contest\Model\Base\Question object.
|
|
* @see applyDefaults()
|
|
*/
|
|
public function __construct()
|
|
{
|
|
$this->applyDefaultValues();
|
|
}
|
|
|
|
/**
|
|
* Returns whether the object has been modified.
|
|
*
|
|
* @return boolean True if the object has been modified.
|
|
*/
|
|
public function isModified()
|
|
{
|
|
return !!$this->modifiedColumns;
|
|
}
|
|
|
|
/**
|
|
* Has specified column been modified?
|
|
*
|
|
* @param string $col column fully qualified name (TableMap::TYPE_COLNAME), e.g. Book::AUTHOR_ID
|
|
* @return boolean True if $col has been modified.
|
|
*/
|
|
public function isColumnModified($col)
|
|
{
|
|
return $this->modifiedColumns && isset($this->modifiedColumns[$col]);
|
|
}
|
|
|
|
/**
|
|
* Get the columns that have been modified in this object.
|
|
* @return array A unique list of the modified column names for this object.
|
|
*/
|
|
public function getModifiedColumns()
|
|
{
|
|
return $this->modifiedColumns ? array_keys($this->modifiedColumns) : [];
|
|
}
|
|
|
|
/**
|
|
* Returns whether the object has ever been saved. This will
|
|
* be false, if the object was retrieved from storage or was created
|
|
* and then saved.
|
|
*
|
|
* @return boolean true, if the object has never been persisted.
|
|
*/
|
|
public function isNew()
|
|
{
|
|
return $this->new;
|
|
}
|
|
|
|
/**
|
|
* Setter for the isNew attribute. This method will be called
|
|
* by Propel-generated children and objects.
|
|
*
|
|
* @param boolean $b the state of the object.
|
|
*/
|
|
public function setNew($b)
|
|
{
|
|
$this->new = (Boolean) $b;
|
|
}
|
|
|
|
/**
|
|
* Whether this object has been deleted.
|
|
* @return boolean The deleted state of this object.
|
|
*/
|
|
public function isDeleted()
|
|
{
|
|
return $this->deleted;
|
|
}
|
|
|
|
/**
|
|
* Specify whether this object has been deleted.
|
|
* @param boolean $b The deleted state of this object.
|
|
* @return void
|
|
*/
|
|
public function setDeleted($b)
|
|
{
|
|
$this->deleted = (Boolean) $b;
|
|
}
|
|
|
|
/**
|
|
* Sets the modified state for the object to be false.
|
|
* @param string $col If supplied, only the specified column is reset.
|
|
* @return void
|
|
*/
|
|
public function resetModified($col = null)
|
|
{
|
|
if (null !== $col) {
|
|
if (isset($this->modifiedColumns[$col])) {
|
|
unset($this->modifiedColumns[$col]);
|
|
}
|
|
} else {
|
|
$this->modifiedColumns = array();
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Compares this with another <code>Question</code> instance. If
|
|
* <code>obj</code> is an instance of <code>Question</code>, delegates to
|
|
* <code>equals(Question)</code>. Otherwise, returns <code>false</code>.
|
|
*
|
|
* @param mixed $obj The object to compare to.
|
|
* @return boolean Whether equal to the object specified.
|
|
*/
|
|
public function equals($obj)
|
|
{
|
|
$thisclazz = get_class($this);
|
|
if (!is_object($obj) || !($obj instanceof $thisclazz)) {
|
|
return false;
|
|
}
|
|
|
|
if ($this === $obj) {
|
|
return true;
|
|
}
|
|
|
|
if (null === $this->getPrimaryKey()
|
|
|| null === $obj->getPrimaryKey()) {
|
|
return false;
|
|
}
|
|
|
|
return $this->getPrimaryKey() === $obj->getPrimaryKey();
|
|
}
|
|
|
|
/**
|
|
* If the primary key is not null, return the hashcode of the
|
|
* primary key. Otherwise, return the hash code of the object.
|
|
*
|
|
* @return int Hashcode
|
|
*/
|
|
public function hashCode()
|
|
{
|
|
if (null !== $this->getPrimaryKey()) {
|
|
return crc32(serialize($this->getPrimaryKey()));
|
|
}
|
|
|
|
return crc32(serialize(clone $this));
|
|
}
|
|
|
|
/**
|
|
* Get the associative array of the virtual columns in this object
|
|
*
|
|
* @return array
|
|
*/
|
|
public function getVirtualColumns()
|
|
{
|
|
return $this->virtualColumns;
|
|
}
|
|
|
|
/**
|
|
* Checks the existence of a virtual column in this object
|
|
*
|
|
* @param string $name The virtual column name
|
|
* @return boolean
|
|
*/
|
|
public function hasVirtualColumn($name)
|
|
{
|
|
return array_key_exists($name, $this->virtualColumns);
|
|
}
|
|
|
|
/**
|
|
* Get the value of a virtual column in this object
|
|
*
|
|
* @param string $name The virtual column name
|
|
* @return mixed
|
|
*
|
|
* @throws PropelException
|
|
*/
|
|
public function getVirtualColumn($name)
|
|
{
|
|
if (!$this->hasVirtualColumn($name)) {
|
|
throw new PropelException(sprintf('Cannot get value of inexistent virtual column %s.', $name));
|
|
}
|
|
|
|
return $this->virtualColumns[$name];
|
|
}
|
|
|
|
/**
|
|
* Set the value of a virtual column in this object
|
|
*
|
|
* @param string $name The virtual column name
|
|
* @param mixed $value The value to give to the virtual column
|
|
*
|
|
* @return Question The current object, for fluid interface
|
|
*/
|
|
public function setVirtualColumn($name, $value)
|
|
{
|
|
$this->virtualColumns[$name] = $value;
|
|
|
|
return $this;
|
|
}
|
|
|
|
/**
|
|
* Logs a message using Propel::log().
|
|
*
|
|
* @param string $msg
|
|
* @param int $priority One of the Propel::LOG_* logging levels
|
|
* @return boolean
|
|
*/
|
|
protected function log($msg, $priority = Propel::LOG_INFO)
|
|
{
|
|
return Propel::log(get_class($this) . ': ' . $msg, $priority);
|
|
}
|
|
|
|
/**
|
|
* Populate the current object from a string, using a given parser format
|
|
* <code>
|
|
* $book = new Book();
|
|
* $book->importFrom('JSON', '{"Id":9012,"Title":"Don Juan","ISBN":"0140422161","Price":12.99,"PublisherId":1234,"AuthorId":5678}');
|
|
* </code>
|
|
*
|
|
* @param mixed $parser A AbstractParser instance,
|
|
* or a format name ('XML', 'YAML', 'JSON', 'CSV')
|
|
* @param string $data The source data to import from
|
|
*
|
|
* @return Question The current object, for fluid interface
|
|
*/
|
|
public function importFrom($parser, $data)
|
|
{
|
|
if (!$parser instanceof AbstractParser) {
|
|
$parser = AbstractParser::getParser($parser);
|
|
}
|
|
|
|
$this->fromArray($parser->toArray($data), TableMap::TYPE_PHPNAME);
|
|
|
|
return $this;
|
|
}
|
|
|
|
/**
|
|
* Export the current object properties to a string, using a given parser format
|
|
* <code>
|
|
* $book = BookQuery::create()->findPk(9012);
|
|
* echo $book->exportTo('JSON');
|
|
* => {"Id":9012,"Title":"Don Juan","ISBN":"0140422161","Price":12.99,"PublisherId":1234,"AuthorId":5678}');
|
|
* </code>
|
|
*
|
|
* @param mixed $parser A AbstractParser instance, or a format name ('XML', 'YAML', 'JSON', 'CSV')
|
|
* @param boolean $includeLazyLoadColumns (optional) Whether to include lazy load(ed) columns. Defaults to TRUE.
|
|
* @return string The exported data
|
|
*/
|
|
public function exportTo($parser, $includeLazyLoadColumns = true)
|
|
{
|
|
if (!$parser instanceof AbstractParser) {
|
|
$parser = AbstractParser::getParser($parser);
|
|
}
|
|
|
|
return $parser->fromArray($this->toArray(TableMap::TYPE_PHPNAME, $includeLazyLoadColumns, array(), true));
|
|
}
|
|
|
|
/**
|
|
* Clean up internal collections prior to serializing
|
|
* Avoids recursive loops that turn into segmentation faults when serializing
|
|
*/
|
|
public function __sleep()
|
|
{
|
|
$this->clearAllReferences();
|
|
|
|
return array_keys(get_object_vars($this));
|
|
}
|
|
|
|
/**
|
|
* Get the [id] column value.
|
|
*
|
|
* @return int
|
|
*/
|
|
public function getId()
|
|
{
|
|
|
|
return $this->id;
|
|
}
|
|
|
|
/**
|
|
* Get the [visible] column value.
|
|
*
|
|
* @return int
|
|
*/
|
|
public function getVisible()
|
|
{
|
|
|
|
return $this->visible;
|
|
}
|
|
|
|
/**
|
|
* Get the [game_id] column value.
|
|
*
|
|
* @return int
|
|
*/
|
|
public function getGameId()
|
|
{
|
|
|
|
return $this->game_id;
|
|
}
|
|
|
|
/**
|
|
* Get the [optionally formatted] temporal [created_at] column value.
|
|
*
|
|
*
|
|
* @param string $format The date/time format string (either date()-style or strftime()-style).
|
|
* If format is NULL, then the raw \DateTime object will be returned.
|
|
*
|
|
* @return mixed Formatted date/time value as string or \DateTime object (if format is NULL), NULL if column is NULL, and 0 if column value is 0000-00-00 00:00:00
|
|
*
|
|
* @throws PropelException - if unable to parse/validate the date/time value.
|
|
*/
|
|
public function getCreatedAt($format = NULL)
|
|
{
|
|
if ($format === null) {
|
|
return $this->created_at;
|
|
} else {
|
|
return $this->created_at instanceof \DateTime ? $this->created_at->format($format) : null;
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Get the [optionally formatted] temporal [updated_at] column value.
|
|
*
|
|
*
|
|
* @param string $format The date/time format string (either date()-style or strftime()-style).
|
|
* If format is NULL, then the raw \DateTime object will be returned.
|
|
*
|
|
* @return mixed Formatted date/time value as string or \DateTime object (if format is NULL), NULL if column is NULL, and 0 if column value is 0000-00-00 00:00:00
|
|
*
|
|
* @throws PropelException - if unable to parse/validate the date/time value.
|
|
*/
|
|
public function getUpdatedAt($format = NULL)
|
|
{
|
|
if ($format === null) {
|
|
return $this->updated_at;
|
|
} else {
|
|
return $this->updated_at instanceof \DateTime ? $this->updated_at->format($format) : null;
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Get the [version] column value.
|
|
*
|
|
* @return int
|
|
*/
|
|
public function getVersion()
|
|
{
|
|
|
|
return $this->version;
|
|
}
|
|
|
|
/**
|
|
* Get the [optionally formatted] temporal [version_created_at] column value.
|
|
*
|
|
*
|
|
* @param string $format The date/time format string (either date()-style or strftime()-style).
|
|
* If format is NULL, then the raw \DateTime object will be returned.
|
|
*
|
|
* @return mixed Formatted date/time value as string or \DateTime object (if format is NULL), NULL if column is NULL, and 0 if column value is 0000-00-00 00:00:00
|
|
*
|
|
* @throws PropelException - if unable to parse/validate the date/time value.
|
|
*/
|
|
public function getVersionCreatedAt($format = NULL)
|
|
{
|
|
if ($format === null) {
|
|
return $this->version_created_at;
|
|
} else {
|
|
return $this->version_created_at instanceof \DateTime ? $this->version_created_at->format($format) : null;
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Get the [version_created_by] column value.
|
|
*
|
|
* @return string
|
|
*/
|
|
public function getVersionCreatedBy()
|
|
{
|
|
|
|
return $this->version_created_by;
|
|
}
|
|
|
|
/**
|
|
* Set the value of [id] column.
|
|
*
|
|
* @param int $v new value
|
|
* @return \Contest\Model\Question The current object (for fluent API support)
|
|
*/
|
|
public function setId($v)
|
|
{
|
|
if ($v !== null) {
|
|
$v = (int) $v;
|
|
}
|
|
|
|
if ($this->id !== $v) {
|
|
$this->id = $v;
|
|
$this->modifiedColumns[QuestionTableMap::ID] = true;
|
|
}
|
|
|
|
|
|
return $this;
|
|
} // setId()
|
|
|
|
/**
|
|
* Set the value of [visible] column.
|
|
*
|
|
* @param int $v new value
|
|
* @return \Contest\Model\Question The current object (for fluent API support)
|
|
*/
|
|
public function setVisible($v)
|
|
{
|
|
if ($v !== null) {
|
|
$v = (int) $v;
|
|
}
|
|
|
|
if ($this->visible !== $v) {
|
|
$this->visible = $v;
|
|
$this->modifiedColumns[QuestionTableMap::VISIBLE] = true;
|
|
}
|
|
|
|
|
|
return $this;
|
|
} // setVisible()
|
|
|
|
/**
|
|
* Set the value of [game_id] column.
|
|
*
|
|
* @param int $v new value
|
|
* @return \Contest\Model\Question The current object (for fluent API support)
|
|
*/
|
|
public function setGameId($v)
|
|
{
|
|
if ($v !== null) {
|
|
$v = (int) $v;
|
|
}
|
|
|
|
if ($this->game_id !== $v) {
|
|
$this->game_id = $v;
|
|
$this->modifiedColumns[QuestionTableMap::GAME_ID] = true;
|
|
}
|
|
|
|
if ($this->aGame !== null && $this->aGame->getId() !== $v) {
|
|
$this->aGame = null;
|
|
}
|
|
|
|
|
|
return $this;
|
|
} // setGameId()
|
|
|
|
/**
|
|
* Sets the value of [created_at] column to a normalized version of the date/time value specified.
|
|
*
|
|
* @param mixed $v string, integer (timestamp), or \DateTime value.
|
|
* Empty strings are treated as NULL.
|
|
* @return \Contest\Model\Question The current object (for fluent API support)
|
|
*/
|
|
public function setCreatedAt($v)
|
|
{
|
|
$dt = PropelDateTime::newInstance($v, null, '\DateTime');
|
|
if ($this->created_at !== null || $dt !== null) {
|
|
if ($dt !== $this->created_at) {
|
|
$this->created_at = $dt;
|
|
$this->modifiedColumns[QuestionTableMap::CREATED_AT] = true;
|
|
}
|
|
} // if either are not null
|
|
|
|
|
|
return $this;
|
|
} // setCreatedAt()
|
|
|
|
/**
|
|
* Sets the value of [updated_at] column to a normalized version of the date/time value specified.
|
|
*
|
|
* @param mixed $v string, integer (timestamp), or \DateTime value.
|
|
* Empty strings are treated as NULL.
|
|
* @return \Contest\Model\Question The current object (for fluent API support)
|
|
*/
|
|
public function setUpdatedAt($v)
|
|
{
|
|
$dt = PropelDateTime::newInstance($v, null, '\DateTime');
|
|
if ($this->updated_at !== null || $dt !== null) {
|
|
if ($dt !== $this->updated_at) {
|
|
$this->updated_at = $dt;
|
|
$this->modifiedColumns[QuestionTableMap::UPDATED_AT] = true;
|
|
}
|
|
} // if either are not null
|
|
|
|
|
|
return $this;
|
|
} // setUpdatedAt()
|
|
|
|
/**
|
|
* Set the value of [version] column.
|
|
*
|
|
* @param int $v new value
|
|
* @return \Contest\Model\Question The current object (for fluent API support)
|
|
*/
|
|
public function setVersion($v)
|
|
{
|
|
if ($v !== null) {
|
|
$v = (int) $v;
|
|
}
|
|
|
|
if ($this->version !== $v) {
|
|
$this->version = $v;
|
|
$this->modifiedColumns[QuestionTableMap::VERSION] = true;
|
|
}
|
|
|
|
|
|
return $this;
|
|
} // setVersion()
|
|
|
|
/**
|
|
* Sets the value of [version_created_at] column to a normalized version of the date/time value specified.
|
|
*
|
|
* @param mixed $v string, integer (timestamp), or \DateTime value.
|
|
* Empty strings are treated as NULL.
|
|
* @return \Contest\Model\Question The current object (for fluent API support)
|
|
*/
|
|
public function setVersionCreatedAt($v)
|
|
{
|
|
$dt = PropelDateTime::newInstance($v, null, '\DateTime');
|
|
if ($this->version_created_at !== null || $dt !== null) {
|
|
if ($dt !== $this->version_created_at) {
|
|
$this->version_created_at = $dt;
|
|
$this->modifiedColumns[QuestionTableMap::VERSION_CREATED_AT] = true;
|
|
}
|
|
} // if either are not null
|
|
|
|
|
|
return $this;
|
|
} // setVersionCreatedAt()
|
|
|
|
/**
|
|
* Set the value of [version_created_by] column.
|
|
*
|
|
* @param string $v new value
|
|
* @return \Contest\Model\Question The current object (for fluent API support)
|
|
*/
|
|
public function setVersionCreatedBy($v)
|
|
{
|
|
if ($v !== null) {
|
|
$v = (string) $v;
|
|
}
|
|
|
|
if ($this->version_created_by !== $v) {
|
|
$this->version_created_by = $v;
|
|
$this->modifiedColumns[QuestionTableMap::VERSION_CREATED_BY] = true;
|
|
}
|
|
|
|
|
|
return $this;
|
|
} // setVersionCreatedBy()
|
|
|
|
/**
|
|
* Indicates whether the columns in this object are only set to default values.
|
|
*
|
|
* This method can be used in conjunction with isModified() to indicate whether an object is both
|
|
* modified _and_ has some values set which are non-default.
|
|
*
|
|
* @return boolean Whether the columns in this object are only been set with default values.
|
|
*/
|
|
public function hasOnlyDefaultValues()
|
|
{
|
|
if ($this->visible !== 0) {
|
|
return false;
|
|
}
|
|
|
|
if ($this->version !== 0) {
|
|
return false;
|
|
}
|
|
|
|
// otherwise, everything was equal, so return TRUE
|
|
return true;
|
|
} // hasOnlyDefaultValues()
|
|
|
|
/**
|
|
* Hydrates (populates) the object variables with values from the database resultset.
|
|
*
|
|
* An offset (0-based "start column") is specified so that objects can be hydrated
|
|
* with a subset of the columns in the resultset rows. This is needed, for example,
|
|
* for results of JOIN queries where the resultset row includes columns from two or
|
|
* more tables.
|
|
*
|
|
* @param array $row The row returned by DataFetcher->fetch().
|
|
* @param int $startcol 0-based offset column which indicates which restultset column to start with.
|
|
* @param boolean $rehydrate Whether this object is being re-hydrated from the database.
|
|
* @param string $indexType The index type of $row. Mostly DataFetcher->getIndexType().
|
|
One of the class type constants TableMap::TYPE_PHPNAME, TableMap::TYPE_STUDLYPHPNAME
|
|
* TableMap::TYPE_COLNAME, TableMap::TYPE_FIELDNAME, TableMap::TYPE_NUM.
|
|
*
|
|
* @return int next starting column
|
|
* @throws PropelException - Any caught Exception will be rewrapped as a PropelException.
|
|
*/
|
|
public function hydrate($row, $startcol = 0, $rehydrate = false, $indexType = TableMap::TYPE_NUM)
|
|
{
|
|
try {
|
|
|
|
|
|
$col = $row[TableMap::TYPE_NUM == $indexType ? 0 + $startcol : QuestionTableMap::translateFieldName('Id', TableMap::TYPE_PHPNAME, $indexType)];
|
|
$this->id = (null !== $col) ? (int) $col : null;
|
|
|
|
$col = $row[TableMap::TYPE_NUM == $indexType ? 1 + $startcol : QuestionTableMap::translateFieldName('Visible', TableMap::TYPE_PHPNAME, $indexType)];
|
|
$this->visible = (null !== $col) ? (int) $col : null;
|
|
|
|
$col = $row[TableMap::TYPE_NUM == $indexType ? 2 + $startcol : QuestionTableMap::translateFieldName('GameId', TableMap::TYPE_PHPNAME, $indexType)];
|
|
$this->game_id = (null !== $col) ? (int) $col : null;
|
|
|
|
$col = $row[TableMap::TYPE_NUM == $indexType ? 3 + $startcol : QuestionTableMap::translateFieldName('CreatedAt', TableMap::TYPE_PHPNAME, $indexType)];
|
|
if ($col === '0000-00-00 00:00:00') {
|
|
$col = null;
|
|
}
|
|
$this->created_at = (null !== $col) ? PropelDateTime::newInstance($col, null, '\DateTime') : null;
|
|
|
|
$col = $row[TableMap::TYPE_NUM == $indexType ? 4 + $startcol : QuestionTableMap::translateFieldName('UpdatedAt', TableMap::TYPE_PHPNAME, $indexType)];
|
|
if ($col === '0000-00-00 00:00:00') {
|
|
$col = null;
|
|
}
|
|
$this->updated_at = (null !== $col) ? PropelDateTime::newInstance($col, null, '\DateTime') : null;
|
|
|
|
$col = $row[TableMap::TYPE_NUM == $indexType ? 5 + $startcol : QuestionTableMap::translateFieldName('Version', TableMap::TYPE_PHPNAME, $indexType)];
|
|
$this->version = (null !== $col) ? (int) $col : null;
|
|
|
|
$col = $row[TableMap::TYPE_NUM == $indexType ? 6 + $startcol : QuestionTableMap::translateFieldName('VersionCreatedAt', TableMap::TYPE_PHPNAME, $indexType)];
|
|
if ($col === '0000-00-00 00:00:00') {
|
|
$col = null;
|
|
}
|
|
$this->version_created_at = (null !== $col) ? PropelDateTime::newInstance($col, null, '\DateTime') : null;
|
|
|
|
$col = $row[TableMap::TYPE_NUM == $indexType ? 7 + $startcol : QuestionTableMap::translateFieldName('VersionCreatedBy', TableMap::TYPE_PHPNAME, $indexType)];
|
|
$this->version_created_by = (null !== $col) ? (string) $col : null;
|
|
$this->resetModified();
|
|
|
|
$this->setNew(false);
|
|
|
|
if ($rehydrate) {
|
|
$this->ensureConsistency();
|
|
}
|
|
|
|
return $startcol + 8; // 8 = QuestionTableMap::NUM_HYDRATE_COLUMNS.
|
|
|
|
} catch (Exception $e) {
|
|
throw new PropelException("Error populating \Contest\Model\Question object", 0, $e);
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Checks and repairs the internal consistency of the object.
|
|
*
|
|
* This method is executed after an already-instantiated object is re-hydrated
|
|
* from the database. It exists to check any foreign keys to make sure that
|
|
* the objects related to the current object are correct based on foreign key.
|
|
*
|
|
* You can override this method in the stub class, but you should always invoke
|
|
* the base method from the overridden method (i.e. parent::ensureConsistency()),
|
|
* in case your model changes.
|
|
*
|
|
* @throws PropelException
|
|
*/
|
|
public function ensureConsistency()
|
|
{
|
|
if ($this->aGame !== null && $this->game_id !== $this->aGame->getId()) {
|
|
$this->aGame = null;
|
|
}
|
|
} // ensureConsistency
|
|
|
|
/**
|
|
* Reloads this object from datastore based on primary key and (optionally) resets all associated objects.
|
|
*
|
|
* This will only work if the object has been saved and has a valid primary key set.
|
|
*
|
|
* @param boolean $deep (optional) Whether to also de-associated any related objects.
|
|
* @param ConnectionInterface $con (optional) The ConnectionInterface connection to use.
|
|
* @return void
|
|
* @throws PropelException - if this object is deleted, unsaved or doesn't have pk match in db
|
|
*/
|
|
public function reload($deep = false, ConnectionInterface $con = null)
|
|
{
|
|
if ($this->isDeleted()) {
|
|
throw new PropelException("Cannot reload a deleted object.");
|
|
}
|
|
|
|
if ($this->isNew()) {
|
|
throw new PropelException("Cannot reload an unsaved object.");
|
|
}
|
|
|
|
if ($con === null) {
|
|
$con = Propel::getServiceContainer()->getReadConnection(QuestionTableMap::DATABASE_NAME);
|
|
}
|
|
|
|
// We don't need to alter the object instance pool; we're just modifying this instance
|
|
// already in the pool.
|
|
|
|
$dataFetcher = ChildQuestionQuery::create(null, $this->buildPkeyCriteria())->setFormatter(ModelCriteria::FORMAT_STATEMENT)->find($con);
|
|
$row = $dataFetcher->fetch();
|
|
$dataFetcher->close();
|
|
if (!$row) {
|
|
throw new PropelException('Cannot find matching row in the database to reload object values.');
|
|
}
|
|
$this->hydrate($row, 0, true, $dataFetcher->getIndexType()); // rehydrate
|
|
|
|
if ($deep) { // also de-associate any related objects?
|
|
|
|
$this->aGame = null;
|
|
$this->collAnswers = null;
|
|
|
|
$this->collQuestionI18ns = null;
|
|
|
|
$this->collQuestionVersions = null;
|
|
|
|
} // if (deep)
|
|
}
|
|
|
|
/**
|
|
* Removes this object from datastore and sets delete attribute.
|
|
*
|
|
* @param ConnectionInterface $con
|
|
* @return void
|
|
* @throws PropelException
|
|
* @see Question::setDeleted()
|
|
* @see Question::isDeleted()
|
|
*/
|
|
public function delete(ConnectionInterface $con = null)
|
|
{
|
|
if ($this->isDeleted()) {
|
|
throw new PropelException("This object has already been deleted.");
|
|
}
|
|
|
|
if ($con === null) {
|
|
$con = Propel::getServiceContainer()->getWriteConnection(QuestionTableMap::DATABASE_NAME);
|
|
}
|
|
|
|
$con->beginTransaction();
|
|
try {
|
|
$deleteQuery = ChildQuestionQuery::create()
|
|
->filterByPrimaryKey($this->getPrimaryKey());
|
|
$ret = $this->preDelete($con);
|
|
if ($ret) {
|
|
$deleteQuery->delete($con);
|
|
$this->postDelete($con);
|
|
$con->commit();
|
|
$this->setDeleted(true);
|
|
} else {
|
|
$con->commit();
|
|
}
|
|
} catch (Exception $e) {
|
|
$con->rollBack();
|
|
throw $e;
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Persists this object to the database.
|
|
*
|
|
* If the object is new, it inserts it; otherwise an update is performed.
|
|
* All modified related objects will also be persisted in the doSave()
|
|
* method. This method wraps all precipitate database operations in a
|
|
* single transaction.
|
|
*
|
|
* @param ConnectionInterface $con
|
|
* @return int The number of rows affected by this insert/update and any referring fk objects' save() operations.
|
|
* @throws PropelException
|
|
* @see doSave()
|
|
*/
|
|
public function save(ConnectionInterface $con = null)
|
|
{
|
|
if ($this->isDeleted()) {
|
|
throw new PropelException("You cannot save an object that has been deleted.");
|
|
}
|
|
|
|
if ($con === null) {
|
|
$con = Propel::getServiceContainer()->getWriteConnection(QuestionTableMap::DATABASE_NAME);
|
|
}
|
|
|
|
$con->beginTransaction();
|
|
$isInsert = $this->isNew();
|
|
try {
|
|
$ret = $this->preSave($con);
|
|
// versionable behavior
|
|
if ($this->isVersioningNecessary()) {
|
|
$this->setVersion($this->isNew() ? 1 : $this->getLastVersionNumber($con) + 1);
|
|
if (!$this->isColumnModified(QuestionTableMap::VERSION_CREATED_AT)) {
|
|
$this->setVersionCreatedAt(time());
|
|
}
|
|
$createVersion = true; // for postSave hook
|
|
}
|
|
if ($isInsert) {
|
|
$ret = $ret && $this->preInsert($con);
|
|
// timestampable behavior
|
|
if (!$this->isColumnModified(QuestionTableMap::CREATED_AT)) {
|
|
$this->setCreatedAt(time());
|
|
}
|
|
if (!$this->isColumnModified(QuestionTableMap::UPDATED_AT)) {
|
|
$this->setUpdatedAt(time());
|
|
}
|
|
} else {
|
|
$ret = $ret && $this->preUpdate($con);
|
|
// timestampable behavior
|
|
if ($this->isModified() && !$this->isColumnModified(QuestionTableMap::UPDATED_AT)) {
|
|
$this->setUpdatedAt(time());
|
|
}
|
|
}
|
|
if ($ret) {
|
|
$affectedRows = $this->doSave($con);
|
|
if ($isInsert) {
|
|
$this->postInsert($con);
|
|
} else {
|
|
$this->postUpdate($con);
|
|
}
|
|
$this->postSave($con);
|
|
// versionable behavior
|
|
if (isset($createVersion)) {
|
|
$this->addVersion($con);
|
|
}
|
|
QuestionTableMap::addInstanceToPool($this);
|
|
} else {
|
|
$affectedRows = 0;
|
|
}
|
|
$con->commit();
|
|
|
|
return $affectedRows;
|
|
} catch (Exception $e) {
|
|
$con->rollBack();
|
|
throw $e;
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Performs the work of inserting or updating the row in the database.
|
|
*
|
|
* If the object is new, it inserts it; otherwise an update is performed.
|
|
* All related objects are also updated in this method.
|
|
*
|
|
* @param ConnectionInterface $con
|
|
* @return int The number of rows affected by this insert/update and any referring fk objects' save() operations.
|
|
* @throws PropelException
|
|
* @see save()
|
|
*/
|
|
protected function doSave(ConnectionInterface $con)
|
|
{
|
|
$affectedRows = 0; // initialize var to track total num of affected rows
|
|
if (!$this->alreadyInSave) {
|
|
$this->alreadyInSave = true;
|
|
|
|
// We call the save method on the following object(s) if they
|
|
// were passed to this object by their corresponding set
|
|
// method. This object relates to these object(s) by a
|
|
// foreign key reference.
|
|
|
|
if ($this->aGame !== null) {
|
|
if ($this->aGame->isModified() || $this->aGame->isNew()) {
|
|
$affectedRows += $this->aGame->save($con);
|
|
}
|
|
$this->setGame($this->aGame);
|
|
}
|
|
|
|
if ($this->isNew() || $this->isModified()) {
|
|
// persist changes
|
|
if ($this->isNew()) {
|
|
$this->doInsert($con);
|
|
} else {
|
|
$this->doUpdate($con);
|
|
}
|
|
$affectedRows += 1;
|
|
$this->resetModified();
|
|
}
|
|
|
|
if ($this->answersScheduledForDeletion !== null) {
|
|
if (!$this->answersScheduledForDeletion->isEmpty()) {
|
|
\Contest\Model\AnswerQuery::create()
|
|
->filterByPrimaryKeys($this->answersScheduledForDeletion->getPrimaryKeys(false))
|
|
->delete($con);
|
|
$this->answersScheduledForDeletion = null;
|
|
}
|
|
}
|
|
|
|
if ($this->collAnswers !== null) {
|
|
foreach ($this->collAnswers as $referrerFK) {
|
|
if (!$referrerFK->isDeleted() && ($referrerFK->isNew() || $referrerFK->isModified())) {
|
|
$affectedRows += $referrerFK->save($con);
|
|
}
|
|
}
|
|
}
|
|
|
|
if ($this->questionI18nsScheduledForDeletion !== null) {
|
|
if (!$this->questionI18nsScheduledForDeletion->isEmpty()) {
|
|
\Contest\Model\QuestionI18nQuery::create()
|
|
->filterByPrimaryKeys($this->questionI18nsScheduledForDeletion->getPrimaryKeys(false))
|
|
->delete($con);
|
|
$this->questionI18nsScheduledForDeletion = null;
|
|
}
|
|
}
|
|
|
|
if ($this->collQuestionI18ns !== null) {
|
|
foreach ($this->collQuestionI18ns as $referrerFK) {
|
|
if (!$referrerFK->isDeleted() && ($referrerFK->isNew() || $referrerFK->isModified())) {
|
|
$affectedRows += $referrerFK->save($con);
|
|
}
|
|
}
|
|
}
|
|
|
|
if ($this->questionVersionsScheduledForDeletion !== null) {
|
|
if (!$this->questionVersionsScheduledForDeletion->isEmpty()) {
|
|
\Contest\Model\QuestionVersionQuery::create()
|
|
->filterByPrimaryKeys($this->questionVersionsScheduledForDeletion->getPrimaryKeys(false))
|
|
->delete($con);
|
|
$this->questionVersionsScheduledForDeletion = null;
|
|
}
|
|
}
|
|
|
|
if ($this->collQuestionVersions !== null) {
|
|
foreach ($this->collQuestionVersions as $referrerFK) {
|
|
if (!$referrerFK->isDeleted() && ($referrerFK->isNew() || $referrerFK->isModified())) {
|
|
$affectedRows += $referrerFK->save($con);
|
|
}
|
|
}
|
|
}
|
|
|
|
$this->alreadyInSave = false;
|
|
|
|
}
|
|
|
|
return $affectedRows;
|
|
} // doSave()
|
|
|
|
/**
|
|
* Insert the row in the database.
|
|
*
|
|
* @param ConnectionInterface $con
|
|
*
|
|
* @throws PropelException
|
|
* @see doSave()
|
|
*/
|
|
protected function doInsert(ConnectionInterface $con)
|
|
{
|
|
$modifiedColumns = array();
|
|
$index = 0;
|
|
|
|
$this->modifiedColumns[QuestionTableMap::ID] = true;
|
|
if (null !== $this->id) {
|
|
throw new PropelException('Cannot insert a value for auto-increment primary key (' . QuestionTableMap::ID . ')');
|
|
}
|
|
|
|
// check the columns in natural order for more readable SQL queries
|
|
if ($this->isColumnModified(QuestionTableMap::ID)) {
|
|
$modifiedColumns[':p' . $index++] = 'ID';
|
|
}
|
|
if ($this->isColumnModified(QuestionTableMap::VISIBLE)) {
|
|
$modifiedColumns[':p' . $index++] = 'VISIBLE';
|
|
}
|
|
if ($this->isColumnModified(QuestionTableMap::GAME_ID)) {
|
|
$modifiedColumns[':p' . $index++] = 'GAME_ID';
|
|
}
|
|
if ($this->isColumnModified(QuestionTableMap::CREATED_AT)) {
|
|
$modifiedColumns[':p' . $index++] = 'CREATED_AT';
|
|
}
|
|
if ($this->isColumnModified(QuestionTableMap::UPDATED_AT)) {
|
|
$modifiedColumns[':p' . $index++] = 'UPDATED_AT';
|
|
}
|
|
if ($this->isColumnModified(QuestionTableMap::VERSION)) {
|
|
$modifiedColumns[':p' . $index++] = 'VERSION';
|
|
}
|
|
if ($this->isColumnModified(QuestionTableMap::VERSION_CREATED_AT)) {
|
|
$modifiedColumns[':p' . $index++] = 'VERSION_CREATED_AT';
|
|
}
|
|
if ($this->isColumnModified(QuestionTableMap::VERSION_CREATED_BY)) {
|
|
$modifiedColumns[':p' . $index++] = 'VERSION_CREATED_BY';
|
|
}
|
|
|
|
$sql = sprintf(
|
|
'INSERT INTO question (%s) VALUES (%s)',
|
|
implode(', ', $modifiedColumns),
|
|
implode(', ', array_keys($modifiedColumns))
|
|
);
|
|
|
|
try {
|
|
$stmt = $con->prepare($sql);
|
|
foreach ($modifiedColumns as $identifier => $columnName) {
|
|
switch ($columnName) {
|
|
case 'ID':
|
|
$stmt->bindValue($identifier, $this->id, PDO::PARAM_INT);
|
|
break;
|
|
case 'VISIBLE':
|
|
$stmt->bindValue($identifier, $this->visible, PDO::PARAM_INT);
|
|
break;
|
|
case 'GAME_ID':
|
|
$stmt->bindValue($identifier, $this->game_id, PDO::PARAM_INT);
|
|
break;
|
|
case 'CREATED_AT':
|
|
$stmt->bindValue($identifier, $this->created_at ? $this->created_at->format("Y-m-d H:i:s") : null, PDO::PARAM_STR);
|
|
break;
|
|
case 'UPDATED_AT':
|
|
$stmt->bindValue($identifier, $this->updated_at ? $this->updated_at->format("Y-m-d H:i:s") : null, PDO::PARAM_STR);
|
|
break;
|
|
case 'VERSION':
|
|
$stmt->bindValue($identifier, $this->version, PDO::PARAM_INT);
|
|
break;
|
|
case 'VERSION_CREATED_AT':
|
|
$stmt->bindValue($identifier, $this->version_created_at ? $this->version_created_at->format("Y-m-d H:i:s") : null, PDO::PARAM_STR);
|
|
break;
|
|
case 'VERSION_CREATED_BY':
|
|
$stmt->bindValue($identifier, $this->version_created_by, PDO::PARAM_STR);
|
|
break;
|
|
}
|
|
}
|
|
$stmt->execute();
|
|
} catch (Exception $e) {
|
|
Propel::log($e->getMessage(), Propel::LOG_ERR);
|
|
throw new PropelException(sprintf('Unable to execute INSERT statement [%s]', $sql), 0, $e);
|
|
}
|
|
|
|
try {
|
|
$pk = $con->lastInsertId();
|
|
} catch (Exception $e) {
|
|
throw new PropelException('Unable to get autoincrement id.', 0, $e);
|
|
}
|
|
$this->setId($pk);
|
|
|
|
$this->setNew(false);
|
|
}
|
|
|
|
/**
|
|
* Update the row in the database.
|
|
*
|
|
* @param ConnectionInterface $con
|
|
*
|
|
* @return Integer Number of updated rows
|
|
* @see doSave()
|
|
*/
|
|
protected function doUpdate(ConnectionInterface $con)
|
|
{
|
|
$selectCriteria = $this->buildPkeyCriteria();
|
|
$valuesCriteria = $this->buildCriteria();
|
|
|
|
return $selectCriteria->doUpdate($valuesCriteria, $con);
|
|
}
|
|
|
|
/**
|
|
* Retrieves a field from the object by name passed in as a string.
|
|
*
|
|
* @param string $name name
|
|
* @param string $type The type of fieldname the $name is of:
|
|
* one of the class type constants TableMap::TYPE_PHPNAME, TableMap::TYPE_STUDLYPHPNAME
|
|
* TableMap::TYPE_COLNAME, TableMap::TYPE_FIELDNAME, TableMap::TYPE_NUM.
|
|
* Defaults to TableMap::TYPE_PHPNAME.
|
|
* @return mixed Value of field.
|
|
*/
|
|
public function getByName($name, $type = TableMap::TYPE_PHPNAME)
|
|
{
|
|
$pos = QuestionTableMap::translateFieldName($name, $type, TableMap::TYPE_NUM);
|
|
$field = $this->getByPosition($pos);
|
|
|
|
return $field;
|
|
}
|
|
|
|
/**
|
|
* Retrieves a field from the object by Position as specified in the xml schema.
|
|
* Zero-based.
|
|
*
|
|
* @param int $pos position in xml schema
|
|
* @return mixed Value of field at $pos
|
|
*/
|
|
public function getByPosition($pos)
|
|
{
|
|
switch ($pos) {
|
|
case 0:
|
|
return $this->getId();
|
|
break;
|
|
case 1:
|
|
return $this->getVisible();
|
|
break;
|
|
case 2:
|
|
return $this->getGameId();
|
|
break;
|
|
case 3:
|
|
return $this->getCreatedAt();
|
|
break;
|
|
case 4:
|
|
return $this->getUpdatedAt();
|
|
break;
|
|
case 5:
|
|
return $this->getVersion();
|
|
break;
|
|
case 6:
|
|
return $this->getVersionCreatedAt();
|
|
break;
|
|
case 7:
|
|
return $this->getVersionCreatedBy();
|
|
break;
|
|
default:
|
|
return null;
|
|
break;
|
|
} // switch()
|
|
}
|
|
|
|
/**
|
|
* Exports the object as an array.
|
|
*
|
|
* You can specify the key type of the array by passing one of the class
|
|
* type constants.
|
|
*
|
|
* @param string $keyType (optional) One of the class type constants TableMap::TYPE_PHPNAME, TableMap::TYPE_STUDLYPHPNAME,
|
|
* TableMap::TYPE_COLNAME, TableMap::TYPE_FIELDNAME, TableMap::TYPE_NUM.
|
|
* Defaults to TableMap::TYPE_PHPNAME.
|
|
* @param boolean $includeLazyLoadColumns (optional) Whether to include lazy loaded columns. Defaults to TRUE.
|
|
* @param array $alreadyDumpedObjects List of objects to skip to avoid recursion
|
|
* @param boolean $includeForeignObjects (optional) Whether to include hydrated related objects. Default to FALSE.
|
|
*
|
|
* @return array an associative array containing the field names (as keys) and field values
|
|
*/
|
|
public function toArray($keyType = TableMap::TYPE_PHPNAME, $includeLazyLoadColumns = true, $alreadyDumpedObjects = array(), $includeForeignObjects = false)
|
|
{
|
|
if (isset($alreadyDumpedObjects['Question'][$this->getPrimaryKey()])) {
|
|
return '*RECURSION*';
|
|
}
|
|
$alreadyDumpedObjects['Question'][$this->getPrimaryKey()] = true;
|
|
$keys = QuestionTableMap::getFieldNames($keyType);
|
|
$result = array(
|
|
$keys[0] => $this->getId(),
|
|
$keys[1] => $this->getVisible(),
|
|
$keys[2] => $this->getGameId(),
|
|
$keys[3] => $this->getCreatedAt(),
|
|
$keys[4] => $this->getUpdatedAt(),
|
|
$keys[5] => $this->getVersion(),
|
|
$keys[6] => $this->getVersionCreatedAt(),
|
|
$keys[7] => $this->getVersionCreatedBy(),
|
|
);
|
|
$virtualColumns = $this->virtualColumns;
|
|
foreach ($virtualColumns as $key => $virtualColumn) {
|
|
$result[$key] = $virtualColumn;
|
|
}
|
|
|
|
if ($includeForeignObjects) {
|
|
if (null !== $this->aGame) {
|
|
$result['Game'] = $this->aGame->toArray($keyType, $includeLazyLoadColumns, $alreadyDumpedObjects, true);
|
|
}
|
|
if (null !== $this->collAnswers) {
|
|
$result['Answers'] = $this->collAnswers->toArray(null, true, $keyType, $includeLazyLoadColumns, $alreadyDumpedObjects);
|
|
}
|
|
if (null !== $this->collQuestionI18ns) {
|
|
$result['QuestionI18ns'] = $this->collQuestionI18ns->toArray(null, true, $keyType, $includeLazyLoadColumns, $alreadyDumpedObjects);
|
|
}
|
|
if (null !== $this->collQuestionVersions) {
|
|
$result['QuestionVersions'] = $this->collQuestionVersions->toArray(null, true, $keyType, $includeLazyLoadColumns, $alreadyDumpedObjects);
|
|
}
|
|
}
|
|
|
|
return $result;
|
|
}
|
|
|
|
/**
|
|
* Sets a field from the object by name passed in as a string.
|
|
*
|
|
* @param string $name
|
|
* @param mixed $value field value
|
|
* @param string $type The type of fieldname the $name is of:
|
|
* one of the class type constants TableMap::TYPE_PHPNAME, TableMap::TYPE_STUDLYPHPNAME
|
|
* TableMap::TYPE_COLNAME, TableMap::TYPE_FIELDNAME, TableMap::TYPE_NUM.
|
|
* Defaults to TableMap::TYPE_PHPNAME.
|
|
* @return void
|
|
*/
|
|
public function setByName($name, $value, $type = TableMap::TYPE_PHPNAME)
|
|
{
|
|
$pos = QuestionTableMap::translateFieldName($name, $type, TableMap::TYPE_NUM);
|
|
|
|
return $this->setByPosition($pos, $value);
|
|
}
|
|
|
|
/**
|
|
* Sets a field from the object by Position as specified in the xml schema.
|
|
* Zero-based.
|
|
*
|
|
* @param int $pos position in xml schema
|
|
* @param mixed $value field value
|
|
* @return void
|
|
*/
|
|
public function setByPosition($pos, $value)
|
|
{
|
|
switch ($pos) {
|
|
case 0:
|
|
$this->setId($value);
|
|
break;
|
|
case 1:
|
|
$this->setVisible($value);
|
|
break;
|
|
case 2:
|
|
$this->setGameId($value);
|
|
break;
|
|
case 3:
|
|
$this->setCreatedAt($value);
|
|
break;
|
|
case 4:
|
|
$this->setUpdatedAt($value);
|
|
break;
|
|
case 5:
|
|
$this->setVersion($value);
|
|
break;
|
|
case 6:
|
|
$this->setVersionCreatedAt($value);
|
|
break;
|
|
case 7:
|
|
$this->setVersionCreatedBy($value);
|
|
break;
|
|
} // switch()
|
|
}
|
|
|
|
/**
|
|
* Populates the object using an array.
|
|
*
|
|
* This is particularly useful when populating an object from one of the
|
|
* request arrays (e.g. $_POST). This method goes through the column
|
|
* names, checking to see whether a matching key exists in populated
|
|
* array. If so the setByName() method is called for that column.
|
|
*
|
|
* You can specify the key type of the array by additionally passing one
|
|
* of the class type constants TableMap::TYPE_PHPNAME, TableMap::TYPE_STUDLYPHPNAME,
|
|
* TableMap::TYPE_COLNAME, TableMap::TYPE_FIELDNAME, TableMap::TYPE_NUM.
|
|
* The default key type is the column's TableMap::TYPE_PHPNAME.
|
|
*
|
|
* @param array $arr An array to populate the object from.
|
|
* @param string $keyType The type of keys the array uses.
|
|
* @return void
|
|
*/
|
|
public function fromArray($arr, $keyType = TableMap::TYPE_PHPNAME)
|
|
{
|
|
$keys = QuestionTableMap::getFieldNames($keyType);
|
|
|
|
if (array_key_exists($keys[0], $arr)) $this->setId($arr[$keys[0]]);
|
|
if (array_key_exists($keys[1], $arr)) $this->setVisible($arr[$keys[1]]);
|
|
if (array_key_exists($keys[2], $arr)) $this->setGameId($arr[$keys[2]]);
|
|
if (array_key_exists($keys[3], $arr)) $this->setCreatedAt($arr[$keys[3]]);
|
|
if (array_key_exists($keys[4], $arr)) $this->setUpdatedAt($arr[$keys[4]]);
|
|
if (array_key_exists($keys[5], $arr)) $this->setVersion($arr[$keys[5]]);
|
|
if (array_key_exists($keys[6], $arr)) $this->setVersionCreatedAt($arr[$keys[6]]);
|
|
if (array_key_exists($keys[7], $arr)) $this->setVersionCreatedBy($arr[$keys[7]]);
|
|
}
|
|
|
|
/**
|
|
* Build a Criteria object containing the values of all modified columns in this object.
|
|
*
|
|
* @return Criteria The Criteria object containing all modified values.
|
|
*/
|
|
public function buildCriteria()
|
|
{
|
|
$criteria = new Criteria(QuestionTableMap::DATABASE_NAME);
|
|
|
|
if ($this->isColumnModified(QuestionTableMap::ID)) $criteria->add(QuestionTableMap::ID, $this->id);
|
|
if ($this->isColumnModified(QuestionTableMap::VISIBLE)) $criteria->add(QuestionTableMap::VISIBLE, $this->visible);
|
|
if ($this->isColumnModified(QuestionTableMap::GAME_ID)) $criteria->add(QuestionTableMap::GAME_ID, $this->game_id);
|
|
if ($this->isColumnModified(QuestionTableMap::CREATED_AT)) $criteria->add(QuestionTableMap::CREATED_AT, $this->created_at);
|
|
if ($this->isColumnModified(QuestionTableMap::UPDATED_AT)) $criteria->add(QuestionTableMap::UPDATED_AT, $this->updated_at);
|
|
if ($this->isColumnModified(QuestionTableMap::VERSION)) $criteria->add(QuestionTableMap::VERSION, $this->version);
|
|
if ($this->isColumnModified(QuestionTableMap::VERSION_CREATED_AT)) $criteria->add(QuestionTableMap::VERSION_CREATED_AT, $this->version_created_at);
|
|
if ($this->isColumnModified(QuestionTableMap::VERSION_CREATED_BY)) $criteria->add(QuestionTableMap::VERSION_CREATED_BY, $this->version_created_by);
|
|
|
|
return $criteria;
|
|
}
|
|
|
|
/**
|
|
* Builds a Criteria object containing the primary key for this object.
|
|
*
|
|
* Unlike buildCriteria() this method includes the primary key values regardless
|
|
* of whether or not they have been modified.
|
|
*
|
|
* @return Criteria The Criteria object containing value(s) for primary key(s).
|
|
*/
|
|
public function buildPkeyCriteria()
|
|
{
|
|
$criteria = new Criteria(QuestionTableMap::DATABASE_NAME);
|
|
$criteria->add(QuestionTableMap::ID, $this->id);
|
|
|
|
return $criteria;
|
|
}
|
|
|
|
/**
|
|
* Returns the primary key for this object (row).
|
|
* @return int
|
|
*/
|
|
public function getPrimaryKey()
|
|
{
|
|
return $this->getId();
|
|
}
|
|
|
|
/**
|
|
* Generic method to set the primary key (id column).
|
|
*
|
|
* @param int $key Primary key.
|
|
* @return void
|
|
*/
|
|
public function setPrimaryKey($key)
|
|
{
|
|
$this->setId($key);
|
|
}
|
|
|
|
/**
|
|
* Returns true if the primary key for this object is null.
|
|
* @return boolean
|
|
*/
|
|
public function isPrimaryKeyNull()
|
|
{
|
|
|
|
return null === $this->getId();
|
|
}
|
|
|
|
/**
|
|
* Sets contents of passed object to values from current object.
|
|
*
|
|
* If desired, this method can also make copies of all associated (fkey referrers)
|
|
* objects.
|
|
*
|
|
* @param object $copyObj An object of \Contest\Model\Question (or compatible) type.
|
|
* @param boolean $deepCopy Whether to also copy all rows that refer (by fkey) to the current row.
|
|
* @param boolean $makeNew Whether to reset autoincrement PKs and make the object new.
|
|
* @throws PropelException
|
|
*/
|
|
public function copyInto($copyObj, $deepCopy = false, $makeNew = true)
|
|
{
|
|
$copyObj->setVisible($this->getVisible());
|
|
$copyObj->setGameId($this->getGameId());
|
|
$copyObj->setCreatedAt($this->getCreatedAt());
|
|
$copyObj->setUpdatedAt($this->getUpdatedAt());
|
|
$copyObj->setVersion($this->getVersion());
|
|
$copyObj->setVersionCreatedAt($this->getVersionCreatedAt());
|
|
$copyObj->setVersionCreatedBy($this->getVersionCreatedBy());
|
|
|
|
if ($deepCopy) {
|
|
// important: temporarily setNew(false) because this affects the behavior of
|
|
// the getter/setter methods for fkey referrer objects.
|
|
$copyObj->setNew(false);
|
|
|
|
foreach ($this->getAnswers() as $relObj) {
|
|
if ($relObj !== $this) { // ensure that we don't try to copy a reference to ourselves
|
|
$copyObj->addAnswer($relObj->copy($deepCopy));
|
|
}
|
|
}
|
|
|
|
foreach ($this->getQuestionI18ns() as $relObj) {
|
|
if ($relObj !== $this) { // ensure that we don't try to copy a reference to ourselves
|
|
$copyObj->addQuestionI18n($relObj->copy($deepCopy));
|
|
}
|
|
}
|
|
|
|
foreach ($this->getQuestionVersions() as $relObj) {
|
|
if ($relObj !== $this) { // ensure that we don't try to copy a reference to ourselves
|
|
$copyObj->addQuestionVersion($relObj->copy($deepCopy));
|
|
}
|
|
}
|
|
|
|
} // if ($deepCopy)
|
|
|
|
if ($makeNew) {
|
|
$copyObj->setNew(true);
|
|
$copyObj->setId(NULL); // this is a auto-increment column, so set to default value
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Makes a copy of this object that will be inserted as a new row in table when saved.
|
|
* It creates a new object filling in the simple attributes, but skipping any primary
|
|
* keys that are defined for the table.
|
|
*
|
|
* If desired, this method can also make copies of all associated (fkey referrers)
|
|
* objects.
|
|
*
|
|
* @param boolean $deepCopy Whether to also copy all rows that refer (by fkey) to the current row.
|
|
* @return \Contest\Model\Question Clone of current object.
|
|
* @throws PropelException
|
|
*/
|
|
public function copy($deepCopy = false)
|
|
{
|
|
// we use get_class(), because this might be a subclass
|
|
$clazz = get_class($this);
|
|
$copyObj = new $clazz();
|
|
$this->copyInto($copyObj, $deepCopy);
|
|
|
|
return $copyObj;
|
|
}
|
|
|
|
/**
|
|
* Declares an association between this object and a ChildGame object.
|
|
*
|
|
* @param ChildGame $v
|
|
* @return \Contest\Model\Question The current object (for fluent API support)
|
|
* @throws PropelException
|
|
*/
|
|
public function setGame(ChildGame $v = null)
|
|
{
|
|
if ($v === null) {
|
|
$this->setGameId(NULL);
|
|
} else {
|
|
$this->setGameId($v->getId());
|
|
}
|
|
|
|
$this->aGame = $v;
|
|
|
|
// Add binding for other direction of this n:n relationship.
|
|
// If this object has already been added to the ChildGame object, it will not be re-added.
|
|
if ($v !== null) {
|
|
$v->addQuestion($this);
|
|
}
|
|
|
|
|
|
return $this;
|
|
}
|
|
|
|
|
|
/**
|
|
* Get the associated ChildGame object
|
|
*
|
|
* @param ConnectionInterface $con Optional Connection object.
|
|
* @return ChildGame The associated ChildGame object.
|
|
* @throws PropelException
|
|
*/
|
|
public function getGame(ConnectionInterface $con = null)
|
|
{
|
|
if ($this->aGame === null && ($this->game_id !== null)) {
|
|
$this->aGame = ChildGameQuery::create()->findPk($this->game_id, $con);
|
|
/* The following can be used additionally to
|
|
guarantee the related object contains a reference
|
|
to this object. This level of coupling may, however, be
|
|
undesirable since it could result in an only partially populated collection
|
|
in the referenced object.
|
|
$this->aGame->addQuestions($this);
|
|
*/
|
|
}
|
|
|
|
return $this->aGame;
|
|
}
|
|
|
|
|
|
/**
|
|
* Initializes a collection based on the name of a relation.
|
|
* Avoids crafting an 'init[$relationName]s' method name
|
|
* that wouldn't work when StandardEnglishPluralizer is used.
|
|
*
|
|
* @param string $relationName The name of the relation to initialize
|
|
* @return void
|
|
*/
|
|
public function initRelation($relationName)
|
|
{
|
|
if ('Answer' == $relationName) {
|
|
return $this->initAnswers();
|
|
}
|
|
if ('QuestionI18n' == $relationName) {
|
|
return $this->initQuestionI18ns();
|
|
}
|
|
if ('QuestionVersion' == $relationName) {
|
|
return $this->initQuestionVersions();
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Clears out the collAnswers collection
|
|
*
|
|
* This does not modify the database; however, it will remove any associated objects, causing
|
|
* them to be refetched by subsequent calls to accessor method.
|
|
*
|
|
* @return void
|
|
* @see addAnswers()
|
|
*/
|
|
public function clearAnswers()
|
|
{
|
|
$this->collAnswers = null; // important to set this to NULL since that means it is uninitialized
|
|
}
|
|
|
|
/**
|
|
* Reset is the collAnswers collection loaded partially.
|
|
*/
|
|
public function resetPartialAnswers($v = true)
|
|
{
|
|
$this->collAnswersPartial = $v;
|
|
}
|
|
|
|
/**
|
|
* Initializes the collAnswers collection.
|
|
*
|
|
* By default this just sets the collAnswers collection to an empty array (like clearcollAnswers());
|
|
* however, you may wish to override this method in your stub class to provide setting appropriate
|
|
* to your application -- for example, setting the initial array to the values stored in database.
|
|
*
|
|
* @param boolean $overrideExisting If set to true, the method call initializes
|
|
* the collection even if it is not empty
|
|
*
|
|
* @return void
|
|
*/
|
|
public function initAnswers($overrideExisting = true)
|
|
{
|
|
if (null !== $this->collAnswers && !$overrideExisting) {
|
|
return;
|
|
}
|
|
$this->collAnswers = new ObjectCollection();
|
|
$this->collAnswers->setModel('\Contest\Model\Answer');
|
|
}
|
|
|
|
/**
|
|
* Gets an array of ChildAnswer objects which contain a foreign key that references this object.
|
|
*
|
|
* If the $criteria is not null, it is used to always fetch the results from the database.
|
|
* Otherwise the results are fetched from the database the first time, then cached.
|
|
* Next time the same method is called without $criteria, the cached collection is returned.
|
|
* If this ChildQuestion is new, it will return
|
|
* an empty collection or the current collection; the criteria is ignored on a new object.
|
|
*
|
|
* @param Criteria $criteria optional Criteria object to narrow the query
|
|
* @param ConnectionInterface $con optional connection object
|
|
* @return Collection|ChildAnswer[] List of ChildAnswer objects
|
|
* @throws PropelException
|
|
*/
|
|
public function getAnswers($criteria = null, ConnectionInterface $con = null)
|
|
{
|
|
$partial = $this->collAnswersPartial && !$this->isNew();
|
|
if (null === $this->collAnswers || null !== $criteria || $partial) {
|
|
if ($this->isNew() && null === $this->collAnswers) {
|
|
// return empty collection
|
|
$this->initAnswers();
|
|
} else {
|
|
$collAnswers = ChildAnswerQuery::create(null, $criteria)
|
|
->filterByQuestion($this)
|
|
->find($con);
|
|
|
|
if (null !== $criteria) {
|
|
if (false !== $this->collAnswersPartial && count($collAnswers)) {
|
|
$this->initAnswers(false);
|
|
|
|
foreach ($collAnswers as $obj) {
|
|
if (false == $this->collAnswers->contains($obj)) {
|
|
$this->collAnswers->append($obj);
|
|
}
|
|
}
|
|
|
|
$this->collAnswersPartial = true;
|
|
}
|
|
|
|
reset($collAnswers);
|
|
|
|
return $collAnswers;
|
|
}
|
|
|
|
if ($partial && $this->collAnswers) {
|
|
foreach ($this->collAnswers as $obj) {
|
|
if ($obj->isNew()) {
|
|
$collAnswers[] = $obj;
|
|
}
|
|
}
|
|
}
|
|
|
|
$this->collAnswers = $collAnswers;
|
|
$this->collAnswersPartial = false;
|
|
}
|
|
}
|
|
|
|
return $this->collAnswers;
|
|
}
|
|
|
|
/**
|
|
* Sets a collection of Answer objects related by a one-to-many relationship
|
|
* to the current object.
|
|
* It will also schedule objects for deletion based on a diff between old objects (aka persisted)
|
|
* and new objects from the given Propel collection.
|
|
*
|
|
* @param Collection $answers A Propel collection.
|
|
* @param ConnectionInterface $con Optional connection object
|
|
* @return ChildQuestion The current object (for fluent API support)
|
|
*/
|
|
public function setAnswers(Collection $answers, ConnectionInterface $con = null)
|
|
{
|
|
$answersToDelete = $this->getAnswers(new Criteria(), $con)->diff($answers);
|
|
|
|
|
|
$this->answersScheduledForDeletion = $answersToDelete;
|
|
|
|
foreach ($answersToDelete as $answerRemoved) {
|
|
$answerRemoved->setQuestion(null);
|
|
}
|
|
|
|
$this->collAnswers = null;
|
|
foreach ($answers as $answer) {
|
|
$this->addAnswer($answer);
|
|
}
|
|
|
|
$this->collAnswers = $answers;
|
|
$this->collAnswersPartial = false;
|
|
|
|
return $this;
|
|
}
|
|
|
|
/**
|
|
* Returns the number of related Answer objects.
|
|
*
|
|
* @param Criteria $criteria
|
|
* @param boolean $distinct
|
|
* @param ConnectionInterface $con
|
|
* @return int Count of related Answer objects.
|
|
* @throws PropelException
|
|
*/
|
|
public function countAnswers(Criteria $criteria = null, $distinct = false, ConnectionInterface $con = null)
|
|
{
|
|
$partial = $this->collAnswersPartial && !$this->isNew();
|
|
if (null === $this->collAnswers || null !== $criteria || $partial) {
|
|
if ($this->isNew() && null === $this->collAnswers) {
|
|
return 0;
|
|
}
|
|
|
|
if ($partial && !$criteria) {
|
|
return count($this->getAnswers());
|
|
}
|
|
|
|
$query = ChildAnswerQuery::create(null, $criteria);
|
|
if ($distinct) {
|
|
$query->distinct();
|
|
}
|
|
|
|
return $query
|
|
->filterByQuestion($this)
|
|
->count($con);
|
|
}
|
|
|
|
return count($this->collAnswers);
|
|
}
|
|
|
|
/**
|
|
* Method called to associate a ChildAnswer object to this object
|
|
* through the ChildAnswer foreign key attribute.
|
|
*
|
|
* @param ChildAnswer $l ChildAnswer
|
|
* @return \Contest\Model\Question The current object (for fluent API support)
|
|
*/
|
|
public function addAnswer(ChildAnswer $l)
|
|
{
|
|
if ($this->collAnswers === null) {
|
|
$this->initAnswers();
|
|
$this->collAnswersPartial = true;
|
|
}
|
|
|
|
if (!in_array($l, $this->collAnswers->getArrayCopy(), true)) { // only add it if the **same** object is not already associated
|
|
$this->doAddAnswer($l);
|
|
}
|
|
|
|
return $this;
|
|
}
|
|
|
|
/**
|
|
* @param Answer $answer The answer object to add.
|
|
*/
|
|
protected function doAddAnswer($answer)
|
|
{
|
|
$this->collAnswers[]= $answer;
|
|
$answer->setQuestion($this);
|
|
}
|
|
|
|
/**
|
|
* @param Answer $answer The answer object to remove.
|
|
* @return ChildQuestion The current object (for fluent API support)
|
|
*/
|
|
public function removeAnswer($answer)
|
|
{
|
|
if ($this->getAnswers()->contains($answer)) {
|
|
$this->collAnswers->remove($this->collAnswers->search($answer));
|
|
if (null === $this->answersScheduledForDeletion) {
|
|
$this->answersScheduledForDeletion = clone $this->collAnswers;
|
|
$this->answersScheduledForDeletion->clear();
|
|
}
|
|
$this->answersScheduledForDeletion[]= clone $answer;
|
|
$answer->setQuestion(null);
|
|
}
|
|
|
|
return $this;
|
|
}
|
|
|
|
/**
|
|
* Clears out the collQuestionI18ns collection
|
|
*
|
|
* This does not modify the database; however, it will remove any associated objects, causing
|
|
* them to be refetched by subsequent calls to accessor method.
|
|
*
|
|
* @return void
|
|
* @see addQuestionI18ns()
|
|
*/
|
|
public function clearQuestionI18ns()
|
|
{
|
|
$this->collQuestionI18ns = null; // important to set this to NULL since that means it is uninitialized
|
|
}
|
|
|
|
/**
|
|
* Reset is the collQuestionI18ns collection loaded partially.
|
|
*/
|
|
public function resetPartialQuestionI18ns($v = true)
|
|
{
|
|
$this->collQuestionI18nsPartial = $v;
|
|
}
|
|
|
|
/**
|
|
* Initializes the collQuestionI18ns collection.
|
|
*
|
|
* By default this just sets the collQuestionI18ns collection to an empty array (like clearcollQuestionI18ns());
|
|
* however, you may wish to override this method in your stub class to provide setting appropriate
|
|
* to your application -- for example, setting the initial array to the values stored in database.
|
|
*
|
|
* @param boolean $overrideExisting If set to true, the method call initializes
|
|
* the collection even if it is not empty
|
|
*
|
|
* @return void
|
|
*/
|
|
public function initQuestionI18ns($overrideExisting = true)
|
|
{
|
|
if (null !== $this->collQuestionI18ns && !$overrideExisting) {
|
|
return;
|
|
}
|
|
$this->collQuestionI18ns = new ObjectCollection();
|
|
$this->collQuestionI18ns->setModel('\Contest\Model\QuestionI18n');
|
|
}
|
|
|
|
/**
|
|
* Gets an array of ChildQuestionI18n objects which contain a foreign key that references this object.
|
|
*
|
|
* If the $criteria is not null, it is used to always fetch the results from the database.
|
|
* Otherwise the results are fetched from the database the first time, then cached.
|
|
* Next time the same method is called without $criteria, the cached collection is returned.
|
|
* If this ChildQuestion is new, it will return
|
|
* an empty collection or the current collection; the criteria is ignored on a new object.
|
|
*
|
|
* @param Criteria $criteria optional Criteria object to narrow the query
|
|
* @param ConnectionInterface $con optional connection object
|
|
* @return Collection|ChildQuestionI18n[] List of ChildQuestionI18n objects
|
|
* @throws PropelException
|
|
*/
|
|
public function getQuestionI18ns($criteria = null, ConnectionInterface $con = null)
|
|
{
|
|
$partial = $this->collQuestionI18nsPartial && !$this->isNew();
|
|
if (null === $this->collQuestionI18ns || null !== $criteria || $partial) {
|
|
if ($this->isNew() && null === $this->collQuestionI18ns) {
|
|
// return empty collection
|
|
$this->initQuestionI18ns();
|
|
} else {
|
|
$collQuestionI18ns = ChildQuestionI18nQuery::create(null, $criteria)
|
|
->filterByQuestion($this)
|
|
->find($con);
|
|
|
|
if (null !== $criteria) {
|
|
if (false !== $this->collQuestionI18nsPartial && count($collQuestionI18ns)) {
|
|
$this->initQuestionI18ns(false);
|
|
|
|
foreach ($collQuestionI18ns as $obj) {
|
|
if (false == $this->collQuestionI18ns->contains($obj)) {
|
|
$this->collQuestionI18ns->append($obj);
|
|
}
|
|
}
|
|
|
|
$this->collQuestionI18nsPartial = true;
|
|
}
|
|
|
|
reset($collQuestionI18ns);
|
|
|
|
return $collQuestionI18ns;
|
|
}
|
|
|
|
if ($partial && $this->collQuestionI18ns) {
|
|
foreach ($this->collQuestionI18ns as $obj) {
|
|
if ($obj->isNew()) {
|
|
$collQuestionI18ns[] = $obj;
|
|
}
|
|
}
|
|
}
|
|
|
|
$this->collQuestionI18ns = $collQuestionI18ns;
|
|
$this->collQuestionI18nsPartial = false;
|
|
}
|
|
}
|
|
|
|
return $this->collQuestionI18ns;
|
|
}
|
|
|
|
/**
|
|
* Sets a collection of QuestionI18n objects related by a one-to-many relationship
|
|
* to the current object.
|
|
* It will also schedule objects for deletion based on a diff between old objects (aka persisted)
|
|
* and new objects from the given Propel collection.
|
|
*
|
|
* @param Collection $questionI18ns A Propel collection.
|
|
* @param ConnectionInterface $con Optional connection object
|
|
* @return ChildQuestion The current object (for fluent API support)
|
|
*/
|
|
public function setQuestionI18ns(Collection $questionI18ns, ConnectionInterface $con = null)
|
|
{
|
|
$questionI18nsToDelete = $this->getQuestionI18ns(new Criteria(), $con)->diff($questionI18ns);
|
|
|
|
|
|
//since at least one column in the foreign key is at the same time a PK
|
|
//we can not just set a PK to NULL in the lines below. We have to store
|
|
//a backup of all values, so we are able to manipulate these items based on the onDelete value later.
|
|
$this->questionI18nsScheduledForDeletion = clone $questionI18nsToDelete;
|
|
|
|
foreach ($questionI18nsToDelete as $questionI18nRemoved) {
|
|
$questionI18nRemoved->setQuestion(null);
|
|
}
|
|
|
|
$this->collQuestionI18ns = null;
|
|
foreach ($questionI18ns as $questionI18n) {
|
|
$this->addQuestionI18n($questionI18n);
|
|
}
|
|
|
|
$this->collQuestionI18ns = $questionI18ns;
|
|
$this->collQuestionI18nsPartial = false;
|
|
|
|
return $this;
|
|
}
|
|
|
|
/**
|
|
* Returns the number of related QuestionI18n objects.
|
|
*
|
|
* @param Criteria $criteria
|
|
* @param boolean $distinct
|
|
* @param ConnectionInterface $con
|
|
* @return int Count of related QuestionI18n objects.
|
|
* @throws PropelException
|
|
*/
|
|
public function countQuestionI18ns(Criteria $criteria = null, $distinct = false, ConnectionInterface $con = null)
|
|
{
|
|
$partial = $this->collQuestionI18nsPartial && !$this->isNew();
|
|
if (null === $this->collQuestionI18ns || null !== $criteria || $partial) {
|
|
if ($this->isNew() && null === $this->collQuestionI18ns) {
|
|
return 0;
|
|
}
|
|
|
|
if ($partial && !$criteria) {
|
|
return count($this->getQuestionI18ns());
|
|
}
|
|
|
|
$query = ChildQuestionI18nQuery::create(null, $criteria);
|
|
if ($distinct) {
|
|
$query->distinct();
|
|
}
|
|
|
|
return $query
|
|
->filterByQuestion($this)
|
|
->count($con);
|
|
}
|
|
|
|
return count($this->collQuestionI18ns);
|
|
}
|
|
|
|
/**
|
|
* Method called to associate a ChildQuestionI18n object to this object
|
|
* through the ChildQuestionI18n foreign key attribute.
|
|
*
|
|
* @param ChildQuestionI18n $l ChildQuestionI18n
|
|
* @return \Contest\Model\Question The current object (for fluent API support)
|
|
*/
|
|
public function addQuestionI18n(ChildQuestionI18n $l)
|
|
{
|
|
if ($l && $locale = $l->getLocale()) {
|
|
$this->setLocale($locale);
|
|
$this->currentTranslations[$locale] = $l;
|
|
}
|
|
if ($this->collQuestionI18ns === null) {
|
|
$this->initQuestionI18ns();
|
|
$this->collQuestionI18nsPartial = true;
|
|
}
|
|
|
|
if (!in_array($l, $this->collQuestionI18ns->getArrayCopy(), true)) { // only add it if the **same** object is not already associated
|
|
$this->doAddQuestionI18n($l);
|
|
}
|
|
|
|
return $this;
|
|
}
|
|
|
|
/**
|
|
* @param QuestionI18n $questionI18n The questionI18n object to add.
|
|
*/
|
|
protected function doAddQuestionI18n($questionI18n)
|
|
{
|
|
$this->collQuestionI18ns[]= $questionI18n;
|
|
$questionI18n->setQuestion($this);
|
|
}
|
|
|
|
/**
|
|
* @param QuestionI18n $questionI18n The questionI18n object to remove.
|
|
* @return ChildQuestion The current object (for fluent API support)
|
|
*/
|
|
public function removeQuestionI18n($questionI18n)
|
|
{
|
|
if ($this->getQuestionI18ns()->contains($questionI18n)) {
|
|
$this->collQuestionI18ns->remove($this->collQuestionI18ns->search($questionI18n));
|
|
if (null === $this->questionI18nsScheduledForDeletion) {
|
|
$this->questionI18nsScheduledForDeletion = clone $this->collQuestionI18ns;
|
|
$this->questionI18nsScheduledForDeletion->clear();
|
|
}
|
|
$this->questionI18nsScheduledForDeletion[]= clone $questionI18n;
|
|
$questionI18n->setQuestion(null);
|
|
}
|
|
|
|
return $this;
|
|
}
|
|
|
|
/**
|
|
* Clears out the collQuestionVersions collection
|
|
*
|
|
* This does not modify the database; however, it will remove any associated objects, causing
|
|
* them to be refetched by subsequent calls to accessor method.
|
|
*
|
|
* @return void
|
|
* @see addQuestionVersions()
|
|
*/
|
|
public function clearQuestionVersions()
|
|
{
|
|
$this->collQuestionVersions = null; // important to set this to NULL since that means it is uninitialized
|
|
}
|
|
|
|
/**
|
|
* Reset is the collQuestionVersions collection loaded partially.
|
|
*/
|
|
public function resetPartialQuestionVersions($v = true)
|
|
{
|
|
$this->collQuestionVersionsPartial = $v;
|
|
}
|
|
|
|
/**
|
|
* Initializes the collQuestionVersions collection.
|
|
*
|
|
* By default this just sets the collQuestionVersions collection to an empty array (like clearcollQuestionVersions());
|
|
* however, you may wish to override this method in your stub class to provide setting appropriate
|
|
* to your application -- for example, setting the initial array to the values stored in database.
|
|
*
|
|
* @param boolean $overrideExisting If set to true, the method call initializes
|
|
* the collection even if it is not empty
|
|
*
|
|
* @return void
|
|
*/
|
|
public function initQuestionVersions($overrideExisting = true)
|
|
{
|
|
if (null !== $this->collQuestionVersions && !$overrideExisting) {
|
|
return;
|
|
}
|
|
$this->collQuestionVersions = new ObjectCollection();
|
|
$this->collQuestionVersions->setModel('\Contest\Model\QuestionVersion');
|
|
}
|
|
|
|
/**
|
|
* Gets an array of ChildQuestionVersion objects which contain a foreign key that references this object.
|
|
*
|
|
* If the $criteria is not null, it is used to always fetch the results from the database.
|
|
* Otherwise the results are fetched from the database the first time, then cached.
|
|
* Next time the same method is called without $criteria, the cached collection is returned.
|
|
* If this ChildQuestion is new, it will return
|
|
* an empty collection or the current collection; the criteria is ignored on a new object.
|
|
*
|
|
* @param Criteria $criteria optional Criteria object to narrow the query
|
|
* @param ConnectionInterface $con optional connection object
|
|
* @return Collection|ChildQuestionVersion[] List of ChildQuestionVersion objects
|
|
* @throws PropelException
|
|
*/
|
|
public function getQuestionVersions($criteria = null, ConnectionInterface $con = null)
|
|
{
|
|
$partial = $this->collQuestionVersionsPartial && !$this->isNew();
|
|
if (null === $this->collQuestionVersions || null !== $criteria || $partial) {
|
|
if ($this->isNew() && null === $this->collQuestionVersions) {
|
|
// return empty collection
|
|
$this->initQuestionVersions();
|
|
} else {
|
|
$collQuestionVersions = ChildQuestionVersionQuery::create(null, $criteria)
|
|
->filterByQuestion($this)
|
|
->find($con);
|
|
|
|
if (null !== $criteria) {
|
|
if (false !== $this->collQuestionVersionsPartial && count($collQuestionVersions)) {
|
|
$this->initQuestionVersions(false);
|
|
|
|
foreach ($collQuestionVersions as $obj) {
|
|
if (false == $this->collQuestionVersions->contains($obj)) {
|
|
$this->collQuestionVersions->append($obj);
|
|
}
|
|
}
|
|
|
|
$this->collQuestionVersionsPartial = true;
|
|
}
|
|
|
|
reset($collQuestionVersions);
|
|
|
|
return $collQuestionVersions;
|
|
}
|
|
|
|
if ($partial && $this->collQuestionVersions) {
|
|
foreach ($this->collQuestionVersions as $obj) {
|
|
if ($obj->isNew()) {
|
|
$collQuestionVersions[] = $obj;
|
|
}
|
|
}
|
|
}
|
|
|
|
$this->collQuestionVersions = $collQuestionVersions;
|
|
$this->collQuestionVersionsPartial = false;
|
|
}
|
|
}
|
|
|
|
return $this->collQuestionVersions;
|
|
}
|
|
|
|
/**
|
|
* Sets a collection of QuestionVersion objects related by a one-to-many relationship
|
|
* to the current object.
|
|
* It will also schedule objects for deletion based on a diff between old objects (aka persisted)
|
|
* and new objects from the given Propel collection.
|
|
*
|
|
* @param Collection $questionVersions A Propel collection.
|
|
* @param ConnectionInterface $con Optional connection object
|
|
* @return ChildQuestion The current object (for fluent API support)
|
|
*/
|
|
public function setQuestionVersions(Collection $questionVersions, ConnectionInterface $con = null)
|
|
{
|
|
$questionVersionsToDelete = $this->getQuestionVersions(new Criteria(), $con)->diff($questionVersions);
|
|
|
|
|
|
//since at least one column in the foreign key is at the same time a PK
|
|
//we can not just set a PK to NULL in the lines below. We have to store
|
|
//a backup of all values, so we are able to manipulate these items based on the onDelete value later.
|
|
$this->questionVersionsScheduledForDeletion = clone $questionVersionsToDelete;
|
|
|
|
foreach ($questionVersionsToDelete as $questionVersionRemoved) {
|
|
$questionVersionRemoved->setQuestion(null);
|
|
}
|
|
|
|
$this->collQuestionVersions = null;
|
|
foreach ($questionVersions as $questionVersion) {
|
|
$this->addQuestionVersion($questionVersion);
|
|
}
|
|
|
|
$this->collQuestionVersions = $questionVersions;
|
|
$this->collQuestionVersionsPartial = false;
|
|
|
|
return $this;
|
|
}
|
|
|
|
/**
|
|
* Returns the number of related QuestionVersion objects.
|
|
*
|
|
* @param Criteria $criteria
|
|
* @param boolean $distinct
|
|
* @param ConnectionInterface $con
|
|
* @return int Count of related QuestionVersion objects.
|
|
* @throws PropelException
|
|
*/
|
|
public function countQuestionVersions(Criteria $criteria = null, $distinct = false, ConnectionInterface $con = null)
|
|
{
|
|
$partial = $this->collQuestionVersionsPartial && !$this->isNew();
|
|
if (null === $this->collQuestionVersions || null !== $criteria || $partial) {
|
|
if ($this->isNew() && null === $this->collQuestionVersions) {
|
|
return 0;
|
|
}
|
|
|
|
if ($partial && !$criteria) {
|
|
return count($this->getQuestionVersions());
|
|
}
|
|
|
|
$query = ChildQuestionVersionQuery::create(null, $criteria);
|
|
if ($distinct) {
|
|
$query->distinct();
|
|
}
|
|
|
|
return $query
|
|
->filterByQuestion($this)
|
|
->count($con);
|
|
}
|
|
|
|
return count($this->collQuestionVersions);
|
|
}
|
|
|
|
/**
|
|
* Method called to associate a ChildQuestionVersion object to this object
|
|
* through the ChildQuestionVersion foreign key attribute.
|
|
*
|
|
* @param ChildQuestionVersion $l ChildQuestionVersion
|
|
* @return \Contest\Model\Question The current object (for fluent API support)
|
|
*/
|
|
public function addQuestionVersion(ChildQuestionVersion $l)
|
|
{
|
|
if ($this->collQuestionVersions === null) {
|
|
$this->initQuestionVersions();
|
|
$this->collQuestionVersionsPartial = true;
|
|
}
|
|
|
|
if (!in_array($l, $this->collQuestionVersions->getArrayCopy(), true)) { // only add it if the **same** object is not already associated
|
|
$this->doAddQuestionVersion($l);
|
|
}
|
|
|
|
return $this;
|
|
}
|
|
|
|
/**
|
|
* @param QuestionVersion $questionVersion The questionVersion object to add.
|
|
*/
|
|
protected function doAddQuestionVersion($questionVersion)
|
|
{
|
|
$this->collQuestionVersions[]= $questionVersion;
|
|
$questionVersion->setQuestion($this);
|
|
}
|
|
|
|
/**
|
|
* @param QuestionVersion $questionVersion The questionVersion object to remove.
|
|
* @return ChildQuestion The current object (for fluent API support)
|
|
*/
|
|
public function removeQuestionVersion($questionVersion)
|
|
{
|
|
if ($this->getQuestionVersions()->contains($questionVersion)) {
|
|
$this->collQuestionVersions->remove($this->collQuestionVersions->search($questionVersion));
|
|
if (null === $this->questionVersionsScheduledForDeletion) {
|
|
$this->questionVersionsScheduledForDeletion = clone $this->collQuestionVersions;
|
|
$this->questionVersionsScheduledForDeletion->clear();
|
|
}
|
|
$this->questionVersionsScheduledForDeletion[]= clone $questionVersion;
|
|
$questionVersion->setQuestion(null);
|
|
}
|
|
|
|
return $this;
|
|
}
|
|
|
|
/**
|
|
* Clears the current object and sets all attributes to their default values
|
|
*/
|
|
public function clear()
|
|
{
|
|
$this->id = null;
|
|
$this->visible = null;
|
|
$this->game_id = null;
|
|
$this->created_at = null;
|
|
$this->updated_at = null;
|
|
$this->version = null;
|
|
$this->version_created_at = null;
|
|
$this->version_created_by = null;
|
|
$this->alreadyInSave = false;
|
|
$this->clearAllReferences();
|
|
$this->applyDefaultValues();
|
|
$this->resetModified();
|
|
$this->setNew(true);
|
|
$this->setDeleted(false);
|
|
}
|
|
|
|
/**
|
|
* Resets all references to other model objects or collections of model objects.
|
|
*
|
|
* This method is a user-space workaround for PHP's inability to garbage collect
|
|
* objects with circular references (even in PHP 5.3). This is currently necessary
|
|
* when using Propel in certain daemon or large-volume/high-memory operations.
|
|
*
|
|
* @param boolean $deep Whether to also clear the references on all referrer objects.
|
|
*/
|
|
public function clearAllReferences($deep = false)
|
|
{
|
|
if ($deep) {
|
|
if ($this->collAnswers) {
|
|
foreach ($this->collAnswers as $o) {
|
|
$o->clearAllReferences($deep);
|
|
}
|
|
}
|
|
if ($this->collQuestionI18ns) {
|
|
foreach ($this->collQuestionI18ns as $o) {
|
|
$o->clearAllReferences($deep);
|
|
}
|
|
}
|
|
if ($this->collQuestionVersions) {
|
|
foreach ($this->collQuestionVersions as $o) {
|
|
$o->clearAllReferences($deep);
|
|
}
|
|
}
|
|
} // if ($deep)
|
|
|
|
// i18n behavior
|
|
$this->currentLocale = 'en_US';
|
|
$this->currentTranslations = null;
|
|
|
|
$this->collAnswers = null;
|
|
$this->collQuestionI18ns = null;
|
|
$this->collQuestionVersions = null;
|
|
$this->aGame = null;
|
|
}
|
|
|
|
/**
|
|
* Return the string representation of this object
|
|
*
|
|
* @return string
|
|
*/
|
|
public function __toString()
|
|
{
|
|
return (string) $this->exportTo(QuestionTableMap::DEFAULT_STRING_FORMAT);
|
|
}
|
|
|
|
// timestampable behavior
|
|
|
|
/**
|
|
* Mark the current object so that the update date doesn't get updated during next save
|
|
*
|
|
* @return ChildQuestion The current object (for fluent API support)
|
|
*/
|
|
public function keepUpdateDateUnchanged()
|
|
{
|
|
$this->modifiedColumns[QuestionTableMap::UPDATED_AT] = true;
|
|
|
|
return $this;
|
|
}
|
|
|
|
// i18n behavior
|
|
|
|
/**
|
|
* Sets the locale for translations
|
|
*
|
|
* @param string $locale Locale to use for the translation, e.g. 'fr_FR'
|
|
*
|
|
* @return ChildQuestion The current object (for fluent API support)
|
|
*/
|
|
public function setLocale($locale = 'en_US')
|
|
{
|
|
$this->currentLocale = $locale;
|
|
|
|
return $this;
|
|
}
|
|
|
|
/**
|
|
* Gets the locale for translations
|
|
*
|
|
* @return string $locale Locale to use for the translation, e.g. 'fr_FR'
|
|
*/
|
|
public function getLocale()
|
|
{
|
|
return $this->currentLocale;
|
|
}
|
|
|
|
/**
|
|
* Returns the current translation for a given locale
|
|
*
|
|
* @param string $locale Locale to use for the translation, e.g. 'fr_FR'
|
|
* @param ConnectionInterface $con an optional connection object
|
|
*
|
|
* @return ChildQuestionI18n */
|
|
public function getTranslation($locale = 'en_US', ConnectionInterface $con = null)
|
|
{
|
|
if (!isset($this->currentTranslations[$locale])) {
|
|
if (null !== $this->collQuestionI18ns) {
|
|
foreach ($this->collQuestionI18ns as $translation) {
|
|
if ($translation->getLocale() == $locale) {
|
|
$this->currentTranslations[$locale] = $translation;
|
|
|
|
return $translation;
|
|
}
|
|
}
|
|
}
|
|
if ($this->isNew()) {
|
|
$translation = new ChildQuestionI18n();
|
|
$translation->setLocale($locale);
|
|
} else {
|
|
$translation = ChildQuestionI18nQuery::create()
|
|
->filterByPrimaryKey(array($this->getPrimaryKey(), $locale))
|
|
->findOneOrCreate($con);
|
|
$this->currentTranslations[$locale] = $translation;
|
|
}
|
|
$this->addQuestionI18n($translation);
|
|
}
|
|
|
|
return $this->currentTranslations[$locale];
|
|
}
|
|
|
|
/**
|
|
* Remove the translation for a given locale
|
|
*
|
|
* @param string $locale Locale to use for the translation, e.g. 'fr_FR'
|
|
* @param ConnectionInterface $con an optional connection object
|
|
*
|
|
* @return ChildQuestion The current object (for fluent API support)
|
|
*/
|
|
public function removeTranslation($locale = 'en_US', ConnectionInterface $con = null)
|
|
{
|
|
if (!$this->isNew()) {
|
|
ChildQuestionI18nQuery::create()
|
|
->filterByPrimaryKey(array($this->getPrimaryKey(), $locale))
|
|
->delete($con);
|
|
}
|
|
if (isset($this->currentTranslations[$locale])) {
|
|
unset($this->currentTranslations[$locale]);
|
|
}
|
|
foreach ($this->collQuestionI18ns as $key => $translation) {
|
|
if ($translation->getLocale() == $locale) {
|
|
unset($this->collQuestionI18ns[$key]);
|
|
break;
|
|
}
|
|
}
|
|
|
|
return $this;
|
|
}
|
|
|
|
/**
|
|
* Returns the current translation
|
|
*
|
|
* @param ConnectionInterface $con an optional connection object
|
|
*
|
|
* @return ChildQuestionI18n */
|
|
public function getCurrentTranslation(ConnectionInterface $con = null)
|
|
{
|
|
return $this->getTranslation($this->getLocale(), $con);
|
|
}
|
|
|
|
|
|
/**
|
|
* Get the [title] column value.
|
|
*
|
|
* @return string
|
|
*/
|
|
public function getTitle()
|
|
{
|
|
return $this->getCurrentTranslation()->getTitle();
|
|
}
|
|
|
|
|
|
/**
|
|
* Set the value of [title] column.
|
|
*
|
|
* @param string $v new value
|
|
* @return \Contest\Model\QuestionI18n The current object (for fluent API support)
|
|
*/
|
|
public function setTitle($v)
|
|
{ $this->getCurrentTranslation()->setTitle($v);
|
|
|
|
return $this;
|
|
}
|
|
|
|
|
|
/**
|
|
* Get the [description] column value.
|
|
*
|
|
* @return string
|
|
*/
|
|
public function getDescription()
|
|
{
|
|
return $this->getCurrentTranslation()->getDescription();
|
|
}
|
|
|
|
|
|
/**
|
|
* Set the value of [description] column.
|
|
*
|
|
* @param string $v new value
|
|
* @return \Contest\Model\QuestionI18n The current object (for fluent API support)
|
|
*/
|
|
public function setDescription($v)
|
|
{ $this->getCurrentTranslation()->setDescription($v);
|
|
|
|
return $this;
|
|
}
|
|
|
|
// versionable behavior
|
|
|
|
/**
|
|
* Enforce a new Version of this object upon next save.
|
|
*
|
|
* @return \Contest\Model\Question
|
|
*/
|
|
public function enforceVersioning()
|
|
{
|
|
$this->enforceVersion = true;
|
|
|
|
return $this;
|
|
}
|
|
|
|
/**
|
|
* Checks whether the current state must be recorded as a version
|
|
*
|
|
* @return boolean
|
|
*/
|
|
public function isVersioningNecessary($con = null)
|
|
{
|
|
if ($this->alreadyInSave) {
|
|
return false;
|
|
}
|
|
|
|
if ($this->enforceVersion) {
|
|
return true;
|
|
}
|
|
|
|
if (ChildQuestionQuery::isVersioningEnabled() && ($this->isNew() || $this->isModified()) || $this->isDeleted()) {
|
|
return true;
|
|
}
|
|
if (null !== ($object = $this->getGame($con)) && $object->isVersioningNecessary($con)) {
|
|
return true;
|
|
}
|
|
|
|
// to avoid infinite loops, emulate in save
|
|
$this->alreadyInSave = true;
|
|
foreach ($this->getAnswers(null, $con) as $relatedObject) {
|
|
if ($relatedObject->isVersioningNecessary($con)) {
|
|
$this->alreadyInSave = false;
|
|
|
|
return true;
|
|
}
|
|
}
|
|
$this->alreadyInSave = false;
|
|
|
|
|
|
return false;
|
|
}
|
|
|
|
/**
|
|
* Creates a version of the current object and saves it.
|
|
*
|
|
* @param ConnectionInterface $con the connection to use
|
|
*
|
|
* @return ChildQuestionVersion A version object
|
|
*/
|
|
public function addVersion($con = null)
|
|
{
|
|
$this->enforceVersion = false;
|
|
|
|
$version = new ChildQuestionVersion();
|
|
$version->setId($this->getId());
|
|
$version->setVisible($this->getVisible());
|
|
$version->setGameId($this->getGameId());
|
|
$version->setCreatedAt($this->getCreatedAt());
|
|
$version->setUpdatedAt($this->getUpdatedAt());
|
|
$version->setVersion($this->getVersion());
|
|
$version->setVersionCreatedAt($this->getVersionCreatedAt());
|
|
$version->setVersionCreatedBy($this->getVersionCreatedBy());
|
|
$version->setQuestion($this);
|
|
if (($related = $this->getGame($con)) && $related->getVersion()) {
|
|
$version->setGameIdVersion($related->getVersion());
|
|
}
|
|
if ($relateds = $this->getAnswers($con)->toKeyValue('Id', 'Version')) {
|
|
$version->setAnswerIds(array_keys($relateds));
|
|
$version->setAnswerVersions(array_values($relateds));
|
|
}
|
|
$version->save($con);
|
|
|
|
return $version;
|
|
}
|
|
|
|
/**
|
|
* Sets the properties of the current object to the value they had at a specific version
|
|
*
|
|
* @param integer $versionNumber The version number to read
|
|
* @param ConnectionInterface $con The connection to use
|
|
*
|
|
* @return ChildQuestion The current object (for fluent API support)
|
|
*/
|
|
public function toVersion($versionNumber, $con = null)
|
|
{
|
|
$version = $this->getOneVersion($versionNumber, $con);
|
|
if (!$version) {
|
|
throw new PropelException(sprintf('No ChildQuestion object found with version %d', $version));
|
|
}
|
|
$this->populateFromVersion($version, $con);
|
|
|
|
return $this;
|
|
}
|
|
|
|
/**
|
|
* Sets the properties of the current object to the value they had at a specific version
|
|
*
|
|
* @param ChildQuestionVersion $version The version object to use
|
|
* @param ConnectionInterface $con the connection to use
|
|
* @param array $loadedObjects objects that been loaded in a chain of populateFromVersion calls on referrer or fk objects.
|
|
*
|
|
* @return ChildQuestion The current object (for fluent API support)
|
|
*/
|
|
public function populateFromVersion($version, $con = null, &$loadedObjects = array())
|
|
{
|
|
$loadedObjects['ChildQuestion'][$version->getId()][$version->getVersion()] = $this;
|
|
$this->setId($version->getId());
|
|
$this->setVisible($version->getVisible());
|
|
$this->setGameId($version->getGameId());
|
|
$this->setCreatedAt($version->getCreatedAt());
|
|
$this->setUpdatedAt($version->getUpdatedAt());
|
|
$this->setVersion($version->getVersion());
|
|
$this->setVersionCreatedAt($version->getVersionCreatedAt());
|
|
$this->setVersionCreatedBy($version->getVersionCreatedBy());
|
|
if ($fkValue = $version->getGameId()) {
|
|
if (isset($loadedObjects['ChildGame']) && isset($loadedObjects['ChildGame'][$fkValue]) && isset($loadedObjects['ChildGame'][$fkValue][$version->getGameIdVersion()])) {
|
|
$related = $loadedObjects['ChildGame'][$fkValue][$version->getGameIdVersion()];
|
|
} else {
|
|
$related = new ChildGame();
|
|
$relatedVersion = ChildGameVersionQuery::create()
|
|
->filterById($fkValue)
|
|
->filterByVersion($version->getGameIdVersion())
|
|
->findOne($con);
|
|
$related->populateFromVersion($relatedVersion, $con, $loadedObjects);
|
|
$related->setNew(false);
|
|
}
|
|
$this->setGame($related);
|
|
}
|
|
if ($fkValues = $version->getAnswerIds()) {
|
|
$this->clearAnswers();
|
|
$fkVersions = $version->getAnswerVersions();
|
|
$query = ChildAnswerVersionQuery::create();
|
|
foreach ($fkValues as $key => $value) {
|
|
$c1 = $query->getNewCriterion(AnswerVersionTableMap::ID, $value);
|
|
$c2 = $query->getNewCriterion(AnswerVersionTableMap::VERSION, $fkVersions[$key]);
|
|
$c1->addAnd($c2);
|
|
$query->addOr($c1);
|
|
}
|
|
foreach ($query->find($con) as $relatedVersion) {
|
|
if (isset($loadedObjects['ChildAnswer']) && isset($loadedObjects['ChildAnswer'][$relatedVersion->getId()]) && isset($loadedObjects['ChildAnswer'][$relatedVersion->getId()][$relatedVersion->getVersion()])) {
|
|
$related = $loadedObjects['ChildAnswer'][$relatedVersion->getId()][$relatedVersion->getVersion()];
|
|
} else {
|
|
$related = new ChildAnswer();
|
|
$related->populateFromVersion($relatedVersion, $con, $loadedObjects);
|
|
$related->setNew(false);
|
|
}
|
|
$this->addAnswer($related);
|
|
$this->collAnswersPartial = false;
|
|
}
|
|
}
|
|
|
|
return $this;
|
|
}
|
|
|
|
/**
|
|
* Gets the latest persisted version number for the current object
|
|
*
|
|
* @param ConnectionInterface $con the connection to use
|
|
*
|
|
* @return integer
|
|
*/
|
|
public function getLastVersionNumber($con = null)
|
|
{
|
|
$v = ChildQuestionVersionQuery::create()
|
|
->filterByQuestion($this)
|
|
->orderByVersion('desc')
|
|
->findOne($con);
|
|
if (!$v) {
|
|
return 0;
|
|
}
|
|
|
|
return $v->getVersion();
|
|
}
|
|
|
|
/**
|
|
* Checks whether the current object is the latest one
|
|
*
|
|
* @param ConnectionInterface $con the connection to use
|
|
*
|
|
* @return Boolean
|
|
*/
|
|
public function isLastVersion($con = null)
|
|
{
|
|
return $this->getLastVersionNumber($con) == $this->getVersion();
|
|
}
|
|
|
|
/**
|
|
* Retrieves a version object for this entity and a version number
|
|
*
|
|
* @param integer $versionNumber The version number to read
|
|
* @param ConnectionInterface $con the connection to use
|
|
*
|
|
* @return ChildQuestionVersion A version object
|
|
*/
|
|
public function getOneVersion($versionNumber, $con = null)
|
|
{
|
|
return ChildQuestionVersionQuery::create()
|
|
->filterByQuestion($this)
|
|
->filterByVersion($versionNumber)
|
|
->findOne($con);
|
|
}
|
|
|
|
/**
|
|
* Gets all the versions of this object, in incremental order
|
|
*
|
|
* @param ConnectionInterface $con the connection to use
|
|
*
|
|
* @return ObjectCollection A list of ChildQuestionVersion objects
|
|
*/
|
|
public function getAllVersions($con = null)
|
|
{
|
|
$criteria = new Criteria();
|
|
$criteria->addAscendingOrderByColumn(QuestionVersionTableMap::VERSION);
|
|
|
|
return $this->getQuestionVersions($criteria, $con);
|
|
}
|
|
|
|
/**
|
|
* Compares the current object with another of its version.
|
|
* <code>
|
|
* print_r($book->compareVersion(1));
|
|
* => array(
|
|
* '1' => array('Title' => 'Book title at version 1'),
|
|
* '2' => array('Title' => 'Book title at version 2')
|
|
* );
|
|
* </code>
|
|
*
|
|
* @param integer $versionNumber
|
|
* @param string $keys Main key used for the result diff (versions|columns)
|
|
* @param ConnectionInterface $con the connection to use
|
|
* @param array $ignoredColumns The columns to exclude from the diff.
|
|
*
|
|
* @return array A list of differences
|
|
*/
|
|
public function compareVersion($versionNumber, $keys = 'columns', $con = null, $ignoredColumns = array())
|
|
{
|
|
$fromVersion = $this->toArray();
|
|
$toVersion = $this->getOneVersion($versionNumber, $con)->toArray();
|
|
|
|
return $this->computeDiff($fromVersion, $toVersion, $keys, $ignoredColumns);
|
|
}
|
|
|
|
/**
|
|
* Compares two versions of the current object.
|
|
* <code>
|
|
* print_r($book->compareVersions(1, 2));
|
|
* => array(
|
|
* '1' => array('Title' => 'Book title at version 1'),
|
|
* '2' => array('Title' => 'Book title at version 2')
|
|
* );
|
|
* </code>
|
|
*
|
|
* @param integer $fromVersionNumber
|
|
* @param integer $toVersionNumber
|
|
* @param string $keys Main key used for the result diff (versions|columns)
|
|
* @param ConnectionInterface $con the connection to use
|
|
* @param array $ignoredColumns The columns to exclude from the diff.
|
|
*
|
|
* @return array A list of differences
|
|
*/
|
|
public function compareVersions($fromVersionNumber, $toVersionNumber, $keys = 'columns', $con = null, $ignoredColumns = array())
|
|
{
|
|
$fromVersion = $this->getOneVersion($fromVersionNumber, $con)->toArray();
|
|
$toVersion = $this->getOneVersion($toVersionNumber, $con)->toArray();
|
|
|
|
return $this->computeDiff($fromVersion, $toVersion, $keys, $ignoredColumns);
|
|
}
|
|
|
|
/**
|
|
* Computes the diff between two versions.
|
|
* <code>
|
|
* print_r($book->computeDiff(1, 2));
|
|
* => array(
|
|
* '1' => array('Title' => 'Book title at version 1'),
|
|
* '2' => array('Title' => 'Book title at version 2')
|
|
* );
|
|
* </code>
|
|
*
|
|
* @param array $fromVersion An array representing the original version.
|
|
* @param array $toVersion An array representing the destination version.
|
|
* @param string $keys Main key used for the result diff (versions|columns).
|
|
* @param array $ignoredColumns The columns to exclude from the diff.
|
|
*
|
|
* @return array A list of differences
|
|
*/
|
|
protected function computeDiff($fromVersion, $toVersion, $keys = 'columns', $ignoredColumns = array())
|
|
{
|
|
$fromVersionNumber = $fromVersion['Version'];
|
|
$toVersionNumber = $toVersion['Version'];
|
|
$ignoredColumns = array_merge(array(
|
|
'Version',
|
|
'VersionCreatedAt',
|
|
'VersionCreatedBy',
|
|
), $ignoredColumns);
|
|
$diff = array();
|
|
foreach ($fromVersion as $key => $value) {
|
|
if (in_array($key, $ignoredColumns)) {
|
|
continue;
|
|
}
|
|
if ($toVersion[$key] != $value) {
|
|
switch ($keys) {
|
|
case 'versions':
|
|
$diff[$fromVersionNumber][$key] = $value;
|
|
$diff[$toVersionNumber][$key] = $toVersion[$key];
|
|
break;
|
|
default:
|
|
$diff[$key] = array(
|
|
$fromVersionNumber => $value,
|
|
$toVersionNumber => $toVersion[$key],
|
|
);
|
|
break;
|
|
}
|
|
}
|
|
}
|
|
|
|
return $diff;
|
|
}
|
|
/**
|
|
* retrieve the last $number versions.
|
|
*
|
|
* @param Integer $number the number of record to return.
|
|
* @return PropelCollection|array \Contest\Model\QuestionVersion[] List of \Contest\Model\QuestionVersion objects
|
|
*/
|
|
public function getLastVersions($number = 10, $criteria = null, $con = null)
|
|
{
|
|
$criteria = ChildQuestionVersionQuery::create(null, $criteria);
|
|
$criteria->addDescendingOrderByColumn(QuestionVersionTableMap::VERSION);
|
|
$criteria->limit($number);
|
|
|
|
return $this->getQuestionVersions($criteria, $con);
|
|
}
|
|
/**
|
|
* Code to be run before persisting the object
|
|
* @param ConnectionInterface $con
|
|
* @return boolean
|
|
*/
|
|
public function preSave(ConnectionInterface $con = null)
|
|
{
|
|
return true;
|
|
}
|
|
|
|
/**
|
|
* Code to be run after persisting the object
|
|
* @param ConnectionInterface $con
|
|
*/
|
|
public function postSave(ConnectionInterface $con = null)
|
|
{
|
|
|
|
}
|
|
|
|
/**
|
|
* Code to be run before inserting to database
|
|
* @param ConnectionInterface $con
|
|
* @return boolean
|
|
*/
|
|
public function preInsert(ConnectionInterface $con = null)
|
|
{
|
|
return true;
|
|
}
|
|
|
|
/**
|
|
* Code to be run after inserting to database
|
|
* @param ConnectionInterface $con
|
|
*/
|
|
public function postInsert(ConnectionInterface $con = null)
|
|
{
|
|
|
|
}
|
|
|
|
/**
|
|
* Code to be run before updating the object in database
|
|
* @param ConnectionInterface $con
|
|
* @return boolean
|
|
*/
|
|
public function preUpdate(ConnectionInterface $con = null)
|
|
{
|
|
return true;
|
|
}
|
|
|
|
/**
|
|
* Code to be run after updating the object in database
|
|
* @param ConnectionInterface $con
|
|
*/
|
|
public function postUpdate(ConnectionInterface $con = null)
|
|
{
|
|
|
|
}
|
|
|
|
/**
|
|
* Code to be run before deleting the object in database
|
|
* @param ConnectionInterface $con
|
|
* @return boolean
|
|
*/
|
|
public function preDelete(ConnectionInterface $con = null)
|
|
{
|
|
return true;
|
|
}
|
|
|
|
/**
|
|
* Code to be run after deleting the object in database
|
|
* @param ConnectionInterface $con
|
|
*/
|
|
public function postDelete(ConnectionInterface $con = null)
|
|
{
|
|
|
|
}
|
|
|
|
|
|
/**
|
|
* Derived method to catches calls to undefined methods.
|
|
*
|
|
* Provides magic import/export method support (fromXML()/toXML(), fromYAML()/toYAML(), etc.).
|
|
* Allows to define default __call() behavior if you overwrite __call()
|
|
*
|
|
* @param string $name
|
|
* @param mixed $params
|
|
*
|
|
* @return array|string
|
|
*/
|
|
public function __call($name, $params)
|
|
{
|
|
if (0 === strpos($name, 'get')) {
|
|
$virtualColumn = substr($name, 3);
|
|
if ($this->hasVirtualColumn($virtualColumn)) {
|
|
return $this->getVirtualColumn($virtualColumn);
|
|
}
|
|
|
|
$virtualColumn = lcfirst($virtualColumn);
|
|
if ($this->hasVirtualColumn($virtualColumn)) {
|
|
return $this->getVirtualColumn($virtualColumn);
|
|
}
|
|
}
|
|
|
|
if (0 === strpos($name, 'from')) {
|
|
$format = substr($name, 4);
|
|
|
|
return $this->importFrom($format, reset($params));
|
|
}
|
|
|
|
if (0 === strpos($name, 'to')) {
|
|
$format = substr($name, 2);
|
|
$includeLazyLoadColumns = isset($params[0]) ? $params[0] : true;
|
|
|
|
return $this->exportTo($format, $includeLazyLoadColumns);
|
|
}
|
|
|
|
throw new BadMethodCallException(sprintf('Call to undefined method: %s.', $name));
|
|
}
|
|
|
|
}
|