Comecei a usar JSF 2.0 com Facelets recentemente e fiquei intrigado com os novos componentes compostos, sabendo das <ui:include>técnicas existentes e de outras técnicas de modelagem oferecidas pelo Facelets 1.x.

Qual é a diferença entre essas abordagens? Funcionalmente, eles parecem oferecer quase o mesmo: arquivos de tag <ui:param>vs <cc:attribute>, <ui:insert>+ <ui:define>vs, reutilização dos modelos existentes. Existe algo além de sintaxe e especificação de interface clara no caso de componentes compostos? O desempenho pode ser diferente?

Qual é a diferença entre essas abordagens?

Modelos de facelet

Use Facelet templates (como em <ui:composition>, <ui:include>e <ui:decorate>) se você quer dividir principais fragmentos de layout de página em modelos reutilizáveis. Por exemplo, cabeçalho, menu, conteúdo, rodapé, etc.

Exemplos:

• Como incluir outro XHTML em XHTML usando JSF 2.0 Facelets?
• Qual é a diferença conceitual real entre ui: decorate e ui: include?
• Como personalizar h: head ao usar o modelo ui: composition?
• Como alterar os elementos principais de uma página ao usar ui: composition
• Como fazer ajax-refresh dynamic include conteúdo por menu de navegação? (JSF SPA)

Arquivos de tag Facelet

Use os arquivos de tag do Facelet se desejar ter um grupo reutilizável de componentes para prevenir / minimizar a duplicação de código. Por exemplo, um grupo de componentes de etiqueta + entrada + mensagem. A principal diferença com os componentes compostos é que a saída de um arquivo de tag Facelet não representa um único UIComponente pode, em algumas circunstâncias, ser a única solução quando um componente composto não é suficiente. Geralmente, ter um <ui:include>com um ou mais <ui:param>que passa uma propriedade de bean gerenciado (e, portanto, não um valor codificado permanentemente) é um sinal de que o arquivo de inclusão pode ser melhor um arquivo de tag.

Exemplos:

• Como criar uma tag Facelets personalizada?
• Como fazer uma grade de componente composto JSF?
• Como criar um componente composto para uma coluna de dados?
• Primefaces outputLabel para componente composto

Componentes compostos

Use componentes compostos se desejar criar um personalizado único e reutilizável UIComponentcom uma única responsabilidade usando XML puro. Esse componente composto geralmente consiste em um monte de componentes existentes e / ou HTML e é renderizado fisicamente como um único componente e deve ser vinculado a uma única propriedade de bean. Por exemplo, um componente que representa uma única java.util.Datepropriedade por 3 <h:selectOneMenu>componentes dependentes , ou um componente que combina <p:fileUpload>e <p:imageCropper>em um único <my:uploadAndCropImage>referindo uma única com.example.Imageentidade personalizada como propriedade.

Exemplos:

• Nossa página wiki de componente composto
• O Código BalusC: Componente Composto com vários campos de entrada
• Divida java.util.Date em dois campos h: inputText que representam hora e minuto com f: convertDateTime
• Selecione todos os itens em Multiple SelectManyCheckBox com ids dinâmicos
• Extensão do componente JSF commandLink
• Evitando IDs duplicados ao reutilizar composições facelets no mesmo contêiner de nomenclatura

Componentes personalizados

Use um componente personalizado sempre que a funcionalidade não puder ser alcançada com arquivos de tag do Facelet ou componentes compostos, devido à falta de suporte no conjunto de componentes padrão / disponível. Os exemplos podem ser encontrados em todos os lugares no código-fonte de bibliotecas de componentes de software livre , como PrimeFaces e OmniFaces .

Manipuladores de tags

Quando você deseja controlar a construção da árvore de componentes JSF em vez de renderizar a saída HTML, deve usar um manipulador de tags em vez de um componente.

Exemplos:

• Componente Custom Facelet em JSF
• Como posso acessar o conteúdo de algo criado com <ui: define> programaticamente?
• Renderização condicional em tagfile dependendo se o atributo é especificado ou não
• Executar um redirecionamento, quando a conversão / validação associada aos parâmetros de consulta falha

Projetos de exemplo

Aqui estão alguns exemplos de projetos que utilizam todas as técnicas mencionadas acima.

• Aplicativo Java EE Kickoff ( modelos - inclui - tagfiles - composto )
• OmniFaces Showcase ( modelos - inclui - tagfiles - composto )

O desempenho pode ser diferente?

Tecnicamente, a preocupação com o desempenho é insignificante. A escolha deve ser feita com base nos requisitos funcionais concretos e no grau final de abstração, reutilização e manutenção da implementação. Cada abordagem tem seu próprio propósito e limitações bem definidas.

Os componentes compostos, entretanto, têm uma sobrecarga significativa durante a construção / restauração da vista (especificamente: durante o salvamento / restauração do estado da vista). E, nas versões mais antigas do Mojarra, os componentes compostos tinham problemas de desempenho com a atribuição de valores padrão, isso já foi corrigido desde 2.1.13. Além disso, Mojarra teve um vazamento de memória quando um <cc:attribute method-signature>é usado para expressões de método, basicamente toda a árvore de componentes é referenciada novamente na sessão HTTP, isso foi corrigido desde 2.1.29 / 2.2.8. O vazamento de memória pode ser contornado em versões 2.1 mais antigas, conforme abaixo:

<context-param>
    <param-name>com.sun.faces.serializeServerState</param-name>
    <param-value>true</param-value>
</context-param>

Ou em versões 2.2 mais antigas, conforme abaixo:

<context-param>
    <param-name>javax.faces.SERIALIZE_SERVER_STATE</param-name>
    <param-value>true</param-value>
</context-param>

Ainda assim, quando você tem relativamente "muitos" componentes compostos e os javax.faces.STATE_SAVING_METHODdefiniu client, o desempenho será péssimo. Não abuse dos componentes compostos se desejar apenas a funcionalidade básica que já é possível com um arquivo de inclusão simples ou arquivo de marca. Não use a facilidade de configuração (leia: nenhum *.taglib.xmlarquivo necessário) como uma desculpa para preferir componentes compostos a arquivos de tag.

Ao usar o Mojarra 2.2.10 ou mais antigo, não se esqueça de desativar o período de atualização do Facelets relativamente curto para o modo de produção:

<context-param>
    <param-name>javax.faces.FACELETS_REFRESH_PERIOD</param-name>
    <param-value>-1</param-value>
</context-param>

Não use esta configuração para desenvolvimento, caso contrário, você terá que reiniciar todo o servidor para que as alterações nos arquivos Facelets sejam refletidas! Mojarra 2.2.11 e mais recente, e MyFaces já assume o padrão -1quando javax.faces.PROJECT_STAGEnão está definido como Development.