/**
* Get the associated ChildUser object
*
* @param ConnectionInterface $con Optional Connection object.
* @return ChildUser The associated ChildUser object.
* @throws PropelException
*/
public function getUser(ConnectionInterface $con = null)
{
if ($this->aUser === null && $this->user_id !== null) {
$this->aUser = ChildUserQuery::create()->findPk($this->user_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->aUser->addConnections($this);
*/
}
return $this->aUser;
}
/**
* Returns all users found so far for the specified instance name
*
* @param string $instanceName
*
* @return User[]
*/
private function getUsers($instanceName)
{
$ignoredUsers = $this->configuration->getInstanceByName($instanceName)->getIgnoredUsers();
return UserQuery::create()->filterIgnoredUsers($ignoredUsers)->findByInstanceName($instanceName)->getArrayCopy();
}
/**
* Performs an INSERT on the database, given a User or Criteria object.
*
* @param mixed $criteria Criteria or User 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(UserTableMap::DATABASE_NAME);
}
if ($criteria instanceof Criteria) {
$criteria = clone $criteria;
// rename for clarity
} else {
$criteria = $criteria->buildCriteria();
// build Criteria from User object
}
if ($criteria->containsKey(UserTableMap::COL_ID) && $criteria->keyContainsValue(UserTableMap::COL_ID)) {
throw new PropelException('Cannot insert a value for auto-increment primary key (' . UserTableMap::COL_ID . ')');
}
// Set the correct dbName
$query = UserQuery::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);
});
}
/**
* 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 countUsers(Criteria $criteria = null, $distinct = false, ConnectionInterface $con = null)
{
$partial = $this->collUsersPartial && !$this->isNew();
if (null === $this->collUsers || null !== $criteria || $partial) {
if ($this->isNew() && null === $this->collUsers) {
return 0;
}
if ($partial && !$criteria) {
return count($this->getUsers());
}
$query = ChildUserQuery::create(null, $criteria);
if ($distinct) {
$query->distinct();
}
return $query->filterByInstance($this)->count($con);
}
return count($this->collUsers);
}
/**
* 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 = ChildUserQuery::create();
$criteria->add(UserTableMap::COL_ID, $this->id);
return $criteria;
}
/**
* @param string $instanceName
* @param string $userName
*
* @throws \Propel\Runtime\Exception\PropelException
*/
private function onUserSeen($instanceName, $userName)
{
if (UserQuery::create()->hasUser($instanceName, $userName)) {
return;
}
$user = new User();
$user->setInstanceName($instanceName)->setName($userName);
$user->save();
$this->logger->info('Stored new user (instance: {instanceName}, username: {userName})', ['instanceName' => $instanceName, 'userName' => $userName]);
}
/**
* Returns a new ChildUserQuery object.
*
* @param string $modelAlias The alias of a model in the query
* @param Criteria $criteria Optional Criteria to build the query from
*
* @return ChildUserQuery
*/
public static function create($modelAlias = null, Criteria $criteria = null)
{
if ($criteria instanceof ChildUserQuery) {
return $criteria;
}
$query = new ChildUserQuery();
if (null !== $modelAlias) {
$query->setModelAlias($modelAlias);
}
if ($criteria instanceof Criteria) {
$query->mergeWith($criteria);
}
return $query;
}
