Cette action positionne la valeur d'une ou plusieurs propriétés du composant JavaBeans à partir soit d'une valeur statique, soit d'une valeur dynamique soit les valeurs des paramètres de la requête. <% -- Syntaxe -- %>
<jsp:setProperty
name="Nom_de_l'instance_du_Bean"
[ property= "*" ] |
[ property="Nom_de_la_propriété"
[ param="Nom_du_paramètre" ] ] |
[ property="Nom_de_la_propriété"
value="Valeur|<%= expression %>" ]
/>
name | Nom d'un bean. Cet attribut est obligatoire
| property |
Nom de la propriété du bean à modifier, ou le symbole * pour modifier toutes les propriétés dont les noms correspondent aux paramètres de la requête. Cet attribut est obligatoire
| param |
Nom d'un paramètre de la requête contenant la valeur si celui est différent du nom de la propriété. Cet attribut est optionnel
| value |
Une valeur par défaut à attribuer à la propriété si elle est absente de la requête. Cet attribut ne peut être combiné avec l'attribut param. Cet attribut est optionnel
|
L'exemple ci-dessous montre les différentes utilisations de l'action setProperty. Nous faisons abstractions des déclarations des composants JavaBeans sollicités. <%-- On garde l'heure et la date de la dernière requête --%
<jsp:setProperty name="userBean" property="lastRequest"
value="<% new java.util.Date() %>" />
<%-- On récupére de la requête l'ID de l'utilisateur --%>
<jsp:setProperty name="userBean" property="userID" param="uid" />
<%-- On récupére tous les paramètres de la requête --%>
<jsp:setProperty name="requestBean" property="*" />
Comme vous pouvez le voir dans le dernier exemple, JSP permet d'extraire tous les paramètres d'une requête facilement à condition qu'ils aient la même appelation que les attibuts de bean. |