/**
* 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 BasePeer::TYPE_PHPNAME, BasePeer::TYPE_STUDLYPHPNAME,
* BasePeer::TYPE_COLNAME, BasePeer::TYPE_FIELDNAME, BasePeer::TYPE_NUM.
* The default key type is the column's BasePeer::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 = BasePeer::TYPE_PHPNAME)
{
$keys = SystemEventSubscriptionPeer::getFieldNames($keyType);
if (array_key_exists($keys[0], $arr)) {
$this->setId($arr[$keys[0]]);
}
if (array_key_exists($keys[1], $arr)) {
$this->setSystemEventId($arr[$keys[1]]);
}
if (array_key_exists($keys[2], $arr)) {
$this->setUserId($arr[$keys[2]]);
}
if (array_key_exists($keys[3], $arr)) {
$this->setType($arr[$keys[3]]);
}
if (array_key_exists($keys[4], $arr)) {
$this->setRemoteUrl($arr[$keys[4]]);
}
if (array_key_exists($keys[5], $arr)) {
$this->setSubject($arr[$keys[5]]);
}
if (array_key_exists($keys[6], $arr)) {
$this->setTemplate($arr[$keys[6]]);
}
if (array_key_exists($keys[7], $arr)) {
$this->setAuthorizationToken($arr[$keys[7]]);
}
if (array_key_exists($keys[8], $arr)) {
$this->setEnabled($arr[$keys[8]]);
}
if (array_key_exists($keys[9], $arr)) {
$this->setCreatedAt($arr[$keys[9]]);
}
if (array_key_exists($keys[10], $arr)) {
$this->setUpdatedAt($arr[$keys[10]]);
}
}
/**
* This is a method for emulating ON DELETE CASCADE for DBs that don't support this
* feature (like MySQL or SQLite).
*
* This method is not very speedy because it must perform a query first to get
* the implicated records and then perform the deletes by calling those Peer classes.
*
* This method should be used within a transaction if possible.
*
* @param Criteria $criteria
* @param PropelPDO $con
* @return int The number of affected rows (if supported by underlying database driver).
*/
protected static function doOnDeleteCascade(Criteria $criteria, PropelPDO $con)
{
// initialize var to track total num of affected rows
$affectedRows = 0;
// first find the objects that are implicated by the $criteria
$objects = SystemEventPeer::doSelect($criteria, $con);
foreach ($objects as $obj) {
// delete related SystemEventSubscription objects
$criteria = new Criteria(SystemEventSubscriptionPeer::DATABASE_NAME);
$criteria->add(SystemEventSubscriptionPeer::SYSTEM_EVENT_ID, $obj->getId());
$affectedRows += SystemEventSubscriptionPeer::doDelete($criteria, $con);
// delete related SystemEventInstance objects
$criteria = new Criteria(SystemEventInstancePeer::DATABASE_NAME);
$criteria->add(SystemEventInstancePeer::SYSTEM_EVENT_ID, $obj->getId());
$affectedRows += SystemEventInstancePeer::doDelete($criteria, $con);
}
return $affectedRows;
}
/**
* Filter the query on the type column
*
* @param mixed $type The value to use as filter
* @param string $comparison Operator to use for the column comparison, defaults to Criteria::EQUAL
*
* @return SystemEventSubscriptionQuery The current query, for fluid interface
* @throws PropelException - if the value is not accepted by the enum.
*/
public function filterByType($type = null, $comparison = null)
{
$valueSet = SystemEventSubscriptionPeer::getValueSet(SystemEventSubscriptionPeer::TYPE);
if (is_scalar($type)) {
if (!in_array($type, $valueSet)) {
throw new PropelException(sprintf('Value "%s" is not accepted in this enumerated column', $type));
}
$type = array_search($type, $valueSet);
} elseif (is_array($type)) {
$convertedValues = array();
foreach ($type as $value) {
if (!in_array($value, $valueSet)) {
throw new PropelException(sprintf('Value "%s" is not accepted in this enumerated column', $value));
}
$convertedValues[] = array_search($value, $valueSet);
}
$type = $convertedValues;
if (null === $comparison) {
$comparison = Criteria::IN;
}
}
return $this->addUsingAlias(SystemEventSubscriptionPeer::TYPE, $type, $comparison);
}
/**
* Triggers a system event.
*
* This will create a SystemEventInstance instance and notify any remote
* systems if they have active SystemEventSubscription objects.
*
* Each subscriber will be sent a unique SystemEventInstanceMessage.
*
* eg.
*
* $message = new stdClass();
* $message->user_id = 54;
* $message->city = 'Vancouver';
* \SystemEventPeer::triggerEvent( 'new_user_signed_up', $message );
*
*
*
* @param string $event_unique_key
* @param stdClass $message
* @param integer $user_id
*
* @throws \Exception if system event is not known
* @throws \Exception if $message is not a stdClass (if not null)
* @throws \Exception if $user_id is provided (not null) but not found
*
* @return SystemEventInstance
*/
public static function triggerEvent($event_unique_key, $message = null, $user_id = null)
{
//validate the arguments
$system_event = \SystemEventPeer::retrieveByUniqueKey($event_unique_key);
if (!$system_event) {
throw new \Exception('Unknown System Event: ' . $event_unique_key);
}
if (!is_null($message)) {
if (!$message instanceof \stdClass) {
throw new \Exception('Message must be a stdClass.');
}
} else {
$message = new \stdClass();
}
if (!is_null($user_id)) {
$user = \UserPeer::retrieveByPK($user_id);
if (!$user) {
throw new \Exception('Unknown User.');
}
} else {
$user = \sfContext::getInstance()->getUser()->getProfile();
if (!$user) {
throw new \Exception('User must be logged in or you must provide a user_id to triggerError()');
}
$user_id = $user->getId();
}
//record the event
$system_event_instance = new \SystemEventInstance();
$system_event_instance->setMessage(json_encode($message));
if (isset($user)) {
$system_event_instance->setUser($user);
}
$system_event_instance->setSystemEvent($system_event);
$system_event_instance->save();
//get the subscribers for this event
$system_event_subscriptions = \SystemEventSubscriptionPeer::getSubscriptionsForEvent($system_event->getId(), $user_id);
//notify each of the subscribers
foreach ($system_event_subscriptions as $system_event_subscription) {
$system_event_subscription->saveSystemEventNotification($system_event_instance);
}
}
/**
* Retrieve multiple objects by pkey.
*
* @param array $pks List of primary keys
* @param PropelPDO $con the connection to use
* @return SystemEventSubscription[]
* @throws PropelException Any exceptions caught during processing will be
* rethrown wrapped into a PropelException.
*/
public static function retrieveByPKs($pks, PropelPDO $con = null)
{
if ($con === null) {
$con = Propel::getConnection(SystemEventSubscriptionPeer::DATABASE_NAME, Propel::CONNECTION_READ);
}
$objs = null;
if (empty($pks)) {
$objs = array();
} else {
$criteria = new Criteria(SystemEventSubscriptionPeer::DATABASE_NAME);
$criteria->add(SystemEventSubscriptionPeer::ID, $pks, Criteria::IN);
$objs = SystemEventSubscriptionPeer::doSelect($criteria, $con);
}
return $objs;
}
/**
* Selects a collection of SystemEventInstanceMessage objects pre-filled with all related objects except SystemEventInstance.
*
* @param Criteria $criteria
* @param PropelPDO $con
* @param String $join_behavior the type of joins to use, defaults to Criteria::LEFT_JOIN
* @return array Array of SystemEventInstanceMessage objects.
* @throws PropelException Any exceptions caught during processing will be
* rethrown wrapped into a PropelException.
*/
public static function doSelectJoinAllExceptSystemEventInstance(Criteria $criteria, $con = null, $join_behavior = Criteria::LEFT_JOIN)
{
$criteria = clone $criteria;
// Set the correct dbName if it has not been overridden
// $criteria->getDbName() will return the same object if not set to another value
// so == check is okay and faster
if ($criteria->getDbName() == Propel::getDefaultDB()) {
$criteria->setDbName(self::DATABASE_NAME);
}
SystemEventInstanceMessagePeer::addSelectColumns($criteria);
$startcol2 = SystemEventInstanceMessagePeer::NUM_HYDRATE_COLUMNS;
SystemEventSubscriptionPeer::addSelectColumns($criteria);
$startcol3 = $startcol2 + SystemEventSubscriptionPeer::NUM_HYDRATE_COLUMNS;
$criteria->addJoin(SystemEventInstanceMessagePeer::SYSTEM_EVENT_SUBSCRIPTION_ID, SystemEventSubscriptionPeer::ID, $join_behavior);
// symfony_behaviors behavior
foreach (sfMixer::getCallables(self::getMixerPreSelectHook(__FUNCTION__)) as $sf_hook) {
call_user_func($sf_hook, 'BaseSystemEventInstanceMessagePeer', $criteria, $con);
}
$stmt = BasePeer::doSelect($criteria, $con);
$results = array();
while ($row = $stmt->fetch(PDO::FETCH_NUM)) {
$key1 = SystemEventInstanceMessagePeer::getPrimaryKeyHashFromRow($row, 0);
if (null !== ($obj1 = SystemEventInstanceMessagePeer::getInstanceFromPool($key1))) {
// We no longer rehydrate the object, since this can cause data loss.
// See http://www.propelorm.org/ticket/509
// $obj1->hydrate($row, 0, true); // rehydrate
} else {
$cls = SystemEventInstanceMessagePeer::getOMClass();
$obj1 = new $cls();
$obj1->hydrate($row);
SystemEventInstanceMessagePeer::addInstanceToPool($obj1, $key1);
}
// if obj1 already loaded
// Add objects for joined SystemEventSubscription rows
$key2 = SystemEventSubscriptionPeer::getPrimaryKeyHashFromRow($row, $startcol2);
if ($key2 !== null) {
$obj2 = SystemEventSubscriptionPeer::getInstanceFromPool($key2);
if (!$obj2) {
$cls = SystemEventSubscriptionPeer::getOMClass();
$obj2 = new $cls();
$obj2->hydrate($row, $startcol2);
SystemEventSubscriptionPeer::addInstanceToPool($obj2, $key2);
}
// if $obj2 already loaded
// Add the $obj1 (SystemEventInstanceMessage) to the collection in $obj2 (SystemEventSubscription)
$obj2->addSystemEventInstanceMessage($obj1);
}
// if joined row is not null
$results[] = $obj1;
}
$stmt->closeCursor();
return $results;
}