diff --git a/src/Model/Base/Certificate.php b/src/Model/Base/Certificate.php index ba280e0..0cf6bf6 100644 --- a/src/Model/Base/Certificate.php +++ b/src/Model/Base/Certificate.php @@ -23,7 +23,7 @@ use Propel\Runtime\Parser\AbstractParser; use Propel\Runtime\Util\PropelDateTime; /** - * Base class that represents a row from the 'Certificate' table. + * Base class that represents a row from the 'certificate' table. * * * @@ -937,7 +937,7 @@ abstract class Certificate implements ActiveRecordInterface } $sql = sprintf( - 'INSERT INTO Certificate (%s) VALUES (%s)', + 'INSERT INTO certificate (%s) VALUES (%s)', implode(', ', $modifiedColumns), implode(', ', array_keys($modifiedColumns)) ); @@ -1116,7 +1116,7 @@ abstract class Certificate implements ActiveRecordInterface $key = 'user'; break; case TableMap::TYPE_FIELDNAME: - $key = 'User'; + $key = 'user'; break; default: $key = 'User'; diff --git a/src/Model/Base/CertificateQuery.php b/src/Model/Base/CertificateQuery.php index 20f6409..e7c6b9a 100644 --- a/src/Model/Base/CertificateQuery.php +++ b/src/Model/Base/CertificateQuery.php @@ -16,7 +16,7 @@ use Propel\Runtime\Connection\ConnectionInterface; use Propel\Runtime\Exception\PropelException; /** - * Base class that represents a query for the 'Certificate' table. + * Base class that represents a query for the 'certificate' table. * * * @@ -173,7 +173,7 @@ abstract class CertificateQuery extends ModelCriteria */ protected function findPkSimple($key, ConnectionInterface $con) { - $sql = 'SELECT id, user_id, name, certificate, private_key, expires_on, revoked, serial FROM Certificate WHERE id = :p0'; + $sql = 'SELECT id, user_id, name, certificate, private_key, expires_on, revoked, serial FROM certificate WHERE id = :p0'; try { $stmt = $con->prepare($sql); $stmt->bindValue(':p0', $key, PDO::PARAM_INT); @@ -627,7 +627,7 @@ abstract class CertificateQuery extends ModelCriteria } /** - * Deletes all rows from the Certificate table. + * Deletes all rows from the certificate table. * * @param ConnectionInterface $con the connection to use * @return int The number of affected rows (if supported by underlying database driver). diff --git a/src/Model/Base/EmailAddress.php b/src/Model/Base/EmailAddress.php new file mode 100644 index 0000000..7960e3e --- /dev/null +++ b/src/Model/Base/EmailAddress.php @@ -0,0 +1,2307 @@ +verified = false; + } + + /** + * Initializes internal state of Eater\Glim\Model\Base\EmailAddress 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 EmailAddress instance. If + * obj is an instance of EmailAddress, delegates to + * equals(EmailAddress). Otherwise, returns false. + * + * @param mixed $obj The object to compare to. + * @return boolean Whether equal to the object specified. + */ + public function equals($obj) + { + if (!$obj instanceof static) { + return false; + } + + if ($this === $obj) { + return true; + } + + if (null === $this->getPrimaryKey() || null === $obj->getPrimaryKey()) { + return false; + } + + return $this->getPrimaryKey() === $obj->getPrimaryKey(); + } + + /** + * 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 $this|EmailAddress 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); + } + + /** + * Export the current object properties to a string, using a given parser format + * + * $book = BookQuery::create()->findPk(9012); + * echo $book->exportTo('JSON'); + * => {"Id":9012,"Title":"Don Juan","ISBN":"0140422161","Price":12.99,"PublisherId":1234,"AuthorId":5678}'); + * + * + * @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 [verified] column value. + * + * @return boolean + */ + public function getVerified() + { + return $this->verified; + } + + /** + * Get the [verified] column value. + * + * @return boolean + */ + public function isVerified() + { + return $this->getVerified(); + } + + /** + * Get the [verification] column value. + * + * @return string + */ + public function getVerification() + { + return $this->verification; + } + + /** + * Get the [address] column value. + * + * @return string + */ + public function getAddress() + { + return $this->address; + } + + /** + * Get the [owner] column value. + * + * @return int + */ + public function getOwner() + { + return $this->owner; + } + + /** + * Set the value of [id] column. + * + * @param int $v new value + * @return $this|\Eater\Glim\Model\EmailAddress 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[EmailAddressTableMap::COL_ID] = true; + } + + return $this; + } // setId() + + /** + * Sets the value of the [verified] column. + * Non-boolean arguments are converted using the following rules: + * * 1, '1', 'true', 'on', and 'yes' are converted to boolean true + * * 0, '0', 'false', 'off', and 'no' are converted to boolean false + * Check on string values is case insensitive (so 'FaLsE' is seen as 'false'). + * + * @param boolean|integer|string $v The new value + * @return $this|\Eater\Glim\Model\EmailAddress The current object (for fluent API support) + */ + public function setVerified($v) + { + if ($v !== null) { + if (is_string($v)) { + $v = in_array(strtolower($v), array('false', 'off', '-', 'no', 'n', '0', '')) ? false : true; + } else { + $v = (boolean) $v; + } + } + + if ($this->verified !== $v) { + $this->verified = $v; + $this->modifiedColumns[EmailAddressTableMap::COL_VERIFIED] = true; + } + + return $this; + } // setVerified() + + /** + * Set the value of [verification] column. + * + * @param string $v new value + * @return $this|\Eater\Glim\Model\EmailAddress The current object (for fluent API support) + */ + public function setVerification($v) + { + if ($v !== null) { + $v = (string) $v; + } + + if ($this->verification !== $v) { + $this->verification = $v; + $this->modifiedColumns[EmailAddressTableMap::COL_VERIFICATION] = true; + } + + return $this; + } // setVerification() + + /** + * Set the value of [address] column. + * + * @param string $v new value + * @return $this|\Eater\Glim\Model\EmailAddress The current object (for fluent API support) + */ + public function setAddress($v) + { + if ($v !== null) { + $v = (string) $v; + } + + if ($this->address !== $v) { + $this->address = $v; + $this->modifiedColumns[EmailAddressTableMap::COL_ADDRESS] = true; + } + + return $this; + } // setAddress() + + /** + * Set the value of [owner] column. + * + * @param int $v new value + * @return $this|\Eater\Glim\Model\EmailAddress The current object (for fluent API support) + */ + public function setOwner($v) + { + if ($v !== null) { + $v = (int) $v; + } + + if ($this->owner !== $v) { + $this->owner = $v; + $this->modifiedColumns[EmailAddressTableMap::COL_OWNER] = true; + } + + if ($this->aUserRelatedByOwner !== null && $this->aUserRelatedByOwner->getId() !== $v) { + $this->aUserRelatedByOwner = null; + } + + return $this; + } // setOwner() + + /** + * 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->verified !== false) { + 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_CAMELNAME + * 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 : EmailAddressTableMap::translateFieldName('Id', TableMap::TYPE_PHPNAME, $indexType)]; + $this->id = (null !== $col) ? (int) $col : null; + + $col = $row[TableMap::TYPE_NUM == $indexType ? 1 + $startcol : EmailAddressTableMap::translateFieldName('Verified', TableMap::TYPE_PHPNAME, $indexType)]; + $this->verified = (null !== $col) ? (boolean) $col : null; + + $col = $row[TableMap::TYPE_NUM == $indexType ? 2 + $startcol : EmailAddressTableMap::translateFieldName('Verification', TableMap::TYPE_PHPNAME, $indexType)]; + $this->verification = (null !== $col) ? (string) $col : null; + + $col = $row[TableMap::TYPE_NUM == $indexType ? 3 + $startcol : EmailAddressTableMap::translateFieldName('Address', TableMap::TYPE_PHPNAME, $indexType)]; + $this->address = (null !== $col) ? (string) $col : null; + + $col = $row[TableMap::TYPE_NUM == $indexType ? 4 + $startcol : EmailAddressTableMap::translateFieldName('Owner', TableMap::TYPE_PHPNAME, $indexType)]; + $this->owner = (null !== $col) ? (int) $col : null; + $this->resetModified(); + + $this->setNew(false); + + if ($rehydrate) { + $this->ensureConsistency(); + } + + return $startcol + 5; // 5 = EmailAddressTableMap::NUM_HYDRATE_COLUMNS. + + } catch (Exception $e) { + throw new PropelException(sprintf('Error populating %s object', '\\Eater\\Glim\\Model\\EmailAddress'), 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->aUserRelatedByOwner !== null && $this->owner !== $this->aUserRelatedByOwner->getId()) { + $this->aUserRelatedByOwner = 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(EmailAddressTableMap::DATABASE_NAME); + } + + // We don't need to alter the object instance pool; we're just modifying this instance + // already in the pool. + + $dataFetcher = ChildEmailAddressQuery::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->aUserRelatedByOwner = null; + $this->collUsersRelatedByEmail = null; + + $this->collEmailMessagesRelatedByRecipient = null; + + $this->collEmailMessagesRelatedBySender = null; + + } // if (deep) + } + + /** + * Removes this object from datastore and sets delete attribute. + * + * @param ConnectionInterface $con + * @return void + * @throws PropelException + * @see EmailAddress::setDeleted() + * @see EmailAddress::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(EmailAddressTableMap::DATABASE_NAME); + } + + $con->transaction(function () use ($con) { + $deleteQuery = ChildEmailAddressQuery::create() + ->filterByPrimaryKey($this->getPrimaryKey()); + $ret = $this->preDelete($con); + if ($ret) { + $deleteQuery->delete($con); + $this->postDelete($con); + $this->setDeleted(true); + } + }); + } + + /** + * 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(EmailAddressTableMap::DATABASE_NAME); + } + + return $con->transaction(function () use ($con) { + $isInsert = $this->isNew(); + $ret = $this->preSave($con); + if ($isInsert) { + $ret = $ret && $this->preInsert($con); + } else { + $ret = $ret && $this->preUpdate($con); + } + if ($ret) { + $affectedRows = $this->doSave($con); + if ($isInsert) { + $this->postInsert($con); + } else { + $this->postUpdate($con); + } + $this->postSave($con); + EmailAddressTableMap::addInstanceToPool($this); + } else { + $affectedRows = 0; + } + + return $affectedRows; + }); + } + + /** + * 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->aUserRelatedByOwner !== null) { + if ($this->aUserRelatedByOwner->isModified() || $this->aUserRelatedByOwner->isNew()) { + $affectedRows += $this->aUserRelatedByOwner->save($con); + } + $this->setUserRelatedByOwner($this->aUserRelatedByOwner); + } + + if ($this->isNew() || $this->isModified()) { + // persist changes + if ($this->isNew()) { + $this->doInsert($con); + $affectedRows += 1; + } else { + $affectedRows += $this->doUpdate($con); + } + $this->resetModified(); + } + + if ($this->usersRelatedByEmailScheduledForDeletion !== null) { + if (!$this->usersRelatedByEmailScheduledForDeletion->isEmpty()) { + foreach ($this->usersRelatedByEmailScheduledForDeletion as $userRelatedByEmail) { + // need to save related object because we set the relation to null + $userRelatedByEmail->save($con); + } + $this->usersRelatedByEmailScheduledForDeletion = null; + } + } + + if ($this->collUsersRelatedByEmail !== null) { + foreach ($this->collUsersRelatedByEmail as $referrerFK) { + if (!$referrerFK->isDeleted() && ($referrerFK->isNew() || $referrerFK->isModified())) { + $affectedRows += $referrerFK->save($con); + } + } + } + + if ($this->emailMessagesRelatedByRecipientScheduledForDeletion !== null) { + if (!$this->emailMessagesRelatedByRecipientScheduledForDeletion->isEmpty()) { + foreach ($this->emailMessagesRelatedByRecipientScheduledForDeletion as $emailMessageRelatedByRecipient) { + // need to save related object because we set the relation to null + $emailMessageRelatedByRecipient->save($con); + } + $this->emailMessagesRelatedByRecipientScheduledForDeletion = null; + } + } + + if ($this->collEmailMessagesRelatedByRecipient !== null) { + foreach ($this->collEmailMessagesRelatedByRecipient as $referrerFK) { + if (!$referrerFK->isDeleted() && ($referrerFK->isNew() || $referrerFK->isModified())) { + $affectedRows += $referrerFK->save($con); + } + } + } + + if ($this->emailMessagesRelatedBySenderScheduledForDeletion !== null) { + if (!$this->emailMessagesRelatedBySenderScheduledForDeletion->isEmpty()) { + foreach ($this->emailMessagesRelatedBySenderScheduledForDeletion as $emailMessageRelatedBySender) { + // need to save related object because we set the relation to null + $emailMessageRelatedBySender->save($con); + } + $this->emailMessagesRelatedBySenderScheduledForDeletion = null; + } + } + + if ($this->collEmailMessagesRelatedBySender !== null) { + foreach ($this->collEmailMessagesRelatedBySender 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[EmailAddressTableMap::COL_ID] = true; + if (null !== $this->id) { + throw new PropelException('Cannot insert a value for auto-increment primary key (' . EmailAddressTableMap::COL_ID . ')'); + } + + // check the columns in natural order for more readable SQL queries + if ($this->isColumnModified(EmailAddressTableMap::COL_ID)) { + $modifiedColumns[':p' . $index++] = 'id'; + } + if ($this->isColumnModified(EmailAddressTableMap::COL_VERIFIED)) { + $modifiedColumns[':p' . $index++] = 'verified'; + } + if ($this->isColumnModified(EmailAddressTableMap::COL_VERIFICATION)) { + $modifiedColumns[':p' . $index++] = 'verification'; + } + if ($this->isColumnModified(EmailAddressTableMap::COL_ADDRESS)) { + $modifiedColumns[':p' . $index++] = 'address'; + } + if ($this->isColumnModified(EmailAddressTableMap::COL_OWNER)) { + $modifiedColumns[':p' . $index++] = 'owner'; + } + + $sql = sprintf( + 'INSERT INTO email_address (%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 'verified': + $stmt->bindValue($identifier, $this->verified, PDO::PARAM_BOOL); + break; + case 'verification': + $stmt->bindValue($identifier, $this->verification, PDO::PARAM_STR); + break; + case 'address': + $stmt->bindValue($identifier, $this->address, PDO::PARAM_STR); + break; + case 'owner': + $stmt->bindValue($identifier, $this->owner, PDO::PARAM_INT); + 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_CAMELNAME + * 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 = EmailAddressTableMap::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->getVerified(); + break; + case 2: + return $this->getVerification(); + break; + case 3: + return $this->getAddress(); + break; + case 4: + return $this->getOwner(); + 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_CAMELNAME, + * 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['EmailAddress'][$this->hashCode()])) { + return '*RECURSION*'; + } + $alreadyDumpedObjects['EmailAddress'][$this->hashCode()] = true; + $keys = EmailAddressTableMap::getFieldNames($keyType); + $result = array( + $keys[0] => $this->getId(), + $keys[1] => $this->getVerified(), + $keys[2] => $this->getVerification(), + $keys[3] => $this->getAddress(), + $keys[4] => $this->getOwner(), + ); + $virtualColumns = $this->virtualColumns; + foreach ($virtualColumns as $key => $virtualColumn) { + $result[$key] = $virtualColumn; + } + + if ($includeForeignObjects) { + if (null !== $this->aUserRelatedByOwner) { + + switch ($keyType) { + case TableMap::TYPE_CAMELNAME: + $key = 'user'; + break; + case TableMap::TYPE_FIELDNAME: + $key = 'user'; + break; + default: + $key = 'User'; + } + + $result[$key] = $this->aUserRelatedByOwner->toArray($keyType, $includeLazyLoadColumns, $alreadyDumpedObjects, true); + } + if (null !== $this->collUsersRelatedByEmail) { + + switch ($keyType) { + case TableMap::TYPE_CAMELNAME: + $key = 'users'; + break; + case TableMap::TYPE_FIELDNAME: + $key = 'users'; + break; + default: + $key = 'Users'; + } + + $result[$key] = $this->collUsersRelatedByEmail->toArray(null, false, $keyType, $includeLazyLoadColumns, $alreadyDumpedObjects); + } + if (null !== $this->collEmailMessagesRelatedByRecipient) { + + switch ($keyType) { + case TableMap::TYPE_CAMELNAME: + $key = 'emailMessages'; + break; + case TableMap::TYPE_FIELDNAME: + $key = 'email_messages'; + break; + default: + $key = 'EmailMessages'; + } + + $result[$key] = $this->collEmailMessagesRelatedByRecipient->toArray(null, false, $keyType, $includeLazyLoadColumns, $alreadyDumpedObjects); + } + if (null !== $this->collEmailMessagesRelatedBySender) { + + switch ($keyType) { + case TableMap::TYPE_CAMELNAME: + $key = 'emailMessages'; + break; + case TableMap::TYPE_FIELDNAME: + $key = 'email_messages'; + break; + default: + $key = 'EmailMessages'; + } + + $result[$key] = $this->collEmailMessagesRelatedBySender->toArray(null, false, $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_CAMELNAME + * TableMap::TYPE_COLNAME, TableMap::TYPE_FIELDNAME, TableMap::TYPE_NUM. + * Defaults to TableMap::TYPE_PHPNAME. + * @return $this|\Eater\Glim\Model\EmailAddress + */ + public function setByName($name, $value, $type = TableMap::TYPE_PHPNAME) + { + $pos = EmailAddressTableMap::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 $this|\Eater\Glim\Model\EmailAddress + */ + public function setByPosition($pos, $value) + { + switch ($pos) { + case 0: + $this->setId($value); + break; + case 1: + $this->setVerified($value); + break; + case 2: + $this->setVerification($value); + break; + case 3: + $this->setAddress($value); + break; + case 4: + $this->setOwner($value); + break; + } // switch() + + return $this; + } + + /** + * 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_CAMELNAME, + * 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 = EmailAddressTableMap::getFieldNames($keyType); + + if (array_key_exists($keys[0], $arr)) { + $this->setId($arr[$keys[0]]); + } + if (array_key_exists($keys[1], $arr)) { + $this->setVerified($arr[$keys[1]]); + } + if (array_key_exists($keys[2], $arr)) { + $this->setVerification($arr[$keys[2]]); + } + if (array_key_exists($keys[3], $arr)) { + $this->setAddress($arr[$keys[3]]); + } + if (array_key_exists($keys[4], $arr)) { + $this->setOwner($arr[$keys[4]]); + } + } + + /** + * Populate the current object from a string, using a given parser format + * + * $book = new Book(); + * $book->importFrom('JSON', '{"Id":9012,"Title":"Don Juan","ISBN":"0140422161","Price":12.99,"PublisherId":1234,"AuthorId":5678}'); + * + * + * You can specify the key type of the array by additionally passing one + * of the class type constants TableMap::TYPE_PHPNAME, TableMap::TYPE_CAMELNAME, + * TableMap::TYPE_COLNAME, TableMap::TYPE_FIELDNAME, TableMap::TYPE_NUM. + * The default key type is the column's TableMap::TYPE_PHPNAME. + * + * @param mixed $parser A AbstractParser instance, + * or a format name ('XML', 'YAML', 'JSON', 'CSV') + * @param string $data The source data to import from + * @param string $keyType The type of keys the array uses. + * + * @return $this|\Eater\Glim\Model\EmailAddress The current object, for fluid interface + */ + public function importFrom($parser, $data, $keyType = TableMap::TYPE_PHPNAME) + { + if (!$parser instanceof AbstractParser) { + $parser = AbstractParser::getParser($parser); + } + + $this->fromArray($parser->toArray($data), $keyType); + + return $this; + } + + /** + * 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(EmailAddressTableMap::DATABASE_NAME); + + if ($this->isColumnModified(EmailAddressTableMap::COL_ID)) { + $criteria->add(EmailAddressTableMap::COL_ID, $this->id); + } + if ($this->isColumnModified(EmailAddressTableMap::COL_VERIFIED)) { + $criteria->add(EmailAddressTableMap::COL_VERIFIED, $this->verified); + } + if ($this->isColumnModified(EmailAddressTableMap::COL_VERIFICATION)) { + $criteria->add(EmailAddressTableMap::COL_VERIFICATION, $this->verification); + } + if ($this->isColumnModified(EmailAddressTableMap::COL_ADDRESS)) { + $criteria->add(EmailAddressTableMap::COL_ADDRESS, $this->address); + } + if ($this->isColumnModified(EmailAddressTableMap::COL_OWNER)) { + $criteria->add(EmailAddressTableMap::COL_OWNER, $this->owner); + } + + 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. + * + * @throws LogicException if no primary key is defined + * + * @return Criteria The Criteria object containing value(s) for primary key(s). + */ + public function buildPkeyCriteria() + { + $criteria = ChildEmailAddressQuery::create(); + $criteria->add(EmailAddressTableMap::COL_ID, $this->id); + + return $criteria; + } + + /** + * 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() + { + $validPk = null !== $this->getId(); + + $validPrimaryKeyFKs = 0; + $primaryKeyFKs = []; + + if ($validPk) { + return crc32(json_encode($this->getPrimaryKey(), JSON_UNESCAPED_UNICODE)); + } elseif ($validPrimaryKeyFKs) { + return crc32(json_encode($primaryKeyFKs, JSON_UNESCAPED_UNICODE)); + } + + return spl_object_hash($this); + } + + /** + * 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 \Eater\Glim\Model\EmailAddress (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->setVerified($this->getVerified()); + $copyObj->setVerification($this->getVerification()); + $copyObj->setAddress($this->getAddress()); + $copyObj->setOwner($this->getOwner()); + + 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->getUsersRelatedByEmail() as $relObj) { + if ($relObj !== $this) { // ensure that we don't try to copy a reference to ourselves + $copyObj->addUserRelatedByEmail($relObj->copy($deepCopy)); + } + } + + foreach ($this->getEmailMessagesRelatedByRecipient() as $relObj) { + if ($relObj !== $this) { // ensure that we don't try to copy a reference to ourselves + $copyObj->addEmailMessageRelatedByRecipient($relObj->copy($deepCopy)); + } + } + + foreach ($this->getEmailMessagesRelatedBySender() as $relObj) { + if ($relObj !== $this) { // ensure that we don't try to copy a reference to ourselves + $copyObj->addEmailMessageRelatedBySender($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 \Eater\Glim\Model\EmailAddress 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 ChildUser object. + * + * @param ChildUser $v + * @return $this|\Eater\Glim\Model\EmailAddress The current object (for fluent API support) + * @throws PropelException + */ + public function setUserRelatedByOwner(ChildUser $v = null) + { + if ($v === null) { + $this->setOwner(NULL); + } else { + $this->setOwner($v->getId()); + } + + $this->aUserRelatedByOwner = $v; + + // Add binding for other direction of this n:n relationship. + // If this object has already been added to the ChildUser object, it will not be re-added. + if ($v !== null) { + $v->addEmailAddressRelatedByOwner($this); + } + + + return $this; + } + + + /** + * Get the associated ChildUser object + * + * @param ConnectionInterface $con Optional Connection object. + * @return ChildUser The associated ChildUser object. + * @throws PropelException + */ + public function getUserRelatedByOwner(ConnectionInterface $con = null) + { + if ($this->aUserRelatedByOwner === null && ($this->owner !== null)) { + $this->aUserRelatedByOwner = ChildUserQuery::create()->findPk($this->owner, $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->aUserRelatedByOwner->addEmailAddressesRelatedByOwner($this); + */ + } + + return $this->aUserRelatedByOwner; + } + + + /** + * 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 ('UserRelatedByEmail' == $relationName) { + return $this->initUsersRelatedByEmail(); + } + if ('EmailMessageRelatedByRecipient' == $relationName) { + return $this->initEmailMessagesRelatedByRecipient(); + } + if ('EmailMessageRelatedBySender' == $relationName) { + return $this->initEmailMessagesRelatedBySender(); + } + } + + /** + * Clears out the collUsersRelatedByEmail 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 addUsersRelatedByEmail() + */ + public function clearUsersRelatedByEmail() + { + $this->collUsersRelatedByEmail = null; // important to set this to NULL since that means it is uninitialized + } + + /** + * Reset is the collUsersRelatedByEmail collection loaded partially. + */ + public function resetPartialUsersRelatedByEmail($v = true) + { + $this->collUsersRelatedByEmailPartial = $v; + } + + /** + * Initializes the collUsersRelatedByEmail collection. + * + * By default this just sets the collUsersRelatedByEmail collection to an empty array (like clearcollUsersRelatedByEmail()); + * 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 initUsersRelatedByEmail($overrideExisting = true) + { + if (null !== $this->collUsersRelatedByEmail && !$overrideExisting) { + return; + } + $this->collUsersRelatedByEmail = new ObjectCollection(); + $this->collUsersRelatedByEmail->setModel('\Eater\Glim\Model\User'); + } + + /** + * Gets an array of ChildUser 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 ChildEmailAddress 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 ObjectCollection|ChildUser[] List of ChildUser objects + * @throws PropelException + */ + public function getUsersRelatedByEmail(Criteria $criteria = null, ConnectionInterface $con = null) + { + $partial = $this->collUsersRelatedByEmailPartial && !$this->isNew(); + if (null === $this->collUsersRelatedByEmail || null !== $criteria || $partial) { + if ($this->isNew() && null === $this->collUsersRelatedByEmail) { + // return empty collection + $this->initUsersRelatedByEmail(); + } else { + $collUsersRelatedByEmail = ChildUserQuery::create(null, $criteria) + ->filterByEmailAddressRelatedByEmail($this) + ->find($con); + + if (null !== $criteria) { + if (false !== $this->collUsersRelatedByEmailPartial && count($collUsersRelatedByEmail)) { + $this->initUsersRelatedByEmail(false); + + foreach ($collUsersRelatedByEmail as $obj) { + if (false == $this->collUsersRelatedByEmail->contains($obj)) { + $this->collUsersRelatedByEmail->append($obj); + } + } + + $this->collUsersRelatedByEmailPartial = true; + } + + return $collUsersRelatedByEmail; + } + + if ($partial && $this->collUsersRelatedByEmail) { + foreach ($this->collUsersRelatedByEmail as $obj) { + if ($obj->isNew()) { + $collUsersRelatedByEmail[] = $obj; + } + } + } + + $this->collUsersRelatedByEmail = $collUsersRelatedByEmail; + $this->collUsersRelatedByEmailPartial = false; + } + } + + return $this->collUsersRelatedByEmail; + } + + /** + * Sets a collection of ChildUser 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 $usersRelatedByEmail A Propel collection. + * @param ConnectionInterface $con Optional connection object + * @return $this|ChildEmailAddress The current object (for fluent API support) + */ + public function setUsersRelatedByEmail(Collection $usersRelatedByEmail, ConnectionInterface $con = null) + { + /** @var ChildUser[] $usersRelatedByEmailToDelete */ + $usersRelatedByEmailToDelete = $this->getUsersRelatedByEmail(new Criteria(), $con)->diff($usersRelatedByEmail); + + + $this->usersRelatedByEmailScheduledForDeletion = $usersRelatedByEmailToDelete; + + foreach ($usersRelatedByEmailToDelete as $userRelatedByEmailRemoved) { + $userRelatedByEmailRemoved->setEmailAddressRelatedByEmail(null); + } + + $this->collUsersRelatedByEmail = null; + foreach ($usersRelatedByEmail as $userRelatedByEmail) { + $this->addUserRelatedByEmail($userRelatedByEmail); + } + + $this->collUsersRelatedByEmail = $usersRelatedByEmail; + $this->collUsersRelatedByEmailPartial = false; + + return $this; + } + + /** + * Returns the number of related User objects. + * + * @param Criteria $criteria + * @param boolean $distinct + * @param ConnectionInterface $con + * @return int Count of related User objects. + * @throws PropelException + */ + public function countUsersRelatedByEmail(Criteria $criteria = null, $distinct = false, ConnectionInterface $con = null) + { + $partial = $this->collUsersRelatedByEmailPartial && !$this->isNew(); + if (null === $this->collUsersRelatedByEmail || null !== $criteria || $partial) { + if ($this->isNew() && null === $this->collUsersRelatedByEmail) { + return 0; + } + + if ($partial && !$criteria) { + return count($this->getUsersRelatedByEmail()); + } + + $query = ChildUserQuery::create(null, $criteria); + if ($distinct) { + $query->distinct(); + } + + return $query + ->filterByEmailAddressRelatedByEmail($this) + ->count($con); + } + + return count($this->collUsersRelatedByEmail); + } + + /** + * Method called to associate a ChildUser object to this object + * through the ChildUser foreign key attribute. + * + * @param ChildUser $l ChildUser + * @return $this|\Eater\Glim\Model\EmailAddress The current object (for fluent API support) + */ + public function addUserRelatedByEmail(ChildUser $l) + { + if ($this->collUsersRelatedByEmail === null) { + $this->initUsersRelatedByEmail(); + $this->collUsersRelatedByEmailPartial = true; + } + + if (!$this->collUsersRelatedByEmail->contains($l)) { + $this->doAddUserRelatedByEmail($l); + } + + return $this; + } + + /** + * @param ChildUser $userRelatedByEmail The ChildUser object to add. + */ + protected function doAddUserRelatedByEmail(ChildUser $userRelatedByEmail) + { + $this->collUsersRelatedByEmail[]= $userRelatedByEmail; + $userRelatedByEmail->setEmailAddressRelatedByEmail($this); + } + + /** + * @param ChildUser $userRelatedByEmail The ChildUser object to remove. + * @return $this|ChildEmailAddress The current object (for fluent API support) + */ + public function removeUserRelatedByEmail(ChildUser $userRelatedByEmail) + { + if ($this->getUsersRelatedByEmail()->contains($userRelatedByEmail)) { + $pos = $this->collUsersRelatedByEmail->search($userRelatedByEmail); + $this->collUsersRelatedByEmail->remove($pos); + if (null === $this->usersRelatedByEmailScheduledForDeletion) { + $this->usersRelatedByEmailScheduledForDeletion = clone $this->collUsersRelatedByEmail; + $this->usersRelatedByEmailScheduledForDeletion->clear(); + } + $this->usersRelatedByEmailScheduledForDeletion[]= $userRelatedByEmail; + $userRelatedByEmail->setEmailAddressRelatedByEmail(null); + } + + return $this; + } + + /** + * Clears out the collEmailMessagesRelatedByRecipient 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 addEmailMessagesRelatedByRecipient() + */ + public function clearEmailMessagesRelatedByRecipient() + { + $this->collEmailMessagesRelatedByRecipient = null; // important to set this to NULL since that means it is uninitialized + } + + /** + * Reset is the collEmailMessagesRelatedByRecipient collection loaded partially. + */ + public function resetPartialEmailMessagesRelatedByRecipient($v = true) + { + $this->collEmailMessagesRelatedByRecipientPartial = $v; + } + + /** + * Initializes the collEmailMessagesRelatedByRecipient collection. + * + * By default this just sets the collEmailMessagesRelatedByRecipient collection to an empty array (like clearcollEmailMessagesRelatedByRecipient()); + * 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 initEmailMessagesRelatedByRecipient($overrideExisting = true) + { + if (null !== $this->collEmailMessagesRelatedByRecipient && !$overrideExisting) { + return; + } + $this->collEmailMessagesRelatedByRecipient = new ObjectCollection(); + $this->collEmailMessagesRelatedByRecipient->setModel('\Eater\Glim\Model\EmailMessage'); + } + + /** + * Gets an array of ChildEmailMessage 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 ChildEmailAddress 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 ObjectCollection|ChildEmailMessage[] List of ChildEmailMessage objects + * @throws PropelException + */ + public function getEmailMessagesRelatedByRecipient(Criteria $criteria = null, ConnectionInterface $con = null) + { + $partial = $this->collEmailMessagesRelatedByRecipientPartial && !$this->isNew(); + if (null === $this->collEmailMessagesRelatedByRecipient || null !== $criteria || $partial) { + if ($this->isNew() && null === $this->collEmailMessagesRelatedByRecipient) { + // return empty collection + $this->initEmailMessagesRelatedByRecipient(); + } else { + $collEmailMessagesRelatedByRecipient = ChildEmailMessageQuery::create(null, $criteria) + ->filterByRecipientEmailAddress($this) + ->find($con); + + if (null !== $criteria) { + if (false !== $this->collEmailMessagesRelatedByRecipientPartial && count($collEmailMessagesRelatedByRecipient)) { + $this->initEmailMessagesRelatedByRecipient(false); + + foreach ($collEmailMessagesRelatedByRecipient as $obj) { + if (false == $this->collEmailMessagesRelatedByRecipient->contains($obj)) { + $this->collEmailMessagesRelatedByRecipient->append($obj); + } + } + + $this->collEmailMessagesRelatedByRecipientPartial = true; + } + + return $collEmailMessagesRelatedByRecipient; + } + + if ($partial && $this->collEmailMessagesRelatedByRecipient) { + foreach ($this->collEmailMessagesRelatedByRecipient as $obj) { + if ($obj->isNew()) { + $collEmailMessagesRelatedByRecipient[] = $obj; + } + } + } + + $this->collEmailMessagesRelatedByRecipient = $collEmailMessagesRelatedByRecipient; + $this->collEmailMessagesRelatedByRecipientPartial = false; + } + } + + return $this->collEmailMessagesRelatedByRecipient; + } + + /** + * Sets a collection of ChildEmailMessage 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 $emailMessagesRelatedByRecipient A Propel collection. + * @param ConnectionInterface $con Optional connection object + * @return $this|ChildEmailAddress The current object (for fluent API support) + */ + public function setEmailMessagesRelatedByRecipient(Collection $emailMessagesRelatedByRecipient, ConnectionInterface $con = null) + { + /** @var ChildEmailMessage[] $emailMessagesRelatedByRecipientToDelete */ + $emailMessagesRelatedByRecipientToDelete = $this->getEmailMessagesRelatedByRecipient(new Criteria(), $con)->diff($emailMessagesRelatedByRecipient); + + + $this->emailMessagesRelatedByRecipientScheduledForDeletion = $emailMessagesRelatedByRecipientToDelete; + + foreach ($emailMessagesRelatedByRecipientToDelete as $emailMessageRelatedByRecipientRemoved) { + $emailMessageRelatedByRecipientRemoved->setRecipientEmailAddress(null); + } + + $this->collEmailMessagesRelatedByRecipient = null; + foreach ($emailMessagesRelatedByRecipient as $emailMessageRelatedByRecipient) { + $this->addEmailMessageRelatedByRecipient($emailMessageRelatedByRecipient); + } + + $this->collEmailMessagesRelatedByRecipient = $emailMessagesRelatedByRecipient; + $this->collEmailMessagesRelatedByRecipientPartial = false; + + return $this; + } + + /** + * Returns the number of related EmailMessage objects. + * + * @param Criteria $criteria + * @param boolean $distinct + * @param ConnectionInterface $con + * @return int Count of related EmailMessage objects. + * @throws PropelException + */ + public function countEmailMessagesRelatedByRecipient(Criteria $criteria = null, $distinct = false, ConnectionInterface $con = null) + { + $partial = $this->collEmailMessagesRelatedByRecipientPartial && !$this->isNew(); + if (null === $this->collEmailMessagesRelatedByRecipient || null !== $criteria || $partial) { + if ($this->isNew() && null === $this->collEmailMessagesRelatedByRecipient) { + return 0; + } + + if ($partial && !$criteria) { + return count($this->getEmailMessagesRelatedByRecipient()); + } + + $query = ChildEmailMessageQuery::create(null, $criteria); + if ($distinct) { + $query->distinct(); + } + + return $query + ->filterByRecipientEmailAddress($this) + ->count($con); + } + + return count($this->collEmailMessagesRelatedByRecipient); + } + + /** + * Method called to associate a ChildEmailMessage object to this object + * through the ChildEmailMessage foreign key attribute. + * + * @param ChildEmailMessage $l ChildEmailMessage + * @return $this|\Eater\Glim\Model\EmailAddress The current object (for fluent API support) + */ + public function addEmailMessageRelatedByRecipient(ChildEmailMessage $l) + { + if ($this->collEmailMessagesRelatedByRecipient === null) { + $this->initEmailMessagesRelatedByRecipient(); + $this->collEmailMessagesRelatedByRecipientPartial = true; + } + + if (!$this->collEmailMessagesRelatedByRecipient->contains($l)) { + $this->doAddEmailMessageRelatedByRecipient($l); + } + + return $this; + } + + /** + * @param ChildEmailMessage $emailMessageRelatedByRecipient The ChildEmailMessage object to add. + */ + protected function doAddEmailMessageRelatedByRecipient(ChildEmailMessage $emailMessageRelatedByRecipient) + { + $this->collEmailMessagesRelatedByRecipient[]= $emailMessageRelatedByRecipient; + $emailMessageRelatedByRecipient->setRecipientEmailAddress($this); + } + + /** + * @param ChildEmailMessage $emailMessageRelatedByRecipient The ChildEmailMessage object to remove. + * @return $this|ChildEmailAddress The current object (for fluent API support) + */ + public function removeEmailMessageRelatedByRecipient(ChildEmailMessage $emailMessageRelatedByRecipient) + { + if ($this->getEmailMessagesRelatedByRecipient()->contains($emailMessageRelatedByRecipient)) { + $pos = $this->collEmailMessagesRelatedByRecipient->search($emailMessageRelatedByRecipient); + $this->collEmailMessagesRelatedByRecipient->remove($pos); + if (null === $this->emailMessagesRelatedByRecipientScheduledForDeletion) { + $this->emailMessagesRelatedByRecipientScheduledForDeletion = clone $this->collEmailMessagesRelatedByRecipient; + $this->emailMessagesRelatedByRecipientScheduledForDeletion->clear(); + } + $this->emailMessagesRelatedByRecipientScheduledForDeletion[]= $emailMessageRelatedByRecipient; + $emailMessageRelatedByRecipient->setRecipientEmailAddress(null); + } + + return $this; + } + + /** + * Clears out the collEmailMessagesRelatedBySender 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 addEmailMessagesRelatedBySender() + */ + public function clearEmailMessagesRelatedBySender() + { + $this->collEmailMessagesRelatedBySender = null; // important to set this to NULL since that means it is uninitialized + } + + /** + * Reset is the collEmailMessagesRelatedBySender collection loaded partially. + */ + public function resetPartialEmailMessagesRelatedBySender($v = true) + { + $this->collEmailMessagesRelatedBySenderPartial = $v; + } + + /** + * Initializes the collEmailMessagesRelatedBySender collection. + * + * By default this just sets the collEmailMessagesRelatedBySender collection to an empty array (like clearcollEmailMessagesRelatedBySender()); + * 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 initEmailMessagesRelatedBySender($overrideExisting = true) + { + if (null !== $this->collEmailMessagesRelatedBySender && !$overrideExisting) { + return; + } + $this->collEmailMessagesRelatedBySender = new ObjectCollection(); + $this->collEmailMessagesRelatedBySender->setModel('\Eater\Glim\Model\EmailMessage'); + } + + /** + * Gets an array of ChildEmailMessage 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 ChildEmailAddress 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 ObjectCollection|ChildEmailMessage[] List of ChildEmailMessage objects + * @throws PropelException + */ + public function getEmailMessagesRelatedBySender(Criteria $criteria = null, ConnectionInterface $con = null) + { + $partial = $this->collEmailMessagesRelatedBySenderPartial && !$this->isNew(); + if (null === $this->collEmailMessagesRelatedBySender || null !== $criteria || $partial) { + if ($this->isNew() && null === $this->collEmailMessagesRelatedBySender) { + // return empty collection + $this->initEmailMessagesRelatedBySender(); + } else { + $collEmailMessagesRelatedBySender = ChildEmailMessageQuery::create(null, $criteria) + ->filterBySenderEmailAddress($this) + ->find($con); + + if (null !== $criteria) { + if (false !== $this->collEmailMessagesRelatedBySenderPartial && count($collEmailMessagesRelatedBySender)) { + $this->initEmailMessagesRelatedBySender(false); + + foreach ($collEmailMessagesRelatedBySender as $obj) { + if (false == $this->collEmailMessagesRelatedBySender->contains($obj)) { + $this->collEmailMessagesRelatedBySender->append($obj); + } + } + + $this->collEmailMessagesRelatedBySenderPartial = true; + } + + return $collEmailMessagesRelatedBySender; + } + + if ($partial && $this->collEmailMessagesRelatedBySender) { + foreach ($this->collEmailMessagesRelatedBySender as $obj) { + if ($obj->isNew()) { + $collEmailMessagesRelatedBySender[] = $obj; + } + } + } + + $this->collEmailMessagesRelatedBySender = $collEmailMessagesRelatedBySender; + $this->collEmailMessagesRelatedBySenderPartial = false; + } + } + + return $this->collEmailMessagesRelatedBySender; + } + + /** + * Sets a collection of ChildEmailMessage 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 $emailMessagesRelatedBySender A Propel collection. + * @param ConnectionInterface $con Optional connection object + * @return $this|ChildEmailAddress The current object (for fluent API support) + */ + public function setEmailMessagesRelatedBySender(Collection $emailMessagesRelatedBySender, ConnectionInterface $con = null) + { + /** @var ChildEmailMessage[] $emailMessagesRelatedBySenderToDelete */ + $emailMessagesRelatedBySenderToDelete = $this->getEmailMessagesRelatedBySender(new Criteria(), $con)->diff($emailMessagesRelatedBySender); + + + $this->emailMessagesRelatedBySenderScheduledForDeletion = $emailMessagesRelatedBySenderToDelete; + + foreach ($emailMessagesRelatedBySenderToDelete as $emailMessageRelatedBySenderRemoved) { + $emailMessageRelatedBySenderRemoved->setSenderEmailAddress(null); + } + + $this->collEmailMessagesRelatedBySender = null; + foreach ($emailMessagesRelatedBySender as $emailMessageRelatedBySender) { + $this->addEmailMessageRelatedBySender($emailMessageRelatedBySender); + } + + $this->collEmailMessagesRelatedBySender = $emailMessagesRelatedBySender; + $this->collEmailMessagesRelatedBySenderPartial = false; + + return $this; + } + + /** + * Returns the number of related EmailMessage objects. + * + * @param Criteria $criteria + * @param boolean $distinct + * @param ConnectionInterface $con + * @return int Count of related EmailMessage objects. + * @throws PropelException + */ + public function countEmailMessagesRelatedBySender(Criteria $criteria = null, $distinct = false, ConnectionInterface $con = null) + { + $partial = $this->collEmailMessagesRelatedBySenderPartial && !$this->isNew(); + if (null === $this->collEmailMessagesRelatedBySender || null !== $criteria || $partial) { + if ($this->isNew() && null === $this->collEmailMessagesRelatedBySender) { + return 0; + } + + if ($partial && !$criteria) { + return count($this->getEmailMessagesRelatedBySender()); + } + + $query = ChildEmailMessageQuery::create(null, $criteria); + if ($distinct) { + $query->distinct(); + } + + return $query + ->filterBySenderEmailAddress($this) + ->count($con); + } + + return count($this->collEmailMessagesRelatedBySender); + } + + /** + * Method called to associate a ChildEmailMessage object to this object + * through the ChildEmailMessage foreign key attribute. + * + * @param ChildEmailMessage $l ChildEmailMessage + * @return $this|\Eater\Glim\Model\EmailAddress The current object (for fluent API support) + */ + public function addEmailMessageRelatedBySender(ChildEmailMessage $l) + { + if ($this->collEmailMessagesRelatedBySender === null) { + $this->initEmailMessagesRelatedBySender(); + $this->collEmailMessagesRelatedBySenderPartial = true; + } + + if (!$this->collEmailMessagesRelatedBySender->contains($l)) { + $this->doAddEmailMessageRelatedBySender($l); + } + + return $this; + } + + /** + * @param ChildEmailMessage $emailMessageRelatedBySender The ChildEmailMessage object to add. + */ + protected function doAddEmailMessageRelatedBySender(ChildEmailMessage $emailMessageRelatedBySender) + { + $this->collEmailMessagesRelatedBySender[]= $emailMessageRelatedBySender; + $emailMessageRelatedBySender->setSenderEmailAddress($this); + } + + /** + * @param ChildEmailMessage $emailMessageRelatedBySender The ChildEmailMessage object to remove. + * @return $this|ChildEmailAddress The current object (for fluent API support) + */ + public function removeEmailMessageRelatedBySender(ChildEmailMessage $emailMessageRelatedBySender) + { + if ($this->getEmailMessagesRelatedBySender()->contains($emailMessageRelatedBySender)) { + $pos = $this->collEmailMessagesRelatedBySender->search($emailMessageRelatedBySender); + $this->collEmailMessagesRelatedBySender->remove($pos); + if (null === $this->emailMessagesRelatedBySenderScheduledForDeletion) { + $this->emailMessagesRelatedBySenderScheduledForDeletion = clone $this->collEmailMessagesRelatedBySender; + $this->emailMessagesRelatedBySenderScheduledForDeletion->clear(); + } + $this->emailMessagesRelatedBySenderScheduledForDeletion[]= $emailMessageRelatedBySender; + $emailMessageRelatedBySender->setSenderEmailAddress(null); + } + + return $this; + } + + /** + * Clears the current object, sets all attributes to their default values and removes + * outgoing references as well as back-references (from other objects to this one. Results probably in a database + * change of those foreign objects when you call `save` there). + */ + public function clear() + { + if (null !== $this->aUserRelatedByOwner) { + $this->aUserRelatedByOwner->removeEmailAddressRelatedByOwner($this); + } + $this->id = null; + $this->verified = null; + $this->verification = null; + $this->address = null; + $this->owner = null; + $this->alreadyInSave = false; + $this->clearAllReferences(); + $this->applyDefaultValues(); + $this->resetModified(); + $this->setNew(true); + $this->setDeleted(false); + } + + /** + * Resets all references and back-references to other model objects or collections of model objects. + * + * This method is used to reset all php object references (not the actual reference in the database). + * Necessary for object serialisation. + * + * @param boolean $deep Whether to also clear the references on all referrer objects. + */ + public function clearAllReferences($deep = false) + { + if ($deep) { + if ($this->collUsersRelatedByEmail) { + foreach ($this->collUsersRelatedByEmail as $o) { + $o->clearAllReferences($deep); + } + } + if ($this->collEmailMessagesRelatedByRecipient) { + foreach ($this->collEmailMessagesRelatedByRecipient as $o) { + $o->clearAllReferences($deep); + } + } + if ($this->collEmailMessagesRelatedBySender) { + foreach ($this->collEmailMessagesRelatedBySender as $o) { + $o->clearAllReferences($deep); + } + } + } // if ($deep) + + $this->collUsersRelatedByEmail = null; + $this->collEmailMessagesRelatedByRecipient = null; + $this->collEmailMessagesRelatedBySender = null; + $this->aUserRelatedByOwner = null; + } + + /** + * Return the string representation of this object + * + * @return string + */ + public function __toString() + { + return (string) $this->exportTo(EmailAddressTableMap::DEFAULT_STRING_FORMAT); + } + + /** + * 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)); + } + +} diff --git a/src/Model/Base/EmailAddressQuery.php b/src/Model/Base/EmailAddressQuery.php new file mode 100644 index 0000000..57c68db --- /dev/null +++ b/src/Model/Base/EmailAddressQuery.php @@ -0,0 +1,805 @@ +setModelAlias($modelAlias); + } + if ($criteria instanceof Criteria) { + $query->mergeWith($criteria); + } + + return $query; + } + + /** + * Find object by primary key. + * Propel uses the instance pool to skip the database if the object exists. + * Go fast if the query is untouched. + * + * + * $obj = $c->findPk(12, $con); + * + * + * @param mixed $key Primary key to use for the query + * @param ConnectionInterface $con an optional connection object + * + * @return ChildEmailAddress|array|mixed the result, formatted by the current formatter + */ + public function findPk($key, ConnectionInterface $con = null) + { + if ($key === null) { + return null; + } + if ((null !== ($obj = EmailAddressTableMap::getInstanceFromPool((string) $key))) && !$this->formatter) { + // the object is already in the instance pool + return $obj; + } + if ($con === null) { + $con = Propel::getServiceContainer()->getReadConnection(EmailAddressTableMap::DATABASE_NAME); + } + $this->basePreSelect($con); + if ($this->formatter || $this->modelAlias || $this->with || $this->select + || $this->selectColumns || $this->asColumns || $this->selectModifiers + || $this->map || $this->having || $this->joins) { + return $this->findPkComplex($key, $con); + } else { + return $this->findPkSimple($key, $con); + } + } + + /** + * Find object by primary key using raw SQL to go fast. + * Bypass doSelect() and the object formatter by using generated code. + * + * @param mixed $key Primary key to use for the query + * @param ConnectionInterface $con A connection object + * + * @throws \Propel\Runtime\Exception\PropelException + * + * @return ChildEmailAddress A model object, or null if the key is not found + */ + protected function findPkSimple($key, ConnectionInterface $con) + { + $sql = 'SELECT id, verified, verification, address, owner FROM email_address WHERE id = :p0'; + try { + $stmt = $con->prepare($sql); + $stmt->bindValue(':p0', $key, PDO::PARAM_INT); + $stmt->execute(); + } catch (Exception $e) { + Propel::log($e->getMessage(), Propel::LOG_ERR); + throw new PropelException(sprintf('Unable to execute SELECT statement [%s]', $sql), 0, $e); + } + $obj = null; + if ($row = $stmt->fetch(\PDO::FETCH_NUM)) { + /** @var ChildEmailAddress $obj */ + $obj = new ChildEmailAddress(); + $obj->hydrate($row); + EmailAddressTableMap::addInstanceToPool($obj, (string) $key); + } + $stmt->closeCursor(); + + return $obj; + } + + /** + * Find object by primary key. + * + * @param mixed $key Primary key to use for the query + * @param ConnectionInterface $con A connection object + * + * @return ChildEmailAddress|array|mixed the result, formatted by the current formatter + */ + protected function findPkComplex($key, ConnectionInterface $con) + { + // As the query uses a PK condition, no limit(1) is necessary. + $criteria = $this->isKeepQuery() ? clone $this : $this; + $dataFetcher = $criteria + ->filterByPrimaryKey($key) + ->doSelect($con); + + return $criteria->getFormatter()->init($criteria)->formatOne($dataFetcher); + } + + /** + * Find objects by primary key + * + * $objs = $c->findPks(array(12, 56, 832), $con); + * + * @param array $keys Primary keys to use for the query + * @param ConnectionInterface $con an optional connection object + * + * @return ObjectCollection|array|mixed the list of results, formatted by the current formatter + */ + public function findPks($keys, ConnectionInterface $con = null) + { + if (null === $con) { + $con = Propel::getServiceContainer()->getReadConnection($this->getDbName()); + } + $this->basePreSelect($con); + $criteria = $this->isKeepQuery() ? clone $this : $this; + $dataFetcher = $criteria + ->filterByPrimaryKeys($keys) + ->doSelect($con); + + return $criteria->getFormatter()->init($criteria)->format($dataFetcher); + } + + /** + * Filter the query by primary key + * + * @param mixed $key Primary key to use for the query + * + * @return $this|ChildEmailAddressQuery The current query, for fluid interface + */ + public function filterByPrimaryKey($key) + { + + return $this->addUsingAlias(EmailAddressTableMap::COL_ID, $key, Criteria::EQUAL); + } + + /** + * Filter the query by a list of primary keys + * + * @param array $keys The list of primary key to use for the query + * + * @return $this|ChildEmailAddressQuery The current query, for fluid interface + */ + public function filterByPrimaryKeys($keys) + { + + return $this->addUsingAlias(EmailAddressTableMap::COL_ID, $keys, Criteria::IN); + } + + /** + * Filter the query on the id column + * + * Example usage: + * + * $query->filterById(1234); // WHERE id = 1234 + * $query->filterById(array(12, 34)); // WHERE id IN (12, 34) + * $query->filterById(array('min' => 12)); // WHERE id > 12 + * + * + * @param mixed $id The value to use as filter. + * Use scalar values for equality. + * Use array values for in_array() equivalent. + * Use associative array('min' => $minValue, 'max' => $maxValue) for intervals. + * @param string $comparison Operator to use for the column comparison, defaults to Criteria::EQUAL + * + * @return $this|ChildEmailAddressQuery The current query, for fluid interface + */ + public function filterById($id = null, $comparison = null) + { + if (is_array($id)) { + $useMinMax = false; + if (isset($id['min'])) { + $this->addUsingAlias(EmailAddressTableMap::COL_ID, $id['min'], Criteria::GREATER_EQUAL); + $useMinMax = true; + } + if (isset($id['max'])) { + $this->addUsingAlias(EmailAddressTableMap::COL_ID, $id['max'], Criteria::LESS_EQUAL); + $useMinMax = true; + } + if ($useMinMax) { + return $this; + } + if (null === $comparison) { + $comparison = Criteria::IN; + } + } + + return $this->addUsingAlias(EmailAddressTableMap::COL_ID, $id, $comparison); + } + + /** + * Filter the query on the verified column + * + * Example usage: + * + * $query->filterByVerified(true); // WHERE verified = true + * $query->filterByVerified('yes'); // WHERE verified = true + * + * + * @param boolean|string $verified The value to use as filter. + * Non-boolean arguments are converted using the following rules: + * * 1, '1', 'true', 'on', and 'yes' are converted to boolean true + * * 0, '0', 'false', 'off', and 'no' are converted to boolean false + * Check on string values is case insensitive (so 'FaLsE' is seen as 'false'). + * @param string $comparison Operator to use for the column comparison, defaults to Criteria::EQUAL + * + * @return $this|ChildEmailAddressQuery The current query, for fluid interface + */ + public function filterByVerified($verified = null, $comparison = null) + { + if (is_string($verified)) { + $verified = in_array(strtolower($verified), array('false', 'off', '-', 'no', 'n', '0', '')) ? false : true; + } + + return $this->addUsingAlias(EmailAddressTableMap::COL_VERIFIED, $verified, $comparison); + } + + /** + * Filter the query on the verification column + * + * Example usage: + * + * $query->filterByVerification('fooValue'); // WHERE verification = 'fooValue' + * $query->filterByVerification('%fooValue%'); // WHERE verification LIKE '%fooValue%' + * + * + * @param string $verification The value to use as filter. + * Accepts wildcards (* and % trigger a LIKE) + * @param string $comparison Operator to use for the column comparison, defaults to Criteria::EQUAL + * + * @return $this|ChildEmailAddressQuery The current query, for fluid interface + */ + public function filterByVerification($verification = null, $comparison = null) + { + if (null === $comparison) { + if (is_array($verification)) { + $comparison = Criteria::IN; + } elseif (preg_match('/[\%\*]/', $verification)) { + $verification = str_replace('*', '%', $verification); + $comparison = Criteria::LIKE; + } + } + + return $this->addUsingAlias(EmailAddressTableMap::COL_VERIFICATION, $verification, $comparison); + } + + /** + * Filter the query on the address column + * + * Example usage: + * + * $query->filterByAddress('fooValue'); // WHERE address = 'fooValue' + * $query->filterByAddress('%fooValue%'); // WHERE address LIKE '%fooValue%' + * + * + * @param string $address The value to use as filter. + * Accepts wildcards (* and % trigger a LIKE) + * @param string $comparison Operator to use for the column comparison, defaults to Criteria::EQUAL + * + * @return $this|ChildEmailAddressQuery The current query, for fluid interface + */ + public function filterByAddress($address = null, $comparison = null) + { + if (null === $comparison) { + if (is_array($address)) { + $comparison = Criteria::IN; + } elseif (preg_match('/[\%\*]/', $address)) { + $address = str_replace('*', '%', $address); + $comparison = Criteria::LIKE; + } + } + + return $this->addUsingAlias(EmailAddressTableMap::COL_ADDRESS, $address, $comparison); + } + + /** + * Filter the query on the owner column + * + * Example usage: + * + * $query->filterByOwner(1234); // WHERE owner = 1234 + * $query->filterByOwner(array(12, 34)); // WHERE owner IN (12, 34) + * $query->filterByOwner(array('min' => 12)); // WHERE owner > 12 + * + * + * @see filterByUserRelatedByOwner() + * + * @param mixed $owner The value to use as filter. + * Use scalar values for equality. + * Use array values for in_array() equivalent. + * Use associative array('min' => $minValue, 'max' => $maxValue) for intervals. + * @param string $comparison Operator to use for the column comparison, defaults to Criteria::EQUAL + * + * @return $this|ChildEmailAddressQuery The current query, for fluid interface + */ + public function filterByOwner($owner = null, $comparison = null) + { + if (is_array($owner)) { + $useMinMax = false; + if (isset($owner['min'])) { + $this->addUsingAlias(EmailAddressTableMap::COL_OWNER, $owner['min'], Criteria::GREATER_EQUAL); + $useMinMax = true; + } + if (isset($owner['max'])) { + $this->addUsingAlias(EmailAddressTableMap::COL_OWNER, $owner['max'], Criteria::LESS_EQUAL); + $useMinMax = true; + } + if ($useMinMax) { + return $this; + } + if (null === $comparison) { + $comparison = Criteria::IN; + } + } + + return $this->addUsingAlias(EmailAddressTableMap::COL_OWNER, $owner, $comparison); + } + + /** + * Filter the query by a related \Eater\Glim\Model\User object + * + * @param \Eater\Glim\Model\User|ObjectCollection $user The related object(s) to use as filter + * @param string $comparison Operator to use for the column comparison, defaults to Criteria::EQUAL + * + * @throws \Propel\Runtime\Exception\PropelException + * + * @return ChildEmailAddressQuery The current query, for fluid interface + */ + public function filterByUserRelatedByOwner($user, $comparison = null) + { + if ($user instanceof \Eater\Glim\Model\User) { + return $this + ->addUsingAlias(EmailAddressTableMap::COL_OWNER, $user->getId(), $comparison); + } elseif ($user instanceof ObjectCollection) { + if (null === $comparison) { + $comparison = Criteria::IN; + } + + return $this + ->addUsingAlias(EmailAddressTableMap::COL_OWNER, $user->toKeyValue('PrimaryKey', 'Id'), $comparison); + } else { + throw new PropelException('filterByUserRelatedByOwner() only accepts arguments of type \Eater\Glim\Model\User or Collection'); + } + } + + /** + * Adds a JOIN clause to the query using the UserRelatedByOwner relation + * + * @param string $relationAlias optional alias for the relation + * @param string $joinType Accepted values are null, 'left join', 'right join', 'inner join' + * + * @return $this|ChildEmailAddressQuery The current query, for fluid interface + */ + public function joinUserRelatedByOwner($relationAlias = null, $joinType = Criteria::LEFT_JOIN) + { + $tableMap = $this->getTableMap(); + $relationMap = $tableMap->getRelation('UserRelatedByOwner'); + + // create a ModelJoin object for this join + $join = new ModelJoin(); + $join->setJoinType($joinType); + $join->setRelationMap($relationMap, $this->useAliasInSQL ? $this->getModelAlias() : null, $relationAlias); + if ($previousJoin = $this->getPreviousJoin()) { + $join->setPreviousJoin($previousJoin); + } + + // add the ModelJoin to the current object + if ($relationAlias) { + $this->addAlias($relationAlias, $relationMap->getRightTable()->getName()); + $this->addJoinObject($join, $relationAlias); + } else { + $this->addJoinObject($join, 'UserRelatedByOwner'); + } + + return $this; + } + + /** + * Use the UserRelatedByOwner relation User object + * + * @see useQuery() + * + * @param string $relationAlias optional alias for the relation, + * to be used as main alias in the secondary query + * @param string $joinType Accepted values are null, 'left join', 'right join', 'inner join' + * + * @return \Eater\Glim\Model\UserQuery A secondary query class using the current class as primary query + */ + public function useUserRelatedByOwnerQuery($relationAlias = null, $joinType = Criteria::LEFT_JOIN) + { + return $this + ->joinUserRelatedByOwner($relationAlias, $joinType) + ->useQuery($relationAlias ? $relationAlias : 'UserRelatedByOwner', '\Eater\Glim\Model\UserQuery'); + } + + /** + * Filter the query by a related \Eater\Glim\Model\User object + * + * @param \Eater\Glim\Model\User|ObjectCollection $user the related object to use as filter + * @param string $comparison Operator to use for the column comparison, defaults to Criteria::EQUAL + * + * @return ChildEmailAddressQuery The current query, for fluid interface + */ + public function filterByUserRelatedByEmail($user, $comparison = null) + { + if ($user instanceof \Eater\Glim\Model\User) { + return $this + ->addUsingAlias(EmailAddressTableMap::COL_ID, $user->getEmail(), $comparison); + } elseif ($user instanceof ObjectCollection) { + return $this + ->useUserRelatedByEmailQuery() + ->filterByPrimaryKeys($user->getPrimaryKeys()) + ->endUse(); + } else { + throw new PropelException('filterByUserRelatedByEmail() only accepts arguments of type \Eater\Glim\Model\User or Collection'); + } + } + + /** + * Adds a JOIN clause to the query using the UserRelatedByEmail relation + * + * @param string $relationAlias optional alias for the relation + * @param string $joinType Accepted values are null, 'left join', 'right join', 'inner join' + * + * @return $this|ChildEmailAddressQuery The current query, for fluid interface + */ + public function joinUserRelatedByEmail($relationAlias = null, $joinType = Criteria::LEFT_JOIN) + { + $tableMap = $this->getTableMap(); + $relationMap = $tableMap->getRelation('UserRelatedByEmail'); + + // create a ModelJoin object for this join + $join = new ModelJoin(); + $join->setJoinType($joinType); + $join->setRelationMap($relationMap, $this->useAliasInSQL ? $this->getModelAlias() : null, $relationAlias); + if ($previousJoin = $this->getPreviousJoin()) { + $join->setPreviousJoin($previousJoin); + } + + // add the ModelJoin to the current object + if ($relationAlias) { + $this->addAlias($relationAlias, $relationMap->getRightTable()->getName()); + $this->addJoinObject($join, $relationAlias); + } else { + $this->addJoinObject($join, 'UserRelatedByEmail'); + } + + return $this; + } + + /** + * Use the UserRelatedByEmail relation User object + * + * @see useQuery() + * + * @param string $relationAlias optional alias for the relation, + * to be used as main alias in the secondary query + * @param string $joinType Accepted values are null, 'left join', 'right join', 'inner join' + * + * @return \Eater\Glim\Model\UserQuery A secondary query class using the current class as primary query + */ + public function useUserRelatedByEmailQuery($relationAlias = null, $joinType = Criteria::LEFT_JOIN) + { + return $this + ->joinUserRelatedByEmail($relationAlias, $joinType) + ->useQuery($relationAlias ? $relationAlias : 'UserRelatedByEmail', '\Eater\Glim\Model\UserQuery'); + } + + /** + * Filter the query by a related \Eater\Glim\Model\EmailMessage object + * + * @param \Eater\Glim\Model\EmailMessage|ObjectCollection $emailMessage the related object to use as filter + * @param string $comparison Operator to use for the column comparison, defaults to Criteria::EQUAL + * + * @return ChildEmailAddressQuery The current query, for fluid interface + */ + public function filterByEmailMessageRelatedByRecipient($emailMessage, $comparison = null) + { + if ($emailMessage instanceof \Eater\Glim\Model\EmailMessage) { + return $this + ->addUsingAlias(EmailAddressTableMap::COL_ID, $emailMessage->getRecipient(), $comparison); + } elseif ($emailMessage instanceof ObjectCollection) { + return $this + ->useEmailMessageRelatedByRecipientQuery() + ->filterByPrimaryKeys($emailMessage->getPrimaryKeys()) + ->endUse(); + } else { + throw new PropelException('filterByEmailMessageRelatedByRecipient() only accepts arguments of type \Eater\Glim\Model\EmailMessage or Collection'); + } + } + + /** + * Adds a JOIN clause to the query using the EmailMessageRelatedByRecipient relation + * + * @param string $relationAlias optional alias for the relation + * @param string $joinType Accepted values are null, 'left join', 'right join', 'inner join' + * + * @return $this|ChildEmailAddressQuery The current query, for fluid interface + */ + public function joinEmailMessageRelatedByRecipient($relationAlias = null, $joinType = Criteria::LEFT_JOIN) + { + $tableMap = $this->getTableMap(); + $relationMap = $tableMap->getRelation('EmailMessageRelatedByRecipient'); + + // create a ModelJoin object for this join + $join = new ModelJoin(); + $join->setJoinType($joinType); + $join->setRelationMap($relationMap, $this->useAliasInSQL ? $this->getModelAlias() : null, $relationAlias); + if ($previousJoin = $this->getPreviousJoin()) { + $join->setPreviousJoin($previousJoin); + } + + // add the ModelJoin to the current object + if ($relationAlias) { + $this->addAlias($relationAlias, $relationMap->getRightTable()->getName()); + $this->addJoinObject($join, $relationAlias); + } else { + $this->addJoinObject($join, 'EmailMessageRelatedByRecipient'); + } + + return $this; + } + + /** + * Use the EmailMessageRelatedByRecipient relation EmailMessage object + * + * @see useQuery() + * + * @param string $relationAlias optional alias for the relation, + * to be used as main alias in the secondary query + * @param string $joinType Accepted values are null, 'left join', 'right join', 'inner join' + * + * @return \Eater\Glim\Model\EmailMessageQuery A secondary query class using the current class as primary query + */ + public function useEmailMessageRelatedByRecipientQuery($relationAlias = null, $joinType = Criteria::LEFT_JOIN) + { + return $this + ->joinEmailMessageRelatedByRecipient($relationAlias, $joinType) + ->useQuery($relationAlias ? $relationAlias : 'EmailMessageRelatedByRecipient', '\Eater\Glim\Model\EmailMessageQuery'); + } + + /** + * Filter the query by a related \Eater\Glim\Model\EmailMessage object + * + * @param \Eater\Glim\Model\EmailMessage|ObjectCollection $emailMessage the related object to use as filter + * @param string $comparison Operator to use for the column comparison, defaults to Criteria::EQUAL + * + * @return ChildEmailAddressQuery The current query, for fluid interface + */ + public function filterByEmailMessageRelatedBySender($emailMessage, $comparison = null) + { + if ($emailMessage instanceof \Eater\Glim\Model\EmailMessage) { + return $this + ->addUsingAlias(EmailAddressTableMap::COL_ID, $emailMessage->getSender(), $comparison); + } elseif ($emailMessage instanceof ObjectCollection) { + return $this + ->useEmailMessageRelatedBySenderQuery() + ->filterByPrimaryKeys($emailMessage->getPrimaryKeys()) + ->endUse(); + } else { + throw new PropelException('filterByEmailMessageRelatedBySender() only accepts arguments of type \Eater\Glim\Model\EmailMessage or Collection'); + } + } + + /** + * Adds a JOIN clause to the query using the EmailMessageRelatedBySender relation + * + * @param string $relationAlias optional alias for the relation + * @param string $joinType Accepted values are null, 'left join', 'right join', 'inner join' + * + * @return $this|ChildEmailAddressQuery The current query, for fluid interface + */ + public function joinEmailMessageRelatedBySender($relationAlias = null, $joinType = Criteria::LEFT_JOIN) + { + $tableMap = $this->getTableMap(); + $relationMap = $tableMap->getRelation('EmailMessageRelatedBySender'); + + // create a ModelJoin object for this join + $join = new ModelJoin(); + $join->setJoinType($joinType); + $join->setRelationMap($relationMap, $this->useAliasInSQL ? $this->getModelAlias() : null, $relationAlias); + if ($previousJoin = $this->getPreviousJoin()) { + $join->setPreviousJoin($previousJoin); + } + + // add the ModelJoin to the current object + if ($relationAlias) { + $this->addAlias($relationAlias, $relationMap->getRightTable()->getName()); + $this->addJoinObject($join, $relationAlias); + } else { + $this->addJoinObject($join, 'EmailMessageRelatedBySender'); + } + + return $this; + } + + /** + * Use the EmailMessageRelatedBySender relation EmailMessage object + * + * @see useQuery() + * + * @param string $relationAlias optional alias for the relation, + * to be used as main alias in the secondary query + * @param string $joinType Accepted values are null, 'left join', 'right join', 'inner join' + * + * @return \Eater\Glim\Model\EmailMessageQuery A secondary query class using the current class as primary query + */ + public function useEmailMessageRelatedBySenderQuery($relationAlias = null, $joinType = Criteria::LEFT_JOIN) + { + return $this + ->joinEmailMessageRelatedBySender($relationAlias, $joinType) + ->useQuery($relationAlias ? $relationAlias : 'EmailMessageRelatedBySender', '\Eater\Glim\Model\EmailMessageQuery'); + } + + /** + * Exclude object from result + * + * @param ChildEmailAddress $emailAddress Object to remove from the list of results + * + * @return $this|ChildEmailAddressQuery The current query, for fluid interface + */ + public function prune($emailAddress = null) + { + if ($emailAddress) { + $this->addUsingAlias(EmailAddressTableMap::COL_ID, $emailAddress->getId(), Criteria::NOT_EQUAL); + } + + return $this; + } + + /** + * Deletes all rows from the email_address table. + * + * @param ConnectionInterface $con the connection to use + * @return int The number of affected rows (if supported by underlying database driver). + */ + public function doDeleteAll(ConnectionInterface $con = null) + { + if (null === $con) { + $con = Propel::getServiceContainer()->getWriteConnection(EmailAddressTableMap::DATABASE_NAME); + } + + // use transaction because $criteria could contain info + // for more than one table or we could emulating ON DELETE CASCADE, etc. + return $con->transaction(function () use ($con) { + $affectedRows = 0; // initialize var to track total num of affected rows + $affectedRows += parent::doDeleteAll($con); + // Because this db requires some delete cascade/set null emulation, we have to + // clear the cached instance *after* the emulation has happened (since + // instances get re-added by the select statement contained therein). + EmailAddressTableMap::clearInstancePool(); + EmailAddressTableMap::clearRelatedInstancePool(); + + return $affectedRows; + }); + } + + /** + * Performs a DELETE on the database based on the current ModelCriteria + * + * @param ConnectionInterface $con the connection to use + * @return int The number of affected rows (if supported by underlying database driver). This includes CASCADE-related rows + * if supported by native driver or if emulated using Propel. + * @throws PropelException Any exceptions caught during processing will be + * rethrown wrapped into a PropelException. + */ + public function delete(ConnectionInterface $con = null) + { + if (null === $con) { + $con = Propel::getServiceContainer()->getWriteConnection(EmailAddressTableMap::DATABASE_NAME); + } + + $criteria = $this; + + // Set the correct dbName + $criteria->setDbName(EmailAddressTableMap::DATABASE_NAME); + + // use transaction because $criteria could contain info + // for more than one table or we could emulating ON DELETE CASCADE, etc. + return $con->transaction(function () use ($con, $criteria) { + $affectedRows = 0; // initialize var to track total num of affected rows + + EmailAddressTableMap::removeInstanceFromPool($criteria); + + $affectedRows += ModelCriteria::delete($con); + EmailAddressTableMap::clearRelatedInstancePool(); + + return $affectedRows; + }); + } + +} // EmailAddressQuery diff --git a/src/Model/Base/EmailMessage.php b/src/Model/Base/EmailMessage.php new file mode 100644 index 0000000..f914546 --- /dev/null +++ b/src/Model/Base/EmailMessage.php @@ -0,0 +1,1427 @@ +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 EmailMessage instance. If + * obj is an instance of EmailMessage, delegates to + * equals(EmailMessage). Otherwise, returns false. + * + * @param mixed $obj The object to compare to. + * @return boolean Whether equal to the object specified. + */ + public function equals($obj) + { + if (!$obj instanceof static) { + return false; + } + + if ($this === $obj) { + return true; + } + + if (null === $this->getPrimaryKey() || null === $obj->getPrimaryKey()) { + return false; + } + + return $this->getPrimaryKey() === $obj->getPrimaryKey(); + } + + /** + * 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 $this|EmailMessage 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); + } + + /** + * Export the current object properties to a string, using a given parser format + * + * $book = BookQuery::create()->findPk(9012); + * echo $book->exportTo('JSON'); + * => {"Id":9012,"Title":"Don Juan","ISBN":"0140422161","Price":12.99,"PublisherId":1234,"AuthorId":5678}'); + * + * + * @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 [recipient] column value. + * + * @return int + */ + public function getRecipient() + { + return $this->recipient; + } + + /** + * Get the [sender] column value. + * + * @return int + */ + public function getSender() + { + return $this->sender; + } + + /** + * Get the [contents] column value. + * + * @return string + */ + public function getContents() + { + return $this->contents; + } + + /** + * Get the [subject] column value. + * + * @return string + */ + public function getSubject() + { + return $this->subject; + } + + /** + * Set the value of [recipient] column. + * + * @param int $v new value + * @return $this|\Eater\Glim\Model\EmailMessage The current object (for fluent API support) + */ + public function setRecipient($v) + { + if ($v !== null) { + $v = (int) $v; + } + + if ($this->recipient !== $v) { + $this->recipient = $v; + $this->modifiedColumns[EmailMessageTableMap::COL_RECIPIENT] = true; + } + + if ($this->aRecipientEmailAddress !== null && $this->aRecipientEmailAddress->getId() !== $v) { + $this->aRecipientEmailAddress = null; + } + + return $this; + } // setRecipient() + + /** + * Set the value of [sender] column. + * + * @param int $v new value + * @return $this|\Eater\Glim\Model\EmailMessage The current object (for fluent API support) + */ + public function setSender($v) + { + if ($v !== null) { + $v = (int) $v; + } + + if ($this->sender !== $v) { + $this->sender = $v; + $this->modifiedColumns[EmailMessageTableMap::COL_SENDER] = true; + } + + if ($this->aSenderEmailAddress !== null && $this->aSenderEmailAddress->getId() !== $v) { + $this->aSenderEmailAddress = null; + } + + return $this; + } // setSender() + + /** + * Set the value of [contents] column. + * + * @param string $v new value + * @return $this|\Eater\Glim\Model\EmailMessage The current object (for fluent API support) + */ + public function setContents($v) + { + if ($v !== null) { + $v = (string) $v; + } + + if ($this->contents !== $v) { + $this->contents = $v; + $this->modifiedColumns[EmailMessageTableMap::COL_CONTENTS] = true; + } + + return $this; + } // setContents() + + /** + * Set the value of [subject] column. + * + * @param string $v new value + * @return $this|\Eater\Glim\Model\EmailMessage The current object (for fluent API support) + */ + public function setSubject($v) + { + if ($v !== null) { + $v = (string) $v; + } + + if ($this->subject !== $v) { + $this->subject = $v; + $this->modifiedColumns[EmailMessageTableMap::COL_SUBJECT] = true; + } + + return $this; + } // setSubject() + + /** + * 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() + { + // 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_CAMELNAME + * 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 : EmailMessageTableMap::translateFieldName('Recipient', TableMap::TYPE_PHPNAME, $indexType)]; + $this->recipient = (null !== $col) ? (int) $col : null; + + $col = $row[TableMap::TYPE_NUM == $indexType ? 1 + $startcol : EmailMessageTableMap::translateFieldName('Sender', TableMap::TYPE_PHPNAME, $indexType)]; + $this->sender = (null !== $col) ? (int) $col : null; + + $col = $row[TableMap::TYPE_NUM == $indexType ? 2 + $startcol : EmailMessageTableMap::translateFieldName('Contents', TableMap::TYPE_PHPNAME, $indexType)]; + $this->contents = (null !== $col) ? (string) $col : null; + + $col = $row[TableMap::TYPE_NUM == $indexType ? 3 + $startcol : EmailMessageTableMap::translateFieldName('Subject', TableMap::TYPE_PHPNAME, $indexType)]; + $this->subject = (null !== $col) ? (string) $col : null; + $this->resetModified(); + + $this->setNew(false); + + if ($rehydrate) { + $this->ensureConsistency(); + } + + return $startcol + 4; // 4 = EmailMessageTableMap::NUM_HYDRATE_COLUMNS. + + } catch (Exception $e) { + throw new PropelException(sprintf('Error populating %s object', '\\Eater\\Glim\\Model\\EmailMessage'), 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->aRecipientEmailAddress !== null && $this->recipient !== $this->aRecipientEmailAddress->getId()) { + $this->aRecipientEmailAddress = null; + } + if ($this->aSenderEmailAddress !== null && $this->sender !== $this->aSenderEmailAddress->getId()) { + $this->aSenderEmailAddress = 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(EmailMessageTableMap::DATABASE_NAME); + } + + // We don't need to alter the object instance pool; we're just modifying this instance + // already in the pool. + + $dataFetcher = ChildEmailMessageQuery::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->aRecipientEmailAddress = null; + $this->aSenderEmailAddress = null; + } // if (deep) + } + + /** + * Removes this object from datastore and sets delete attribute. + * + * @param ConnectionInterface $con + * @return void + * @throws PropelException + * @see EmailMessage::setDeleted() + * @see EmailMessage::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(EmailMessageTableMap::DATABASE_NAME); + } + + $con->transaction(function () use ($con) { + $deleteQuery = ChildEmailMessageQuery::create() + ->filterByPrimaryKey($this->getPrimaryKey()); + $ret = $this->preDelete($con); + if ($ret) { + $deleteQuery->delete($con); + $this->postDelete($con); + $this->setDeleted(true); + } + }); + } + + /** + * 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(EmailMessageTableMap::DATABASE_NAME); + } + + return $con->transaction(function () use ($con) { + $isInsert = $this->isNew(); + $ret = $this->preSave($con); + if ($isInsert) { + $ret = $ret && $this->preInsert($con); + } else { + $ret = $ret && $this->preUpdate($con); + } + if ($ret) { + $affectedRows = $this->doSave($con); + if ($isInsert) { + $this->postInsert($con); + } else { + $this->postUpdate($con); + } + $this->postSave($con); + EmailMessageTableMap::addInstanceToPool($this); + } else { + $affectedRows = 0; + } + + return $affectedRows; + }); + } + + /** + * 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->aRecipientEmailAddress !== null) { + if ($this->aRecipientEmailAddress->isModified() || $this->aRecipientEmailAddress->isNew()) { + $affectedRows += $this->aRecipientEmailAddress->save($con); + } + $this->setRecipientEmailAddress($this->aRecipientEmailAddress); + } + + if ($this->aSenderEmailAddress !== null) { + if ($this->aSenderEmailAddress->isModified() || $this->aSenderEmailAddress->isNew()) { + $affectedRows += $this->aSenderEmailAddress->save($con); + } + $this->setSenderEmailAddress($this->aSenderEmailAddress); + } + + if ($this->isNew() || $this->isModified()) { + // persist changes + if ($this->isNew()) { + $this->doInsert($con); + $affectedRows += 1; + } else { + $affectedRows += $this->doUpdate($con); + } + $this->resetModified(); + } + + $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; + + + // check the columns in natural order for more readable SQL queries + if ($this->isColumnModified(EmailMessageTableMap::COL_RECIPIENT)) { + $modifiedColumns[':p' . $index++] = 'recipient'; + } + if ($this->isColumnModified(EmailMessageTableMap::COL_SENDER)) { + $modifiedColumns[':p' . $index++] = 'sender'; + } + if ($this->isColumnModified(EmailMessageTableMap::COL_CONTENTS)) { + $modifiedColumns[':p' . $index++] = 'contents'; + } + if ($this->isColumnModified(EmailMessageTableMap::COL_SUBJECT)) { + $modifiedColumns[':p' . $index++] = 'subject'; + } + + $sql = sprintf( + 'INSERT INTO email_message (%s) VALUES (%s)', + implode(', ', $modifiedColumns), + implode(', ', array_keys($modifiedColumns)) + ); + + try { + $stmt = $con->prepare($sql); + foreach ($modifiedColumns as $identifier => $columnName) { + switch ($columnName) { + case 'recipient': + $stmt->bindValue($identifier, $this->recipient, PDO::PARAM_INT); + break; + case 'sender': + $stmt->bindValue($identifier, $this->sender, PDO::PARAM_INT); + break; + case 'contents': + $stmt->bindValue($identifier, $this->contents, PDO::PARAM_STR); + break; + case 'subject': + $stmt->bindValue($identifier, $this->subject, 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); + } + + $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_CAMELNAME + * 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 = EmailMessageTableMap::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->getRecipient(); + break; + case 1: + return $this->getSender(); + break; + case 2: + return $this->getContents(); + break; + case 3: + return $this->getSubject(); + 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_CAMELNAME, + * 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['EmailMessage'][$this->hashCode()])) { + return '*RECURSION*'; + } + $alreadyDumpedObjects['EmailMessage'][$this->hashCode()] = true; + $keys = EmailMessageTableMap::getFieldNames($keyType); + $result = array( + $keys[0] => $this->getRecipient(), + $keys[1] => $this->getSender(), + $keys[2] => $this->getContents(), + $keys[3] => $this->getSubject(), + ); + $virtualColumns = $this->virtualColumns; + foreach ($virtualColumns as $key => $virtualColumn) { + $result[$key] = $virtualColumn; + } + + if ($includeForeignObjects) { + if (null !== $this->aRecipientEmailAddress) { + + switch ($keyType) { + case TableMap::TYPE_CAMELNAME: + $key = 'emailAddress'; + break; + case TableMap::TYPE_FIELDNAME: + $key = 'email_address'; + break; + default: + $key = 'EmailAddress'; + } + + $result[$key] = $this->aRecipientEmailAddress->toArray($keyType, $includeLazyLoadColumns, $alreadyDumpedObjects, true); + } + if (null !== $this->aSenderEmailAddress) { + + switch ($keyType) { + case TableMap::TYPE_CAMELNAME: + $key = 'emailAddress'; + break; + case TableMap::TYPE_FIELDNAME: + $key = 'email_address'; + break; + default: + $key = 'EmailAddress'; + } + + $result[$key] = $this->aSenderEmailAddress->toArray($keyType, $includeLazyLoadColumns, $alreadyDumpedObjects, true); + } + } + + 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_CAMELNAME + * TableMap::TYPE_COLNAME, TableMap::TYPE_FIELDNAME, TableMap::TYPE_NUM. + * Defaults to TableMap::TYPE_PHPNAME. + * @return $this|\Eater\Glim\Model\EmailMessage + */ + public function setByName($name, $value, $type = TableMap::TYPE_PHPNAME) + { + $pos = EmailMessageTableMap::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 $this|\Eater\Glim\Model\EmailMessage + */ + public function setByPosition($pos, $value) + { + switch ($pos) { + case 0: + $this->setRecipient($value); + break; + case 1: + $this->setSender($value); + break; + case 2: + $this->setContents($value); + break; + case 3: + $this->setSubject($value); + break; + } // switch() + + return $this; + } + + /** + * 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_CAMELNAME, + * 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 = EmailMessageTableMap::getFieldNames($keyType); + + if (array_key_exists($keys[0], $arr)) { + $this->setRecipient($arr[$keys[0]]); + } + if (array_key_exists($keys[1], $arr)) { + $this->setSender($arr[$keys[1]]); + } + if (array_key_exists($keys[2], $arr)) { + $this->setContents($arr[$keys[2]]); + } + if (array_key_exists($keys[3], $arr)) { + $this->setSubject($arr[$keys[3]]); + } + } + + /** + * Populate the current object from a string, using a given parser format + * + * $book = new Book(); + * $book->importFrom('JSON', '{"Id":9012,"Title":"Don Juan","ISBN":"0140422161","Price":12.99,"PublisherId":1234,"AuthorId":5678}'); + * + * + * You can specify the key type of the array by additionally passing one + * of the class type constants TableMap::TYPE_PHPNAME, TableMap::TYPE_CAMELNAME, + * TableMap::TYPE_COLNAME, TableMap::TYPE_FIELDNAME, TableMap::TYPE_NUM. + * The default key type is the column's TableMap::TYPE_PHPNAME. + * + * @param mixed $parser A AbstractParser instance, + * or a format name ('XML', 'YAML', 'JSON', 'CSV') + * @param string $data The source data to import from + * @param string $keyType The type of keys the array uses. + * + * @return $this|\Eater\Glim\Model\EmailMessage The current object, for fluid interface + */ + public function importFrom($parser, $data, $keyType = TableMap::TYPE_PHPNAME) + { + if (!$parser instanceof AbstractParser) { + $parser = AbstractParser::getParser($parser); + } + + $this->fromArray($parser->toArray($data), $keyType); + + return $this; + } + + /** + * 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(EmailMessageTableMap::DATABASE_NAME); + + if ($this->isColumnModified(EmailMessageTableMap::COL_RECIPIENT)) { + $criteria->add(EmailMessageTableMap::COL_RECIPIENT, $this->recipient); + } + if ($this->isColumnModified(EmailMessageTableMap::COL_SENDER)) { + $criteria->add(EmailMessageTableMap::COL_SENDER, $this->sender); + } + if ($this->isColumnModified(EmailMessageTableMap::COL_CONTENTS)) { + $criteria->add(EmailMessageTableMap::COL_CONTENTS, $this->contents); + } + if ($this->isColumnModified(EmailMessageTableMap::COL_SUBJECT)) { + $criteria->add(EmailMessageTableMap::COL_SUBJECT, $this->subject); + } + + 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. + * + * @throws LogicException if no primary key is defined + * + * @return Criteria The Criteria object containing value(s) for primary key(s). + */ + public function buildPkeyCriteria() + { + throw new LogicException('The EmailMessage object has no primary key'); + + return $criteria; + } + + /** + * 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() + { + $validPk = false; + + $validPrimaryKeyFKs = 0; + $primaryKeyFKs = []; + + if ($validPk) { + return crc32(json_encode($this->getPrimaryKey(), JSON_UNESCAPED_UNICODE)); + } elseif ($validPrimaryKeyFKs) { + return crc32(json_encode($primaryKeyFKs, JSON_UNESCAPED_UNICODE)); + } + + return spl_object_hash($this); + } + + /** + * Returns NULL since this table doesn't have a primary key. + * This method exists only for BC and is deprecated! + * @return null + */ + public function getPrimaryKey() + { + return null; + } + + /** + * Dummy primary key setter. + * + * This function only exists to preserve backwards compatibility. It is no longer + * needed or required by the Persistent interface. It will be removed in next BC-breaking + * release of Propel. + * + * @deprecated + */ + public function setPrimaryKey($pk) + { + // do nothing, because this object doesn't have any primary keys + } + + /** + * Returns true if the primary key for this object is null. + * @return boolean + */ + public function isPrimaryKeyNull() + { + return ; + } + + /** + * 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 \Eater\Glim\Model\EmailMessage (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->setRecipient($this->getRecipient()); + $copyObj->setSender($this->getSender()); + $copyObj->setContents($this->getContents()); + $copyObj->setSubject($this->getSubject()); + if ($makeNew) { + $copyObj->setNew(true); + } + } + + /** + * 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 \Eater\Glim\Model\EmailMessage 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 ChildEmailAddress object. + * + * @param ChildEmailAddress $v + * @return $this|\Eater\Glim\Model\EmailMessage The current object (for fluent API support) + * @throws PropelException + */ + public function setRecipientEmailAddress(ChildEmailAddress $v = null) + { + if ($v === null) { + $this->setRecipient(NULL); + } else { + $this->setRecipient($v->getId()); + } + + $this->aRecipientEmailAddress = $v; + + // Add binding for other direction of this n:n relationship. + // If this object has already been added to the ChildEmailAddress object, it will not be re-added. + if ($v !== null) { + $v->addEmailMessageRelatedByRecipient($this); + } + + + return $this; + } + + + /** + * Get the associated ChildEmailAddress object + * + * @param ConnectionInterface $con Optional Connection object. + * @return ChildEmailAddress The associated ChildEmailAddress object. + * @throws PropelException + */ + public function getRecipientEmailAddress(ConnectionInterface $con = null) + { + if ($this->aRecipientEmailAddress === null && ($this->recipient !== null)) { + $this->aRecipientEmailAddress = ChildEmailAddressQuery::create()->findPk($this->recipient, $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->aRecipientEmailAddress->addEmailMessagesRelatedByRecipient($this); + */ + } + + return $this->aRecipientEmailAddress; + } + + /** + * Declares an association between this object and a ChildEmailAddress object. + * + * @param ChildEmailAddress $v + * @return $this|\Eater\Glim\Model\EmailMessage The current object (for fluent API support) + * @throws PropelException + */ + public function setSenderEmailAddress(ChildEmailAddress $v = null) + { + if ($v === null) { + $this->setSender(NULL); + } else { + $this->setSender($v->getId()); + } + + $this->aSenderEmailAddress = $v; + + // Add binding for other direction of this n:n relationship. + // If this object has already been added to the ChildEmailAddress object, it will not be re-added. + if ($v !== null) { + $v->addEmailMessageRelatedBySender($this); + } + + + return $this; + } + + + /** + * Get the associated ChildEmailAddress object + * + * @param ConnectionInterface $con Optional Connection object. + * @return ChildEmailAddress The associated ChildEmailAddress object. + * @throws PropelException + */ + public function getSenderEmailAddress(ConnectionInterface $con = null) + { + if ($this->aSenderEmailAddress === null && ($this->sender !== null)) { + $this->aSenderEmailAddress = ChildEmailAddressQuery::create()->findPk($this->sender, $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->aSenderEmailAddress->addEmailMessagesRelatedBySender($this); + */ + } + + return $this->aSenderEmailAddress; + } + + /** + * Clears the current object, sets all attributes to their default values and removes + * outgoing references as well as back-references (from other objects to this one. Results probably in a database + * change of those foreign objects when you call `save` there). + */ + public function clear() + { + if (null !== $this->aRecipientEmailAddress) { + $this->aRecipientEmailAddress->removeEmailMessageRelatedByRecipient($this); + } + if (null !== $this->aSenderEmailAddress) { + $this->aSenderEmailAddress->removeEmailMessageRelatedBySender($this); + } + $this->recipient = null; + $this->sender = null; + $this->contents = null; + $this->subject = null; + $this->alreadyInSave = false; + $this->clearAllReferences(); + $this->resetModified(); + $this->setNew(true); + $this->setDeleted(false); + } + + /** + * Resets all references and back-references to other model objects or collections of model objects. + * + * This method is used to reset all php object references (not the actual reference in the database). + * Necessary for object serialisation. + * + * @param boolean $deep Whether to also clear the references on all referrer objects. + */ + public function clearAllReferences($deep = false) + { + if ($deep) { + } // if ($deep) + + $this->aRecipientEmailAddress = null; + $this->aSenderEmailAddress = null; + } + + /** + * Return the string representation of this object + * + * @return string + */ + public function __toString() + { + return (string) $this->exportTo(EmailMessageTableMap::DEFAULT_STRING_FORMAT); + } + + /** + * 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)); + } + +} diff --git a/src/Model/Base/EmailMessageQuery.php b/src/Model/Base/EmailMessageQuery.php new file mode 100644 index 0000000..6951824 --- /dev/null +++ b/src/Model/Base/EmailMessageQuery.php @@ -0,0 +1,545 @@ +setModelAlias($modelAlias); + } + if ($criteria instanceof Criteria) { + $query->mergeWith($criteria); + } + + return $query; + } + + /** + * Find object by primary key. + * Propel uses the instance pool to skip the database if the object exists. + * Go fast if the query is untouched. + * + * + * $obj = $c->findPk(12, $con); + * + * + * @param mixed $key Primary key to use for the query + * @param ConnectionInterface $con an optional connection object + * + * @return ChildEmailMessage|array|mixed the result, formatted by the current formatter + */ + public function findPk($key, ConnectionInterface $con = null) + { + throw new LogicException('The EmailMessage object has no primary key'); + } + + /** + * Find objects by primary key + * + * $objs = $c->findPks(array(array(12, 56), array(832, 123), array(123, 456)), $con); + * + * @param array $keys Primary keys to use for the query + * @param ConnectionInterface $con an optional connection object + * + * @return ObjectCollection|array|mixed the list of results, formatted by the current formatter + */ + public function findPks($keys, ConnectionInterface $con = null) + { + throw new LogicException('The EmailMessage object has no primary key'); + } + + /** + * Filter the query by primary key + * + * @param mixed $key Primary key to use for the query + * + * @return $this|ChildEmailMessageQuery The current query, for fluid interface + */ + public function filterByPrimaryKey($key) + { + throw new LogicException('The EmailMessage object has no primary key'); + } + + /** + * Filter the query by a list of primary keys + * + * @param array $keys The list of primary key to use for the query + * + * @return $this|ChildEmailMessageQuery The current query, for fluid interface + */ + public function filterByPrimaryKeys($keys) + { + throw new LogicException('The EmailMessage object has no primary key'); + } + + /** + * Filter the query on the recipient column + * + * Example usage: + * + * $query->filterByRecipient(1234); // WHERE recipient = 1234 + * $query->filterByRecipient(array(12, 34)); // WHERE recipient IN (12, 34) + * $query->filterByRecipient(array('min' => 12)); // WHERE recipient > 12 + * + * + * @see filterByRecipientEmailAddress() + * + * @param mixed $recipient The value to use as filter. + * Use scalar values for equality. + * Use array values for in_array() equivalent. + * Use associative array('min' => $minValue, 'max' => $maxValue) for intervals. + * @param string $comparison Operator to use for the column comparison, defaults to Criteria::EQUAL + * + * @return $this|ChildEmailMessageQuery The current query, for fluid interface + */ + public function filterByRecipient($recipient = null, $comparison = null) + { + if (is_array($recipient)) { + $useMinMax = false; + if (isset($recipient['min'])) { + $this->addUsingAlias(EmailMessageTableMap::COL_RECIPIENT, $recipient['min'], Criteria::GREATER_EQUAL); + $useMinMax = true; + } + if (isset($recipient['max'])) { + $this->addUsingAlias(EmailMessageTableMap::COL_RECIPIENT, $recipient['max'], Criteria::LESS_EQUAL); + $useMinMax = true; + } + if ($useMinMax) { + return $this; + } + if (null === $comparison) { + $comparison = Criteria::IN; + } + } + + return $this->addUsingAlias(EmailMessageTableMap::COL_RECIPIENT, $recipient, $comparison); + } + + /** + * Filter the query on the sender column + * + * Example usage: + * + * $query->filterBySender(1234); // WHERE sender = 1234 + * $query->filterBySender(array(12, 34)); // WHERE sender IN (12, 34) + * $query->filterBySender(array('min' => 12)); // WHERE sender > 12 + * + * + * @see filterBySenderEmailAddress() + * + * @param mixed $sender The value to use as filter. + * Use scalar values for equality. + * Use array values for in_array() equivalent. + * Use associative array('min' => $minValue, 'max' => $maxValue) for intervals. + * @param string $comparison Operator to use for the column comparison, defaults to Criteria::EQUAL + * + * @return $this|ChildEmailMessageQuery The current query, for fluid interface + */ + public function filterBySender($sender = null, $comparison = null) + { + if (is_array($sender)) { + $useMinMax = false; + if (isset($sender['min'])) { + $this->addUsingAlias(EmailMessageTableMap::COL_SENDER, $sender['min'], Criteria::GREATER_EQUAL); + $useMinMax = true; + } + if (isset($sender['max'])) { + $this->addUsingAlias(EmailMessageTableMap::COL_SENDER, $sender['max'], Criteria::LESS_EQUAL); + $useMinMax = true; + } + if ($useMinMax) { + return $this; + } + if (null === $comparison) { + $comparison = Criteria::IN; + } + } + + return $this->addUsingAlias(EmailMessageTableMap::COL_SENDER, $sender, $comparison); + } + + /** + * Filter the query on the contents column + * + * Example usage: + * + * $query->filterByContents('fooValue'); // WHERE contents = 'fooValue' + * $query->filterByContents('%fooValue%'); // WHERE contents LIKE '%fooValue%' + * + * + * @param string $contents The value to use as filter. + * Accepts wildcards (* and % trigger a LIKE) + * @param string $comparison Operator to use for the column comparison, defaults to Criteria::EQUAL + * + * @return $this|ChildEmailMessageQuery The current query, for fluid interface + */ + public function filterByContents($contents = null, $comparison = null) + { + if (null === $comparison) { + if (is_array($contents)) { + $comparison = Criteria::IN; + } elseif (preg_match('/[\%\*]/', $contents)) { + $contents = str_replace('*', '%', $contents); + $comparison = Criteria::LIKE; + } + } + + return $this->addUsingAlias(EmailMessageTableMap::COL_CONTENTS, $contents, $comparison); + } + + /** + * Filter the query on the subject column + * + * Example usage: + * + * $query->filterBySubject('fooValue'); // WHERE subject = 'fooValue' + * $query->filterBySubject('%fooValue%'); // WHERE subject LIKE '%fooValue%' + * + * + * @param string $subject The value to use as filter. + * Accepts wildcards (* and % trigger a LIKE) + * @param string $comparison Operator to use for the column comparison, defaults to Criteria::EQUAL + * + * @return $this|ChildEmailMessageQuery The current query, for fluid interface + */ + public function filterBySubject($subject = null, $comparison = null) + { + if (null === $comparison) { + if (is_array($subject)) { + $comparison = Criteria::IN; + } elseif (preg_match('/[\%\*]/', $subject)) { + $subject = str_replace('*', '%', $subject); + $comparison = Criteria::LIKE; + } + } + + return $this->addUsingAlias(EmailMessageTableMap::COL_SUBJECT, $subject, $comparison); + } + + /** + * Filter the query by a related \Eater\Glim\Model\EmailAddress object + * + * @param \Eater\Glim\Model\EmailAddress|ObjectCollection $emailAddress The related object(s) to use as filter + * @param string $comparison Operator to use for the column comparison, defaults to Criteria::EQUAL + * + * @throws \Propel\Runtime\Exception\PropelException + * + * @return ChildEmailMessageQuery The current query, for fluid interface + */ + public function filterByRecipientEmailAddress($emailAddress, $comparison = null) + { + if ($emailAddress instanceof \Eater\Glim\Model\EmailAddress) { + return $this + ->addUsingAlias(EmailMessageTableMap::COL_RECIPIENT, $emailAddress->getId(), $comparison); + } elseif ($emailAddress instanceof ObjectCollection) { + if (null === $comparison) { + $comparison = Criteria::IN; + } + + return $this + ->addUsingAlias(EmailMessageTableMap::COL_RECIPIENT, $emailAddress->toKeyValue('PrimaryKey', 'Id'), $comparison); + } else { + throw new PropelException('filterByRecipientEmailAddress() only accepts arguments of type \Eater\Glim\Model\EmailAddress or Collection'); + } + } + + /** + * Adds a JOIN clause to the query using the RecipientEmailAddress relation + * + * @param string $relationAlias optional alias for the relation + * @param string $joinType Accepted values are null, 'left join', 'right join', 'inner join' + * + * @return $this|ChildEmailMessageQuery The current query, for fluid interface + */ + public function joinRecipientEmailAddress($relationAlias = null, $joinType = Criteria::LEFT_JOIN) + { + $tableMap = $this->getTableMap(); + $relationMap = $tableMap->getRelation('RecipientEmailAddress'); + + // create a ModelJoin object for this join + $join = new ModelJoin(); + $join->setJoinType($joinType); + $join->setRelationMap($relationMap, $this->useAliasInSQL ? $this->getModelAlias() : null, $relationAlias); + if ($previousJoin = $this->getPreviousJoin()) { + $join->setPreviousJoin($previousJoin); + } + + // add the ModelJoin to the current object + if ($relationAlias) { + $this->addAlias($relationAlias, $relationMap->getRightTable()->getName()); + $this->addJoinObject($join, $relationAlias); + } else { + $this->addJoinObject($join, 'RecipientEmailAddress'); + } + + return $this; + } + + /** + * Use the RecipientEmailAddress relation EmailAddress object + * + * @see useQuery() + * + * @param string $relationAlias optional alias for the relation, + * to be used as main alias in the secondary query + * @param string $joinType Accepted values are null, 'left join', 'right join', 'inner join' + * + * @return \Eater\Glim\Model\EmailAddressQuery A secondary query class using the current class as primary query + */ + public function useRecipientEmailAddressQuery($relationAlias = null, $joinType = Criteria::LEFT_JOIN) + { + return $this + ->joinRecipientEmailAddress($relationAlias, $joinType) + ->useQuery($relationAlias ? $relationAlias : 'RecipientEmailAddress', '\Eater\Glim\Model\EmailAddressQuery'); + } + + /** + * Filter the query by a related \Eater\Glim\Model\EmailAddress object + * + * @param \Eater\Glim\Model\EmailAddress|ObjectCollection $emailAddress The related object(s) to use as filter + * @param string $comparison Operator to use for the column comparison, defaults to Criteria::EQUAL + * + * @throws \Propel\Runtime\Exception\PropelException + * + * @return ChildEmailMessageQuery The current query, for fluid interface + */ + public function filterBySenderEmailAddress($emailAddress, $comparison = null) + { + if ($emailAddress instanceof \Eater\Glim\Model\EmailAddress) { + return $this + ->addUsingAlias(EmailMessageTableMap::COL_SENDER, $emailAddress->getId(), $comparison); + } elseif ($emailAddress instanceof ObjectCollection) { + if (null === $comparison) { + $comparison = Criteria::IN; + } + + return $this + ->addUsingAlias(EmailMessageTableMap::COL_SENDER, $emailAddress->toKeyValue('PrimaryKey', 'Id'), $comparison); + } else { + throw new PropelException('filterBySenderEmailAddress() only accepts arguments of type \Eater\Glim\Model\EmailAddress or Collection'); + } + } + + /** + * Adds a JOIN clause to the query using the SenderEmailAddress relation + * + * @param string $relationAlias optional alias for the relation + * @param string $joinType Accepted values are null, 'left join', 'right join', 'inner join' + * + * @return $this|ChildEmailMessageQuery The current query, for fluid interface + */ + public function joinSenderEmailAddress($relationAlias = null, $joinType = Criteria::LEFT_JOIN) + { + $tableMap = $this->getTableMap(); + $relationMap = $tableMap->getRelation('SenderEmailAddress'); + + // create a ModelJoin object for this join + $join = new ModelJoin(); + $join->setJoinType($joinType); + $join->setRelationMap($relationMap, $this->useAliasInSQL ? $this->getModelAlias() : null, $relationAlias); + if ($previousJoin = $this->getPreviousJoin()) { + $join->setPreviousJoin($previousJoin); + } + + // add the ModelJoin to the current object + if ($relationAlias) { + $this->addAlias($relationAlias, $relationMap->getRightTable()->getName()); + $this->addJoinObject($join, $relationAlias); + } else { + $this->addJoinObject($join, 'SenderEmailAddress'); + } + + return $this; + } + + /** + * Use the SenderEmailAddress relation EmailAddress object + * + * @see useQuery() + * + * @param string $relationAlias optional alias for the relation, + * to be used as main alias in the secondary query + * @param string $joinType Accepted values are null, 'left join', 'right join', 'inner join' + * + * @return \Eater\Glim\Model\EmailAddressQuery A secondary query class using the current class as primary query + */ + public function useSenderEmailAddressQuery($relationAlias = null, $joinType = Criteria::LEFT_JOIN) + { + return $this + ->joinSenderEmailAddress($relationAlias, $joinType) + ->useQuery($relationAlias ? $relationAlias : 'SenderEmailAddress', '\Eater\Glim\Model\EmailAddressQuery'); + } + + /** + * Exclude object from result + * + * @param ChildEmailMessage $emailMessage Object to remove from the list of results + * + * @return $this|ChildEmailMessageQuery The current query, for fluid interface + */ + public function prune($emailMessage = null) + { + if ($emailMessage) { + throw new LogicException('EmailMessage object has no primary key'); + + } + + return $this; + } + + /** + * Deletes all rows from the email_message table. + * + * @param ConnectionInterface $con the connection to use + * @return int The number of affected rows (if supported by underlying database driver). + */ + public function doDeleteAll(ConnectionInterface $con = null) + { + if (null === $con) { + $con = Propel::getServiceContainer()->getWriteConnection(EmailMessageTableMap::DATABASE_NAME); + } + + // use transaction because $criteria could contain info + // for more than one table or we could emulating ON DELETE CASCADE, etc. + return $con->transaction(function () use ($con) { + $affectedRows = 0; // initialize var to track total num of affected rows + $affectedRows += parent::doDeleteAll($con); + // Because this db requires some delete cascade/set null emulation, we have to + // clear the cached instance *after* the emulation has happened (since + // instances get re-added by the select statement contained therein). + EmailMessageTableMap::clearInstancePool(); + EmailMessageTableMap::clearRelatedInstancePool(); + + return $affectedRows; + }); + } + + /** + * Performs a DELETE on the database based on the current ModelCriteria + * + * @param ConnectionInterface $con the connection to use + * @return int The number of affected rows (if supported by underlying database driver). This includes CASCADE-related rows + * if supported by native driver or if emulated using Propel. + * @throws PropelException Any exceptions caught during processing will be + * rethrown wrapped into a PropelException. + */ + public function delete(ConnectionInterface $con = null) + { + if (null === $con) { + $con = Propel::getServiceContainer()->getWriteConnection(EmailMessageTableMap::DATABASE_NAME); + } + + $criteria = $this; + + // Set the correct dbName + $criteria->setDbName(EmailMessageTableMap::DATABASE_NAME); + + // use transaction because $criteria could contain info + // for more than one table or we could emulating ON DELETE CASCADE, etc. + return $con->transaction(function () use ($con, $criteria) { + $affectedRows = 0; // initialize var to track total num of affected rows + + EmailMessageTableMap::removeInstanceFromPool($criteria); + + $affectedRows += ModelCriteria::delete($con); + EmailMessageTableMap::clearRelatedInstancePool(); + + return $affectedRows; + }); + } + +} // EmailMessageQuery diff --git a/src/Model/Base/Invite.php b/src/Model/Base/Invite.php index 96da6de..f352831 100644 --- a/src/Model/Base/Invite.php +++ b/src/Model/Base/Invite.php @@ -21,7 +21,7 @@ use Propel\Runtime\Map\TableMap; use Propel\Runtime\Parser\AbstractParser; /** - * Base class that represents a row from the 'Invite' table. + * Base class that represents a row from the 'invite' table. * * * @@ -679,7 +679,7 @@ abstract class Invite implements ActiveRecordInterface } $sql = sprintf( - 'INSERT INTO Invite (%s) VALUES (%s)', + 'INSERT INTO invite (%s) VALUES (%s)', implode(', ', $modifiedColumns), implode(', ', array_keys($modifiedColumns)) ); @@ -815,7 +815,7 @@ abstract class Invite implements ActiveRecordInterface $key = 'user'; break; case TableMap::TYPE_FIELDNAME: - $key = 'User'; + $key = 'user'; break; default: $key = 'User'; diff --git a/src/Model/Base/InviteQuery.php b/src/Model/Base/InviteQuery.php index 716c54c..9a75653 100644 --- a/src/Model/Base/InviteQuery.php +++ b/src/Model/Base/InviteQuery.php @@ -16,7 +16,7 @@ use Propel\Runtime\Connection\ConnectionInterface; use Propel\Runtime\Exception\PropelException; /** - * Base class that represents a query for the 'Invite' table. + * Base class that represents a query for the 'invite' table. * * * @@ -148,7 +148,7 @@ abstract class InviteQuery extends ModelCriteria */ protected function findPkSimple($key, ConnectionInterface $con) { - $sql = 'SELECT id, invite, owner FROM Invite WHERE id = :p0'; + $sql = 'SELECT id, invite, owner FROM invite WHERE id = :p0'; try { $stmt = $con->prepare($sql); $stmt->bindValue(':p0', $key, PDO::PARAM_INT); @@ -445,7 +445,7 @@ abstract class InviteQuery extends ModelCriteria } /** - * Deletes all rows from the Invite table. + * Deletes all rows from the invite table. * * @param ConnectionInterface $con the connection to use * @return int The number of affected rows (if supported by underlying database driver). diff --git a/src/Model/Base/Server.php b/src/Model/Base/Server.php index 31f206b..344d00a 100644 --- a/src/Model/Base/Server.php +++ b/src/Model/Base/Server.php @@ -19,7 +19,7 @@ use Propel\Runtime\Map\TableMap; use Propel\Runtime\Parser\AbstractParser; /** - * Base class that represents a row from the 'Server' table. + * Base class that represents a row from the 'server' table. * * * @@ -1238,7 +1238,7 @@ abstract class Server implements ActiveRecordInterface } $sql = sprintf( - 'INSERT INTO Server (%s) VALUES (%s)', + 'INSERT INTO server (%s) VALUES (%s)', implode(', ', $modifiedColumns), implode(', ', array_keys($modifiedColumns)) ); diff --git a/src/Model/Base/ServerQuery.php b/src/Model/Base/ServerQuery.php index 9cbfd9d..628177b 100644 --- a/src/Model/Base/ServerQuery.php +++ b/src/Model/Base/ServerQuery.php @@ -15,7 +15,7 @@ use Propel\Runtime\Connection\ConnectionInterface; use Propel\Runtime\Exception\PropelException; /** - * Base class that represents a query for the 'Server' table. + * Base class that represents a query for the 'server' table. * * * @@ -201,7 +201,7 @@ abstract class ServerQuery extends ModelCriteria */ protected function findPkSimple($key, ConnectionInterface $con) { - $sql = 'SELECT id, fqdn, fingerprint, public_key, certificate, location, speed, external_ip, internal_ip, netmask, first_dns, second_dns, port, protocol, status FROM Server WHERE id = :p0'; + $sql = 'SELECT id, fqdn, fingerprint, public_key, certificate, location, speed, external_ip, internal_ip, netmask, first_dns, second_dns, port, protocol, status FROM server WHERE id = :p0'; try { $stmt = $con->prepare($sql); $stmt->bindValue(':p0', $key, PDO::PARAM_INT); @@ -799,7 +799,7 @@ abstract class ServerQuery extends ModelCriteria } /** - * Deletes all rows from the Server table. + * Deletes all rows from the server table. * * @param ConnectionInterface $con the connection to use * @return int The number of affected rows (if supported by underlying database driver). diff --git a/src/Model/Base/User.php b/src/Model/Base/User.php index 8d46ff1..1d92cc9 100644 --- a/src/Model/Base/User.php +++ b/src/Model/Base/User.php @@ -6,6 +6,8 @@ use \Exception; use \PDO; use Eater\Glim\Model\Certificate as ChildCertificate; use Eater\Glim\Model\CertificateQuery as ChildCertificateQuery; +use Eater\Glim\Model\EmailAddress as ChildEmailAddress; +use Eater\Glim\Model\EmailAddressQuery as ChildEmailAddressQuery; use Eater\Glim\Model\Invite as ChildInvite; use Eater\Glim\Model\InviteQuery as ChildInviteQuery; use Eater\Glim\Model\User as ChildUser; @@ -25,7 +27,7 @@ use Propel\Runtime\Map\TableMap; use Propel\Runtime\Parser\AbstractParser; /** - * Base class that represents a row from the 'User' table. + * Base class that represents a row from the 'user' table. * * * @@ -86,7 +88,7 @@ abstract class User implements ActiveRecordInterface /** * The value for the email field. - * @var string + * @var int */ protected $email; @@ -117,6 +119,17 @@ abstract class User implements ActiveRecordInterface */ protected $used_invites; + /** + * @var ChildEmailAddress + */ + protected $aEmailAddressRelatedByEmail; + + /** + * @var ObjectCollection|ChildEmailAddress[] Collection to store aggregation of ChildEmailAddress objects. + */ + protected $collEmailAddressesRelatedByOwner; + protected $collEmailAddressesRelatedByOwnerPartial; + /** * @var ObjectCollection|ChildCertificate[] Collection to store aggregation of ChildCertificate objects. */ @@ -137,6 +150,12 @@ abstract class User implements ActiveRecordInterface */ protected $alreadyInSave = false; + /** + * An array of objects scheduled for deletion. + * @var ObjectCollection|ChildEmailAddress[] + */ + protected $emailAddressesRelatedByOwnerScheduledForDeletion = null; + /** * An array of objects scheduled for deletion. * @var ObjectCollection|ChildCertificate[] @@ -415,7 +434,7 @@ abstract class User implements ActiveRecordInterface /** * Get the [email] column value. * - * @return string + * @return int */ public function getEmail() { @@ -535,13 +554,13 @@ abstract class User implements ActiveRecordInterface /** * Set the value of [email] column. * - * @param string $v new value + * @param int $v new value * @return $this|\Eater\Glim\Model\User The current object (for fluent API support) */ public function setEmail($v) { if ($v !== null) { - $v = (string) $v; + $v = (int) $v; } if ($this->email !== $v) { @@ -549,6 +568,10 @@ abstract class User implements ActiveRecordInterface $this->modifiedColumns[UserTableMap::COL_EMAIL] = true; } + if ($this->aEmailAddressRelatedByEmail !== null && $this->aEmailAddressRelatedByEmail->getId() !== $v) { + $this->aEmailAddressRelatedByEmail = null; + } + return $this; } // setEmail() @@ -702,7 +725,7 @@ abstract class User implements ActiveRecordInterface $this->username = (null !== $col) ? (string) $col : null; $col = $row[TableMap::TYPE_NUM == $indexType ? 3 + $startcol : UserTableMap::translateFieldName('Email', TableMap::TYPE_PHPNAME, $indexType)]; - $this->email = (null !== $col) ? (string) $col : null; + $this->email = (null !== $col) ? (int) $col : null; $col = $row[TableMap::TYPE_NUM == $indexType ? 4 + $startcol : UserTableMap::translateFieldName('Password', TableMap::TYPE_PHPNAME, $indexType)]; $this->password = (null !== $col) ? (string) $col : null; @@ -745,6 +768,9 @@ abstract class User implements ActiveRecordInterface */ public function ensureConsistency() { + if ($this->aEmailAddressRelatedByEmail !== null && $this->email !== $this->aEmailAddressRelatedByEmail->getId()) { + $this->aEmailAddressRelatedByEmail = null; + } } // ensureConsistency /** @@ -784,6 +810,9 @@ abstract class User implements ActiveRecordInterface if ($deep) { // also de-associate any related objects? + $this->aEmailAddressRelatedByEmail = null; + $this->collEmailAddressesRelatedByOwner = null; + $this->collCertificates = null; $this->collInvites = null; @@ -887,6 +916,18 @@ abstract class User implements ActiveRecordInterface 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->aEmailAddressRelatedByEmail !== null) { + if ($this->aEmailAddressRelatedByEmail->isModified() || $this->aEmailAddressRelatedByEmail->isNew()) { + $affectedRows += $this->aEmailAddressRelatedByEmail->save($con); + } + $this->setEmailAddressRelatedByEmail($this->aEmailAddressRelatedByEmail); + } + if ($this->isNew() || $this->isModified()) { // persist changes if ($this->isNew()) { @@ -898,6 +939,24 @@ abstract class User implements ActiveRecordInterface $this->resetModified(); } + if ($this->emailAddressesRelatedByOwnerScheduledForDeletion !== null) { + if (!$this->emailAddressesRelatedByOwnerScheduledForDeletion->isEmpty()) { + foreach ($this->emailAddressesRelatedByOwnerScheduledForDeletion as $emailAddressRelatedByOwner) { + // need to save related object because we set the relation to null + $emailAddressRelatedByOwner->save($con); + } + $this->emailAddressesRelatedByOwnerScheduledForDeletion = null; + } + } + + if ($this->collEmailAddressesRelatedByOwner !== null) { + foreach ($this->collEmailAddressesRelatedByOwner as $referrerFK) { + if (!$referrerFK->isDeleted() && ($referrerFK->isNew() || $referrerFK->isModified())) { + $affectedRows += $referrerFK->save($con); + } + } + } + if ($this->certificatesScheduledForDeletion !== null) { if (!$this->certificatesScheduledForDeletion->isEmpty()) { foreach ($this->certificatesScheduledForDeletion as $certificate) { @@ -986,7 +1045,7 @@ abstract class User implements ActiveRecordInterface } $sql = sprintf( - 'INSERT INTO User (%s) VALUES (%s)', + 'INSERT INTO user (%s) VALUES (%s)', implode(', ', $modifiedColumns), implode(', ', array_keys($modifiedColumns)) ); @@ -1005,7 +1064,7 @@ abstract class User implements ActiveRecordInterface $stmt->bindValue($identifier, $this->username, PDO::PARAM_STR); break; case 'email': - $stmt->bindValue($identifier, $this->email, PDO::PARAM_STR); + $stmt->bindValue($identifier, $this->email, PDO::PARAM_INT); break; case 'password': $stmt->bindValue($identifier, $this->password, PDO::PARAM_STR); @@ -1150,6 +1209,36 @@ abstract class User implements ActiveRecordInterface } if ($includeForeignObjects) { + if (null !== $this->aEmailAddressRelatedByEmail) { + + switch ($keyType) { + case TableMap::TYPE_CAMELNAME: + $key = 'emailAddress'; + break; + case TableMap::TYPE_FIELDNAME: + $key = 'email_address'; + break; + default: + $key = 'EmailAddress'; + } + + $result[$key] = $this->aEmailAddressRelatedByEmail->toArray($keyType, $includeLazyLoadColumns, $alreadyDumpedObjects, true); + } + if (null !== $this->collEmailAddressesRelatedByOwner) { + + switch ($keyType) { + case TableMap::TYPE_CAMELNAME: + $key = 'emailAddresses'; + break; + case TableMap::TYPE_FIELDNAME: + $key = 'email_addresses'; + break; + default: + $key = 'EmailAddresses'; + } + + $result[$key] = $this->collEmailAddressesRelatedByOwner->toArray(null, false, $keyType, $includeLazyLoadColumns, $alreadyDumpedObjects); + } if (null !== $this->collCertificates) { switch ($keyType) { @@ -1157,7 +1246,7 @@ abstract class User implements ActiveRecordInterface $key = 'certificates'; break; case TableMap::TYPE_FIELDNAME: - $key = 'Certificates'; + $key = 'certificates'; break; default: $key = 'Certificates'; @@ -1172,7 +1261,7 @@ abstract class User implements ActiveRecordInterface $key = 'invites'; break; case TableMap::TYPE_FIELDNAME: - $key = 'Invites'; + $key = 'invites'; break; default: $key = 'Invites'; @@ -1452,6 +1541,12 @@ abstract class User implements ActiveRecordInterface // the getter/setter methods for fkey referrer objects. $copyObj->setNew(false); + foreach ($this->getEmailAddressesRelatedByOwner() as $relObj) { + if ($relObj !== $this) { // ensure that we don't try to copy a reference to ourselves + $copyObj->addEmailAddressRelatedByOwner($relObj->copy($deepCopy)); + } + } + foreach ($this->getCertificates() as $relObj) { if ($relObj !== $this) { // ensure that we don't try to copy a reference to ourselves $copyObj->addCertificate($relObj->copy($deepCopy)); @@ -1494,6 +1589,57 @@ abstract class User implements ActiveRecordInterface return $copyObj; } + /** + * Declares an association between this object and a ChildEmailAddress object. + * + * @param ChildEmailAddress $v + * @return $this|\Eater\Glim\Model\User The current object (for fluent API support) + * @throws PropelException + */ + public function setEmailAddressRelatedByEmail(ChildEmailAddress $v = null) + { + if ($v === null) { + $this->setEmail(NULL); + } else { + $this->setEmail($v->getId()); + } + + $this->aEmailAddressRelatedByEmail = $v; + + // Add binding for other direction of this n:n relationship. + // If this object has already been added to the ChildEmailAddress object, it will not be re-added. + if ($v !== null) { + $v->addUserRelatedByEmail($this); + } + + + return $this; + } + + + /** + * Get the associated ChildEmailAddress object + * + * @param ConnectionInterface $con Optional Connection object. + * @return ChildEmailAddress The associated ChildEmailAddress object. + * @throws PropelException + */ + public function getEmailAddressRelatedByEmail(ConnectionInterface $con = null) + { + if ($this->aEmailAddressRelatedByEmail === null && ($this->email !== null)) { + $this->aEmailAddressRelatedByEmail = ChildEmailAddressQuery::create()->findPk($this->email, $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->aEmailAddressRelatedByEmail->addUsersRelatedByEmail($this); + */ + } + + return $this->aEmailAddressRelatedByEmail; + } + /** * Initializes a collection based on the name of a relation. @@ -1505,6 +1651,9 @@ abstract class User implements ActiveRecordInterface */ public function initRelation($relationName) { + if ('EmailAddressRelatedByOwner' == $relationName) { + return $this->initEmailAddressesRelatedByOwner(); + } if ('Certificate' == $relationName) { return $this->initCertificates(); } @@ -1513,6 +1662,224 @@ abstract class User implements ActiveRecordInterface } } + /** + * Clears out the collEmailAddressesRelatedByOwner 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 addEmailAddressesRelatedByOwner() + */ + public function clearEmailAddressesRelatedByOwner() + { + $this->collEmailAddressesRelatedByOwner = null; // important to set this to NULL since that means it is uninitialized + } + + /** + * Reset is the collEmailAddressesRelatedByOwner collection loaded partially. + */ + public function resetPartialEmailAddressesRelatedByOwner($v = true) + { + $this->collEmailAddressesRelatedByOwnerPartial = $v; + } + + /** + * Initializes the collEmailAddressesRelatedByOwner collection. + * + * By default this just sets the collEmailAddressesRelatedByOwner collection to an empty array (like clearcollEmailAddressesRelatedByOwner()); + * 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 initEmailAddressesRelatedByOwner($overrideExisting = true) + { + if (null !== $this->collEmailAddressesRelatedByOwner && !$overrideExisting) { + return; + } + $this->collEmailAddressesRelatedByOwner = new ObjectCollection(); + $this->collEmailAddressesRelatedByOwner->setModel('\Eater\Glim\Model\EmailAddress'); + } + + /** + * Gets an array of ChildEmailAddress 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 ChildUser 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 ObjectCollection|ChildEmailAddress[] List of ChildEmailAddress objects + * @throws PropelException + */ + public function getEmailAddressesRelatedByOwner(Criteria $criteria = null, ConnectionInterface $con = null) + { + $partial = $this->collEmailAddressesRelatedByOwnerPartial && !$this->isNew(); + if (null === $this->collEmailAddressesRelatedByOwner || null !== $criteria || $partial) { + if ($this->isNew() && null === $this->collEmailAddressesRelatedByOwner) { + // return empty collection + $this->initEmailAddressesRelatedByOwner(); + } else { + $collEmailAddressesRelatedByOwner = ChildEmailAddressQuery::create(null, $criteria) + ->filterByUserRelatedByOwner($this) + ->find($con); + + if (null !== $criteria) { + if (false !== $this->collEmailAddressesRelatedByOwnerPartial && count($collEmailAddressesRelatedByOwner)) { + $this->initEmailAddressesRelatedByOwner(false); + + foreach ($collEmailAddressesRelatedByOwner as $obj) { + if (false == $this->collEmailAddressesRelatedByOwner->contains($obj)) { + $this->collEmailAddressesRelatedByOwner->append($obj); + } + } + + $this->collEmailAddressesRelatedByOwnerPartial = true; + } + + return $collEmailAddressesRelatedByOwner; + } + + if ($partial && $this->collEmailAddressesRelatedByOwner) { + foreach ($this->collEmailAddressesRelatedByOwner as $obj) { + if ($obj->isNew()) { + $collEmailAddressesRelatedByOwner[] = $obj; + } + } + } + + $this->collEmailAddressesRelatedByOwner = $collEmailAddressesRelatedByOwner; + $this->collEmailAddressesRelatedByOwnerPartial = false; + } + } + + return $this->collEmailAddressesRelatedByOwner; + } + + /** + * Sets a collection of ChildEmailAddress 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 $emailAddressesRelatedByOwner A Propel collection. + * @param ConnectionInterface $con Optional connection object + * @return $this|ChildUser The current object (for fluent API support) + */ + public function setEmailAddressesRelatedByOwner(Collection $emailAddressesRelatedByOwner, ConnectionInterface $con = null) + { + /** @var ChildEmailAddress[] $emailAddressesRelatedByOwnerToDelete */ + $emailAddressesRelatedByOwnerToDelete = $this->getEmailAddressesRelatedByOwner(new Criteria(), $con)->diff($emailAddressesRelatedByOwner); + + + $this->emailAddressesRelatedByOwnerScheduledForDeletion = $emailAddressesRelatedByOwnerToDelete; + + foreach ($emailAddressesRelatedByOwnerToDelete as $emailAddressRelatedByOwnerRemoved) { + $emailAddressRelatedByOwnerRemoved->setUserRelatedByOwner(null); + } + + $this->collEmailAddressesRelatedByOwner = null; + foreach ($emailAddressesRelatedByOwner as $emailAddressRelatedByOwner) { + $this->addEmailAddressRelatedByOwner($emailAddressRelatedByOwner); + } + + $this->collEmailAddressesRelatedByOwner = $emailAddressesRelatedByOwner; + $this->collEmailAddressesRelatedByOwnerPartial = false; + + return $this; + } + + /** + * Returns the number of related EmailAddress objects. + * + * @param Criteria $criteria + * @param boolean $distinct + * @param ConnectionInterface $con + * @return int Count of related EmailAddress objects. + * @throws PropelException + */ + public function countEmailAddressesRelatedByOwner(Criteria $criteria = null, $distinct = false, ConnectionInterface $con = null) + { + $partial = $this->collEmailAddressesRelatedByOwnerPartial && !$this->isNew(); + if (null === $this->collEmailAddressesRelatedByOwner || null !== $criteria || $partial) { + if ($this->isNew() && null === $this->collEmailAddressesRelatedByOwner) { + return 0; + } + + if ($partial && !$criteria) { + return count($this->getEmailAddressesRelatedByOwner()); + } + + $query = ChildEmailAddressQuery::create(null, $criteria); + if ($distinct) { + $query->distinct(); + } + + return $query + ->filterByUserRelatedByOwner($this) + ->count($con); + } + + return count($this->collEmailAddressesRelatedByOwner); + } + + /** + * Method called to associate a ChildEmailAddress object to this object + * through the ChildEmailAddress foreign key attribute. + * + * @param ChildEmailAddress $l ChildEmailAddress + * @return $this|\Eater\Glim\Model\User The current object (for fluent API support) + */ + public function addEmailAddressRelatedByOwner(ChildEmailAddress $l) + { + if ($this->collEmailAddressesRelatedByOwner === null) { + $this->initEmailAddressesRelatedByOwner(); + $this->collEmailAddressesRelatedByOwnerPartial = true; + } + + if (!$this->collEmailAddressesRelatedByOwner->contains($l)) { + $this->doAddEmailAddressRelatedByOwner($l); + } + + return $this; + } + + /** + * @param ChildEmailAddress $emailAddressRelatedByOwner The ChildEmailAddress object to add. + */ + protected function doAddEmailAddressRelatedByOwner(ChildEmailAddress $emailAddressRelatedByOwner) + { + $this->collEmailAddressesRelatedByOwner[]= $emailAddressRelatedByOwner; + $emailAddressRelatedByOwner->setUserRelatedByOwner($this); + } + + /** + * @param ChildEmailAddress $emailAddressRelatedByOwner The ChildEmailAddress object to remove. + * @return $this|ChildUser The current object (for fluent API support) + */ + public function removeEmailAddressRelatedByOwner(ChildEmailAddress $emailAddressRelatedByOwner) + { + if ($this->getEmailAddressesRelatedByOwner()->contains($emailAddressRelatedByOwner)) { + $pos = $this->collEmailAddressesRelatedByOwner->search($emailAddressRelatedByOwner); + $this->collEmailAddressesRelatedByOwner->remove($pos); + if (null === $this->emailAddressesRelatedByOwnerScheduledForDeletion) { + $this->emailAddressesRelatedByOwnerScheduledForDeletion = clone $this->collEmailAddressesRelatedByOwner; + $this->emailAddressesRelatedByOwnerScheduledForDeletion->clear(); + } + $this->emailAddressesRelatedByOwnerScheduledForDeletion[]= $emailAddressRelatedByOwner; + $emailAddressRelatedByOwner->setUserRelatedByOwner(null); + } + + return $this; + } + /** * Clears out the collCertificates collection * @@ -1956,6 +2323,9 @@ abstract class User implements ActiveRecordInterface */ public function clear() { + if (null !== $this->aEmailAddressRelatedByEmail) { + $this->aEmailAddressRelatedByEmail->removeUserRelatedByEmail($this); + } $this->id = null; $this->max_keys = null; $this->username = null; @@ -1983,6 +2353,11 @@ abstract class User implements ActiveRecordInterface public function clearAllReferences($deep = false) { if ($deep) { + if ($this->collEmailAddressesRelatedByOwner) { + foreach ($this->collEmailAddressesRelatedByOwner as $o) { + $o->clearAllReferences($deep); + } + } if ($this->collCertificates) { foreach ($this->collCertificates as $o) { $o->clearAllReferences($deep); @@ -1995,8 +2370,10 @@ abstract class User implements ActiveRecordInterface } } // if ($deep) + $this->collEmailAddressesRelatedByOwner = null; $this->collCertificates = null; $this->collInvites = null; + $this->aEmailAddressRelatedByEmail = null; } /** diff --git a/src/Model/Base/UserQuery.php b/src/Model/Base/UserQuery.php index 8b74113..934510d 100644 --- a/src/Model/Base/UserQuery.php +++ b/src/Model/Base/UserQuery.php @@ -16,7 +16,7 @@ use Propel\Runtime\Connection\ConnectionInterface; use Propel\Runtime\Exception\PropelException; /** - * Base class that represents a query for the 'User' table. + * Base class that represents a query for the 'user' table. * * * @@ -42,6 +42,14 @@ use Propel\Runtime\Exception\PropelException; * @method ChildUserQuery rightJoin($relation) Adds a RIGHT JOIN clause to the query * @method ChildUserQuery innerJoin($relation) Adds a INNER JOIN clause to the query * + * @method ChildUserQuery leftJoinEmailAddressRelatedByEmail($relationAlias = null) Adds a LEFT JOIN clause to the query using the EmailAddressRelatedByEmail relation + * @method ChildUserQuery rightJoinEmailAddressRelatedByEmail($relationAlias = null) Adds a RIGHT JOIN clause to the query using the EmailAddressRelatedByEmail relation + * @method ChildUserQuery innerJoinEmailAddressRelatedByEmail($relationAlias = null) Adds a INNER JOIN clause to the query using the EmailAddressRelatedByEmail relation + * + * @method ChildUserQuery leftJoinEmailAddressRelatedByOwner($relationAlias = null) Adds a LEFT JOIN clause to the query using the EmailAddressRelatedByOwner relation + * @method ChildUserQuery rightJoinEmailAddressRelatedByOwner($relationAlias = null) Adds a RIGHT JOIN clause to the query using the EmailAddressRelatedByOwner relation + * @method ChildUserQuery innerJoinEmailAddressRelatedByOwner($relationAlias = null) Adds a INNER JOIN clause to the query using the EmailAddressRelatedByOwner relation + * * @method ChildUserQuery leftJoinCertificate($relationAlias = null) Adds a LEFT JOIN clause to the query using the Certificate relation * @method ChildUserQuery rightJoinCertificate($relationAlias = null) Adds a RIGHT JOIN clause to the query using the Certificate relation * @method ChildUserQuery innerJoinCertificate($relationAlias = null) Adds a INNER JOIN clause to the query using the Certificate relation @@ -50,7 +58,7 @@ use Propel\Runtime\Exception\PropelException; * @method ChildUserQuery rightJoinInvite($relationAlias = null) Adds a RIGHT JOIN clause to the query using the Invite relation * @method ChildUserQuery innerJoinInvite($relationAlias = null) Adds a INNER JOIN clause to the query using the Invite relation * - * @method \Eater\Glim\Model\CertificateQuery|\Eater\Glim\Model\InviteQuery endUse() Finalizes a secondary criteria and merges it with its primary Criteria + * @method \Eater\Glim\Model\EmailAddressQuery|\Eater\Glim\Model\CertificateQuery|\Eater\Glim\Model\InviteQuery endUse() Finalizes a secondary criteria and merges it with its primary Criteria * * @method ChildUser findOne(ConnectionInterface $con = null) Return the first ChildUser matching the query * @method ChildUser findOneOrCreate(ConnectionInterface $con = null) Return the first ChildUser matching the query, or a new ChildUser object populated from the query conditions when no match is found @@ -58,7 +66,7 @@ use Propel\Runtime\Exception\PropelException; * @method ChildUser findOneById(int $id) Return the first ChildUser filtered by the id column * @method ChildUser findOneByMaxKeys(int $max_keys) Return the first ChildUser filtered by the max_keys column * @method ChildUser findOneByUsername(string $username) Return the first ChildUser filtered by the username column - * @method ChildUser findOneByEmail(string $email) Return the first ChildUser filtered by the email column + * @method ChildUser findOneByEmail(int $email) Return the first ChildUser filtered by the email column * @method ChildUser findOneByPassword(string $password) Return the first ChildUser filtered by the password column * @method ChildUser findOneBySuperuser(boolean $superuser) Return the first ChildUser filtered by the superuser column * @method ChildUser findOneByMaxInvites(int $max_invites) Return the first ChildUser filtered by the max_invites column @@ -70,7 +78,7 @@ use Propel\Runtime\Exception\PropelException; * @method ChildUser requireOneById(int $id) Return the first ChildUser filtered by the id column and throws \Propel\Runtime\Exception\EntityNotFoundException when not found * @method ChildUser requireOneByMaxKeys(int $max_keys) Return the first ChildUser filtered by the max_keys column and throws \Propel\Runtime\Exception\EntityNotFoundException when not found * @method ChildUser requireOneByUsername(string $username) Return the first ChildUser filtered by the username column and throws \Propel\Runtime\Exception\EntityNotFoundException when not found - * @method ChildUser requireOneByEmail(string $email) Return the first ChildUser filtered by the email column and throws \Propel\Runtime\Exception\EntityNotFoundException when not found + * @method ChildUser requireOneByEmail(int $email) Return the first ChildUser filtered by the email column and throws \Propel\Runtime\Exception\EntityNotFoundException when not found * @method ChildUser requireOneByPassword(string $password) Return the first ChildUser filtered by the password column and throws \Propel\Runtime\Exception\EntityNotFoundException when not found * @method ChildUser requireOneBySuperuser(boolean $superuser) Return the first ChildUser filtered by the superuser column and throws \Propel\Runtime\Exception\EntityNotFoundException when not found * @method ChildUser requireOneByMaxInvites(int $max_invites) Return the first ChildUser filtered by the max_invites column and throws \Propel\Runtime\Exception\EntityNotFoundException when not found @@ -80,7 +88,7 @@ use Propel\Runtime\Exception\PropelException; * @method ChildUser[]|ObjectCollection findById(int $id) Return ChildUser objects filtered by the id column * @method ChildUser[]|ObjectCollection findByMaxKeys(int $max_keys) Return ChildUser objects filtered by the max_keys column * @method ChildUser[]|ObjectCollection findByUsername(string $username) Return ChildUser objects filtered by the username column - * @method ChildUser[]|ObjectCollection findByEmail(string $email) Return ChildUser objects filtered by the email column + * @method ChildUser[]|ObjectCollection findByEmail(int $email) Return ChildUser objects filtered by the email column * @method ChildUser[]|ObjectCollection findByPassword(string $password) Return ChildUser objects filtered by the password column * @method ChildUser[]|ObjectCollection findBySuperuser(boolean $superuser) Return ChildUser objects filtered by the superuser column * @method ChildUser[]|ObjectCollection findByMaxInvites(int $max_invites) Return ChildUser objects filtered by the max_invites column @@ -177,7 +185,7 @@ abstract class UserQuery extends ModelCriteria */ protected function findPkSimple($key, ConnectionInterface $con) { - $sql = 'SELECT id, max_keys, username, email, password, superuser, max_invites, used_invites FROM User WHERE id = :p0'; + $sql = 'SELECT id, max_keys, username, email, password, superuser, max_invites, used_invites FROM user WHERE id = :p0'; try { $stmt = $con->prepare($sql); $stmt->bindValue(':p0', $key, PDO::PARAM_INT); @@ -383,24 +391,38 @@ abstract class UserQuery extends ModelCriteria * * Example usage: * - * $query->filterByEmail('fooValue'); // WHERE email = 'fooValue' - * $query->filterByEmail('%fooValue%'); // WHERE email LIKE '%fooValue%' + * $query->filterByEmail(1234); // WHERE email = 1234 + * $query->filterByEmail(array(12, 34)); // WHERE email IN (12, 34) + * $query->filterByEmail(array('min' => 12)); // WHERE email > 12 * * - * @param string $email The value to use as filter. - * Accepts wildcards (* and % trigger a LIKE) + * @see filterByEmailAddressRelatedByEmail() + * + * @param mixed $email The value to use as filter. + * Use scalar values for equality. + * Use array values for in_array() equivalent. + * Use associative array('min' => $minValue, 'max' => $maxValue) for intervals. * @param string $comparison Operator to use for the column comparison, defaults to Criteria::EQUAL * * @return $this|ChildUserQuery The current query, for fluid interface */ public function filterByEmail($email = null, $comparison = null) { - if (null === $comparison) { - if (is_array($email)) { + if (is_array($email)) { + $useMinMax = false; + if (isset($email['min'])) { + $this->addUsingAlias(UserTableMap::COL_EMAIL, $email['min'], Criteria::GREATER_EQUAL); + $useMinMax = true; + } + if (isset($email['max'])) { + $this->addUsingAlias(UserTableMap::COL_EMAIL, $email['max'], Criteria::LESS_EQUAL); + $useMinMax = true; + } + if ($useMinMax) { + return $this; + } + if (null === $comparison) { $comparison = Criteria::IN; - } elseif (preg_match('/[\%\*]/', $email)) { - $email = str_replace('*', '%', $email); - $comparison = Criteria::LIKE; } } @@ -545,6 +567,156 @@ abstract class UserQuery extends ModelCriteria return $this->addUsingAlias(UserTableMap::COL_USED_INVITES, $usedInvites, $comparison); } + /** + * Filter the query by a related \Eater\Glim\Model\EmailAddress object + * + * @param \Eater\Glim\Model\EmailAddress|ObjectCollection $emailAddress The related object(s) to use as filter + * @param string $comparison Operator to use for the column comparison, defaults to Criteria::EQUAL + * + * @throws \Propel\Runtime\Exception\PropelException + * + * @return ChildUserQuery The current query, for fluid interface + */ + public function filterByEmailAddressRelatedByEmail($emailAddress, $comparison = null) + { + if ($emailAddress instanceof \Eater\Glim\Model\EmailAddress) { + return $this + ->addUsingAlias(UserTableMap::COL_EMAIL, $emailAddress->getId(), $comparison); + } elseif ($emailAddress instanceof ObjectCollection) { + if (null === $comparison) { + $comparison = Criteria::IN; + } + + return $this + ->addUsingAlias(UserTableMap::COL_EMAIL, $emailAddress->toKeyValue('PrimaryKey', 'Id'), $comparison); + } else { + throw new PropelException('filterByEmailAddressRelatedByEmail() only accepts arguments of type \Eater\Glim\Model\EmailAddress or Collection'); + } + } + + /** + * Adds a JOIN clause to the query using the EmailAddressRelatedByEmail relation + * + * @param string $relationAlias optional alias for the relation + * @param string $joinType Accepted values are null, 'left join', 'right join', 'inner join' + * + * @return $this|ChildUserQuery The current query, for fluid interface + */ + public function joinEmailAddressRelatedByEmail($relationAlias = null, $joinType = Criteria::LEFT_JOIN) + { + $tableMap = $this->getTableMap(); + $relationMap = $tableMap->getRelation('EmailAddressRelatedByEmail'); + + // create a ModelJoin object for this join + $join = new ModelJoin(); + $join->setJoinType($joinType); + $join->setRelationMap($relationMap, $this->useAliasInSQL ? $this->getModelAlias() : null, $relationAlias); + if ($previousJoin = $this->getPreviousJoin()) { + $join->setPreviousJoin($previousJoin); + } + + // add the ModelJoin to the current object + if ($relationAlias) { + $this->addAlias($relationAlias, $relationMap->getRightTable()->getName()); + $this->addJoinObject($join, $relationAlias); + } else { + $this->addJoinObject($join, 'EmailAddressRelatedByEmail'); + } + + return $this; + } + + /** + * Use the EmailAddressRelatedByEmail relation EmailAddress object + * + * @see useQuery() + * + * @param string $relationAlias optional alias for the relation, + * to be used as main alias in the secondary query + * @param string $joinType Accepted values are null, 'left join', 'right join', 'inner join' + * + * @return \Eater\Glim\Model\EmailAddressQuery A secondary query class using the current class as primary query + */ + public function useEmailAddressRelatedByEmailQuery($relationAlias = null, $joinType = Criteria::LEFT_JOIN) + { + return $this + ->joinEmailAddressRelatedByEmail($relationAlias, $joinType) + ->useQuery($relationAlias ? $relationAlias : 'EmailAddressRelatedByEmail', '\Eater\Glim\Model\EmailAddressQuery'); + } + + /** + * Filter the query by a related \Eater\Glim\Model\EmailAddress object + * + * @param \Eater\Glim\Model\EmailAddress|ObjectCollection $emailAddress the related object to use as filter + * @param string $comparison Operator to use for the column comparison, defaults to Criteria::EQUAL + * + * @return ChildUserQuery The current query, for fluid interface + */ + public function filterByEmailAddressRelatedByOwner($emailAddress, $comparison = null) + { + if ($emailAddress instanceof \Eater\Glim\Model\EmailAddress) { + return $this + ->addUsingAlias(UserTableMap::COL_ID, $emailAddress->getOwner(), $comparison); + } elseif ($emailAddress instanceof ObjectCollection) { + return $this + ->useEmailAddressRelatedByOwnerQuery() + ->filterByPrimaryKeys($emailAddress->getPrimaryKeys()) + ->endUse(); + } else { + throw new PropelException('filterByEmailAddressRelatedByOwner() only accepts arguments of type \Eater\Glim\Model\EmailAddress or Collection'); + } + } + + /** + * Adds a JOIN clause to the query using the EmailAddressRelatedByOwner relation + * + * @param string $relationAlias optional alias for the relation + * @param string $joinType Accepted values are null, 'left join', 'right join', 'inner join' + * + * @return $this|ChildUserQuery The current query, for fluid interface + */ + public function joinEmailAddressRelatedByOwner($relationAlias = null, $joinType = Criteria::LEFT_JOIN) + { + $tableMap = $this->getTableMap(); + $relationMap = $tableMap->getRelation('EmailAddressRelatedByOwner'); + + // create a ModelJoin object for this join + $join = new ModelJoin(); + $join->setJoinType($joinType); + $join->setRelationMap($relationMap, $this->useAliasInSQL ? $this->getModelAlias() : null, $relationAlias); + if ($previousJoin = $this->getPreviousJoin()) { + $join->setPreviousJoin($previousJoin); + } + + // add the ModelJoin to the current object + if ($relationAlias) { + $this->addAlias($relationAlias, $relationMap->getRightTable()->getName()); + $this->addJoinObject($join, $relationAlias); + } else { + $this->addJoinObject($join, 'EmailAddressRelatedByOwner'); + } + + return $this; + } + + /** + * Use the EmailAddressRelatedByOwner relation EmailAddress object + * + * @see useQuery() + * + * @param string $relationAlias optional alias for the relation, + * to be used as main alias in the secondary query + * @param string $joinType Accepted values are null, 'left join', 'right join', 'inner join' + * + * @return \Eater\Glim\Model\EmailAddressQuery A secondary query class using the current class as primary query + */ + public function useEmailAddressRelatedByOwnerQuery($relationAlias = null, $joinType = Criteria::LEFT_JOIN) + { + return $this + ->joinEmailAddressRelatedByOwner($relationAlias, $joinType) + ->useQuery($relationAlias ? $relationAlias : 'EmailAddressRelatedByOwner', '\Eater\Glim\Model\EmailAddressQuery'); + } + /** * Filter the query by a related \Eater\Glim\Model\Certificate object * @@ -708,7 +880,7 @@ abstract class UserQuery extends ModelCriteria } /** - * Deletes all rows from the User table. + * Deletes all rows from the user table. * * @param ConnectionInterface $con the connection to use * @return int The number of affected rows (if supported by underlying database driver). diff --git a/src/Model/EmailAddress.php b/src/Model/EmailAddress.php new file mode 100644 index 0000000..dd596a1 --- /dev/null +++ b/src/Model/EmailAddress.php @@ -0,0 +1,23 @@ +setVerification(bin2hex(openssl_random_pseudo_bytes(32))); + } +} diff --git a/src/Model/EmailAddressQuery.php b/src/Model/EmailAddressQuery.php new file mode 100644 index 0000000..3513b78 --- /dev/null +++ b/src/Model/EmailAddressQuery.php @@ -0,0 +1,20 @@ +getRecipientEmailAddress()->getAddress(); + } + + public function getRecipientName() + { + return $this->getRecipientEmailAddress()->getUserRelatedByOwner()->getUsername(); + } + + public function getSenderName() { + $emailAddress = $this->getSenderEmailAddress(); + + if ($emailAddress === null) { + return 'Zer.ooo system'; + } + + return $emailAddress->getUserRelatedByOwner()->getUsername(); + } + + public function getSenderEmail() { + $emailAddress = $this->getSenderEmailAddress(); + + if ($emailAddress === null) { + return 'info@zer.ooo'; + } + + return $emailAddress->getAddress(); + } +} diff --git a/src/Model/EmailMessageQuery.php b/src/Model/EmailMessageQuery.php new file mode 100644 index 0000000..7f3e794 --- /dev/null +++ b/src/Model/EmailMessageQuery.php @@ -0,0 +1,20 @@ +setName('Certificate'); + $this->setName('certificate'); $this->setPhpName('Certificate'); $this->setIdentifierQuoting(false); $this->setClassName('\\Eater\\Glim\\Model\\Certificate'); @@ -162,7 +162,7 @@ class CertificateTableMap extends TableMap $this->setUseIdGenerator(true); // columns $this->addPrimaryKey('id', 'Id', 'INTEGER', true, null, null); - $this->addForeignKey('user_id', 'UserId', 'INTEGER', 'User', 'id', false, null, null); + $this->addForeignKey('user_id', 'UserId', 'INTEGER', 'user', 'id', false, null, null); $this->addColumn('name', 'Name', 'VARCHAR', false, 64, null); $this->addColumn('certificate', 'Certificate', 'LONGVARCHAR', false, null, null); $this->addColumn('private_key', 'PrivateKey', 'LONGVARCHAR', false, null, null); @@ -411,7 +411,7 @@ class CertificateTableMap extends TableMap } /** - * Deletes all rows from the Certificate table. + * Deletes all rows from the certificate table. * * @param ConnectionInterface $con the connection to use * @return int The number of affected rows (if supported by underlying database driver). diff --git a/src/Model/Map/EmailAddressTableMap.php b/src/Model/Map/EmailAddressTableMap.php new file mode 100644 index 0000000..572c74e --- /dev/null +++ b/src/Model/Map/EmailAddressTableMap.php @@ -0,0 +1,460 @@ + array('Id', 'Verified', 'Verification', 'Address', 'Owner', ), + self::TYPE_CAMELNAME => array('id', 'verified', 'verification', 'address', 'owner', ), + self::TYPE_COLNAME => array(EmailAddressTableMap::COL_ID, EmailAddressTableMap::COL_VERIFIED, EmailAddressTableMap::COL_VERIFICATION, EmailAddressTableMap::COL_ADDRESS, EmailAddressTableMap::COL_OWNER, ), + self::TYPE_FIELDNAME => array('id', 'verified', 'verification', 'address', 'owner', ), + self::TYPE_NUM => array(0, 1, 2, 3, 4, ) + ); + + /** + * holds an array of keys for quick access to the fieldnames array + * + * first dimension keys are the type constants + * e.g. self::$fieldKeys[self::TYPE_PHPNAME]['Id'] = 0 + */ + protected static $fieldKeys = array ( + self::TYPE_PHPNAME => array('Id' => 0, 'Verified' => 1, 'Verification' => 2, 'Address' => 3, 'Owner' => 4, ), + self::TYPE_CAMELNAME => array('id' => 0, 'verified' => 1, 'verification' => 2, 'address' => 3, 'owner' => 4, ), + self::TYPE_COLNAME => array(EmailAddressTableMap::COL_ID => 0, EmailAddressTableMap::COL_VERIFIED => 1, EmailAddressTableMap::COL_VERIFICATION => 2, EmailAddressTableMap::COL_ADDRESS => 3, EmailAddressTableMap::COL_OWNER => 4, ), + self::TYPE_FIELDNAME => array('id' => 0, 'verified' => 1, 'verification' => 2, 'address' => 3, 'owner' => 4, ), + self::TYPE_NUM => array(0, 1, 2, 3, 4, ) + ); + + /** + * Initialize the table attributes and columns + * Relations are not initialized by this method since they are lazy loaded + * + * @return void + * @throws PropelException + */ + public function initialize() + { + // attributes + $this->setName('email_address'); + $this->setPhpName('EmailAddress'); + $this->setIdentifierQuoting(false); + $this->setClassName('\\Eater\\Glim\\Model\\EmailAddress'); + $this->setPackage(''); + $this->setUseIdGenerator(true); + // columns + $this->addPrimaryKey('id', 'Id', 'INTEGER', true, null, null); + $this->addColumn('verified', 'Verified', 'BOOLEAN', false, null, false); + $this->addColumn('verification', 'Verification', 'VARCHAR', false, 64, null); + $this->addColumn('address', 'Address', 'VARCHAR', false, 256, null); + $this->addForeignKey('owner', 'Owner', 'INTEGER', 'user', 'id', false, null, null); + } // initialize() + + /** + * Build the RelationMap objects for this table relationships + */ + public function buildRelations() + { + $this->addRelation('UserRelatedByOwner', '\\Eater\\Glim\\Model\\User', RelationMap::MANY_TO_ONE, array ( + 0 => + array ( + 0 => ':owner', + 1 => ':id', + ), +), null, null, null, false); + $this->addRelation('UserRelatedByEmail', '\\Eater\\Glim\\Model\\User', RelationMap::ONE_TO_MANY, array ( + 0 => + array ( + 0 => ':email', + 1 => ':id', + ), +), null, null, 'UsersRelatedByEmail', false); + $this->addRelation('EmailMessageRelatedByRecipient', '\\Eater\\Glim\\Model\\EmailMessage', RelationMap::ONE_TO_MANY, array ( + 0 => + array ( + 0 => ':recipient', + 1 => ':id', + ), +), null, null, 'EmailMessagesRelatedByRecipient', false); + $this->addRelation('EmailMessageRelatedBySender', '\\Eater\\Glim\\Model\\EmailMessage', RelationMap::ONE_TO_MANY, array ( + 0 => + array ( + 0 => ':sender', + 1 => ':id', + ), +), null, null, 'EmailMessagesRelatedBySender', false); + } // buildRelations() + + /** + * Retrieves a string version of the primary key from the DB resultset row that can be used to uniquely identify a row in this table. + * + * For tables with a single-column primary key, that simple pkey value will be returned. For tables with + * a multi-column primary key, a serialize()d version of the primary key will be returned. + * + * @param array $row resultset row. + * @param int $offset The 0-based offset for reading from the resultset row. + * @param string $indexType One of the class type constants TableMap::TYPE_PHPNAME, TableMap::TYPE_CAMELNAME + * TableMap::TYPE_COLNAME, TableMap::TYPE_FIELDNAME, TableMap::TYPE_NUM + * + * @return string The primary key hash of the row + */ + public static function getPrimaryKeyHashFromRow($row, $offset = 0, $indexType = TableMap::TYPE_NUM) + { + // If the PK cannot be derived from the row, return NULL. + if ($row[TableMap::TYPE_NUM == $indexType ? 0 + $offset : static::translateFieldName('Id', TableMap::TYPE_PHPNAME, $indexType)] === null) { + return null; + } + + return (string) $row[TableMap::TYPE_NUM == $indexType ? 0 + $offset : static::translateFieldName('Id', TableMap::TYPE_PHPNAME, $indexType)]; + } + + /** + * Retrieves the primary key from the DB resultset row + * For tables with a single-column primary key, that simple pkey value will be returned. For tables with + * a multi-column primary key, an array of the primary key columns will be returned. + * + * @param array $row resultset row. + * @param int $offset The 0-based offset for reading from the resultset row. + * @param string $indexType One of the class type constants TableMap::TYPE_PHPNAME, TableMap::TYPE_CAMELNAME + * TableMap::TYPE_COLNAME, TableMap::TYPE_FIELDNAME, TableMap::TYPE_NUM + * + * @return mixed The primary key of the row + */ + public static function getPrimaryKeyFromRow($row, $offset = 0, $indexType = TableMap::TYPE_NUM) + { + return (int) $row[ + $indexType == TableMap::TYPE_NUM + ? 0 + $offset + : self::translateFieldName('Id', TableMap::TYPE_PHPNAME, $indexType) + ]; + } + + /** + * The class that the tableMap will make instances of. + * + * If $withPrefix is true, the returned path + * uses a dot-path notation which is translated into a path + * relative to a location on the PHP include_path. + * (e.g. path.to.MyClass -> 'path/to/MyClass.php') + * + * @param boolean $withPrefix Whether or not to return the path with the class name + * @return string path.to.ClassName + */ + public static function getOMClass($withPrefix = true) + { + return $withPrefix ? EmailAddressTableMap::CLASS_DEFAULT : EmailAddressTableMap::OM_CLASS; + } + + /** + * Populates an object of the default type or an object that inherit from the default. + * + * @param array $row row returned by DataFetcher->fetch(). + * @param int $offset The 0-based offset for reading from the resultset row. + * @param string $indexType The index type of $row. Mostly DataFetcher->getIndexType(). + One of the class type constants TableMap::TYPE_PHPNAME, TableMap::TYPE_CAMELNAME + * TableMap::TYPE_COLNAME, TableMap::TYPE_FIELDNAME, TableMap::TYPE_NUM. + * + * @throws PropelException Any exceptions caught during processing will be + * rethrown wrapped into a PropelException. + * @return array (EmailAddress object, last column rank) + */ + public static function populateObject($row, $offset = 0, $indexType = TableMap::TYPE_NUM) + { + $key = EmailAddressTableMap::getPrimaryKeyHashFromRow($row, $offset, $indexType); + if (null !== ($obj = EmailAddressTableMap::getInstanceFromPool($key))) { + // We no longer rehydrate the object, since this can cause data loss. + // See http://www.propelorm.org/ticket/509 + // $obj->hydrate($row, $offset, true); // rehydrate + $col = $offset + EmailAddressTableMap::NUM_HYDRATE_COLUMNS; + } else { + $cls = EmailAddressTableMap::OM_CLASS; + /** @var EmailAddress $obj */ + $obj = new $cls(); + $col = $obj->hydrate($row, $offset, false, $indexType); + EmailAddressTableMap::addInstanceToPool($obj, $key); + } + + return array($obj, $col); + } + + /** + * The returned array will contain objects of the default type or + * objects that inherit from the default. + * + * @param DataFetcherInterface $dataFetcher + * @return array + * @throws PropelException Any exceptions caught during processing will be + * rethrown wrapped into a PropelException. + */ + public static function populateObjects(DataFetcherInterface $dataFetcher) + { + $results = array(); + + // set the class once to avoid overhead in the loop + $cls = static::getOMClass(false); + // populate the object(s) + while ($row = $dataFetcher->fetch()) { + $key = EmailAddressTableMap::getPrimaryKeyHashFromRow($row, 0, $dataFetcher->getIndexType()); + if (null !== ($obj = EmailAddressTableMap::getInstanceFromPool($key))) { + // We no longer rehydrate the object, since this can cause data loss. + // See http://www.propelorm.org/ticket/509 + // $obj->hydrate($row, 0, true); // rehydrate + $results[] = $obj; + } else { + /** @var EmailAddress $obj */ + $obj = new $cls(); + $obj->hydrate($row); + $results[] = $obj; + EmailAddressTableMap::addInstanceToPool($obj, $key); + } // if key exists + } + + return $results; + } + /** + * Add all the columns needed to create a new object. + * + * Note: any columns that were marked with lazyLoad="true" in the + * XML schema will not be added to the select list and only loaded + * on demand. + * + * @param Criteria $criteria object containing the columns to add. + * @param string $alias optional table alias + * @throws PropelException Any exceptions caught during processing will be + * rethrown wrapped into a PropelException. + */ + public static function addSelectColumns(Criteria $criteria, $alias = null) + { + if (null === $alias) { + $criteria->addSelectColumn(EmailAddressTableMap::COL_ID); + $criteria->addSelectColumn(EmailAddressTableMap::COL_VERIFIED); + $criteria->addSelectColumn(EmailAddressTableMap::COL_VERIFICATION); + $criteria->addSelectColumn(EmailAddressTableMap::COL_ADDRESS); + $criteria->addSelectColumn(EmailAddressTableMap::COL_OWNER); + } else { + $criteria->addSelectColumn($alias . '.id'); + $criteria->addSelectColumn($alias . '.verified'); + $criteria->addSelectColumn($alias . '.verification'); + $criteria->addSelectColumn($alias . '.address'); + $criteria->addSelectColumn($alias . '.owner'); + } + } + + /** + * Returns the TableMap related to this object. + * This method is not needed for general use but a specific application could have a need. + * @return TableMap + * @throws PropelException Any exceptions caught during processing will be + * rethrown wrapped into a PropelException. + */ + public static function getTableMap() + { + return Propel::getServiceContainer()->getDatabaseMap(EmailAddressTableMap::DATABASE_NAME)->getTable(EmailAddressTableMap::TABLE_NAME); + } + + /** + * Add a TableMap instance to the database for this tableMap class. + */ + public static function buildTableMap() + { + $dbMap = Propel::getServiceContainer()->getDatabaseMap(EmailAddressTableMap::DATABASE_NAME); + if (!$dbMap->hasTable(EmailAddressTableMap::TABLE_NAME)) { + $dbMap->addTableObject(new EmailAddressTableMap()); + } + } + + /** + * Performs a DELETE on the database, given a EmailAddress or Criteria object OR a primary key value. + * + * @param mixed $values Criteria or EmailAddress object or primary key or array of primary keys + * which is used to create the DELETE statement + * @param ConnectionInterface $con the connection to use + * @return int The number of affected rows (if supported by underlying database driver). This includes CASCADE-related rows + * if supported by native driver or if emulated using Propel. + * @throws PropelException Any exceptions caught during processing will be + * rethrown wrapped into a PropelException. + */ + public static function doDelete($values, ConnectionInterface $con = null) + { + if (null === $con) { + $con = Propel::getServiceContainer()->getWriteConnection(EmailAddressTableMap::DATABASE_NAME); + } + + if ($values instanceof Criteria) { + // rename for clarity + $criteria = $values; + } elseif ($values instanceof \Eater\Glim\Model\EmailAddress) { // it's a model object + // create criteria based on pk values + $criteria = $values->buildPkeyCriteria(); + } else { // it's a primary key, or an array of pks + $criteria = new Criteria(EmailAddressTableMap::DATABASE_NAME); + $criteria->add(EmailAddressTableMap::COL_ID, (array) $values, Criteria::IN); + } + + $query = EmailAddressQuery::create()->mergeWith($criteria); + + if ($values instanceof Criteria) { + EmailAddressTableMap::clearInstancePool(); + } elseif (!is_object($values)) { // it's a primary key, or an array of pks + foreach ((array) $values as $singleval) { + EmailAddressTableMap::removeInstanceFromPool($singleval); + } + } + + return $query->delete($con); + } + + /** + * Deletes all rows from the email_address table. + * + * @param ConnectionInterface $con the connection to use + * @return int The number of affected rows (if supported by underlying database driver). + */ + public static function doDeleteAll(ConnectionInterface $con = null) + { + return EmailAddressQuery::create()->doDeleteAll($con); + } + + /** + * Performs an INSERT on the database, given a EmailAddress or Criteria object. + * + * @param mixed $criteria Criteria or EmailAddress object containing data that is used to create the INSERT statement. + * @param ConnectionInterface $con the ConnectionInterface connection to use + * @return mixed The new primary key. + * @throws PropelException Any exceptions caught during processing will be + * rethrown wrapped into a PropelException. + */ + public static function doInsert($criteria, ConnectionInterface $con = null) + { + if (null === $con) { + $con = Propel::getServiceContainer()->getWriteConnection(EmailAddressTableMap::DATABASE_NAME); + } + + if ($criteria instanceof Criteria) { + $criteria = clone $criteria; // rename for clarity + } else { + $criteria = $criteria->buildCriteria(); // build Criteria from EmailAddress object + } + + if ($criteria->containsKey(EmailAddressTableMap::COL_ID) && $criteria->keyContainsValue(EmailAddressTableMap::COL_ID) ) { + throw new PropelException('Cannot insert a value for auto-increment primary key ('.EmailAddressTableMap::COL_ID.')'); + } + + + // Set the correct dbName + $query = EmailAddressQuery::create()->mergeWith($criteria); + + // use transaction because $criteria could contain info + // for more than one table (I guess, conceivably) + return $con->transaction(function () use ($con, $query) { + return $query->doInsert($con); + }); + } + +} // EmailAddressTableMap +// This is the static code needed to register the TableMap for this table with the main Propel class. +// +EmailAddressTableMap::buildTableMap(); diff --git a/src/Model/Map/EmailMessageTableMap.php b/src/Model/Map/EmailMessageTableMap.php new file mode 100644 index 0000000..eade7c6 --- /dev/null +++ b/src/Model/Map/EmailMessageTableMap.php @@ -0,0 +1,425 @@ + array('Recipient', 'Sender', 'Contents', 'Subject', ), + self::TYPE_CAMELNAME => array('recipient', 'sender', 'contents', 'subject', ), + self::TYPE_COLNAME => array(EmailMessageTableMap::COL_RECIPIENT, EmailMessageTableMap::COL_SENDER, EmailMessageTableMap::COL_CONTENTS, EmailMessageTableMap::COL_SUBJECT, ), + self::TYPE_FIELDNAME => array('recipient', 'sender', 'contents', 'subject', ), + self::TYPE_NUM => array(0, 1, 2, 3, ) + ); + + /** + * holds an array of keys for quick access to the fieldnames array + * + * first dimension keys are the type constants + * e.g. self::$fieldKeys[self::TYPE_PHPNAME]['Id'] = 0 + */ + protected static $fieldKeys = array ( + self::TYPE_PHPNAME => array('Recipient' => 0, 'Sender' => 1, 'Contents' => 2, 'Subject' => 3, ), + self::TYPE_CAMELNAME => array('recipient' => 0, 'sender' => 1, 'contents' => 2, 'subject' => 3, ), + self::TYPE_COLNAME => array(EmailMessageTableMap::COL_RECIPIENT => 0, EmailMessageTableMap::COL_SENDER => 1, EmailMessageTableMap::COL_CONTENTS => 2, EmailMessageTableMap::COL_SUBJECT => 3, ), + self::TYPE_FIELDNAME => array('recipient' => 0, 'sender' => 1, 'contents' => 2, 'subject' => 3, ), + self::TYPE_NUM => array(0, 1, 2, 3, ) + ); + + /** + * Initialize the table attributes and columns + * Relations are not initialized by this method since they are lazy loaded + * + * @return void + * @throws PropelException + */ + public function initialize() + { + // attributes + $this->setName('email_message'); + $this->setPhpName('EmailMessage'); + $this->setIdentifierQuoting(false); + $this->setClassName('\\Eater\\Glim\\Model\\EmailMessage'); + $this->setPackage(''); + $this->setUseIdGenerator(false); + // columns + $this->addForeignKey('recipient', 'Recipient', 'INTEGER', 'email_address', 'id', false, null, null); + $this->addForeignKey('sender', 'Sender', 'INTEGER', 'email_address', 'id', false, null, null); + $this->addColumn('contents', 'Contents', 'LONGVARCHAR', false, null, null); + $this->addColumn('subject', 'Subject', 'VARCHAR', false, 256, null); + } // initialize() + + /** + * Build the RelationMap objects for this table relationships + */ + public function buildRelations() + { + $this->addRelation('RecipientEmailAddress', '\\Eater\\Glim\\Model\\EmailAddress', RelationMap::MANY_TO_ONE, array ( + 0 => + array ( + 0 => ':recipient', + 1 => ':id', + ), +), null, null, null, false); + $this->addRelation('SenderEmailAddress', '\\Eater\\Glim\\Model\\EmailAddress', RelationMap::MANY_TO_ONE, array ( + 0 => + array ( + 0 => ':sender', + 1 => ':id', + ), +), null, null, null, false); + } // buildRelations() + + /** + * Retrieves a string version of the primary key from the DB resultset row that can be used to uniquely identify a row in this table. + * + * For tables with a single-column primary key, that simple pkey value will be returned. For tables with + * a multi-column primary key, a serialize()d version of the primary key will be returned. + * + * @param array $row resultset row. + * @param int $offset The 0-based offset for reading from the resultset row. + * @param string $indexType One of the class type constants TableMap::TYPE_PHPNAME, TableMap::TYPE_CAMELNAME + * TableMap::TYPE_COLNAME, TableMap::TYPE_FIELDNAME, TableMap::TYPE_NUM + * + * @return string The primary key hash of the row + */ + public static function getPrimaryKeyHashFromRow($row, $offset = 0, $indexType = TableMap::TYPE_NUM) + { + return null; + } + + /** + * Retrieves the primary key from the DB resultset row + * For tables with a single-column primary key, that simple pkey value will be returned. For tables with + * a multi-column primary key, an array of the primary key columns will be returned. + * + * @param array $row resultset row. + * @param int $offset The 0-based offset for reading from the resultset row. + * @param string $indexType One of the class type constants TableMap::TYPE_PHPNAME, TableMap::TYPE_CAMELNAME + * TableMap::TYPE_COLNAME, TableMap::TYPE_FIELDNAME, TableMap::TYPE_NUM + * + * @return mixed The primary key of the row + */ + public static function getPrimaryKeyFromRow($row, $offset = 0, $indexType = TableMap::TYPE_NUM) + { + return ''; + } + + /** + * The class that the tableMap will make instances of. + * + * If $withPrefix is true, the returned path + * uses a dot-path notation which is translated into a path + * relative to a location on the PHP include_path. + * (e.g. path.to.MyClass -> 'path/to/MyClass.php') + * + * @param boolean $withPrefix Whether or not to return the path with the class name + * @return string path.to.ClassName + */ + public static function getOMClass($withPrefix = true) + { + return $withPrefix ? EmailMessageTableMap::CLASS_DEFAULT : EmailMessageTableMap::OM_CLASS; + } + + /** + * Populates an object of the default type or an object that inherit from the default. + * + * @param array $row row returned by DataFetcher->fetch(). + * @param int $offset The 0-based offset for reading from the resultset row. + * @param string $indexType The index type of $row. Mostly DataFetcher->getIndexType(). + One of the class type constants TableMap::TYPE_PHPNAME, TableMap::TYPE_CAMELNAME + * TableMap::TYPE_COLNAME, TableMap::TYPE_FIELDNAME, TableMap::TYPE_NUM. + * + * @throws PropelException Any exceptions caught during processing will be + * rethrown wrapped into a PropelException. + * @return array (EmailMessage object, last column rank) + */ + public static function populateObject($row, $offset = 0, $indexType = TableMap::TYPE_NUM) + { + $key = EmailMessageTableMap::getPrimaryKeyHashFromRow($row, $offset, $indexType); + if (null !== ($obj = EmailMessageTableMap::getInstanceFromPool($key))) { + // We no longer rehydrate the object, since this can cause data loss. + // See http://www.propelorm.org/ticket/509 + // $obj->hydrate($row, $offset, true); // rehydrate + $col = $offset + EmailMessageTableMap::NUM_HYDRATE_COLUMNS; + } else { + $cls = EmailMessageTableMap::OM_CLASS; + /** @var EmailMessage $obj */ + $obj = new $cls(); + $col = $obj->hydrate($row, $offset, false, $indexType); + EmailMessageTableMap::addInstanceToPool($obj, $key); + } + + return array($obj, $col); + } + + /** + * The returned array will contain objects of the default type or + * objects that inherit from the default. + * + * @param DataFetcherInterface $dataFetcher + * @return array + * @throws PropelException Any exceptions caught during processing will be + * rethrown wrapped into a PropelException. + */ + public static function populateObjects(DataFetcherInterface $dataFetcher) + { + $results = array(); + + // set the class once to avoid overhead in the loop + $cls = static::getOMClass(false); + // populate the object(s) + while ($row = $dataFetcher->fetch()) { + $key = EmailMessageTableMap::getPrimaryKeyHashFromRow($row, 0, $dataFetcher->getIndexType()); + if (null !== ($obj = EmailMessageTableMap::getInstanceFromPool($key))) { + // We no longer rehydrate the object, since this can cause data loss. + // See http://www.propelorm.org/ticket/509 + // $obj->hydrate($row, 0, true); // rehydrate + $results[] = $obj; + } else { + /** @var EmailMessage $obj */ + $obj = new $cls(); + $obj->hydrate($row); + $results[] = $obj; + EmailMessageTableMap::addInstanceToPool($obj, $key); + } // if key exists + } + + return $results; + } + /** + * Add all the columns needed to create a new object. + * + * Note: any columns that were marked with lazyLoad="true" in the + * XML schema will not be added to the select list and only loaded + * on demand. + * + * @param Criteria $criteria object containing the columns to add. + * @param string $alias optional table alias + * @throws PropelException Any exceptions caught during processing will be + * rethrown wrapped into a PropelException. + */ + public static function addSelectColumns(Criteria $criteria, $alias = null) + { + if (null === $alias) { + $criteria->addSelectColumn(EmailMessageTableMap::COL_RECIPIENT); + $criteria->addSelectColumn(EmailMessageTableMap::COL_SENDER); + $criteria->addSelectColumn(EmailMessageTableMap::COL_CONTENTS); + $criteria->addSelectColumn(EmailMessageTableMap::COL_SUBJECT); + } else { + $criteria->addSelectColumn($alias . '.recipient'); + $criteria->addSelectColumn($alias . '.sender'); + $criteria->addSelectColumn($alias . '.contents'); + $criteria->addSelectColumn($alias . '.subject'); + } + } + + /** + * Returns the TableMap related to this object. + * This method is not needed for general use but a specific application could have a need. + * @return TableMap + * @throws PropelException Any exceptions caught during processing will be + * rethrown wrapped into a PropelException. + */ + public static function getTableMap() + { + return Propel::getServiceContainer()->getDatabaseMap(EmailMessageTableMap::DATABASE_NAME)->getTable(EmailMessageTableMap::TABLE_NAME); + } + + /** + * Add a TableMap instance to the database for this tableMap class. + */ + public static function buildTableMap() + { + $dbMap = Propel::getServiceContainer()->getDatabaseMap(EmailMessageTableMap::DATABASE_NAME); + if (!$dbMap->hasTable(EmailMessageTableMap::TABLE_NAME)) { + $dbMap->addTableObject(new EmailMessageTableMap()); + } + } + + /** + * Performs a DELETE on the database, given a EmailMessage or Criteria object OR a primary key value. + * + * @param mixed $values Criteria or EmailMessage object or primary key or array of primary keys + * which is used to create the DELETE statement + * @param ConnectionInterface $con the connection to use + * @return int The number of affected rows (if supported by underlying database driver). This includes CASCADE-related rows + * if supported by native driver or if emulated using Propel. + * @throws PropelException Any exceptions caught during processing will be + * rethrown wrapped into a PropelException. + */ + public static function doDelete($values, ConnectionInterface $con = null) + { + if (null === $con) { + $con = Propel::getServiceContainer()->getWriteConnection(EmailMessageTableMap::DATABASE_NAME); + } + + if ($values instanceof Criteria) { + // rename for clarity + $criteria = $values; + } elseif ($values instanceof \Eater\Glim\Model\EmailMessage) { // it's a model object + // create criteria based on pk value + $criteria = $values->buildCriteria(); + } else { // it's a primary key, or an array of pks + throw new LogicException('The EmailMessage object has no primary key'); + } + + $query = EmailMessageQuery::create()->mergeWith($criteria); + + if ($values instanceof Criteria) { + EmailMessageTableMap::clearInstancePool(); + } elseif (!is_object($values)) { // it's a primary key, or an array of pks + foreach ((array) $values as $singleval) { + EmailMessageTableMap::removeInstanceFromPool($singleval); + } + } + + return $query->delete($con); + } + + /** + * Deletes all rows from the email_message table. + * + * @param ConnectionInterface $con the connection to use + * @return int The number of affected rows (if supported by underlying database driver). + */ + public static function doDeleteAll(ConnectionInterface $con = null) + { + return EmailMessageQuery::create()->doDeleteAll($con); + } + + /** + * Performs an INSERT on the database, given a EmailMessage or Criteria object. + * + * @param mixed $criteria Criteria or EmailMessage object containing data that is used to create the INSERT statement. + * @param ConnectionInterface $con the ConnectionInterface connection to use + * @return mixed The new primary key. + * @throws PropelException Any exceptions caught during processing will be + * rethrown wrapped into a PropelException. + */ + public static function doInsert($criteria, ConnectionInterface $con = null) + { + if (null === $con) { + $con = Propel::getServiceContainer()->getWriteConnection(EmailMessageTableMap::DATABASE_NAME); + } + + if ($criteria instanceof Criteria) { + $criteria = clone $criteria; // rename for clarity + } else { + $criteria = $criteria->buildCriteria(); // build Criteria from EmailMessage object + } + + + // Set the correct dbName + $query = EmailMessageQuery::create()->mergeWith($criteria); + + // use transaction because $criteria could contain info + // for more than one table (I guess, conceivably) + return $con->transaction(function () use ($con, $query) { + return $query->doInsert($con); + }); + } + +} // EmailMessageTableMap +// This is the static code needed to register the TableMap for this table with the main Propel class. +// +EmailMessageTableMap::buildTableMap(); diff --git a/src/Model/Map/InviteTableMap.php b/src/Model/Map/InviteTableMap.php index fab9b0f..0a00bcd 100644 --- a/src/Model/Map/InviteTableMap.php +++ b/src/Model/Map/InviteTableMap.php @@ -16,7 +16,7 @@ use Propel\Runtime\Map\TableMapTrait; /** - * This class defines the structure of the 'Invite' table. + * This class defines the structure of the 'invite' table. * * * @@ -44,7 +44,7 @@ class InviteTableMap extends TableMap /** * The table name for this class */ - const TABLE_NAME = 'Invite'; + const TABLE_NAME = 'invite'; /** * The related Propel class for this table @@ -74,17 +74,17 @@ class InviteTableMap extends TableMap /** * the column name for the id field */ - const COL_ID = 'Invite.id'; + const COL_ID = 'invite.id'; /** * the column name for the invite field */ - const COL_INVITE = 'Invite.invite'; + const COL_INVITE = 'invite.invite'; /** * the column name for the owner field */ - const COL_OWNER = 'Invite.owner'; + const COL_OWNER = 'invite.owner'; /** * The default string format for model objects of the related table @@ -129,7 +129,7 @@ class InviteTableMap extends TableMap public function initialize() { // attributes - $this->setName('Invite'); + $this->setName('invite'); $this->setPhpName('Invite'); $this->setIdentifierQuoting(false); $this->setClassName('\\Eater\\Glim\\Model\\Invite'); @@ -138,7 +138,7 @@ class InviteTableMap extends TableMap // columns $this->addPrimaryKey('id', 'Id', 'INTEGER', true, null, null); $this->addColumn('invite', 'Invite', 'VARCHAR', false, 64, null); - $this->addForeignKey('owner', 'Owner', 'INTEGER', 'User', 'id', false, null, null); + $this->addForeignKey('owner', 'Owner', 'INTEGER', 'user', 'id', false, null, null); } // initialize() /** @@ -371,7 +371,7 @@ class InviteTableMap extends TableMap } /** - * Deletes all rows from the Invite table. + * Deletes all rows from the invite table. * * @param ConnectionInterface $con the connection to use * @return int The number of affected rows (if supported by underlying database driver). diff --git a/src/Model/Map/ServerTableMap.php b/src/Model/Map/ServerTableMap.php index 681c3b3..2d60911 100644 --- a/src/Model/Map/ServerTableMap.php +++ b/src/Model/Map/ServerTableMap.php @@ -16,7 +16,7 @@ use Propel\Runtime\Map\TableMapTrait; /** - * This class defines the structure of the 'Server' table. + * This class defines the structure of the 'server' table. * * * @@ -44,7 +44,7 @@ class ServerTableMap extends TableMap /** * The table name for this class */ - const TABLE_NAME = 'Server'; + const TABLE_NAME = 'server'; /** * The related Propel class for this table @@ -74,77 +74,77 @@ class ServerTableMap extends TableMap /** * the column name for the id field */ - const COL_ID = 'Server.id'; + const COL_ID = 'server.id'; /** * the column name for the fqdn field */ - const COL_FQDN = 'Server.fqdn'; + const COL_FQDN = 'server.fqdn'; /** * the column name for the fingerprint field */ - const COL_FINGERPRINT = 'Server.fingerprint'; + const COL_FINGERPRINT = 'server.fingerprint'; /** * the column name for the public_key field */ - const COL_PUBLIC_KEY = 'Server.public_key'; + const COL_PUBLIC_KEY = 'server.public_key'; /** * the column name for the certificate field */ - const COL_CERTIFICATE = 'Server.certificate'; + const COL_CERTIFICATE = 'server.certificate'; /** * the column name for the location field */ - const COL_LOCATION = 'Server.location'; + const COL_LOCATION = 'server.location'; /** * the column name for the speed field */ - const COL_SPEED = 'Server.speed'; + const COL_SPEED = 'server.speed'; /** * the column name for the external_ip field */ - const COL_EXTERNAL_IP = 'Server.external_ip'; + const COL_EXTERNAL_IP = 'server.external_ip'; /** * the column name for the internal_ip field */ - const COL_INTERNAL_IP = 'Server.internal_ip'; + const COL_INTERNAL_IP = 'server.internal_ip'; /** * the column name for the netmask field */ - const COL_NETMASK = 'Server.netmask'; + const COL_NETMASK = 'server.netmask'; /** * the column name for the first_dns field */ - const COL_FIRST_DNS = 'Server.first_dns'; + const COL_FIRST_DNS = 'server.first_dns'; /** * the column name for the second_dns field */ - const COL_SECOND_DNS = 'Server.second_dns'; + const COL_SECOND_DNS = 'server.second_dns'; /** * the column name for the port field */ - const COL_PORT = 'Server.port'; + const COL_PORT = 'server.port'; /** * the column name for the protocol field */ - const COL_PROTOCOL = 'Server.protocol'; + const COL_PROTOCOL = 'server.protocol'; /** * the column name for the status field */ - const COL_STATUS = 'Server.status'; + const COL_STATUS = 'server.status'; /** * The default string format for model objects of the related table @@ -232,7 +232,7 @@ class ServerTableMap extends TableMap public function initialize() { // attributes - $this->setName('Server'); + $this->setName('server'); $this->setPhpName('Server'); $this->setIdentifierQuoting(false); $this->setClassName('\\Eater\\Glim\\Model\\Server'); @@ -512,7 +512,7 @@ class ServerTableMap extends TableMap } /** - * Deletes all rows from the Server table. + * Deletes all rows from the server table. * * @param ConnectionInterface $con the connection to use * @return int The number of affected rows (if supported by underlying database driver). diff --git a/src/Model/Map/UserTableMap.php b/src/Model/Map/UserTableMap.php index 97b4a25..ae07174 100644 --- a/src/Model/Map/UserTableMap.php +++ b/src/Model/Map/UserTableMap.php @@ -16,7 +16,7 @@ use Propel\Runtime\Map\TableMapTrait; /** - * This class defines the structure of the 'User' table. + * This class defines the structure of the 'user' table. * * * @@ -44,7 +44,7 @@ class UserTableMap extends TableMap /** * The table name for this class */ - const TABLE_NAME = 'User'; + const TABLE_NAME = 'user'; /** * The related Propel class for this table @@ -74,42 +74,42 @@ class UserTableMap extends TableMap /** * the column name for the id field */ - const COL_ID = 'User.id'; + const COL_ID = 'user.id'; /** * the column name for the max_keys field */ - const COL_MAX_KEYS = 'User.max_keys'; + const COL_MAX_KEYS = 'user.max_keys'; /** * the column name for the username field */ - const COL_USERNAME = 'User.username'; + const COL_USERNAME = 'user.username'; /** * the column name for the email field */ - const COL_EMAIL = 'User.email'; + const COL_EMAIL = 'user.email'; /** * the column name for the password field */ - const COL_PASSWORD = 'User.password'; + const COL_PASSWORD = 'user.password'; /** * the column name for the superuser field */ - const COL_SUPERUSER = 'User.superuser'; + const COL_SUPERUSER = 'user.superuser'; /** * the column name for the max_invites field */ - const COL_MAX_INVITES = 'User.max_invites'; + const COL_MAX_INVITES = 'user.max_invites'; /** * the column name for the used_invites field */ - const COL_USED_INVITES = 'User.used_invites'; + const COL_USED_INVITES = 'user.used_invites'; /** * The default string format for model objects of the related table @@ -154,7 +154,7 @@ class UserTableMap extends TableMap public function initialize() { // attributes - $this->setName('User'); + $this->setName('user'); $this->setPhpName('User'); $this->setIdentifierQuoting(false); $this->setClassName('\\Eater\\Glim\\Model\\User'); @@ -164,7 +164,7 @@ class UserTableMap extends TableMap $this->addPrimaryKey('id', 'Id', 'INTEGER', true, null, null); $this->addColumn('max_keys', 'MaxKeys', 'INTEGER', false, null, 5); $this->addColumn('username', 'Username', 'VARCHAR', false, 64, null); - $this->addColumn('email', 'Email', 'VARCHAR', false, 256, null); + $this->addForeignKey('email', 'Email', 'INTEGER', 'email_address', 'id', false, null, null); $this->addColumn('password', 'Password', 'VARCHAR', false, 64, null); $this->addColumn('superuser', 'Superuser', 'BOOLEAN', false, null, false); $this->addColumn('max_invites', 'MaxInvites', 'INTEGER', false, null, 0); @@ -176,6 +176,20 @@ class UserTableMap extends TableMap */ public function buildRelations() { + $this->addRelation('EmailAddressRelatedByEmail', '\\Eater\\Glim\\Model\\EmailAddress', RelationMap::MANY_TO_ONE, array ( + 0 => + array ( + 0 => ':email', + 1 => ':id', + ), +), null, null, null, false); + $this->addRelation('EmailAddressRelatedByOwner', '\\Eater\\Glim\\Model\\EmailAddress', RelationMap::ONE_TO_MANY, array ( + 0 => + array ( + 0 => ':owner', + 1 => ':id', + ), +), null, null, 'EmailAddressesRelatedByOwner', false); $this->addRelation('Certificate', '\\Eater\\Glim\\Model\\Certificate', RelationMap::ONE_TO_MANY, array ( 0 => array ( @@ -418,7 +432,7 @@ class UserTableMap extends TableMap } /** - * Deletes all rows from the User table. + * Deletes all rows from the user table. * * @param ConnectionInterface $con the connection to use * @return int The number of affected rows (if supported by underlying database driver).