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

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


limb3_2007_4:ru:packages:active_record:sql_exec

Создание новых find() методов. Выполнение своих sql-запросов.

Свои find() и get()-методы

В процесс работы вам немременно необходимо будет создавать новые 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 findKidsForParent($parent_id)
  {
    $sql = 'SELECT document.* '.
           ' FROM document LEFT JOIN node ON node.object_id = document.id '.
           ' WHERE node.parent_id = '. $parent_id;
 
    return lmbActiveRecord :: findBySql('Document', $sql);
  }
 
  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);
  }
}

findBySql() - методы lmbActiveRecord

Как вы уже заметили, для выполнения своих 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) - это аналог вызова метода [limb3_2007_4:ru:packages:dbal:lmbDBAL|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 по-умолчанию.

Обсуждение

Ваш комментарий. Вики-синтаксис разрешён:
  _   __  __  __   ____   ___      __
 | | / / / / / /  /  _/  / _ \ __ / /
 | |/ / / /_/ /  _/ /   / // // // / 
 |___/  \____/  /___/  /____/ \___/
 
limb3_2007_4/ru/packages/active_record/sql_exec.txt · Последние изменения: 2010/11/10 10:02 (внешнее изменение)