tuna.model.ListResource

Класс хранилища набора экземпляров модели данных приложения. В случае, если данный набор соотвествует удаленномй набору данных, получить который возможно при вызове REST-метода, то в качестве аргументов конструктора можно задать имя удаленного метода, тогда при вызове метода load данного класса, удаленный набор данных будет загружен и преобразован в массив экземпляров данных зарегистрированнаого в фабрике tuna.model.recordFactory под указанным вторым аргументом именем.

Аргументы конструктора:

Имя Тип Описание
opt_methodName string Имя удаленного REST-метода, при вызове которого возвращается соответсвующий набор данных.
opt_recordName string Имя экземпляра данных.

См. также:

Реализует и наследует:

Свойства

_listeners:Object.<string, Array.<function(tuna.events.BasicEvent, *)>>

[protected] Таблица слушателей событий определенных типов.

_methodName:string

[protected] Имя удаленного REST-метода, при вызове которого возвращается соответсвующий набор данных.

_propagationParent:tuna.events.IEventDispatcher

[protected] Родительский объект иерархии распростанения (баблинга).

_recordName:string

[protected] Имя экземпляра данных.

Методы

addEventListener:

Добавление обработчика события. Обработчиком события должна быть функция принимающая в качестве аргументов объект события и сопуствующие ему данные. В случае, если сопутствующие данные не были заданы в качестве данных передается null. По-умолчанию функция обработчик будет вызвана в контексте объекта который оповестил о событии.

Аргументы:

Имя Тип Описание
type string Тип события который необходимо обрабатывать.
listener function(tuna.events.BasicEvent, *) Функция-обработчик события.

См. также:

addEventListener:

Добавление обработчика события. Обработчиком события должна быть функция принимающая в качестве аргументов объект события и сопуствующие ему данные. В случае, если сопутствующие данные не были заданы в качестве данных передается null. По-умолчанию функция обработчик будет вызвана в контексте объекта который оповестил о событии.

Аргументы:

Имя Тип Описание
type string Тип события который необходимо обрабатывать.
listener function(tuna.events.BasicEvent, *) Функция-обработчик события.

См. также:

addItem:

Добавление экземпляра данных в набор. В случае существования, экземпляр с тем же идентификатором, что и выбранный заменяется.

Аргументы:

Имя Тип Описание
record tuna.model.Record Экземпляр данных, который необходимо добавить либо заменить.

См. также:

clear:

Очищение хранимого набора данных.

dispatch:boolean

Оповещение слушателей о наступлении события.

Аргументы:

Имя Тип Описание
event tuna.events.BasicEvent | string Событие, о котором необходимо оповестить. В качестве данного аргумента может выступать либо объект события, либо тип события. В случае если передан тип события объект события должен быть создан автоматически.
opt_data * Сопуствующие событию данные.

Возвращает:

  • Флаг отсутствия отмены обрабтки по-умолчанию.

См. также:

dispatch:boolean

Оповещение слушателей о наступлении события.

Аргументы:

Имя Тип Описание
event tuna.events.BasicEvent | string Событие, о котором необходимо оповестить. В качестве данного аргумента может выступать либо объект события, либо тип события. В случае если передан тип события объект события должен быть создан автоматически.
opt_data * Сопуствующие событию данные.

Возвращает:

  • Флаг отсутствия отмены обрабтки по-умолчанию.

См. также:

each:

Вызов выбранной функции-обработчика для каждого элемента набора.

Аргументы:

Имя Тип Описание
callback function(!tuna.model.Record) Функция-обработчик.

find:Array.

Поиск экземпляров данных удовлетворяющих условию. Условие поиска задается специальной функцией, принимающий как аргумент экземпляр данных и возвращающей результат проверки.

Аргументы:

Имя Тип Описание
callback function(!tuna.model.Record):boolean Функция-условие. проверки.

Возвращает:

  • Массив найденных экземпляров.

findOne:tuna.model.Record

Поиск первого экземпляра данных удовлетворяющего условию.

Аргументы:

Имя Тип Описание
callback function(!tuna.model.Record):boolean Функция-условие.

Возвращает:

  • Найденный экземпляр или null.

См. также:

get:Array.

Получение всего набора экземпряров.

Возвращает:

  • Хранимый набор экземпляров.

getItemById:tuna.model.Record

Поиск экземпляра данных в наборе по идентификатору.

Аргументы:

Имя Тип Описание
id string Идентификатор необходимого экземпляра.

Возвращает:

  • Найденный экземпляр или null.

hasEventListener:boolean

Проверка наличия обработчика события определенного типа.

Аргументы:

Имя Тип Описание
type string Тип события который, наличие обработчика которого следует определить.
listener function(tuna.events.BasicEvent, *) Функция-обработчик.

Возвращает:

  • Результат проверки наличия обработчика.

hasEventListener:boolean

Проверка наличия обработчика события определенного типа.

Аргументы:

Имя Тип Описание
type string Тип события который, наличие обработчика которого следует определить.
listener function(tuna.events.BasicEvent, *) Функция-обработчик.

Возвращает:

  • Результат проверки наличия обработчика.

load:

Загрузка соотвествующего набора данных. Загрузка заключается в вызове указанного в конструкторе REST-метода. В случае если загрузка вызывается повторно с теми же аргументами что и ранее и флаг вынужденной загрузки не установлен, то ничего не происходит.

Аргументы:

Имя Тип Описание
opt_args Object Аргументы указанного в конструкторе REST-метода.
opt_isForce boolean Флаг вынужденной загрузки.

map:Array

Вызов выбранной функции-обработчика для каждого элемента набора и сохранение ее результатов в массив.

Аргументы:

Имя Тип Описание
callback function(!tuna.model.Record):* Функция-обработчик.

Возвращает:

  • Массив результатов вызова.

removeEventListener:

Удаление слушателя события.

Аргументы:

Имя Тип Описание
type string Тип события который не нужно больше обрабатывать.
listener function(tuna.events.BasicEvent, *) Функция-обработчик.

См. также:

removeEventListener:

Удаление слушателя события.

Аргументы:

Имя Тип Описание
type string Тип события который не нужно больше обрабатывать.
listener function(tuna.events.BasicEvent, *) Функция-обработчик.

См. также:

removeItem:

Удаление экземпляра из набора. Поиск экземпляра для удаления производиться по идентификатору.

Аргументы:

Имя Тип Описание
record tuna.model.Record Экземпляр данных, который необходимо удалить.

См. также:

removeItemById:

Поиск и удаление экземпляра данных по его идентификатору.

Аргументы:

Имя Тип Описание
id string Идентификатор экземпляра, который необходимо удалить.

См. также:

set:

Установка нового набора экземпляров данных для хранения.

Аргументы:

Имя Тип Описание
list Array.<!tuna.model.Record> Новый набор экземпляров.

Tuna Framework 2012