Ho iniziato a utilizzare JSF 2.0 con Facelets di recente e sono rimasto sconcertato dai nuovi componenti compositi che conoscevano le <ui:include>tecniche esistenti e di altro tipo offerte da Facelets 1.x.

Qual è la differenza tra questi approcci? Funzionalmente sembrano offrire più o meno lo stesso: <ui:param>vs <cc:attribute>, <ui:insert>+ <ui:define>vs file di tag, riutilizzo dei modelli esistenti. C'è qualcosa oltre alla sintassi e alle chiare specifiche dell'interfaccia in caso di componenti compositi? Le prestazioni potrebbero differire?

Qual è la differenza tra questi approcci?

Modelli di facelet

Usa i modelli Facelet (come in <ui:composition>, <ui:include>e <ui:decorate>) se vuoi dividere i frammenti del layout della pagina principale in modelli riutilizzabili. Ad esempio intestazione, menu, contenuto, piè di pagina, ecc.

Esempi:

• Come includere un altro XHTML in XHTML usando JSF 2.0 Facelets?
• Qual è la vera differenza concettuale tra ui: decorate e ui: include?
• Come personalizzare h: head quando si utilizza ui: modello di composizione?
• Come cambiare gli elementi di intestazione di una pagina quando si usa ui: composizione
• Come aggiornare ajax include contenuto dinamico dal menu di navigazione? (JSF SPA)

File di tag facelet

Utilizza i file dei tag Facelet se desideri disporre di un gruppo di componenti riutilizzabili per prevenire / ridurre al minimo la duplicazione del codice. Ad esempio un gruppo di componenti etichetta + input + messaggio. La principale differenza con i componenti compositi è che l'output di un file di tag Facelet non rappresenta un singolo UIComponente in alcune circostanze può essere l'unica soluzione quando un componente composito non è sufficiente. Generalmente, avere un <ui:include>con uno o più file<ui:param> che passa una proprietà del bean gestito (e quindi non un valore hardcoded) è un segnale che il file include può essere meglio un file di tag.

Esempi:

• Come creare un tag Facelets personalizzato?
• Come realizzare una griglia di un componente composito JSF?
• Come creare un componente composito per una colonna databile?
• Output Primefaces Etichetta per il componente composito

Componenti compositi

Usa componenti compositi se vuoi creare un custom unico e riutilizzabile UIComponentcon un'unica responsabilità usando XML puro. Un tale componente composito di solito consiste in un gruppo di componenti esistenti e / o HTML e viene reso fisicamente come singolo componente e si suppone che sia associato a una singola proprietà del bean. Ad esempio un componente che rappresenta una singola java.util.Dateproprietà da 3 <h:selectOneMenu>componenti dipendenti , o un componente che combina <p:fileUpload>e <p:imageCropper>in un unico <my:uploadAndCropImage>riferimento a una singola abitudinecom.example.Image entità come proprietà.

Esempi:

• La nostra pagina wiki sui componenti compositi
• Il codice BalusC: componente composito con più campi di input
• Suddividi java.util.Date su due campi h: inputText che rappresentano ora e minuti con f: convertDateTime
• Seleziona tutti gli elementi in Multiple SelectManyCheckBox con ID dinamici
• Estensione del componente commandLink JSF
• Evitare gli ID duplicati quando si riutilizzano le composizioni di facelets nello stesso contenitore di denominazione

Componenti personalizzati

Utilizzare un componente personalizzato ogni volta che la funzionalità non può essere ottenuta con file di tag Facelet o componenti compositi, a causa della mancanza di supporto nel set di componenti standard / disponibile. Esempi possono essere trovati ovunque nel codice sorgente di librerie di componenti open source come PrimeFaces e OmniFaces .

Gestori di tag

Quando si desidera controllare la creazione dell'albero dei componenti JSF invece del rendering dell'output HTML, è necessario utilizzare un gestore di tag invece di un componente.

Esempi:

• Componente Facelet personalizzato in JSF
• Come posso accedere al contenuto di qualcosa creato con <ui: define> a livello di codice?
• Rendering condizionale nel tagfile a seconda che l'attributo sia specificato o meno
• Esecuzione di un reindirizzamento, quando la conversione / convalida associata ai parametri di query non riesce

Progetti di esempio

Ecco alcuni progetti di esempio che utilizzano tutte le tecniche sopra menzionate.

• App Java EE Kickoff ( modelli - include - tagfiles - composito )
• OmniFaces Showcase ( modelli - include - tagfiles - composito )

Le prestazioni potrebbero differire?

Tecnicamente, la preoccupazione per le prestazioni è trascurabile. La scelta dovrebbe essere fatta sulla base dei requisiti funzionali concreti e del grado finale di astrazione, riusabilità e manutenibilità dell'implementazione. Ogni approccio ha il proprio scopo e i propri limiti ben definiti.

I componenti compositi hanno tuttavia un sovraccarico significativo durante la costruzione / ripristino della vista (in particolare: durante il salvataggio / ripristino dello stato di visualizzazione). E, nelle versioni precedenti di Mojarra, i componenti compositi avevano problemi di prestazioni con l'assegnazione dei valori predefiniti, questo è già stato risolto dalla 2.1.13. Inoltre, Mojarra ha avuto una perdita di memoria quando a <cc:attribute method-signature>viene utilizzato per le espressioni del metodo, fondamentalmente l'intero albero dei componenti viene ri-referenziato nella sessione HTTP, questo è stato risolto dalla 2.1.29 / 2.2.8. La perdita di memoria può essere aggirata nelle versioni 2.1 precedenti come di seguito:

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

O nelle versioni 2.2 precedenti come di seguito:

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

Tuttavia, quando si hanno relativamente "molti" componenti compositi e si è javax.faces.STATE_SAVING_METHODimpostato suclient , le prestazioni saranno un dolore. Non abusare dei componenti compositi se desideri semplicemente la funzionalità di base che è già possibile con un semplice file include o tag. Non utilizzare la facilità di configurazione (leggi: nessun *.taglib.xmlfile necessario) come scusa per preferire i componenti compositi ai file di tag.

Quando si utilizza Mojarra 2.2.10 o versioni precedenti, non dimenticare di disabilitare il periodo di aggiornamento dei Facelets relativamente breve per la modalità di produzione:

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

Non utilizzare questa impostazione per lo sviluppo, altrimenti devi riavviare l'intero server per far sì che le modifiche nei file Facelets si riflettano! Mojarra 2.2.11 e versioni successive e MyFaces è già impostato su -1quando javax.faces.PROJECT_STAGEnon è impostato su Development.