В чем разница между этими подходами?
Шаблоны Facelet
Используйте шаблоны Facelet (как в <ui:composition>, <ui:include> и <ui:decorate>), если вы хотите разделить фрагменты макета главной страницы на повторно используемые шаблоны. Например. верхний колонтитул, меню, содержимое, нижний колонтитул и т. д.
Примеры:
Файлы тегов Facelet
Используйте файлы тегов Facelet, если вы хотите иметь повторно используемую группу компонентов, чтобы предотвратить / минимизировать дублирование кода. Например. группа компонентов метка + вход + сообщение. Основное различие с составными компонентами состоит в том, что вывод файла тега Facelet не представляет единственного UIComponent и может в некоторых случаях быть единственным решением, когда составного компонента недостаточно. Как правило, наличие <ui:include> с одним или несколькими <ui:param>, которое передает свойство управляемого компонента (и, следовательно, не является жестко заданным значением), является сигналом того, что включаемый файл может быть файлом тегов.
Примеры:
Композитные компоненты
Используйте составные компоненты, если вы хотите создать единый и повторно используемый пользовательский UIComponent с единственной ответственностью, используя чистый XML. Такой составной компонент обычно состоит из набора существующих компонентов и / или HTML и физически отображается как отдельный компонент, и предполагается, что он связан с одним свойством компонента. Например. компонент, представляющий одно свойство java.util.Date тремя зависимыми <h:selectOneMenu> компонентами, или компонент, который объединяет <p:fileUpload> и <p:imageCropper> в один <my:uploadAndCropImage>, ссылаясь на один пользовательский объект com.example.Image в качестве свойства.
Примеры:
Пользовательские компоненты
Используйте пользовательский компонент всякий раз, когда функциональность не может быть достигнута с помощью файлов тегов Facelet или составных компонентов из-за отсутствия поддержки в стандартном / доступном наборе компонентов. Примеры можно найти повсюду в исходном коде библиотек компонентов с открытым исходным кодом, таких как PrimeFaces и OmniFaces .
Обработчики тегов
Если вы хотите управлять построением дерева компонентов JSF вместо рендеринга вывода HTML, тогда вы должны использовать обработчик тега вместо компонента.
Примеры:
Примеры проектов
Вот несколько примеров проектов, в которых используются все вышеперечисленные методы.
Может ли производительность отличаться?
Техническипроблема производительности незначительна.Выбор должен быть сделан на основе конкретных функциональных требований и конечной степени абстракции, возможности повторного использования и ремонтопригодности реализации.Каждый подход имеет свою четко определенную цель и ограничения.
Составные компоненты, однако, имеют значительные накладные расходы при создании / восстановлении представления (в частности, при сохранении / восстановлении состояния представления).И в более старых версиях Mojarra у составных компонентов были проблемы с производительностью при назначении значений по умолчанию, это уже исправлено с 2.1.13.Кроме того, у Mojarra была утечка памяти , когда <cc:attribute method-signature> используется для выражений методов, в основном, все дерево компонентов повторно ссылается в сеансе HTTP, это исправлено начиная с 2.1.29 / 2.2.8.Утечка памяти может быть обойдена в более старых версиях 2.1, как показано ниже:
<context-param>
<param-name>com.sun.faces.serializeServerState</param-name>
<param-value>true</param-value>
</context-param>
или в более старых версиях 2.2, как показано ниже:
<context-param>
<param-name>javax.faces.SERIALIZE_SERVER_STATE</param-name>
<param-value>true</param-value>
</context-param>
Тем не менее, когда у вас относительно "много"составные компоненты, и вы установили javax.faces.STATE_SAVING_METHOD на client, тогда производительность будет проблемой.Не злоупотребляйте составными компонентами, если вы просто хотите получить базовую функциональность, которая уже возможна с помощью простого включаемого файла или файла тегов.Не используйте простоту настройки (читай: файл *.taglib.xml не требуется) в качестве предлога для предпочтения составных компонентов над файлами тегов.
При использовании Mojarra 2.2.10 или более ранней версии не забудьте отключить относительно короткий период обновления Facelets для производственного режима:
<context-param>
<param-name>javax.faces.FACELETS_REFRESH_PERIOD</param-name>
<param-value>-1</param-value>
</context-param>
Не используйте этот параметр для разработки, в противном случае вы 'Перезапустите весь сервер, чтобы изменения в файлах Facelets были отражены!Mojarra 2.2.11 и новее, и MyFaces уже по умолчанию -1, когда javax.faces.PROJECT_STAGE не установлен на Development.