Веб-ресурсы

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

Ресурс, упакованный в корне веб-приложения, должен находиться в подкаталоге каталога resources в корне веб-приложения: resources/resource-identifier.
Ресурс, упакованный в classpath веб-приложения, должен находиться в подкаталоге каталога META-INF/resources веб-приложения: META-INF/resources/resource-identifier. Вы можете использовать эту файловую структуру для упаковки ресурсов в файл JAR, размещённый в веб-приложении.

Среда выполнения JavaServer Faces будет искать ресурсы в предыдущих перечисленных местах в указанном порядке.

Идентификаторы ресурса — это уникальные строки, которые соответствуют следующему формату (все в одной строке):

[locale-prefix/][library-name/][library-version/]resource-name[/resource-version]

Элементы идентификатора ресурса в скобках ([]) являются необязательными, что указывает на то, что обязательным элементом является только имя ресурса, которое обычно является именем файла. Например, наиболее распространённый способ указать таблицу стилей, изображение или скрипт — это использовать атрибуты library и name, как в следующем теге из guessnumber-jsf:

<h:outputStylesheet library="css" name="default.css"/>

Этот тег указывает, что таблица стилей default.css находится в каталоге web/resources/css.

Можно также указать местоположение изображения, используя следующий синтаксис, также взятый из примера guessnumber-jsf:

<h:graphicImage value="#{resource['images:wave.med.gif']}"/>

Этот тег указывает, что изображение wave.med.gif находится в каталоге web/resources/images.

Ресурсы можно рассматривать как место расположения библиотеки. Любой артефакт, такой как составной компонент или шаблон, который хранится в каталоге resources, становится доступным для других компонентов приложения, которые могут использовать его для создания объекта ресурса.