====== Контейнеры данных WACT. Какие данные можно передавать в WACT-шаблоны ======

Под контейнером данных в WACT шаблоне мы понимаем такой активный компонент откомпилированного шаблона, который предоставляет для остальных доступ к некоторым данным. Контейнеры данных в откомпилированном шаблоне формируют дерево. Это должно быть вам знакомо по материалам разделов:
  *  [[limb3_2007_2:ru:usage:wact:important_details|Компиляция и выполнение шаблона. Активные компоненты шаблона. Дерево контейнеров данных]],
  * [[limb3_2007_2:ru:usage:wact:dbe|Data Binding Expressions]].

Различают 2 вида контейнеров данных:
  * Обычный контейнер данных, из которого берутся данные для выражений вида {$title}
  * Списковые контейнеры данных, из которых берутся данных для вывода списков (типичный представитель - тег <list:list>)

  * обычные контейнеры данных обычно называются термином **Datasource**
  * Списковые контейнеры данных обычно называются итераторами (**Iterator**) или наборами данных (**Dataset**).


===== Обычные контейнеры данных (datasource) =====

В качестве обычного контейнера данных WACT может использовать следующие объекты:
  * ассоциативный массив
  * объект, который поддерживает интерфейс get()/set() (содержит методы get($field) и set($field, $value))
  * объект, который поддерживает интерфейс ArrayAccess

<code xml>
<core:datasource id='article'>
<h1>{$title}</h1>
{$content}
</core:datasource>
</code>

<code php>
$template = new WactTemplate('my_template.html');
$article = $template->findChild('article');

// Вариант 1. Контейнер данных - обычный массив.
$data = array('title' => 'Item1', 'content' => 'Super article');
$article->registerDatasource($data);

// Вариант 2. Контейнер данных - объект класса lmbDataspace
$data = new lmbDataspace(array('title' => 'Item1', 'content' => 'Super article'));
$article->registerDatasource($data);

// Вариант 3. Контейнер данных - запись из базы данных
$connection = lmbToolkit :: instance()->getDefaultDbConnection();
$stmt = $connection->newStatement('SELECT * FROM item');
$items = $stmt->getRecordSet();
$items->rewind();
$data = $items->current();
$article->registerDatasource($data);
</code>

Если в WACT пришел контейнер данных в виде объекта, то он проверяет, поддерживает ли тот методы get. Если да, поддерживает, тогда всегда будет использоваться $datasource->get(’title’) вместо datasource[’title’].

Приоритетность использования интерфейса get()/set() активно используется в пакете WEB_APP для интеграции пакетов ACTIVE_RECORD и WACT. Подробнее об этом см. раздел [[limb3_2007_2:ru:usage:active_record:in_wact_templates|"Использование ACTIVE_RECORD в шаблонах WACT"]].

Теги, которым соответствуют обычные контейнеры данных:
    * [[limb3_2007_2:ru:usage:wact:tags:core_tags:core_datasource_tag|<core:datasource>]]
    * [[limb3_2007_2:ru:usage:wact:tags:form_tags:form_tag|<form>]]
    * [[limb3_2007_2:ru:usage:wact:tags:list_tags:list_item_tag|<list:item>]]

===== Итераторы (dataset) =====

В качестве источника данных для спискового контейнера данных WACT может использовать обычные массивы, а также любые объекты, которые поддерживают интерфейс итератора (Iterator). Основное условие - чтобы метод current() возвращал нечто, что можно назвать обычным источником данных.

Например:
<code xml>
<list:list id='items'>
<ul>
 <list:item><li>{$title}</li></list:item>
</ul>
</list:list>
</code>

<code php>
$template = new WactTemplate('my_template.html');
$list = $template->findChild('items');

// Вариант 1. Контейнер данных - обычный массив.
$data = array(array('title' => 'Item1'),
              array('title' => 'Item2'));
$list->registerDataset($data);

// Вариант 2. Контейнер данных - итератор.
$data = new lmbArrayDataset(array(array('title' => 'Item1'), array('title' => 'Item2')));
$list->registerDataset($data);

// Вариант 3. Контейнер данных - итератор c данными из базы данных.
$connection = lmbToolkit :: instance()->getDefaultDbConnection();
$stmt = $connection->newStatement('SELECT * FROM item');
$data = $stmt->getRecordSet();
$list->registerDataset($data);
</code>

Таким образом WACT может работать одинаково с объектами класса lmbArrayDataset, c объектами lmbMySQLRecordSet и с обычными многомерными массивами.

Мы рекомендуем вам также взглянуть на [[limb3_2007_2:ru:packages:datasource|описание пакета DATASOURCE]] чтобы ознакомиться с классами, которые используются в Limb в качестве контейнеров данных.

Теги, которым соответствуют списковые контейнеры данных:
    * [[limb3_2007_2:ru:usage:wact:tags:list_tags:list_list_tag|<list:list>]]