Capitolo 20. Supporto RSS

20.1. Installazione
20.2. Generare dei feed
20.3. I feed
20.4. Elementi
20.5. Link e ulteriore documentazione

Con Seam è semplice gestire i feed RSS tramite la libreria YARFRAW. Il supporto RSS in questa versione è da considerarsi nello stato di anteprima.

20.1. Installazione

Per abilitare il supporto RSS includere jboss-seam-rss.jar nella cartella WEB-INF/lib dell'applicazione. La libreria RSS ha anche alcune dipendenze che devono essere posizionate nella stessa cartella. Vedi Sezione 42.2.6, «Supporto Seam RSS» per la lista delle librerie da includere.

Il supporto RSS in Seam richiede di utilizzare Facelets come tecnologia per la vista.

20.2. Generare dei feed

Il progetto examples/rss contiene un esempio del supporto RSS in azione. Mostra il modo appropriato per posizionare le librerie e illustra le funzionalità esposte.

Un feed è una pagina xhtml che consiste in un feed e una lista di elementi annidati.




            <r:feed 

               xmlns="http://www.w3.org/1999/xhtml" 

               xmlns:ui="http://java.sun.com/jsf/facelets" 

               xmlns:r="http://jboss.com/products/seam/rss"

               title="#{rss.feed.title}"

               uid="#{rss.feed.uid}"

               subtitle="#{rss.feed.subtitle}"

               updated="#{rss.feed.updated}"

               link="#{rss.feed.link}">

               <ui:repeat value="#{rss.feed.entries}" var="entry">

                  <r:entry

                     uid="#{entry.uid}"

                     title="#{entry.title}"

                     link="#{entry.link}"

                     author="#{entry.author}"

                     summary="#{entry.summary}"

                     published="#{entry.published}"

                     updated="#{entry.updated}"

                          />

                   </ui:repeat>

            </r:feed>

20.3. I feed

I feed sono delle entità di primo livello che descrivono le proprietà della sorgente di informazioni. Possono contenere uno o più elementi.

<r:feed>

Attributi

uid — Un identificativo unico opzionale. Il valore è una stringa.
title — Il titolo del feed. Il valore è una stringa.
subtitle — Il sottotitolo del feed. Il valore è una stringa.
updated — Quando è stato aggiornato il feed? Il valore è una data.
link — Il link alla fonte dell'informazione. Il valore è una stringa.
feedFormat — Il formato del feed. Il valore è una stringa con default ATOM1. I valori ammessi sono RSS10, RSS20, ATOM03 e ATOM10.

Elementi contenuti

Zero o più elementi

Facets

nessuna

20.4. Elementi

Gli elementi rappresentano i "titoli" del feed.

<r:feed>

Attributi

uid — Un identificativo unico opzionale. Il valore è una stringa.
title — Il titolo dell'elemento. Il valore è una stringa.
link — Un link all'articolo. Il valore è una stringa.
author — L'autore dell'articolo. Il valore è una stringa.
summary — Il corpo dell'articolo. Il valore è una stringa.
textFormat — Il formato del corpo e del titolo dell'articolo. Il valore è una stringa e i valori ammessi sono "text" e "html". Il valore di default è "html".
published — Quando è stato pubblicato l'articolo? Il valore è una data.
updated — Quando è stato aggiornato l'articolo? Il valore è una data.

Elementi contenuti

nessuna

Facets

nessuna

20.5. Link e ulteriore documentazione

Alla base del supporto RSS c'è la libreria YARFRAW che si può trovare all'indirizzo http://yarfraw.sourceforge.net/ e da questa deriva la maggior parte delle caratteristiche e delle limitazioni.

Per i dettagli sul formato ATOM 1.0, si veda sulle specifiche

Per i dettagli sul formato RSS 2.0, si veda su le specifiche.