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

Необходимо создавать кастомный компонент в следующих ситуациях.

Вам не нужно создавать кастомный компонент в следующих случаях.

Отрисовщик, который генерирует разметку для отображения компонента на веб-странице, позволяет отделить семантику компонента от его внешнего вида. Сохраняя это разделение, вы можете поддерживать различные виды клиентских устройств используя одну и ту же логику обработки. Вы можете думать об отрисовщике как о «клиентском адаптере». Он производит вывод, подходящий для употребления и отображения клиентом, и принимает ввод от клиента, когда пользователь взаимодействует с этим компонентом.

Если создаётся кастомный компонент, необходимо, среди прочего, убедиться, что класс компонента выполняет следующие операции, которые являются центральными для отрисовки компонента:

Спецификация JavaServer Faces поддерживает две программные модели для выполнения кодирования и декодирования.

Передав операции отрисовщику, вы можете связать кастомный компонент с различными отрисовщиками, чтобы можно было отрисовать компонент на разных клиентах. Если вы не планируете отрисовывать определённый компонент на разных клиентах, может быть проще позволить классу компонента обрабатывать отрисовку. Тем не менее, отдельный отрисовщик позволяет сохранить разделение семантики от внешнего вида. Приложение Duke's Bookstore отделяет отрисовщики от компонентов, хотя оно обслуживает только веб-браузеры с поддержкой HTML 4.

Если вы не уверены, нужна ли вам гибкость, предоставляемая отдельными отрисовщиками, но вы хотите использовать более простой подход прямой реализации, вы можете использовать обе модели. Класс вашего компонента может включать некоторый код отрисовки по умолчанию, но он может и делегировать отрисовку отдельному отрисовщику.

Когда вы создаёте кастомный компонент, вы можете создать и парный ему кастомный отрисовщик. Чтобы связать компонент с отрисовщиком и сослаться на компонент со страницы, вам также потребуется кастомный тег.

Хотя если нужно написать кастомный компонент и отрисовщик, писать код для кастомного тега (обработчик тега) нет необходимости. Если вы укажете комбинацию компонента и отрисовщика, Facelets автоматически создаст обработчик тега.

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

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

Кастомные компоненты, как и кастомные отрисовщики нуждаются в кастомных тегах, связанных с ними. Тем не менее, вы можете иметь кастомный тег без кастомного отрисовщика или кастомного компонента. Для примера предположим, что вам нужно создать кастомный валидатор, который требует дополнительных атрибутов в теге валидатора. В этом случае кастомный тег соответствует кастомному валидатору, а не кастомному компоненту или кастомному отрисовщику. В любом случае вам всё равно нужно связать кастомный тег с серверным объектом.

Таблица 15-1 суммирует, что вы должны или можете связать с кастомным компонентом, отрисовщиком или тегом.

Таблица 15-1. Требования к кастомным компонентам, отрисовщикам и тегам