Files
grzanieplus.pl/plugins/stMailPlugin/lib/model/om/BaseMailDescription.php
2025-03-12 17:06:23 +01:00

1166 lines
32 KiB
PHP

<?php
/**
* Base class that represents a row from the 'st_mail_description' table.
*
*
*
* @package plugins.stMailPlugin.lib.model.om
*/
abstract class BaseMailDescription extends BaseObject implements Persistent {
protected static $dispatcher = null;
/**
* The value for the created_at field.
* @var int
*/
protected $created_at;
/**
* The value for the updated_at field.
* @var int
*/
protected $updated_at;
/**
* The value for the id field.
* @var int
*/
protected $id;
/**
* The value for the system_name field.
* @var string
*/
protected $system_name;
/**
* The value for the opt_name field.
* @var string
*/
protected $opt_name;
/**
* The value for the opt_description field.
* @var string
*/
protected $opt_description;
/**
* The value for the is_active field.
* @var boolean
*/
protected $is_active = false;
/**
* Collection to store aggregation of collMailDescriptionI18ns.
* @var array
*/
protected $collMailDescriptionI18ns;
/**
* The criteria used to select the current contents of collMailDescriptionI18ns.
* @var Criteria
*/
protected $lastMailDescriptionI18nCriteria = null;
/**
* Flag to prevent endless save loop, if this object is referenced
* by another object which falls in this transaction.
* @var boolean
*/
protected $alreadyInSave = false;
/**
* Flag to prevent endless validation loop, if this object is referenced
* by another object which falls in this transaction.
* @var boolean
*/
protected $alreadyInValidation = false;
/**
* The value for the culture field.
* @var string
*/
protected $culture;
/**
* Get the [optionally formatted] [created_at] column value.
*
* @param string $format The date/time format string (either date()-style or strftime()-style).
* If format is NULL, then the integer unix timestamp will be returned.
* @return mixed Formatted date/time value as string or integer unix timestamp (if format is NULL).
* @throws PropelException - if unable to convert the date/time to timestamp.
*/
public function getCreatedAt($format = 'Y-m-d H:i:s')
{
if ($this->created_at === null || $this->created_at === '') {
return null;
} elseif (!is_int($this->created_at)) {
// a non-timestamp value was set externally, so we convert it
$ts = strtotime($this->created_at);
if ($ts === -1 || $ts === false) { // in PHP 5.1 return value changes to FALSE
throw new PropelException("Unable to parse value of [created_at] as date/time value: " . var_export($this->created_at, true));
}
} else {
$ts = $this->created_at;
}
if ($format === null) {
return $ts;
} elseif (strpos($format, '%') !== false) {
return strftime($format, $ts);
} else {
return date($format, $ts);
}
}
/**
* Get the [optionally formatted] [updated_at] column value.
*
* @param string $format The date/time format string (either date()-style or strftime()-style).
* If format is NULL, then the integer unix timestamp will be returned.
* @return mixed Formatted date/time value as string or integer unix timestamp (if format is NULL).
* @throws PropelException - if unable to convert the date/time to timestamp.
*/
public function getUpdatedAt($format = 'Y-m-d H:i:s')
{
if ($this->updated_at === null || $this->updated_at === '') {
return null;
} elseif (!is_int($this->updated_at)) {
// a non-timestamp value was set externally, so we convert it
$ts = strtotime($this->updated_at);
if ($ts === -1 || $ts === false) { // in PHP 5.1 return value changes to FALSE
throw new PropelException("Unable to parse value of [updated_at] as date/time value: " . var_export($this->updated_at, true));
}
} else {
$ts = $this->updated_at;
}
if ($format === null) {
return $ts;
} elseif (strpos($format, '%') !== false) {
return strftime($format, $ts);
} else {
return date($format, $ts);
}
}
/**
* Get the [id] column value.
*
* @return int
*/
public function getId()
{
return $this->id;
}
/**
* Get the [system_name] column value.
*
* @return string
*/
public function getSystemName()
{
return $this->system_name;
}
/**
* Get the [opt_name] column value.
*
* @return string
*/
public function getOptName()
{
return $this->opt_name;
}
/**
* Get the [opt_description] column value.
*
* @return string
*/
public function getOptDescription()
{
return $this->opt_description;
}
/**
* Get the [is_active] column value.
*
* @return boolean
*/
public function getIsActive()
{
return $this->is_active;
}
/**
* Set the value of [created_at] column.
*
* @param int $v new value
* @return void
*/
public function setCreatedAt($v)
{
if ($v !== null && !is_int($v)) {
$ts = strtotime($v);
if ($ts === -1 || $ts === false) { // in PHP 5.1 return value changes to FALSE
throw new PropelException("Unable to parse date/time value for [created_at] from input: " . var_export($v, true));
}
} else {
$ts = $v;
}
if ($this->created_at !== $ts) {
$this->created_at = $ts;
$this->modifiedColumns[] = MailDescriptionPeer::CREATED_AT;
}
} // setCreatedAt()
/**
* Set the value of [updated_at] column.
*
* @param int $v new value
* @return void
*/
public function setUpdatedAt($v)
{
if ($v !== null && !is_int($v)) {
$ts = strtotime($v);
if ($ts === -1 || $ts === false) { // in PHP 5.1 return value changes to FALSE
throw new PropelException("Unable to parse date/time value for [updated_at] from input: " . var_export($v, true));
}
} else {
$ts = $v;
}
if ($this->updated_at !== $ts) {
$this->updated_at = $ts;
$this->modifiedColumns[] = MailDescriptionPeer::UPDATED_AT;
}
} // setUpdatedAt()
/**
* Set the value of [id] column.
*
* @param int $v new value
* @return void
*/
public function setId($v)
{
if ($v !== null && !is_int($v) && is_numeric($v)) {
$v = (int) $v;
}
if ($this->id !== $v) {
$this->id = $v;
$this->modifiedColumns[] = MailDescriptionPeer::ID;
}
} // setId()
/**
* Set the value of [system_name] column.
*
* @param string $v new value
* @return void
*/
public function setSystemName($v)
{
if ($v !== null && !is_string($v)) {
$v = (string) $v;
}
if ($this->system_name !== $v) {
$this->system_name = $v;
$this->modifiedColumns[] = MailDescriptionPeer::SYSTEM_NAME;
}
} // setSystemName()
/**
* Set the value of [opt_name] column.
*
* @param string $v new value
* @return void
*/
public function setOptName($v)
{
if ($v !== null && !is_string($v)) {
$v = (string) $v;
}
if ($this->opt_name !== $v) {
$this->opt_name = $v;
$this->modifiedColumns[] = MailDescriptionPeer::OPT_NAME;
}
} // setOptName()
/**
* Set the value of [opt_description] column.
*
* @param string $v new value
* @return void
*/
public function setOptDescription($v)
{
if ($v !== null && !is_string($v)) {
$v = (string) $v;
}
if ($this->opt_description !== $v) {
$this->opt_description = $v;
$this->modifiedColumns[] = MailDescriptionPeer::OPT_DESCRIPTION;
}
} // setOptDescription()
/**
* Set the value of [is_active] column.
*
* @param boolean $v new value
* @return void
*/
public function setIsActive($v)
{
if ($v !== null && !is_bool($v)) {
$v = (bool) $v;
}
if ($this->is_active !== $v || $v === false) {
$this->is_active = $v;
$this->modifiedColumns[] = MailDescriptionPeer::IS_ACTIVE;
}
} // setIsActive()
/**
* Hydrates (populates) the object variables with values from the database resultset.
*
* An offset (1-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 ResultSet $rs The ResultSet class with cursor advanced to desired record pos.
* @param int $startcol 1-based offset column which indicates which restultset column to start with.
* @return int next starting column
* @throws PropelException - Any caught Exception will be rewrapped as a PropelException.
*/
public function hydrate(ResultSet $rs, $startcol = 1)
{
try {
if ($this->getDispatcher()->getListeners('MailDescription.preHydrate')) {
$event = $this->getDispatcher()->notify(new sfEvent($this, 'MailDescription.preHydrate', array('resultset' => $rs, 'startcol' => $startcol)));
$startcol = $event['startcol'];
}
$this->created_at = $rs->getTimestamp($startcol + 0, null);
$this->updated_at = $rs->getTimestamp($startcol + 1, null);
$this->id = $rs->getInt($startcol + 2);
$this->system_name = $rs->getString($startcol + 3);
$this->opt_name = $rs->getString($startcol + 4);
$this->opt_description = $rs->getString($startcol + 5);
$this->is_active = $rs->getBoolean($startcol + 6);
$this->resetModified();
$this->setNew(false);
if ($this->getDispatcher()->getListeners('MailDescription.postHydrate')) {
$event = $this->getDispatcher()->notify(new sfEvent($this, 'MailDescription.postHydrate', array('resultset' => $rs, 'startcol' => $startcol + 7)));
return $event['startcol'];
}
// FIXME - using NUM_COLUMNS may be clearer.
return $startcol + 7; // 7 = MailDescriptionPeer::NUM_COLUMNS - MailDescriptionPeer::NUM_LAZY_LOAD_COLUMNS).
} catch (Exception $e) {
throw new PropelException("Error populating MailDescription object", $e);
}
}
/**
* Removes this object from datastore and sets delete attribute.
*
* @param Connection $con
* @return void
* @throws PropelException
* @see BaseObject::setDeleted()
* @see BaseObject::isDeleted()
*/
public function delete($con = null)
{
if ($this->isDeleted()) {
throw new PropelException("This object has already been deleted.");
}
if ($this->getDispatcher()->getListeners('MailDescription.preDelete')) {
$this->getDispatcher()->notify(new sfEvent($this, 'MailDescription.preDelete', array('con' => $con)));
}
if (sfMixer::hasCallables('BaseMailDescription:delete:pre'))
{
foreach (sfMixer::getCallables('BaseMailDescription:delete:pre') as $callable)
{
$ret = call_user_func($callable, $this, $con);
if ($ret)
{
return;
}
}
}
if ($con === null) {
$con = Propel::getConnection(MailDescriptionPeer::DATABASE_NAME);
}
try {
$con->begin();
MailDescriptionPeer::doDelete($this, $con);
$this->setDeleted(true);
$con->commit();
} catch (PropelException $e) {
$con->rollback();
throw $e;
}
if ($this->getDispatcher()->getListeners('MailDescription.postDelete')) {
$this->getDispatcher()->notify(new sfEvent($this, 'MailDescription.postDelete', array('con' => $con)));
}
if (sfMixer::hasCallables('BaseMailDescription:delete:post'))
{
foreach (sfMixer::getCallables('BaseMailDescription:delete:post') as $callable)
{
call_user_func($callable, $this, $con);
}
}
}
/**
* Stores the object in the database. If the object is new,
* it inserts it; otherwise an update is performed. This method
* wraps the doSave() worker method in a transaction.
*
* @param Connection $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($con = null)
{
if ($this->isDeleted()) {
throw new PropelException("You cannot save an object that has been deleted.");
}
if (!$this->alreadyInSave) {
if ($this->getDispatcher()->getListeners('MailDescription.preSave')) {
$this->getDispatcher()->notify(new sfEvent($this, 'MailDescription.preSave', array('con' => $con)));
}
foreach (sfMixer::getCallables('BaseMailDescription:save:pre') as $callable)
{
$affectedRows = call_user_func($callable, $this, $con);
if (is_int($affectedRows))
{
return $affectedRows;
}
}
}
if ($this->isNew() && !$this->isColumnModified(MailDescriptionPeer::CREATED_AT))
{
$this->setCreatedAt(time());
}
if ($this->isModified() && !$this->isColumnModified(MailDescriptionPeer::UPDATED_AT))
{
$this->setUpdatedAt(time());
}
if ($con === null) {
$con = Propel::getConnection(MailDescriptionPeer::DATABASE_NAME);
}
try {
$con->begin();
$affectedRows = $this->doSave($con);
$con->commit();
if (!$this->alreadyInSave) {
if ($this->getDispatcher()->getListeners('MailDescription.postSave')) {
$this->getDispatcher()->notify(new sfEvent($this, 'MailDescription.postSave', array('con' => $con)));
}
foreach (sfMixer::getCallables('BaseMailDescription:save:post') as $callable)
{
call_user_func($callable, $this, $con, $affectedRows);
}
}
return $affectedRows;
} catch (PropelException $e) {
$con->rollback();
throw $e;
}
}
/**
* Stores the object 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 Connection $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($con)
{
$affectedRows = 0; // initialize var to track total num of affected rows
if (!$this->alreadyInSave) {
$this->alreadyInSave = true;
// If this object has been modified, then save it to the database.
if ($this->isModified()) {
if ($this->isNew()) {
$pk = MailDescriptionPeer::doInsert($this, $con);
$affectedRows += 1; // we are assuming that there is only 1 row per doInsert() which
// should always be true here (even though technically
// BasePeer::doInsert() can insert multiple rows).
$this->setId($pk); //[IMV] update autoincrement primary key
$this->setNew(false);
} else {
$affectedRows += MailDescriptionPeer::doUpdate($this, $con);
}
$this->resetModified(); // [HL] After being saved an object is no longer 'modified'
}
if ($this->collMailDescriptionI18ns !== null) {
foreach($this->collMailDescriptionI18ns as $referrerFK) {
if (!$referrerFK->isDeleted()) {
$affectedRows += $referrerFK->save($con);
}
}
}
$this->alreadyInSave = false;
}
return $affectedRows;
} // doSave()
/**
* Array of ValidationFailed objects.
* @var array ValidationFailed[]
*/
protected $validationFailures = array();
/**
* Gets any ValidationFailed objects that resulted from last call to validate().
*
*
* @return array ValidationFailed[]
* @see validate()
*/
public function getValidationFailures()
{
return $this->validationFailures;
}
/**
* Validates the objects modified field values and all objects related to this table.
*
* If $columns is either a column name or an array of column names
* only those columns are validated.
*
* @param mixed $columns Column name or an array of column names.
* @return boolean Whether all columns pass validation.
* @see doValidate()
* @see getValidationFailures()
*/
public function validate($columns = null)
{
$res = $this->doValidate($columns);
if ($res === true) {
$this->validationFailures = array();
return true;
} else {
$this->validationFailures = $res;
return false;
}
}
/**
* This function performs the validation work for complex object models.
*
* In addition to checking the current object, all related objects will
* also be validated. If all pass then <code>true</code> is returned; otherwise
* an aggreagated array of ValidationFailed objects will be returned.
*
* @param array $columns Array of column names to validate.
* @return mixed <code>true</code> if all validations pass; array of <code>ValidationFailed</code> objets otherwise.
*/
protected function doValidate($columns = null)
{
if (!$this->alreadyInValidation) {
$this->alreadyInValidation = true;
$retval = null;
$failureMap = array();
if (($retval = MailDescriptionPeer::doValidate($this, $columns)) !== true) {
$failureMap = array_merge($failureMap, $retval);
}
if ($this->collMailDescriptionI18ns !== null) {
foreach($this->collMailDescriptionI18ns as $referrerFK) {
if (!$referrerFK->validate($columns)) {
$failureMap = array_merge($failureMap, $referrerFK->getValidationFailures());
}
}
}
$this->alreadyInValidation = false;
}
return (!empty($failureMap) ? $failureMap : true);
}
/**
* 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 TYPE_PHPNAME,
* TYPE_COLNAME, TYPE_FIELDNAME, TYPE_NUM
* @return mixed Value of field.
*/
public function getByName($name, $type = BasePeer::TYPE_PHPNAME)
{
$pos = MailDescriptionPeer::translateFieldName($name, $type, BasePeer::TYPE_NUM);
return $this->getByPosition($pos);
}
/**
* 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->getCreatedAt();
break;
case 1:
return $this->getUpdatedAt();
break;
case 2:
return $this->getId();
break;
case 3:
return $this->getSystemName();
break;
case 4:
return $this->getOptName();
break;
case 5:
return $this->getOptDescription();
break;
case 6:
return $this->getIsActive();
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 One of the class type constants TYPE_PHPNAME,
* TYPE_COLNAME, TYPE_FIELDNAME, TYPE_NUM
* @return an associative array containing the field names (as keys) and field values
*/
public function toArray($keyType = BasePeer::TYPE_PHPNAME)
{
$keys = MailDescriptionPeer::getFieldNames($keyType);
$result = array(
$keys[0] => $this->getCreatedAt(),
$keys[1] => $this->getUpdatedAt(),
$keys[2] => $this->getId(),
$keys[3] => $this->getSystemName(),
$keys[4] => $this->getOptName(),
$keys[5] => $this->getOptDescription(),
$keys[6] => $this->getIsActive(),
);
return $result;
}
/**
* Sets a field from the object by name passed in as a string.
*
* @param string $name peer name
* @param mixed $value field value
* @param string $type The type of fieldname the $name is of:
* one of the class type constants TYPE_PHPNAME,
* TYPE_COLNAME, TYPE_FIELDNAME, TYPE_NUM
* @return void
*/
public function setByName($name, $value, $type = BasePeer::TYPE_PHPNAME)
{
$pos = MailDescriptionPeer::translateFieldName($name, $type, BasePeer::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->setCreatedAt($value);
break;
case 1:
$this->setUpdatedAt($value);
break;
case 2:
$this->setId($value);
break;
case 3:
$this->setSystemName($value);
break;
case 4:
$this->setOptName($value);
break;
case 5:
$this->setOptDescription($value);
break;
case 6:
$this->setIsActive($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 TYPE_PHPNAME, TYPE_COLNAME, TYPE_FIELDNAME,
* TYPE_NUM. The default key type is the column's phpname (e.g. 'authorId')
*
* @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 = BasePeer::TYPE_PHPNAME)
{
$keys = MailDescriptionPeer::getFieldNames($keyType);
if (array_key_exists($keys[0], $arr)) $this->setCreatedAt($arr[$keys[0]]);
if (array_key_exists($keys[1], $arr)) $this->setUpdatedAt($arr[$keys[1]]);
if (array_key_exists($keys[2], $arr)) $this->setId($arr[$keys[2]]);
if (array_key_exists($keys[3], $arr)) $this->setSystemName($arr[$keys[3]]);
if (array_key_exists($keys[4], $arr)) $this->setOptName($arr[$keys[4]]);
if (array_key_exists($keys[5], $arr)) $this->setOptDescription($arr[$keys[5]]);
if (array_key_exists($keys[6], $arr)) $this->setIsActive($arr[$keys[6]]);
}
/**
* 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(MailDescriptionPeer::DATABASE_NAME);
if ($this->isColumnModified(MailDescriptionPeer::CREATED_AT)) $criteria->add(MailDescriptionPeer::CREATED_AT, $this->created_at);
if ($this->isColumnModified(MailDescriptionPeer::UPDATED_AT)) $criteria->add(MailDescriptionPeer::UPDATED_AT, $this->updated_at);
if ($this->isColumnModified(MailDescriptionPeer::ID)) $criteria->add(MailDescriptionPeer::ID, $this->id);
if ($this->isColumnModified(MailDescriptionPeer::SYSTEM_NAME)) $criteria->add(MailDescriptionPeer::SYSTEM_NAME, $this->system_name);
if ($this->isColumnModified(MailDescriptionPeer::OPT_NAME)) $criteria->add(MailDescriptionPeer::OPT_NAME, $this->opt_name);
if ($this->isColumnModified(MailDescriptionPeer::OPT_DESCRIPTION)) $criteria->add(MailDescriptionPeer::OPT_DESCRIPTION, $this->opt_description);
if ($this->isColumnModified(MailDescriptionPeer::IS_ACTIVE)) $criteria->add(MailDescriptionPeer::IS_ACTIVE, $this->is_active);
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(MailDescriptionPeer::DATABASE_NAME);
$criteria->add(MailDescriptionPeer::ID, $this->id);
return $criteria;
}
/**
* Returns the primary key for this object (row).
* @return int
*/
public function getPrimaryKey()
{
return $this->getId();
}
/**
* Returns [composite] primary key fields
*
* @param string $keyType
* @return array
*/
public function getPrimaryKeyFields($keyType = BasePeer::TYPE_FIELDNAME)
{
return array(MailDescriptionPeer::translateFieldName('id', BasePeer::TYPE_FIELDNAME, $keyType));
}
/**
* Generic method to set the primary key (id column).
*
* @param int $key Primary key.
* @return void
*/
public function setPrimaryKey($key)
{
$this->setId($key);
}
/**
* 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 MailDescription (or compatible) type.
* @param boolean $deepCopy Whether to also copy all rows that refer (by fkey) to the current row.
* @throws PropelException
*/
public function copyInto($copyObj, $deepCopy = false)
{
$copyObj->setCreatedAt($this->created_at);
$copyObj->setUpdatedAt($this->updated_at);
$copyObj->setSystemName($this->system_name);
$copyObj->setOptName($this->opt_name);
$copyObj->setOptDescription($this->opt_description);
$copyObj->setIsActive($this->is_active);
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->getMailDescriptionI18ns() as $relObj) {
$copyObj->addMailDescriptionI18n($relObj->copy($deepCopy));
}
} // if ($deepCopy)
$copyObj->setNew(true);
$copyObj->setId(NULL); // this is a pkey 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 MailDescription 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;
}
/**
* Returns a peer instance associated with this om.
*
* @return string Peer class name
*/
public function getPeer()
{
return 'MailDescriptionPeer';
}
/**
* Temporary storage of collMailDescriptionI18ns to save a possible db hit in
* the event objects are add to the collection, but the
* complete collection is never requested.
* @return void
*/
public function initMailDescriptionI18ns()
{
if ($this->collMailDescriptionI18ns === null) {
$this->collMailDescriptionI18ns = array();
}
}
/**
* If this collection has already been initialized with
* an identical criteria, it returns the collection.
* Otherwise if this MailDescription has previously
* been saved, it will retrieve related MailDescriptionI18ns from storage.
* If this MailDescription is new, it will return
* an empty collection or the current collection, the criteria
* is ignored on a new object.
*
* @param Connection $con
* @param Criteria $criteria
* @return MailDescriptionI18n[]
* @throws PropelException
*/
public function getMailDescriptionI18ns($criteria = null, $con = null)
{
// include the Peer class
if ($criteria === null) {
$criteria = new Criteria();
}
elseif ($criteria instanceof Criteria)
{
$criteria = clone $criteria;
}
if ($this->collMailDescriptionI18ns === null) {
if ($this->isNew()) {
$this->collMailDescriptionI18ns = array();
} else {
$criteria->add(MailDescriptionI18nPeer::ID, $this->getId());
MailDescriptionI18nPeer::addSelectColumns($criteria);
$this->collMailDescriptionI18ns = MailDescriptionI18nPeer::doSelect($criteria, $con);
}
} else {
// criteria has no effect for a new object
if (!$this->isNew()) {
// the following code is to determine if a new query is
// called for. If the criteria is the same as the last
// one, just return the collection.
$criteria->add(MailDescriptionI18nPeer::ID, $this->getId());
MailDescriptionI18nPeer::addSelectColumns($criteria);
if (!isset($this->lastMailDescriptionI18nCriteria) || !$this->lastMailDescriptionI18nCriteria->equals($criteria)) {
$this->collMailDescriptionI18ns = MailDescriptionI18nPeer::doSelect($criteria, $con);
}
}
}
$this->lastMailDescriptionI18nCriteria = $criteria;
return $this->collMailDescriptionI18ns;
}
/**
* Returns the number of related MailDescriptionI18ns.
*
* @param Criteria $criteria
* @param boolean $distinct
* @param Connection $con
* @throws PropelException
*/
public function countMailDescriptionI18ns($criteria = null, $distinct = false, $con = null)
{
// include the Peer class
if ($criteria === null) {
$criteria = new Criteria();
}
elseif ($criteria instanceof Criteria)
{
$criteria = clone $criteria;
}
$criteria->add(MailDescriptionI18nPeer::ID, $this->getId());
return MailDescriptionI18nPeer::doCount($criteria, $distinct, $con);
}
/**
* Method called to associate a MailDescriptionI18n object to this object
* through the MailDescriptionI18n foreign key attribute
*
* @param MailDescriptionI18n $l MailDescriptionI18n
* @return void
* @throws PropelException
*/
public function addMailDescriptionI18n(MailDescriptionI18n $l)
{
$this->collMailDescriptionI18ns[] = $l;
$l->setMailDescription($this);
}
public function getCulture()
{
return $this->culture;
}
public function setCulture($culture)
{
$this->culture = $culture;
}
public function getDescription()
{
$obj = $this->getCurrentMailDescriptionI18n();
return ($obj ? $obj->getDescription() : null);
}
public function setDescription($value)
{
$this->getCurrentMailDescriptionI18n()->setDescription($value);
}
public function getName()
{
$obj = $this->getCurrentMailDescriptionI18n();
return ($obj ? $obj->getName() : null);
}
public function setName($value)
{
$this->getCurrentMailDescriptionI18n()->setName($value);
}
public $current_i18n = array();
public function getCurrentMailDescriptionI18n()
{
if (!isset($this->current_i18n[$this->culture]))
{
$obj = MailDescriptionI18nPeer::retrieveByPK($this->getId(), $this->culture);
if ($obj)
{
$this->setMailDescriptionI18nForCulture($obj, $this->culture);
}
else
{
$this->setMailDescriptionI18nForCulture(new MailDescriptionI18n(), $this->culture);
$this->current_i18n[$this->culture]->setCulture($this->culture);
}
}
return $this->current_i18n[$this->culture];
}
public function setMailDescriptionI18nForCulture($object, $culture)
{
$this->current_i18n[$culture] = $object;
$this->addMailDescriptionI18n($object);
}
public function getDispatcher()
{
if (null === self::$dispatcher)
{
self::$dispatcher = stEventDispatcher::getInstance();
}
return self::$dispatcher;
}
public function __call($method, $arguments)
{
$event = $this->getDispatcher()->notifyUntil(new sfEvent($this, 'MailDescription.' . $method, array('arguments' => $arguments, 'method' => $method)));
if ($event->isProcessed())
{
return $event->getReturnValue();
}
if (!$callable = sfMixer::getCallable('BaseMailDescription:'.$method))
{
throw new sfException(sprintf('Call to undefined method BaseMailDescription::%s', $method));
}
array_unshift($arguments, $this);
return call_user_func_array($callable, $arguments);
}
} // BaseMailDescription