JSP Standard Tag Library (JSTL)
Die JSP Standard Tag Library (JSTL) ist eine Sammlung von JSP-Tags, die die gemeinsame Kernfunktionalität von JSP-Anwendungen kapselt.
JSTL unterstützt allgemeine, strukturierte Aufgaben wie Iteration, Bedingungsprüfung, XML-Dokumentbearbeitung, Internationalisierungs-Tags und SQL-Tags. Darüber hinaus bietet es ein Framework für die Verwendung benutzerdefinierter Tags, die sich in JSTL integrieren lassen.
Entsprechend der von JSTL-Tags bereitgestellten Funktionalität können sie in 5 Kategorien unterteilt werden.
- Kern-Tags
- Formatierungs-Tags
- SQL-Tags
- XML-Tags
- JSTL-Funktionen
Installation der JSTL-Bibliothek
Die Schritte zur Installation der JSTL-Bibliothek in Apache Tomcat sind wie folgt:
Das Binärpaket (jakarta-taglibs-standard-current.zip), das von Apaches Standard Tag Library heruntergeladen wurde.
- Offizielle Download-Adresse:http://archive.apache.org/dist/jakarta/taglibs/standard/binaries/
- Download-Adresse dieser Website:jakarta-taglibs-standard-1.1.2.zip
Laden Siejakarta-taglibs-standard-1.1.2.zipherunter, das Paket, und entpacken Sie es, dannjakarta-taglibs-standard-1.1.2/lib/die beiden JAR-Dateien unter:standard.jarundjstl.jarKopieren Sie die Dateien nach/WEB-INF/lib/hinein.
Kopieren Sie die erforderlichen TLD-Dateien aus dem TLD-Verzeichnis in das WEB-INF-Verzeichnis.
Fügen Sie als Nächstes die folgende Konfiguration zur web.xml-Datei hinzu:
<?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>
Um eine beliebige Bibliothek zu verwenden, müssen Sie das<taglib>-Tag am Anfang jeder JSP-Datei einfügen.
Kern-Tags
Core-Tags sind die am häufigsten verwendeten JSTL-Tags. Die Syntax für die Referenzierung der Core-Tag-Bibliothek ist wie folgt:
<%@ taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core" %>
| Tag | Beschreibung |
|---|---|
| <c:out> | Wird verwendet, um Daten in JSP anzuzeigen, genau wie <%= ... > |
| <c:set> | Wird zum Speichern von Daten verwendet |
| <c:remove> | Wird zum Löschen von Daten verwendet |
| <c:catch> | Wird verwendet, um Ausnahmebedingungen zu behandeln, die Fehler erzeugen, und um die Fehlerinformationen zu speichern |
| <c:if> | Entspricht dem if, das in der allgemeinen Programmierung verwendet wird |
| <c:choose> | Dient selbst nur als übergeordnetes Tag von <c:when> und <c:otherwise> |
| <c:when> | Ein untergeordnetes Tag von <c:choose>, das verwendet wird, um festzustellen, ob eine Bedingung wahr ist |
| <c:otherwise> | Ein untergeordnetes Tag von <c:choose>, das nach dem <c:when>-Tag steht und ausgeführt wird, wenn das <c:when>-Tag zu false ausgewertet wird |
| <c:import> | Ruft eine absolute oder relative URL ab und macht ihren Inhalt für die Seite verfügbar |
| <c:forEach> | Grundlegendes Iterations-Tag, akzeptiert mehrere Sammlungstypen |
| <c:forTokens> | Trennt Inhalte anhand des angegebenen Trennzeichens und gibt sie iterativ aus |
| <c:param> | Wird verwendet, um Parameter an eingebundene oder umgeleitete Seiten zu übergeben |
| <c:redirect> | Leitet zu einer neuen URL weiter. |
| <c:url> | Erstellt eine URL mit optionalen Query-Parametern |
Formatierungs-Tags
JSTL-Formatierungs-Tags werden verwendet, um Text, Datumsangaben, Uhrzeiten und Zahlen zu formatieren und auszugeben. Die Syntax zum Referenzieren der Formatierungs-Tag-Bibliothek lautet wie folgt:
<%@ taglib prefix="fmt"
uri="http://java.sun.com/jsp/jstl/fmt" %>
| Tag | Beschreibung |
|---|---|
| <fmt:formatNumber> | Formatiert Zahlen unter Verwendung des angegebenen Formats oder der angegebenen Genauigkeit |
| <fmt:parseNumber> | Parst eine Zeichenkette, die eine Zahl, eine Währung oder einen Prozentsatz darstellt |
| <fmt:formatDate> | Formatiert Datumsangaben und Uhrzeiten unter Verwendung des angegebenen Stils oder Musters |
| <fmt:parseDate> | Parst eine Zeichenkette, die ein Datum oder eine Uhrzeit darstellt |
| <fmt:bundle> | Bindet Ressourcen |
| <fmt:setLocale> | Legt die Locale fest |
| <fmt:setBundle> | Bindet Ressourcen |
| <fmt:timeZone> | Gibt die Zeitzone an |
| <fmt:setTimeZone> | Gibt die Zeitzone an |
| <fmt:message> | Zeigt Informationen zur Konfigurationsdatei des Resource-Bundles an |
| <fmt:requestEncoding> | Legt die Zeichenkodierung der Anfrage fest |
SQL-Tags
Die JSTL-SQL-Bibliothek bietet Tags für die Interaktion mit relationalen Datenbanken (Oracle, MySQL, SQL Server usw.). Die Syntax zum Referenzieren der SQL-Tag-Bibliothek lautet wie folgt:
<%@ taglib prefix="sql"
uri="http://java.sun.com/jsp/jstl/sql" %>
| Tag | Beschreibung |
|---|---|
| <sql:setDataSource> | Gibt die Datenquelle an |
| <sql:query> | Führt SQL-Abfrageanweisungen aus |
| <sql:update> | Führt SQL-Update-Anweisungen aus |
| <sql:param> | Setzt die Parameter in einer SQL-Anweisung auf angegebene Werte |
| <sql:dateParam> | Setzt den Datumsparameter in einer SQL-Anweisung auf den angegebenen Wert des java.util.Date-Objekts |
| <sql:transaction> | Stellt verschachtelte Datenbankverhaltens-Elemente innerhalb einer gemeinsam genutzten Datenbankverbindung bereit und führt alle Anweisungen als eine einzelne Transaktion aus |
XML-Tags
Die JSTL-XML-Tag-Bibliothek bietet Tags zum Erstellen und Bearbeiten von XML-Dokumenten. Die Syntax zum Referenzieren der XML-Tag-Bibliothek lautet wie folgt:
<%@ taglib prefix="x"
uri="http://java.sun.com/jsp/jstl/xml" %>
Bevor Sie XML-Tags verwenden, müssen Sie die XML- und XPath-bezogenen Pakete in Ihr <Tomcat-Installationsverzeichnis>\lib kopieren:
- XercesImpl.jar
Download-Adresse:http://www.apache.org/dist/xerces/j/
- xalan.jar
Download-Adresse:http://xml.apache.org/xalan-j/index.html
| Tag | Beschreibung |
|---|---|
| <x:out> | Ähnlich wie <%= ... >, wird aber nur für XPath-Ausdrücke verwendet |
| <x:parse> | Parst XML-Daten |
| <x:set> | Legt den XPath-Ausdruck fest |
| <x:if> | Wertet den XPath-Ausdruck aus; wenn true, wird der Inhalt innerhalb des Rumpfs ausgeführt, andernfalls wird der Rumpf übersprungen |
| <x:forEach> | Iteriert über Knoten in einem XML-Dokument |
| <x:choose> | Das übergeordnete Tag von <x:when> und <x:otherwise> |
| <x:when> | Ein untergeordnetes Tag von <x:choose>, das für bedingte Prüfungen verwendet wird |
| <x:otherwise> | Ein untergeordnetes Tag von <x:choose>, das ausgeführt wird, wenn <x:when> zu false ausgewertet wird |
| <x:transform> | Wendet eine XSL-Transformation auf ein XML-Dokument an |
| <x:param> | Wird zusammen mit <x:transform> verwendet, um das XSL-Stylesheet festzulegen |
JSTL-Funktionen
JSTL enthält eine Reihe von Standardfunktionen, von denen die meisten allgemeine Funktionen zur Zeichenkettenverarbeitung sind. Die Syntax zum Referenzieren der JSTL-Funktionsbibliothek lautet wie folgt:
<%@ taglib prefix="fn"
uri="http://java.sun.com/jsp/jstl/functions" %>
| Funktion | Beschreibung |
|---|---|
| fn:contains() | Prüft, ob die Eingabezeichenfolge die angegebene Teilzeichenfolge enthält |
| fn:containsIgnoreCase() | Prüft, ob die Eingabezeichenfolge die angegebene Teilzeichenfolge enthält, ohne Berücksichtigung der Groß-/Kleinschreibung |
| fn:endsWith() | Prüft, ob die Eingabezeichenfolge mit dem angegebenen Suffix endet |
| fn:escapeXml() | Maskiert Zeichen, die als XML-Markup verwendet werden können |
| fn:indexOf() | Gibt die Position der angegebenen Zeichenfolge in der Eingabezeichenfolge zurück |
| fn:join() | Verbindet die Elemente eines Arrays zu einem String und gibt ihn aus |
| fn:length() | Gibt die Länge eines Strings zurück |
| fn:replace() | Ersetzt die angegebene Position im Eingabe-String durch den angegebenen String und gibt ihn zurück |
| fn:split() | Teilt den String unter Verwendung des angegebenen Trennzeichens in ein Array aus Teilstrings auf und gibt dieses zurück |
| fn:startsWith() | Prüft, ob der Eingabe-String mit dem angegebenen Präfix beginnt |
| fn:substring() | Gibt einen Teilstring des Strings zurück |
| fn:substringAfter() | Gibt den Teil der Zeichenkette nach der angegebenen Teilzeichenkette zurück |
| fn:substringBefore() | Gibt den Teil der Zeichenkette vor der angegebenen Teilzeichenkette zurück |
| fn:toLowerCase() | Wandelt die Zeichen in der Zeichenkette in Kleinbuchstaben um |
| fn:toUpperCase() | Wandelt die Zeichen in der Zeichenkette in Großbuchstaben um |
| fn:trim() | Entfernt führende und nachfolgende Leerzeichen |