/**
* 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 = ChildRoutineQuery::create();
$criteria->add(RoutineTableMap::COL_ID, $this->id);
return $criteria;
}
/**
* Returns one Routine with the given id from cache
*
* @param mixed $id
* @return Routine|null
*/
protected function get($id)
{
if ($this->pool === null) {
$this->pool = new Map();
} else {
if ($this->pool->has($id)) {
return $this->pool->get($id);
}
}
$model = RoutineQuery::create()->findOneById($id);
$this->pool->set($id, $model);
return $model;
}
/**
* Performs an INSERT on the database, given a Routine or Criteria object.
*
* @param mixed $criteria Criteria or Routine 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(RoutineTableMap::DATABASE_NAME);
}
if ($criteria instanceof Criteria) {
$criteria = clone $criteria;
// rename for clarity
} else {
$criteria = $criteria->buildCriteria();
// build Criteria from Routine object
}
if ($criteria->containsKey(RoutineTableMap::COL_ID) && $criteria->keyContainsValue(RoutineTableMap::COL_ID)) {
throw new PropelException('Cannot insert a value for auto-increment primary key (' . RoutineTableMap::COL_ID . ')');
}
// Set the correct dbName
$query = RoutineQuery::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);
});
}
/**
* Get the associated ChildRoutine object
*
* @param ConnectionInterface $con Optional Connection object.
* @return ChildRoutine The associated ChildRoutine object.
* @throws PropelException
*/
public function getRoutine(ConnectionInterface $con = null)
{
if ($this->aRoutine === null && $this->routine_id !== null) {
$this->aRoutine = ChildRoutineQuery::create()->findPk($this->routine_id, $con);
/* The following can be used additionally to
guarantee the related object contains a reference
to this object. This level of coupling may, however, be
undesirable since it could result in an only partially populated collection
in the referenced object.
$this->aRoutine->addPerformanceScores($this);
*/
}
return $this->aRoutine;
}
/**
* If this collection has already been initialized with
* an identical criteria, it returns the collection.
* Otherwise if this Startgroup is new, it will return
* an empty collection; or if this Startgroup has previously
* been saved, it will retrieve related Routines from storage.
*
* This method is protected by default in order to keep the public
* api reasonable. You can provide public methods for those you
* actually need in Startgroup.
*
* @param Criteria $criteria optional Criteria object to narrow the query
* @param ConnectionInterface $con optional connection object
* @param string $joinBehavior optional join type to use (defaults to Criteria::LEFT_JOIN)
* @return ObjectCollection|ChildRoutine[] List of ChildRoutine objects
*/
public function getRoutinesJoinPerformanceMusicAndTimingStatistic(Criteria $criteria = null, ConnectionInterface $con = null, $joinBehavior = Criteria::LEFT_JOIN)
{
$query = ChildRoutineQuery::create(null, $criteria);
$query->joinWith('PerformanceMusicAndTimingStatistic', $joinBehavior);
return $this->getRoutines($query, $con);
}
/**
* Updates Routines on Startgroup
*
* @param mixed $id
* @param mixed $data
* @return PayloadInterface
*/
public function updateRoutines($id, $data)
{
// find
$model = $this->get($id);
if ($model === null) {
return new NotFound(['message' => 'Startgroup not found.']);
}
// remove all relationships before
RoutineQuery::create()->filterByStartgroup($model)->delete();
// add them
$errors = [];
foreach ($data as $entry) {
if (!isset($entry['id'])) {
$errors[] = 'Missing id for Routine';
}
$related = RoutineQuery::create()->findOneById($entry['id']);
$model->addRoutine($related);
}
if (count($errors) > 0) {
return new NotValid(['errors' => $errors]);
}
// save and dispatch events
$event = new StartgroupEvent($model);
$dispatcher = $this->getServiceContainer()->getDispatcher();
$dispatcher->dispatch(StartgroupEvent::PRE_ROUTINES_UPDATE, $event);
$dispatcher->dispatch(StartgroupEvent::PRE_SAVE, $event);
$rows = $model->save();
$dispatcher->dispatch(StartgroupEvent::POST_ROUTINES_UPDATE, $event);
$dispatcher->dispatch(StartgroupEvent::POST_SAVE, $event);
if ($rows > 0) {
return Updated(['model' => $model]);
}
return NotUpdated(['model' => $model]);
}