Когда использовать <ui: include>, файлы тегов, составные компоненты и / или пользовательские компоненты?

Question 1

Недавно я начал использовать JSF 2.0 с Facelets и был озадачен новыми составными компонентами, зная существующие <ui:include>и другие методы создания шаблонов, предлагаемые Facelets 1.x.

В чем разница между этими подходами? Функционально они, кажется, предлагают примерно то же самое: файлы тегов <ui:param>vs <cc:attribute>, <ui:insert>+ <ui:define>vs, повторное использование существующих шаблонов. Есть ли что-нибудь помимо синтаксиса и четкой спецификации интерфейса в случае составных компонентов? Могут ли отличаться характеристики?

Question 2

В чем разница между этими подходами?

Шаблоны Facelet

Используйте шаблоны Facelet (например <ui:composition>, <ui:include>и <ui:decorate>), если вы хотите разделить фрагменты макета главной страницы на повторно используемые шаблоны. Например, заголовок, меню, контент, нижний колонтитул и т. Д.

Примеры:

Файлы тегов Facelet

Используйте файлы тегов Facelet, если вы хотите иметь повторно используемую группу компонентов, чтобы предотвратить / минимизировать дублирование кода. Например, группа компонентов label + input + message. Основное различие с составными компонентами состоит в том, что выходные данные файла тегов Facelet не представляют собой единичные данные UIComponentи могут в некоторых обстоятельствах быть единственным решением, когда составного компонента недостаточно. Как правило, наличие <ui:include>с одним или несколькими <ui:param>объектами, которые передают свойство управляемого компонента (и, следовательно, не жестко запрограммированное значение), является сигналом о том, что включаемый файл может лучше быть файлом тегов.

Примеры:

Композитные компоненты

Используйте составные компоненты, если вы хотите создать единый и многократно используемый заказ UIComponentс единой ответственностью, используя чистый XML. Такой составной компонент обычно состоит из группы существующих компонентов и / или HTML и физически отображается как один компонент и должен быть привязан к одному свойству bean-компонента. Например , компонент , который представляет собой единый java.util.Dateобъект по 3 зависимых <h:selectOneMenu>компонентов, или компонента , который сочетает в себе <p:fileUpload>и <p:imageCropper>в единую со <my:uploadAndCropImage>ссылкой единый пользовательский com.example.Imageобъект как собственность.

Примеры:

Пользовательские компоненты

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

Обработчики тегов

Если вы хотите управлять построением дерева компонентов JSF вместо рендеринга вывода HTML, вам следует использовать обработчик тегов вместо компонента.

Примеры:

Примеры проектов

Вот несколько примеров проектов, в которых используются все вышеупомянутые методы.

Могут ли отличаться характеристики?

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

Однако составные компоненты имеют значительные накладные расходы во время построения / восстановления представления (в частности: во время сохранения / восстановления состояния представления). И в более старых версиях Mojarra у составных компонентов были проблемы с производительностью при назначении значений по умолчанию, это уже исправлено, начиная с 2.1.13. Кроме того, у Mojarra была утечка памяти, когда a <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.