SeamFramework.orgCommunity Documentation
Seam fourni un extention pour le Langage d'Expression Unifiée (EL) standardisé appelé JBoss EL. JBoss EL fournit un nombre d'amélioration qui augmente l'expressivité et la puissance des expressions EL.
Le EL standard ne vous permet d'utiliser une méthode où l'utilisateur définir les paramètres — bien sur, les méthodes d'écoute de JSF (par exemple, un valueChangeListener) prends les paramètres fournis par JSF.
JBoss EL retire cette restriction. Par exemple:
<h:commandButton action="#{hotelBooking.bookHotel(hotel)}" value="Book Hotel"/>
@Name("hotelBooking")
public class HotelBooking {
public String bookHotel(Hotel hotel) {
// Book the hotel
}
}
Appelez juste cette méthode depuis Java, les paramètres sont entourés par des parenthèses, et séparés par des virgules:
<h:commandButton action="#{hotelBooking.bookHotel(hotel, user)}" value="Book Hotel"/>
Les paramètres hotel et user seront évalués comme des expressions de valeur et passés à la méthode du composant bookHotel().
Tout expression de valeur peut être utilisé comme un paramètre:
<h:commandButton
action="#{hotelBooking.bookHotel(hotel.id, user.username)}"
value="Book Hotel"/>
Il est important de bien comprends comme cette extension de EL fonctionne. Quand la page est rendu, le paramètres names est stocké (par exemple, hotel.id et user.username) et évalués (comme des expressions de valeur) quand la page est soumise. Vous ne pouvez passer des objets comme des paramètres!
Vous devez vous assurer que les paramètres sont disponibles pas seulement quand la page est rendue mais aussi quand elle est soumis. Si l'argument ne peut être résolu quand la page est soumise la méthode d'action sera appelée avec des arguments null!
Vous pouvez aussi passer des chaines de caractères en utilisant les apostrophes:
<h:commandLink action="#{printer.println('Hello world!')}" value="Hello"/>
EL unifié supporte aussi les expressions de valeur, utilisés pour trouver un champs d'un bean arrière. Les expressions de valeurs utilise les conventions de nommage des JavaBeans et s'attends à une paire d'assesseurs. Souvent JSF attends une expression de valeur avec seulement une lecture (get) est nécéssaire (par exemple l'attribut rendered). Beaucoup d'objets, cependant, n'ont pas les asseceurs de propriétés dénommé de manière approprié ou nécéssite des paramètres.
JBoss EL retire cette restriction qui permet aux valeurs d'êre retrouvé en utilisant la syntaxe des méthodes. Par exemple:
<h:outputText value="#{person.name}" rendered="#{person.name.length()
> 5}" />
Vous pouvez accéder à la taille de la collection de manière similaire:
#{searchResults.size()}En égénral, toute expression de la forme #{obj.property} devrait être indentique à l'expression #{obj.getProperty()}.
Les paramètres sont aussi permis. L'exemple suivant appelle productsByColorMethod avec un argument chaine de caractère litérale:
#{controller.productsByColor('blue')}Avec l'utilisation de JBoss EL, vous devriez garder les points suivants en tête:
Incompatibilité avec JSP 2.1 — JBoss EL ne peut actuellement pas être utilisé avec JSP 2.1 car le compilateur rejette les epxressions avec des paramètres. Donc, si vous voulez utiliser cette extension avec JSF 1.2, vous allez devoir utiliser les Facelets. L'extension fonctionne correctement avec JSP 2.0.
Utilisation de composants itératif à l'intérieur — Les composants comme <c:forEach /> et <ui:repeat />itérate au travers d'une List ou d'un tableau, exposant chaque élément de la liste au composant lié. Cela fonctionne bien si vous avez sélectionné une ligne en utilisant <h:commandButton /> ou <h:commandLink />:
@Factory("items")
public List<Item
> getItems() {
return entityManager.createQuery("select ...").getResultList();
}
<h:dataTable value="#{items}" var="item">
<h:column>
<h:commandLink value="Select #{item.name}" action="#{itemSelector.select(item})" />
</h:column>
</h:dataTable
>
Cependant si vous voulez utiliser <s:link /> ou <s:button /> vous devez exposer les élements au DataModel, et utiliser une <dataTable /> (ou une équivalence d'un composant défini comme <rich:dataTable /> ). Ni <s:link /> ou <s:button /> soumettent le formulaire (et ainsi produisent un lien capable d'être en favori) donc un paramètre "magique" est nécéssaire pour recréer l'élement quand la méthode d'action est appelée. Ce paramètre magique peut seuelement êrte ajouté quand le tableau de donnée liée avec un un DataModel est utilisé.
L'appel à MethodExpression depuis du code Java — Normallement, quand une MethodExpression est crée, les types des paramètres sont passés par JSF. Dans le cas d'une liaison de méthode, JSF suppose qu'il n'y a aucun paramètres à passer. Avec cette extension, nous ne pouvons pas savoir les types de paramètres tant que l'expression n'a pas été évaluée. Ceci a deux conséquences mineures:
Quand vous invoquez une MethodExpression dans du code Java, les paramètres que vous passez sont ignorés. Les paramètres définis dans l'expression prendront la priorité.
Ordinairement, il est plus sûr it d'appeler methodExpression.getMethodInfo().getParamTypes() à chaque fois. Pour une expression avec des paramètres, vous devez en premier invoquer la MethodExpression avant l'apperl de getParamTypes().
Ces deux cas sont extrêmement rare et ne s'applique que quand vous voulez invoquerMethodExpression à la main dans du code Java.
JBoss EL supporte une syntaxe de projection limitée. Une expression de projection correspond une sous-expression au travers d'expression de multiples valeurs (list, set, etc...). Par exemple, l'expression:
#{company.departments}doit retourner une liste de département. Si vous avez seulement besoin d'une liste de noms de département, votre seule option est d'itérer au travers de la liste pour retrouver les valeurs. JBoss EL permet cela avec une expression de projection:
#{company.departments.{d|d.name}}La sous-expression est entouré par des accolades. Dans cet exemple, l'expression d.name est évalué pour chaque département, en utilisant d comme un alias sur l'objet département. Le résultat de cette expression est une liste de valeurs String.
Toute expression valide peut être utilisée comme une expression, ainsi il est parfaitement valide d'écrire ce qui suit, en supposant que vous avez une utilisation de la longeurs de tous les noms de département dans une entreprise:
#{company.departments.{d|d.size()}}Les projections peuvent être liée. L'expression suivante retourne les noms de familles de chaque employé dans chaque département:
#{company.departments.{d|d.employees.{emp|emp.lastName}}}Les projections liées peuvent être légèrement épineuse, toutefois. L'expression suivante devrait faire comme si elle retourne une liste de tous les employés dans tous les départements:
#{company.departments.{d|d.employees}}Cependant, elle retourne actuellement une liste contenant une liste des employés pour chaque département individuellement. Pour combiner les valeurs, il est nécéssaire d'utiliser une expression légèrement plus longue:
#{company.departments.{d|d.employees.{e|e}}}Il est important de noter que la syntaxe ne peut être analysé par les Facelets ou par JSP et ainsi ne peut être utilisé dans les fichiers xhtml ou JSP. Nous anticipons que la syntaxe de projection va changer dans les futures versions de JBoss EL.