====== Шаг 8.1. Модель связанная с заказами  ======
===== Связи между классами =====

Наша модель по хранению заказов будет выглядеть следующим образом:

{{limb3:ru:tutorials:shop:order_model.png|}}

Поясним:
  * Order состоит из %%OrderLine%%. Здесь отношении композиции (один-ко-многим).
  * %%OrderLine%% имеет ссылку на Product. На Product может ссылать множество %%OrderLine%%. Здесь у нас будет отнонаправленная связь один-ко-многим.
  * User может иметь несколько Order, в тоже время Order имеет ссылку на User. Здесь двусторонее отношение один-ко-многим.

Что ж, не густо - только различные вариации один-ко-многим, однако нам этого будет достаточно, чтобы показать принципы.

Конечно, связи между объектами можно сохранять вручную - при помощи соответствующих ключей в таблицах базы данных, однако пакет ACTIVE_RECORD предоставляет средства, которые облегчают эту задачи и позволяют не отходить от объектной схемы работы.

===== Поддержка отношений в пакете ACTIVE_RECORD =====

Пакет ACTIVE_RECORD содержит набор средств, которые позволяют автоматизировать работу с отношениями. Для этого необходимо лишь внутри требуемых классов добавить соответствующие описания отношений.
==== Краткий пример ====

Начнем формировать отношения между Order и %%OrderLine%%, и на примере покажем как работать с отношениями при помощи пакета ACTIVE_RECORD. Создадим класс Order:

Файл shop/src/model/Order.class.php:
<code php>
<?php
lmb_require('src/model/OrderLine.class.php');

class Order extends lmbActiveRecord
{
  protected $_has_many = array('lines' => array('field' => 'order_id',
                                                'class' => 'OrderLine'));

}
?>
</code>

Обратите внимание на атрибут **$_has_many**. Это массив, который может содержать набор описаний отношений один-ко-многим данного класса с другими. **lines** - это название отношений, оно нам потребуется, когда мы будем добавлять позиции в заказ. Ключ **field** указывает на название поля в таблице, где хранятся экземпляры класса %%OrderLine%%, в которое будет сохранен идентификатор объекта класса Order. В нашем случае это поле order_id таблицы order_line. Ключ **class** указывает на класс, с которым Order состоит в отношении.

Теперь мы можем написать следующий код:

<code php>
$order = new Order();
$item1 = new OrderLine();
$order->addToLines($item1);
// или
$lines = $order->getLines(); // lines - это коллекция объектов, которая поддерживает интерфейс Iterator.
$lines->add($line1);
//или так
$lines = $order->get('lines'); // это очень важно! Будет нами использоваться в WACT-шаблонах
$lines->add($line1);
// или 
$order->setLines(array($line1));
</code>

Поддержка методов вида addToLines(), getLines(), setLines() добавляется в %%ActiveRecord%% автоматически после создания соответствующего описания отношения. Обратите внимание на поддержку $order->get('lines'); - это позволит нам легко получить список позиций, связанных с заказом, прямо из WACT-шаблона.

Связанные объекты сохраняются в базе данных и загружаются из базы данных автоматически, например:
<code php>
$order = new Order();
$item1 = new OrderLine();
$item2 = new OrderLine();
$order->addToLines($item1);
$order->addToLines($item2);
$order->save(); // будет сохранен Order и связанные с ним item1 и item2
//....
$order2 = new Order($order->getId());
$lines = $order2->getLines(); // lines будет содержать объекты с данными item1 и item2
</code>

Пока класс %%OrderLin%%e ничего не знает об Order. Добавим описание отношения в класса Order. Оно будет немного отличаться:

<code php>
<?php
lmb_require('src/model/Order.class.php');

class OrderLine extends lmbActiveRecord
{
  protected $_many_belongs_to = array('order' => array('field' => 'order_id',
                                                       'class' => 'Order'));

  [...]
}
?>
</code>

Атрибут **$_many_belongs_to** описывает отношение много-к-одному (то есть один-ко-многим с другой стороны). Теперь ключ **field** указывает на название поля в таблице, где хранятся объекты класса %%OrderLine%%. **class** описывает название класса, с которым %%OrderLine%% находится к отношении много-к-одному.

Теперь мы можем использовать следующий код:
<code php>
$order_line = new OrderLine(previously_saved_id);
$order = $order_line->getOrder();
// или
$order = $order_line->get('order');
</code>

В целом, принцип должен быть понятен.

Обратите внимание, что при удалении объекта Order будут также удалены соответсвующие объекты %%OrderLine%% (но не наоборот).

==== Возможности пакета ACTIVE_RECORD по работе с отношениями ====

Мы не будем описывать здесь все, что касается работы с отношениями, так как это достаточно обширная тема. Приведем лишь список наиболее значительных моментов, которые вам рекомендуется знать.

В версии 0.2 пакета ACTIVE_RECORD доступен следующий функционал:
  * Различные виды связей:
    * [[limb3:ru:packages:active_record:one_to_one|Связь один-к-одному]]
    * [[limb3:ru:packages:active_record:one_to_many|Связь один-к-многим]]
    * [[limb3:ru:packages:active_record:many_to_many|Связь много-ко-многим]]
    * Отношения могут быть как однонаправленными, так и двунаправленными.
    * При удалении могут производиться каскадные удаления связанных объектов, а могут и нет.
  * [[limb3:ru:packages:active_record:more_on_relations|Средства, расширяющие работу со связанными объектами]]
    * Отложенная загрузка связанных объектов (только по требованию).
    * Внедрение дополнительных критерий при описании отношений.
    * Внедрение своих собственных классов для работы с коллекциями связанных объектов.
  * Кеширование и жадная загрузка в версии 0.2 не поддерживается! Для этого вам пока придется создавать свои собственные find()-методы. 

Наше приложение будет пользоваться только базовыми средствами пакета ACTIVE_RECORD по работе со связанными объектами. Остальное, мы надеемся, вы сможете освоить при помощи раздела [[limb3:ru:packages:active_record|"Использование пакета ACTIVE_RECORD"]]
===== Классы OrderLine, Order, User и отношения между ними =====

У нас уже есть начальная реализация %%OrderLine%%, теперь мы добавим к нее описания связи с Product:

Файл %%shop/src/model/OrderLine.class.php%%:
<code php>
<?php
lmb_require('src/model/Product.class.php');

class OrderLine extends lmbActiveRecord
{
  protected $_many_belongs_to = array('order' => array('field' => 'order_id',
                                                       'class' => 'Order'),
                                      'product' => array('field' => 'product_id',
                                                         'class' => 'Product'));

  [...]
}
?>
</code>

(Теоретически, мы могли бы описать связь %%OrderLine%% и Product как один-ко-одному)

Пользователи у нас должны иметь также связь с заказами, поэтому добавим в соответсвующие классы описания этого отношения.

Файл shop/src/model/User.class.php:
<code php>
<?php
lmb_require('src/model/Order.class.php');

class User extends lmbActiveRecord
{
  protected $_has_many = array('orders' => array('field' => 'user_id',
                                                 'class' => 'Order',
                                                 'sort_params' => array('date' => 'DESC')));
  [...]
}
?>
</code>

Обратите внимание на ключ **sort_params**. В качестве значения - массив пар 'поле' => 'тип сортировки'. Это позволяет задать способ сортировки связанных с пользователем заказов по-умолчанию.

Файл shop/src/model/Order.class.php:
<code php>
<?php
lmb_require('src/model/OrderLine.class.php');

class Order extends lmbActiveRecord
{
  protected $_has_many = array('lines' => array('field' => 'order_id',
                                                'class' => 'OrderLine'));

  protected $_many_belongs_to = array('user' => array('field' => 'user_id',
                                                      'class' => 'User'));
}
?>
</code>
===== Класс Order =====

Теперь доработаем класс Order следующим образом:
  * Добавим поддержку **статусов** заказа
  * Добавим фабричный метод, который будет создавать новый объект Order из Cart.

Файл shop/src/model/Order.class.php:
<code php>
class Order extends lmbActiveRecord
{
  const STATUS_NEW                 = 1;
  const STATUS_PROCESSED           = 2;
  const STATUS_FINISHED            = 3;

  protected $_has_many = array('lines' => array('field' => 'order_id',
                                                'class' => 'OrderLine'));

  protected $_many_belongs_to = array('user' => array('field' => 'user_id',
                                                      'class' => 'User'));

  function createForCart($cart)
  {
    $order = new Order();
    $order->setStatus(Order :: STATUS_NEW);
    $order->setLines($cart->getItems());
    $order->setSumm($cart->getTotalSumm());
    $order->setDate(time());
    return $order;
  }

  function setStatus($value)
  {
    $statuses = $this->getStatusOptions();
    if(isset($statuses[$value]))
      $this->_setRaw('status', $value);
  }

  function getStatusName()
  {
    $statuses = $this->getStatusOptions();
    return $statuses[$this->getStatus()];
  }
}
?>
</code>

Поясним некоторые моменты.

Мы добавили набор контант, которыми мы будем пользоваться в коде для указания текущего статуса заказа. Это обычный прием, который мы используем в таких случаях. Если статусов было бы много и(или) они описывались бы не одним, а несколькими полями, мы бы вынесли отдельный класс %%OrderStatus%%. 

Особо стоит отметить метод Order :: **setStatus($status)**. Обратите внимание на вызов метода **_setRaw('status', $value)**. Нам нельзя в данном методе использовать set('status', $value), так как lmbObject (от которого отнаследован lmbActiveRecord) автоматически вызовет метод setStatus(), и это приведет к рекурсии. _setRaw() нужен как раз в таких случаях - он устанавливает значение поля напрямую, минуя проверку, если ли метод вида setStatus() или нет.

(Кстати, мы могли бы вообще обойтись без использования класса Cart, а использовать только класс Order).

===== Далее =====

Теперь, когда наша модель готова, можно добавить функционал по оформлению корзины. 

Итак, следующий шаг: [[step8-2|Шаг8.2. Отправка заказа.]]