JSP Bibliothèque de balises standard (JSTL)
La bibliothèque de balises standard JSP (JSTL) est un ensemble de balises JSP qui encapsule les fonctionnalités de base communes des applications JSP.
JSTL prend en charge des tâches courantes et structurées telles que l'itération, le jugement conditionnel, la manipulation de documents XML, les balises d'internationalisation et les balises SQL. En plus de celles-ci, il fournit également un cadre pour l'utilisation de balises personnalisées qui s'intègrent à JSTL.
Selon les fonctionnalités fournies par les balises JSTL, elles peuvent être divisées en 5 catégories.
- Balises de base
- Balises de mise en forme
- Balises SQL
- Balises XML
- Fonctions JSTL
Installation de la bibliothèque JSTL
Les étapes d'installation de la bibliothèque JSTL dans Apache Tomcat sont les suivantes :
Le paquet binaire (jakarta-taglibs-standard-current.zip) téléchargé depuis la bibliothèque de balises standard d'Apache.
- Adresse de téléchargement officielle :http://archive.apache.org/dist/jakarta/taglibs/standard/binaries/
- Adresse de téléchargement de ce site :jakarta-taglibs-standard-1.1.2.zip
Téléchargezjakarta-taglibs-standard-1.1.2.ziple paquet et extrayez-le, puisjakarta-taglibs-standard-1.1.2/lib/les deux fichiers jar sous :standard.jaretjstl.jarCopiez les fichiers dans/WEB-INF/lib/.
Copiez les fichiers tld requis du répertoire tld vers le répertoire WEB-INF.
Ensuite, ajoutez la configuration suivante au fichier web.xml :
<?xml version="1.0" encoding="UTF-8"?>
<web-app version="2.4"
xmlns="http://java.sun.com/xml/ns/j2ee"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee
http://java.sun.com/xml/ns/j2ee/web-app_2_4.xsd">
<jsp-config>
<taglib>
<taglib-uri>http://java.sun.com/jsp/jstl/fmt</taglib-uri>
<taglib-location>/WEB-INF/fmt.tld</taglib-location>
</taglib>
<taglib>
<taglib-uri>http://java.sun.com/jsp/jstl/fmt-rt</taglib-uri>
<taglib-location>/WEB-INF/fmt-rt.tld</taglib-location>
</taglib>
<taglib>
<taglib-uri>http://java.sun.com/jsp/jstl/core</taglib-uri>
<taglib-location>/WEB-INF/c.tld</taglib-location>
</taglib>
<taglib>
<taglib-uri>http://java.sun.com/jsp/jstl/core-rt</taglib-uri>
<taglib-location>/WEB-INF/c-rt.tld</taglib-location>
</taglib>
<taglib>
<taglib-uri>http://java.sun.com/jsp/jstl/sql</taglib-uri>
<taglib-location>/WEB-INF/sql.tld</taglib-location>
</taglib>
<taglib>
<taglib-uri>http://java.sun.com/jsp/jstl/sql-rt</taglib-uri>
<taglib-location>/WEB-INF/sql-rt.tld</taglib-location>
</taglib>
<taglib>
<taglib-uri>http://java.sun.com/jsp/jstl/x</taglib-uri>
<taglib-location>/WEB-INF/x.tld</taglib-location>
</taglib>
<taglib>
<taglib-uri>http://java.sun.com/jsp/jstl/x-rt</taglib-uri>
<taglib-location>/WEB-INF/x-rt.tld</taglib-location>
</taglib>
</jsp-config>
</web-app>
Pour utiliser une bibliothèque, vous devez inclure la<taglib>balise en haut de chaque fichier JSP.
Balises de base
Les balises Core sont les balises JSTL les plus couramment utilisées. La syntaxe pour référencer la bibliothèque de balises core est la suivante :
<%@ taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core" %>
| Balise | Description |
|---|---|
| <c:out> | Utilisé pour afficher des données dans JSP, tout comme <%= ... > |
| <c:set> | Utilisé pour enregistrer des données |
| <c:remove> | Utilisé pour supprimer des données |
| <c:catch> | Utilisé pour gérer les conditions exceptionnelles qui produisent des erreurs et pour stocker les informations sur l'erreur |
| <c:if> | Identique au if utilisé dans la programmation générale |
| <c:choose> | Sert uniquement de balise parente de <c:when> et <c:otherwise> |
| <c:when> | Une balise enfant de <c:choose>, utilisée pour déterminer si une condition est vraie |
| <c:otherwise> | Une balise enfant de <c:choose>, placée après la balise <c:when>, exécutée lorsque la balise <c:when> est évaluée à false |
| <c:import> | Récupère une URL absolue ou relative, puis expose son contenu à la page |
| <c:forEach> | Balise d'itération de base, accepte plusieurs types de collections |
| <c:forTokens> | Sépare le contenu selon le délimiteur spécifié et le restitue de manière itérative |
| <c:param> | Utilisé pour transmettre des paramètres aux pages incluses ou redirigées |
| <c:redirect> | Redirige vers une nouvelle URL. |
| <c:url> | Crée une URL avec des paramètres de requête facultatifs |
Balises de mise en forme
Les balises de formatage JSTL sont utilisées pour formater et afficher du texte, des dates, des heures et des nombres. La syntaxe pour référencer la bibliothèque de balises de formatage est la suivante :
<%@ taglib prefix="fmt"
uri="http://java.sun.com/jsp/jstl/fmt" %>
| Balise | Description |
|---|---|
| <fmt:formatNumber> | Formate les nombres à l'aide du format ou de la précision spécifiés |
| <fmt:parseNumber> | Analyse une chaîne représentant un nombre, une devise ou un pourcentage |
| <fmt:formatDate> | Formate les dates et les heures à l'aide du style ou du modèle spécifié |
| <fmt:parseDate> | Analyse une chaîne représentant une date ou une heure |
| <fmt:bundle> | Lie des ressources |
| <fmt:setLocale> | Spécifie la locale |
| <fmt:setBundle> | Lie des ressources |
| <fmt:timeZone> | Spécifie le fuseau horaire |
| <fmt:setTimeZone> | Spécifie le fuseau horaire |
| <fmt:message> | Affiche les informations du fichier de configuration du bundle de ressources |
| <fmt:requestEncoding> | Définit l'encodage des caractères de la requête |
Balises SQL
La bibliothèque de balises SQL JSTL fournit des balises pour interagir avec des bases de données relationnelles (Oracle, MySQL, SQL Server, etc.). La syntaxe pour référencer la bibliothèque de balises SQL est la suivante :
<%@ taglib prefix="sql"
uri="http://java.sun.com/jsp/jstl/sql" %>
| Balise | Description |
|---|---|
| <sql:setDataSource> | Spécifie la source de données |
| <sql:query> | Exécute des instructions de requête SQL |
| <sql:update> | Exécute des instructions de mise à jour SQL |
| <sql:param> | Définit les paramètres d'une instruction SQL sur les valeurs spécifiées |
| <sql:dateParam> | Définit le paramètre de date dans une instruction SQL sur la valeur d'objet java.util.Date spécifiée |
| <sql:transaction> | Fournit des éléments de comportement de base de données imbriqués dans une connexion de base de données partagée, en exécutant toutes les instructions comme une seule transaction |
Balises XML
La bibliothèque de balises JSTL XML fournit des balises pour créer et manipuler des documents XML. La syntaxe pour référencer la bibliothèque de balises XML est la suivante :
<%@ taglib prefix="x"
uri="http://java.sun.com/jsp/jstl/xml" %>
Avant d'utiliser les balises XML, vous devez copier les paquets liés à XML et XPath dans votre <répertoire d'installation de Tomcat>\lib :
- XercesImpl.jar
Adresse de téléchargement :http://www.apache.org/dist/xerces/j/
- xalan.jar
Adresse de téléchargement :http://xml.apache.org/xalan-j/index.html
| Balise | Description |
|---|---|
| <x:out> | Similaire à <%= ... >, mais utilisé uniquement pour les expressions XPath |
| <x:parse> | Analyse les données XML |
| <x:set> | Définit l'expression XPath |
| <x:if> | Évalue l'expression XPath ; si vrai, exécute le contenu dans le corps, sinon ignore le corps |
| <x:forEach> | Itère sur les nœuds d'un document XML |
| <x:choose> | La balise parente de <x:when> et <x:otherwise> |
| <x:when> | Une balise enfant de <x:choose>, utilisée pour un jugement conditionnel |
| <x:otherwise> | Une balise enfant de <x:choose>, exécutée lorsque <x:when> est évalué à false |
| <x:transform> | Applique une transformation XSL à un document XML |
| <x:param> | Utilisé avec <x:transform> pour définir la feuille de style XSL |
Fonctions JSTL
JSTL contient une série de fonctions standard, dont la plupart sont des fonctions de traitement de chaînes à usage général. La syntaxe de référencement de la bibliothèque de fonctions JSTL est la suivante :
<%@ taglib prefix="fn"
uri="http://java.sun.com/jsp/jstl/functions" %>
| Fonction | Description |
|---|---|
| fn:contains() | Teste si la chaîne d'entrée contient la sous-chaîne spécifiée |
| fn:containsIgnoreCase() | Teste si la chaîne d'entrée contient la sous-chaîne spécifiée, sans tenir compte de la casse |
| fn:endsWith() | Teste si la chaîne d'entrée se termine par le suffixe spécifié |
| fn:escapeXml() | Échappe les caractères pouvant être utilisés comme balisage XML |
| fn:indexOf() | Renvoie la position de la chaîne spécifiée dans la chaîne d'entrée |
| fn:join() | Joint les éléments d'un tableau en une chaîne et l'affiche |
| fn:length() | Renvoie la longueur d'une chaîne |
| fn:replace() | Remplace la position spécifiée dans la chaîne d'entrée par la chaîne spécifiée et la renvoie |
| fn:split() | Divise la chaîne à l'aide du délimiteur spécifié pour former un tableau de sous-chaînes et le renvoie |
| fn:startsWith() | Teste si la chaîne d'entrée commence par le préfixe spécifié |
| fn:substring() | Renvoie un sous-ensemble de la chaîne |
| fn:substringAfter() | Renvoie le sous-ensemble de la chaîne après la sous-chaîne spécifiée |
| fn:substringBefore() | Renvoie le sous-ensemble de la chaîne avant la sous-chaîne spécifiée |
| fn:toLowerCase() | Convertit les caractères de la chaîne en minuscules |
| fn:toUpperCase() | Convertit les caractères de la chaîne en majuscules |
| fn:trim() | Supprime les espaces blancs de début et de fin |