Inhalt	Abbildung	PDF	Source	SCWCD
\|<	<	>	>\|	Generated by CoCoDiL

8.2 Direktiven

Write JSP code that uses the directives: (a) 'page' (with attributes 'import', 'session', 'contentType', and 'isELIgnored'), (b) 'include', and (c) 'taglib'.

8.2.1 Page Direktive

Eine page Direktive informiert die JSP Maschine über Eingenschaften einer JSP Seite. Diese Eingenschaft betrifft nicht nur die aktuelle Seite, sondern auch die Seiten die mit der include Direktive eingebunden werden.

In der JSP 2.0 Spezifikation gibt es insgesamt 13 verschiedene Attribute, es werden lediglich nach der Objektive die folgenden Attribute für die Zertifizierung benötigt:

Attributname	Beschreibung	Default Werte
import	Eine Liste von Java Klassen und Packages, die in der JSP Seite gebraucht werden	Keine Default Werte
session	Falls true sollte die Seite Teil einer Session sein. Bei false ist zu dieser Seite keine implizite session Variable verfügbar	true
contentType	Enthält den Mime Type und character encoding der Ausgabe	text/html bzw text/xml
isELIgnored	falls true wird ein ${code} als normaler Text interpretiert und nicht ausgewertet	entsprechend Datei web.xml sonst false

Beispiele:

<%@ page import="java.util.*,java.text.*"%> <%@ page contentType="text/plain"%>

Das import Attribut ist das einzigste Attribut innerhalb einer page Direktive die in einer Translation Unit mehrfach vorkommen können. Eine Translation Unit bezieht sich auf die akuelle JSP Seite und dijenigen die mit der include Direktive eingebunden werden.

8.2.2 Inlcude Direktive

Mit der Include Direktive wird zur Übersetzungszeit der JSP Seite in ein Servlet eine Datei eingebunden. Die include Direktive hat genau ein Attribut, nämlich file und enthält den Pfad zu einer Datei. Die Dateien die mit Include eingebunden werden gehören zu einer Translation Unit, d.h die aktuelle und eingebundene Dateien werden in ein Servlet übersetzt.

<html> <head> <title>Including Files at Translation Time (JSP)</title> </head> <body> <%@ include file="somePage.jsp" %> </body> </html>

8.2.3 TagLib Direktive

Wird benötigt um custom Tags zu definieren

<%@ taglib prefix="example" uri="http://www.server.com/example-taglib" %>

In der Datei web.xml kann man den Pfad zur taglib Beschreibungs datei spezifizieren.

<taglib> <taglib-uri>http://www.server.com/example-taglib</taglib-uri> <taglib-location>/WEB-INF/example-taglib.tld</taglib-location> </taglib>

Die Taglib-URI muss ein eindeutiger Name für die Tag Lib Bibliothek sein. Man kann auch den Umweg über die web.xml Datei umgehen und direkt den Pfad zur tld.Datei in der taglib Direktive angeben. Allerdings verliert man dadurch die Flexibilität die tld-Datei zu verschieben oder umzubenennen.

<%@ taglib prefix="example" uri="/WEB-INF/example-taglib.tld" %>

8.3 JSP als XML Dokumente

Write a JSP Document (XML-based document) that uses the correct syntax.

Es besteht die Möglichkeit JSP Seiten teilweise oder vollständig als XML-Dokumente anzulegen. Eine JSP Seite die vollständig als XML-Dokument angelegt ist (und damit wohlgeformt ist), nennt man JSP Dokument

8.3.1 Identifikation von JSP-Dokumenten

Der Servlet Container erkennt i.a. nicht automatisch ob es sich um eine normale JSP Seite oder um ein JSP-Dokument handelt. Folgende Verfahren zur Indentifikation von JSP-Dokumenten gibt es:

Anstelle der sonst üblichen Dateierweiterung .jsp wird .jspx verwendent.
Es wird zwar die Dateierweiterung .jsp verwendet, aber das oberste Element ist ein <jsp:root> Element. Ab der Spezifikation 2.0 muss das oberste Element eines JSP Dokumentes nicht root sein.
Eine jsp Seite wird durch dir Datei web.xml als JSP-Dokument gekennzeichnet

<jsp-property-group> <url-pattern>*.jsp</url-pattern> <is-xml>true</is-xml> </jsp-property-group>

8.3.2 jsp:root Element

Ein JSP-Dokument beginnt i.a. nicht mit dem typischen xml Kopf <?xml version="1.0" ?> Wird ein jsp:root Element verwendet, so muss das oberste Element xml sein. Es hat zwingend das Attribut version, dessen Werte "2.0" oder "1.2" sein musss. Ausserdem wird es benutzt um Namensräume zu deklarieren.

<jsp:root xmlns:jsp="http://java.sun.com/JSP/Page" xmlns:c="http://java.sun.com/jsp/jstl/core" version="2.0"> ... </jsp:root>

Die Namespaces werden verwendet um Tag-Bibliotheken der Aktionen zu deklarieren.

8.3.3 Kommentare

Es gibt keine spezielle Tags für Kommentare um einen Kommentar von einer JSP-Seite umzuwandeln sollte man einen normalen xml Kommentar verwenden.

<%-- Dies ist ein JSP Kommentar --%>

8.3.4 Template Text

Template Texte werden durch das Element jsp:text deklariert. Man muss aufpassen dass durch den Template Text die XML Syntax nicht verletzt wird.

Beispiel eines ungültigen Template Textes

<jsp:text> bestanden? $(test.punktzahl > 1000) </jsp:text>

Das > Zeichen ist innerhalb eines xml-Elements nicht erlaubt. Ersetze in diesem Fall das > Zeichen durch gt

8.3.5 Skriptelemente

Deklarationen

Es wird das Element jsp:declaration verwendet. Dieses Element hat keine Attribute

<%! public String someFunc(int i) { if (i<3) return("..."); } %> <jsp:declaration> public String someFunc(int i) { if (i<3) return("..."); } </jsp:declaration>

Skripte

Es wird das Element jsp:scriptlet verwendet. Dieses Element hat keine Attribute

<% out.println("Gesamtbetrag: "); %> <jsp:scriplet> out.println("Gesamtbetrag: "); </jsp:scriplet>

Expressions

Es wird das Element jsp:expression verwendet. Dieses Element hat keine Attribute

2 + 3 = <%= 2 + 3 %> <jsp:text> 2 + 3 </jsp:text> <jsp:expression> 2 + 3 </jsp:expression>

8.3.6 Direktiven

Bei Page Direktiven wird das Element jsp:directive.page verwendet. Bei Include Direktiven wird das Element jsp:directive.include verwendet.

Beispiel:

<jsp:directive.page contentType="text/html" /> <jsp:directive.include file="anotherFile.jsp" /> Es gibt kein xml Elmement für die taglib Direktiven. Die Spezifikation der taglib Bibliotheken, erfolgt stattdessen durch Namensräume. $S() <%@ taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core" %> <c:forEach items="$(paramValus}" var="parValue"> .... </c:forEach>

Eine Namensraumdeklaration kann auch mitten in einem Element stehen, und gilt dann für dieses Element und den untergeordneten Elementen.

<c:forEach xmlns:c="http://java.sun.com/jsp/jstl/core" items="$(paramValus}" var="parValue"> .... </c:forEach>

Inhalt Abbildung PDF Source SCWCD
|< < > >| Generated by CoCoDiL