Фремворк Limb

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

====== Контейнеры данных Limb3: интерфейсы и базовые классы ======

===== Итераторы =====

Итераторы - стандартная форма работы со списковыми данными. Грубо говоря, под итератором можно понимать просто массив или массив массивов (очень условно).

Итератор обычно содержит следующие методы:
  * rewind() - переводит внутренний курсор итератора на начальное положение (перемотка на начало).
  * valid() - возвращает true, если курсор не вышел за границы итератора.
  * current() - возвращает текущее значение итератора, на которое указывает курсор.
  * next() - переводит внутренний курсор итератора на следующее положение.

Обычная форма работы с итератором выглядит так:
<code php>
for($iterator->rewind(); $iterator->valid(); $iterator->next())
{
  $item = $iterator->current();
  [..do something with $item..]
}
</code>

или в сокращенной форме:
<code php>
foreach($iterator as $item)
{
  [..do something with $item..]
}
</code>

В PHP5 интерфейсы Iterator, Traversable, Countable и ArrayAccess являются уже встроенными и входят в [[http://www.php.net/~helly/php/ext/spl/| библиотеку SPL (StandardPHPLibrary)]]. Есть [[http://www.sitepoint.com/article/php5-standard-library|хорошая статья-введение в SPL на sitepoint.com от Harry Fuecks]].

Однако базовых интерфейсов нам показалось мало, и мы расширили Iterator до интерфейса [[lmbCollectionInterface]]:

Пакет CORE содержит следующий набор интфейсов и классов для работы с итераторами:

^Класс/Интерфейс^Назначение^
|[[lmbCollectionInterface]]|Интерфейс для работы с итераторами, который применяется в Limb|
|[[lmbCollection]]|Класс, реализующий lmbCollectionInterface. По-сути объектная форма массива ассоциативных массивов |
|[[lmbCollectionDecorator]]|Базовый декоратор на итератор с интерфейсом lmbCollectionInterface.|

===== Единичные (несписковые) контейнеры данных =====

Единичные (несписковые) контейнеры данных можно представлять как обычный ассоциативный массив в объектной форме. На самом деле все не так просто...

SPL содержит интерфейс ArrayAccess, который позволяет работать с классами, как с обычными массивами. Однако из-за того, что в Limb3 работа преимущественно ведется с объектами, мы решили, что было неплохо иметь возможность работать наоборот - с массивами как с объектами. Результатом этого появился интерфейс [[lmbSetInterface]] и класс [[lmbSet]].

Важным классом также является [[lmbObject]], который используется в качестве базового для объектов модели. lmbObject используется в пакете ACTIVE_RECORD в качестве родительского lmbActiveRecord. lmbObject вносит достаточно много "магии" в ваш код, поэтому его использование может как увеличить гибкость вашего кода и его наглядность, так и отнять у вас много времени на отладку, если этой "магией" неправильно пользоваться.

^Класс/Интерфейс^Назначение^
|[[lmbSetInterface]]|Интерфейс для работы с единичными контейнерами данных|
|[[lmbSet]]|Класс, реализующий lmbSetInterface. По-сути объектная форма ассоциативного массива |
|[[lmbObject]]|Базовый класс, для объектов модели в Limb3. lmbObject поддерживает магические getter()-ы и setter()ы и реализует lmbSetInterface.|

===== Для чего все это? =====

* Итераторы, поддерживающие постраничный вывод оказываются очень полезны в шаблонах.
  * Итераторы легко декорировать и декорирование полностью прозначно для клиентов. С массивами такой фокус не проходит - многое приходится делать вручную.
  * Единая форма работы с массивами и объектами через интерфейс lmbSetInterface - оказалась удобной в шаблонах, когда вместо 
<code php>
  if(isset($item['some_property'])) 
   echo $item['some_property']; 
</code>

можно просто написать

<code php>
 echo $item->get('some_property'). 
</code>

и пусть $item сам разбирается, есть у него такая some_property или нет.

А при использовании lmbObject-а в качестве $item из вышестоящего примера с методом getSomeProperty() будет вызван именно этот метод.

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

   _  __  _   __   ____   __ __   __ __
  | |/_/ | | / /  / __/  / // /  / //_/
 _>  <   | |/ /  / _/   / _  /  / ,<   
/_/|_|   |___/  /___/  /_//_/  /_/|_|

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

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

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

Фремворк Limb

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

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

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