/** * If this collection has already been initialized with * an identical criteria, it returns the collection. * Otherwise if this RatingField is new, it will return * an empty collection; or if this RatingField has previously * been saved, it will retrieve related CourseRatings 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 RatingField. */ public function getCourseRatingsJoinCourseInstructorAssociation($criteria = null, $con = null, $join_behavior = Criteria::LEFT_JOIN) { if ($criteria === null) { $criteria = new Criteria(RatingFieldPeer::DATABASE_NAME); } elseif ($criteria instanceof Criteria) { $criteria = clone $criteria; } if ($this->collCourseRatings === null) { if ($this->isNew()) { $this->collCourseRatings = array(); } else { $criteria->add(CourseRatingPeer::FIELD_ID, $this->id); $this->collCourseRatings = CourseRatingPeer::doSelectJoinCourseInstructorAssociation($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(CourseRatingPeer::FIELD_ID, $this->id); if (!isset($this->lastCourseRatingCriteria) || !$this->lastCourseRatingCriteria->equals($criteria)) { $this->collCourseRatings = CourseRatingPeer::doSelectJoinCourseInstructorAssociation($criteria, $con, $join_behavior); } } $this->lastCourseRatingCriteria = $criteria; return $this->collCourseRatings; }