Загрузка объектов

В процесс работы вам немременно необходимо будет создавать новые find() и get() методы в ваших ActiveRecord-ах.

Мы для себя уславливаемся обычно, что find()-методы это статические методы, а getter-ы - это instance-методы, например:

class Document extends lmbActiveRecord
{
  static function findPublished()
  {
    $time = time();
    return lmbActiveRecord :: find('Document', "is_published = 1 AND (date_start <= {$time} AND date_end >= {$time})");
  }
 
  static function findOlderThan($time)
  {
    $criteria = lmbSQLCriteria::less('date_start', $time);
    return lmbActiveRecord :: find('Document', $criteria);
  }
 
  static function findYoungerThan($time)
  {
    return lmbARQuery::create('Document')
      ->where(lmbSQLCriteria::great('date_start', $time))
      ->fetch();
  }
 
  function getPublishedKids()
  {
    $sql = 'SELECT document.* '.
           ' FROM document LEFT JOIN node ON node.object_id = document.id '.
           ' WHERE node.parent_id = '. $this->getNode()->getId() .
           ' AND document.date_start <= :time: AND document.date_end >= :time:'.
           ' AND document.is_published = 1 ' .
           ' ORDER BY node.priority ASC,document.date DESC';
 
    return lmbActiveRecord :: findBySql('Document', $sql);
  }
}

lmbARQuery является аналогом lmbSelectQuery, но предназначенным для работы с объектами ACTIVE_RECORD. Воспользовавшись им можно переписать функцию getPublishedKids, из первого примера, c использованием жадной загрузки:

function getPublishedKids()
{
  $criteria = lmbSQLCriteria :: equal('node.parent_id', $this->getNode()->getId());
  $criteria->add(lmbSQLCriteria :: greater('document.date_start', time()));
  $criteria->add(lmbSQLCriteria :: less('document.date_end', time()));
  $criteria->add(lmbSQLCriteria :: equal('document.is_published', 1));
  $query = lmbARQuery :: create('Document')->eagerJoin('Node');
  $query->where($criteria);
  $query->sort(array('node.priority' => 'ASC' , 'document.date' => 'DESC'));
  return $query->fetch();
}

Как вы уже заметили, для выполнения своих sql-запросов и получения объектов ActiveRecord при этом, мы использовали метод findBySql.

Рассмотрим, какие методы класса lmbActiveRecord могут быть полезными для выполнения своих sql-запросов:

• findBySql($class_name, $sql)- возвращает набор объектов ActiveRecord класса $class_name, полученный в результате $sql-запроса
• findFirstBySql($class_name, $sql) - возвращает первый объект ActiveRecord класса $class_name, полученный в результате $sql-запроса
• findOneBySql($class_name, $sql) - алиас для findFirstBySql()

Стоит отметить, что в создаваемый ActiveRecord из результата выборки передаются все поля, даже если они не относятся непосредственно к ActiveRecord, поэтому иногда можно указывать дополнительное количество полей в выборках, например:

class Document extends lmbActiveRecord
{
  [...]
  static function findKidsForParent($parent_id)
  {
    $sql = 'SELECT document.*, node.identifier as node_identifier, node.title as node_title '.
           ' FROM document LEFT JOIN node ON node.object_id = document.id '.
           ' WHERE node.parent_id = '. $parent_id;
 
    return lmbActiveRecord :: findBySql($sql, 'Document');
  }
  [...]
}
 
....
$documents = Document :: findKidsForParent($parent_id);
$document = $documents->at(0);
echo $document->get('node_identifier');
echo $document->get('node_title');

Это может позволить увеличить скорость приложений.

Если вам нужны более низкоуровневые операции, когда есть набор методов, которые позволяют выполнить аналогичные вещи, но явно:

• _query($sql) - это аналог вызова метода lmbDBAL :: fetch($sql, $conn = null), с тем отличием, что будет испольван именно тот connection к базе данных, который сейчас установлен для ActiveRecord (об это читайте на странице Использование своего подключение к базе данных вместе с lmbActiveRecord.
• _createSQLStatement($sql) - это аналог вызова метода lmbDBAL :: newStatement($sql, $conn = null).
• decorateRecordSet($iterator, $class_name) - статический метод класса lmbActiveRecord, который обворачивает итератор $iterator декоратором класса lmbARRecordSetDecorator, который создает объект ActiveRecord из каждого элемента итератора.

Рекомендуем вам здесь ознакомиться c пакетов DBAL, чтобы полностью понимать назначение этих методов.

Например:

  $sql = 'SELECT document.* FROM document WHERE ...';
  $rs = $this->_query($sql);
  return lmbActiveRecord :: decorateRecordSet($rs, 'Document');

или при помощи statement:

  $sql = 'SELECT document.* FROM document WHERE section_id = :section_id:';
  $stmt = $this->_createSQLStatement($sql);
  $stmt->setInteger('section_id', $section_id);
  return lmbActiveRecord :: decorateRecordSet($stmt->getRecordSet(), 'Document');

Как вы наверное поняли, find()-методы класса lmbActiveRecord применяют этот декоратор lmbARRecordSetDecorator по-умолчанию.