Составной компонент структуры папок

Question

JSF спецификации 2.2 (2013-03-20) говорит, что в пункте 10.3.3.1 (Декларирование составной библиотеки компонентов для использования на странице Facelet):

Если facelet библиотеку тегов объявлен в страница с XHTML с пространством имен, начиная со строкой «http://java.sun.com/jsf/composite/» (без кавычек), остальная часть декларации пространства имен берутся как название библиотеки ресурсов [...]

Если подстрока следующая « http://java.sun.com/jsf/composite/ "содержит символ"/"или любые символы, не являющиеся законными для имени библиотеки fo должны быть приняты меры. Если application.getProjectStage() - Разработка, информационное сообщение об ошибке должно быть размещено на странице и также занесено в журнал. В противном случае сообщение должно быть зарегистрировано только.

Так это означает, что это незаконно, чтобы иметь следующую структуру папок:

resources 
    components 
     system 
     something_specific 
     something_even_more_specific 

и относятся к библиотеке имени «http://java.sun.com/jsf/composite/components/something_specific»? Это верно?

Это похоже на странное ограничение. Я хочу, чтобы мои источники были структурированы, а не собраны вместе в огромном куске.

Такая иерархическая библиотека фактически работает в Wildfly 8.0.0.CR1, но я не уверен, насколько разумно полагаться на это поведение.

Ответы на «лучшие практики» приветствуются.

Answer 1

Я обобщу свои выводы.

Источники: JSF spec issue 740, discussion preceding issue 740, another discussion, JSF spec issue 1141, discussion preceding issue 1141.

Слэш в имени библиотеки запрещен. Разрешено разрезать имя ресурса.

На практике на Mojarra 2.2.5 библиотека составных компонентов работает как в объявлении пространства имен XHTML, так и в <composite-library-name>components/system</composite-library-name> taglib. Я ожидаю, что в будущем Моджарра и/или версии спецификации JSF могут по-прежнему ломаться. Если вы используете это, вы находитесь в милости разработчиков JSF spec/impl. Связанные проблемы и дискуссии показали, что они готовы сохранять обратную совместимость даже для непреднамеренных функций.

В MyFaces имеется специальная настройка, org.apache.myfaces.STRICT_JSF_2_ALLOW_SLASH_LIBRARY_NAME (MyFaces issue 3454). Я полагаю, что использование библиотеки ресурсов со слэшами в названии с использованием этого параметра может привести к нарушению некоторых функций, таких как управление версиями ресурсов JSF (как узнать, какая часть является именем библиотеки и какая часть принадлежит имени ресурса?).

Я думаю, что иерархия библиотека составной компонент может быть реализован за счет импорта компонентов в TagLib один за другим:

<tag> 
    <tag-name>test</tag-name> 
    <component> 
     <resource-id> 
      components/system/test.xhtml 
     </resource-id> 
    </component> 
</tag> 

Таким образом, имя библиотеки фактически становится «компоненты» и имя ресурса становится «система/test.xhtml ».

Answer 2

после некоторого опыта, я думаю, что эти заявления следует читать:

• остальная часть декларации пространства имен принимаются как имя библиотеки ресурсов http://java.sun.com/jsf/composite/components/system должен соответствовать /resources/components/system

• любые символы, не являющиеся юридическими для имени библиотеки

  если объявить http://java.sun.com/jsf/composite/components/system2 и /resources/components/system2 не существует, принимать меры

  Warning: This page calls for XML namespace http://java.sun.com/jsf/composite/components/system2 declared with prefix y but no taglibrary exists for that namespace.

так это абсолютно легально объявить

xmlns:x="http://java.sun.com/jsf/composite/components/system" 

и любую другую структуру папок, которая существует в рамках/ресурсов