11 Tag Libraries

11.1 Deklaration einer TagLib in JSP

For a custom tag library or a library of Tag Files, create the 'taglib' directive for a JSP page.

TagLib Direktiven wurden im Kapitel über Direktiven ausführlich behandelt.

Hier die Syntax zur Deklaration einer TagLib Direktive

<%@ taglib prefix="prefix" [uri="taglibURI" | tagdir="contextRelativePath"]%>

Attribut	Beschreibung
prefix	Der Prefix mappt eine Aktion zu einer TagLib Library
uri	Entweder ein eindeutiges Symbol das eine TLD spezifiziert oder ein relativer Pfad zu einer TLD Datei bzw Jar File
tagdir	Kontextrelativer Pfad zu einem Ordner mit Tag-Dateien. Der Pfad startet mit /WEBINF/tags

Beispiele:

11.3 Die Core Standard Tag Library

11.3.2 Allgemeine Aktionen

Die Aktion <c:out>

Die <c:out> Aktion wertet einen Ausdruck aus und übergibt das Ergebnis an das aktuelle JspWriter-Objekt.

Da EL-Ausdrücke direkt innerhalb von Template-Daten eingefügt werden dürfen, wird diese Funktion selten verwendet, und ist vor allem mit den Attributen interessant.

Die Beispiele zeigen, dass der default Wert als Attribut, oder als Body angegeben werden kann.

<c:out value="${param.phone}" default="No Phone" /> <c:out value="${user.imageURL}"> <c:url value="/defaultUserImage.jpg" /> </c:out>

Die Aktion <c:set>

Diese Aktion setzt Variablen in einem bestimmten Scope, oder setzt eine Property einer Bean.

<%-- Beispiel: Setzen einer Variable ohne Body --%> <c:set value="${user.name}" var="Name" /> <%-- Beispiel: Setzen einer Variable mit Body --%> <c:set var="Name" scope="session" > ${user.name} </c:set> <%-- Beispiel: Property einer Bean setzen --%> <c:set value="${user.name}" target="${userBeanId}" property="Name" /> <%-- Beispiel: Property einer Bean setzen --%> <c:set target="${userBeanId}" property="Name" ${user.name} </c:set>

Die Aktion <c:remove>

Diese Aktion entfernt eine Variable aus einem Gültigkeitsbereich

Beispiel:

<c:remove var="loggedOut" scope="session" />

Die Aktion <c:catch>

Diese Aktion fängt Fehler ab, es ist möglich die ausgelöste Exception an eine Variable im PageScope zuzuordnen.

<c:catch var="importException"> <c:if test="${importException != null}"> <jsp:forward page="input.jsp"> <jsp:param name="msg" value="Invalidate date format" /> </jsp:forward> </c:if> </c:catch>

Die Aktion <c:catch> hat nur ein einziges optionales Attribut var. Diese Variable liegt automatisch im pageScope.

11.3.3 Bedingungen und Schleifen

Die Aktion <c:if>

Die Auswertung des Bodys eine Aktion <c:if> erfolgt nur dann, falls die der im Attribut test angegebene Ausdruck true ergibt.

<c:if test="booleanExpression"> JSPElements </c:if>

Attribut	Java Typ	Dynamik	Beschreibung
test	boolean	Ja	Ausdruck der ausgewertet wird
var	String	Nein	Variablenname
scope	String	Nein	Scope von var

Statt Auswertung eines Bodys kann man auch das Ergebnis der Auswertung in einer Variablen abspeichern.

<c:if test="booleanExpression" var="var" scope="page|request|session|application" />

Die Aktionen <c:choose> <c:when> <c:otherwise>

Diese Aktionen entspricht dem Java switch() Statement. Die Aktionen <c:when> und <c:otherwise> sind Kindelemente der Aktion<c:choose>. Das Vorhandensein einer Aktion <c:otherwise> ist optional.

<c:choose> <c:when test="${product.onSale}"> ${product.salesPrice} On sale ! </c:when> <c:otherwise> ${product.price} </c:otherwise> </c:choose>

Die Aktion <c:when> ist die einzigste die ein Attribut besitzt. Ergibt die Auswertung des Ausdruck vom test den Wert true so wird der Body ausgewertet. Innerhalb der Aktion cc:choose> können mehrere <c:when> Ausdrücke sein. Es wird der Body der ersten <c:when> Aktion ausgeführt, die true ergibt. Ansonsten wird der Body der <c:otherwise> Aktion ausgeführt.

Die Aktion <c:forEach>

Es gibt 2 Arten diese Aktion zu verwenden.

1. Iteration über eine feste Anzahl von Iterationen
2. Iteration über eine Collection

Iteration über eine feste Anzahl von Iterationen

Beispiel:

<%-- Iterate five times, writing 0,2,4,6 --%> <c:forEach begin="0" end="6" step="2" var="current"> ${current} </c:forEach>

Das Attribut begin und end sind wenn man über eine feste Anzahl von Iterationen iteriert Pflichtattribute.

Iteration über eine Collection

Beispiel:

<%-- Iterate over all request parameters --%> <c:forEach items="${param}" var="current"> Name: ${current.key} Vorname: ${current.value} </c:forEach>

Attribut	Java Typ	Dynamik	Beschreibung
begin	int	Ja	Index für Anfang der Iteration
end	int	Ja	Index für das Ende der Iteration
items	Collection, Iterator, Enumeration , Map oder ein Array	Ja	Darüber wird iteriert
step	int	Ja	Schrittweite der Schleife, Standard ist 1.
var	String	Nein	Variable das das aktuelle Element der Iteration hält
varStatus	String	Nein	Variable enthält interne Informationen über die Schleifenduchlauf Ist vom Interface LoopTagStatus

varStatus kann man nur innerhalb einer forEach bzw forToken Aktion verwenden. Das Objekt das varStatus hält ist vom Interface LoopTagStatus und hat folgende Methoden:

public Integer getBegin() // begin Wert oder null public Integer getCount() // Aktuelle Iteration beginnend bei 1 public Object getCurrent() // Aktuelle Variable der Iteration public int getIndex() // Index aktueller Variable beginned bei 0 public Integer getStart() // start Wert oder null public Integer getStep() // step Wert oder null public boolean isFirst() // Gibt true für den ersten Durchlauf public boolean isLast() // Gibt true für den letzten Durchlauf

Die Aktion <c:forTokens>

Diese Aktion iteriert für jeden Token innerhalb eines String. Die Token werden über sogenannte Trennzeichen (delimiters) getrennt.

Beispiel: