/**
* Retrieve object using using composite pkey values.
* @param int $article_id
* @param int $author_id
* @param PropelPDO $con
* @return ArticleAuthor
*/
public static function retrieveByPK($article_id, $author_id, PropelPDO $con = null)
{
$key = serialize(array((string) $article_id, (string) $author_id));
if (null !== ($obj = ArticleAuthorPeer::getInstanceFromPool($key))) {
return $obj;
}
if ($con === null) {
$con = Propel::getConnection(ArticleAuthorPeer::DATABASE_NAME, Propel::CONNECTION_READ);
}
$criteria = new Criteria(ArticleAuthorPeer::DATABASE_NAME);
$criteria->add(ArticleAuthorPeer::ARTICLE_ID, $article_id);
$criteria->add(ArticleAuthorPeer::AUTHOR_ID, $author_id);
$v = ArticleAuthorPeer::doSelect($criteria, $con);
return !empty($v) ? $v[0] : null;
}
/**
* If this collection has already been initialized with
* an identical criteria, it returns the collection.
* Otherwise if this Author is new, it will return
* an empty collection; or if this Author has previously
* been saved, it will retrieve related ArticleAuthors 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 Author.
*/
public function getArticleAuthorsJoinArticle($criteria = null, $con = null, $join_behavior = Criteria::LEFT_JOIN)
{
if ($criteria === null) {
$criteria = new Criteria(AuthorPeer::DATABASE_NAME);
} elseif ($criteria instanceof Criteria) {
$criteria = clone $criteria;
}
if ($this->collArticleAuthors === null) {
if ($this->isNew()) {
$this->collArticleAuthors = array();
} else {
$criteria->add(ArticleAuthorPeer::AUTHOR_ID, $this->id);
$this->collArticleAuthors = ArticleAuthorPeer::doSelectJoinArticle($criteria, $con, $join_behavior);
}
} else {
// the following code is to determine if a new query is
// called for. If the criteria is the same as the last
// one, just return the collection.
$criteria->add(ArticleAuthorPeer::AUTHOR_ID, $this->id);
if (!isset($this->lastArticleAuthorCriteria) || !$this->lastArticleAuthorCriteria->equals($criteria)) {
$this->collArticleAuthors = ArticleAuthorPeer::doSelectJoinArticle($criteria, $con, $join_behavior);
}
}
$this->lastArticleAuthorCriteria = $criteria;
return $this->collArticleAuthors;
}
/**
* 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 phpname (e.g. 'AuthorId')
*
* @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 = ArticleAuthorPeer::getFieldNames($keyType);
if (array_key_exists($keys[0], $arr)) {
$this->setArticleId($arr[$keys[0]]);
}
if (array_key_exists($keys[1], $arr)) {
$this->setAuthorId($arr[$keys[1]]);
}
}