5.13.1. Общие положения¶

Application Server предоставляет следующие способы работы с изображениями, используемыми в прикладных приложениях:

Коллекции изображений - наборы изображений, объединённых в виде спрайта изображений и хранящихся в ресурсах Application Server или в базе данных прикладного проекта. Используются для быстрого и централизованного доступа к большому количеству однотипных изображений по индексу.
Изображения ресурсов прикладного проекта - отдельные файлы изображений, хранящиеся в каталоге КореньПроекта/Модуль/src/main/resources прикладного проекта. Используются для хранения уникальных или редко используемых изображений, которые нецелесообразно добавлять в коллекции изображений, так как они предназначены исключительно для конкретного прикладного проекта.
Изображения из файлового хранилища сервера - отдельные файлы изображений, хранящиеся в файловом хранилище сервера, путь к которым берётся из значения поля выборки. Используются для изображений, привязанных к конкретным записям (фотографии, фото товаров и т. п.).

5.13.1.1. Сравнение способов¶

Характеристика	Коллекции изображений	Изображения ресурсов прикладного проекта	Изображения из файлового хранилища
Место хранения	`${G3_HOME}/server/resources/imagecollection/` или таблица `BTK_COMPONENT` базы данных прикладного проекта	`КореньПроекта/Модуль/src/main/resources`	Файловое хранилище сервера (каталоги из `белого списка`)
Поддерживаемые форматы	`.png`, `.svg`	`.jpeg`, `.jpg`, `.png`, `.ico`, `.svg`	Указано в спецификации изображений из файлового хранилища сервера
Доступ к данным	EngineEndpoint.get_image Сервис загрузки коллекций изображений	EngineEndpoint.get_resource_image Сервис загрузки ресурсных файлов	Указано в спецификации изображений из файлового хранилища сервера
Назначение	Набор однотипных изображений	Единичные или уникальные изображения	Изображения, привязанные к записям выборки (путь хранится в поле)
Требования к размеру	Единый размер для всех изображений коллекции	Нет	Нет
Производительность при массовом доступе	Высокая (все изображения передаются в составе одного спрайта)	Низкая (каждое изображение запрашивается отдельно)	Низкая (каждое изображение запрашивается отдельно)

5.13.1.2. Рекомендации по выбору¶

Используйте коллекции изображений, если:

Требуется быстрый доступ к большому набору изображений.
Важно уменьшить количество сетевых запросов.
Все изображения имеют одинаковый размер.
Все изображения схожи по смыслу и назначению. Например: коллекция изображений, используемых в кнопках редактора - editbuttons, коллекция изображений панели инструментов - toolbarprimary.

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

Графика уникальна для конкретного прикладного проекта.
Изображений мало, нет смысла собирать их в коллекцию.
Необходимо гибко обновлять отдельные файлы без обновления коллекции изображений.

Используйте изображения из файлового хранилища сервера, если:

Изображение является данными конкретной записи выборки: фотографией сотрудника, фото товара и т.д..
Путь к изображению хранится в данных выборки и может отличаться для каждой строки.
Файлы создаются, обновляются или удаляются вне цикла сборки и поставки прикладного проекта.
Изображения должны храниться в общем файловом хранилище, доступном серверу, а не в ресурсах прикладного проекта.