/**
* Get the associated ChildMenuItemI18n object
*
* @param ConnectionInterface $con Optional Connection object.
* @return ChildMenuItemI18n The associated ChildMenuItemI18n object.
* @throws PropelException
*/
public function getMenuItemI18n(ConnectionInterface $con = null)
{
if ($this->aMenuItemI18n === null && $this->id !== null) {
$this->aMenuItemI18n = ChildMenuItemI18nQuery::create()->findPk($this->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->aMenuItemI18n->addMenuItemI18nVersions($this);
*/
}
return $this->aMenuItemI18n;
}
/**
* Checks whether the current state must be recorded as a version
*
* @return boolean
*/
public function isVersioningNecessary($con = null)
{
if ($this->alreadyInSave) {
return false;
}
if ($this->enforceVersion) {
return true;
}
if (ChildMenuItemI18nQuery::isVersioningEnabled() && ($this->isNew() || $this->isModified()) || $this->isDeleted()) {
return true;
}
return false;
}
/**
* Performs an INSERT on the database, given a MenuItemI18n or Criteria object.
*
* @param mixed $criteria Criteria or MenuItemI18n 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(MenuItemI18nTableMap::DATABASE_NAME);
}
if ($criteria instanceof Criteria) {
$criteria = clone $criteria;
// rename for clarity
} else {
$criteria = $criteria->buildCriteria();
// build Criteria from MenuItemI18n object
}
// Set the correct dbName
$query = MenuItemI18nQuery::create()->mergeWith($criteria);
try {
// use transaction because $criteria could contain info
// for more than one table (I guess, conceivably)
$con->beginTransaction();
$pk = $query->doInsert($con);
$con->commit();
} catch (PropelException $e) {
$con->rollBack();
throw $e;
}
return $pk;
}