Фремворк Limb

Отредактируйте страницу и нажмите «Сохранить». Прочтите справочную страницу для ознакомления с синтаксисом вики. Пожалуйста, редактируйте только в том случае, если планируете улучшить содержимое. Если вы просто хотите потестировать что-либо, воспользуйтесь специальной страницей: PlayGround.

====== Расширение классов коллекций связей вида один-ко-многим и много-ко-многим ======

===== Создание и внедрение новых классов коллекций =====

Необходимость использовать свои собственные классы для коллекций связанных объектов может проявиться, если вам необходимо применять какие-либо особенные правила при выборках объектов или при изменении состояния коллекции.

Базовыми классами для коллекций являются:
  * **lmbAROneToManyCollection** - для коллекций связей один-ко-многим.
  * **lmbARManyToManyCollection** - для коллекция связей много-ко-многим.

Для внедрения новой коллекции используется параметр **collection** при описании связи, например:

<code php>
class Course extends lmbActiveRecord
{
  protected $_has_many = array('lectures' => array('field' => 'course_id',
                                                   'class' => 'Lecture',
                                                   'collection' => 'CourseLecturesCollection'));
}

class Lecture extends lmbActiveRecord
{
  protected $_many_belongs_to = array('course' => array('field' => 'course_id',
                                                        'class' => 'Course'));
}
</code>

В примере мы будем использовать CourseLecturesCollection при работе со списком лекций, которые относятся к курсу.

Класс CourseLecturesCollection может выглядеть следующим образом:

<code php>
class CourseLecturesCollection extends lmbAROneToManyCollection
{
  function add($object)
  {
    if($this->_someImportantCondition())
      parent :: add($object);
    else
      throw new lmbException('This operation is not allowed');
  }
  
  protected _someImportantCondition()
  {
    [...]
  }
}
</code>

===== Условное внедрение новых классов коллекций =====

Иногда новый класс нужно внедрять на основе какой-либо логики. Коллекции создаются в методе lmbActiveRecord :: **createRelationCollection($relation, $criteria = null)**

В нашей работе мы встречались со случаем, когда необходимо было внедрять декоратор на коллекцию, если объекты в коллекции были определенного класса:
<code php>
  function createRelationCollection($relation, $criteria = null)
  {
    $collection = parent :: createRelationCollection($relation, $criteria);
    $relation_info = $this->getRelationInfo($relation);
    $class = $relation_info['class'];
    $object = new $class();
    if($object instanceof SpecialObject)
      return new SpecialObjectCollectionDecorator($collection);
    else
      return $collection;
  }
</code>

===== Наложение условий на все выборки в коллекции =====

Обратите внимание на второй параметр метода lmbActiveRecord :: createRelationCollection($relation, $criteria = null). Этот параметр позволяет внедрить в коллекцию условие, которое всегда будет накладываться на выборки элементов, помимо тех, что передаются в find()-методы.

Пожалуйста, введите код подтверждения, чтобы доказать, что вы не робот:

   ___   __  __  _____   __  ___   ___ 
  / _ ) / / / / / ___/  /  |/  /  / _ \
 / _  |/ /_/ / / (_ /  / /|_/ /  / ___/
/____/ \____/  \___/  /_/  /_/  /_/

Пожалуйста, оставьте это поле пустым:

Сводка изменений

Примечание: редактируя эту страницу, вы соглашаетесь на использование своего вклада на условиях следующей лицензии: CC Attribution-Share Alike 4.0 International

Фремворк Limb

Инструменты пользователя

Инструменты сайта

Инструменты страницы