17.12 JSP-Direktiven 
Eine Direktive gibt dem JSP-Container besondere Informationen darüber mit, wie er die Seite bearbeiten soll. Sie ergeben keine direkt sichtbare Ausgabe. Direktiven werden in den Tags <%@ und %> eingeschlossen, und die allgemeine Form lautet:
<%@ direktivnname attribut="wert" attribut2="wert" ... %>
Jede Direktive besitzt einen Namen. Es gibt sie für die Einbettung von fremden Seiten (include), die Definition der Seitenattribute (page), die Startinformationen für die Servlet-Umgebung definiert, und weitere. Mit dem Namen können wir auch eine XML-Form nutzen:
<jsp:directive direktivnname attrib1="wert" attrib2="wert" ... />
17.12.1 page-Direktiven im Überblick
Die page-Direktive ist die komplexeste aller Direktiven. Sie hat eine Reihe von Attributen, die vorgestellt werden sollen.
Attribut import
Die Direktive page import gibt an, welche Klassen durch die JSP importiert werden sollen. Sie entsprechen dem bekannten import. Mehrere Pakete werden durch ein Komma getrennt. Das Attribut import ist das einzige, das mehr als einmal benutzt werden kann.
<%@ page import="java.util.*, java.awt.Point" %>
Die Klassen der Pakete java.lang, javax.servlet, javax.servlet.http und javax.servlet.jsp sind automatisch importiert.
Attribut contentType
Der Content-Type ist der MIME-Typ der JSP-Seite. Änderungen des Standardwerts »text/html« sind nötig, wenn unsere JSP zum Beispiel eine XML-Datei zurückgibt.
<%@ page contentType="text/xml" %>
Die Zeichenkette kann zusätzlich Informationen über die Zeichenkodierung enthalten. Der Wert ist mit einem Semikolon abgetrennt.
<%@ page contentType="text/xml; charset=ISO-8859-1" %>
Attribut extends
Eine JSP wird vom JSP-Compiler in ein Servlet übersetzt. Ein selbst geschriebenes Servlet erweitert in der Regel eine Oberklasse wie HttpServlet. Bei JSPs ist die Oberklasse nicht bekannt, sie muss nur die Schnittstelle HttpJspPage implementieren. Möchten wir eine eigene Oberklasse angeben, so würden wir das extends-Attribut der page-Direktive nutzen. Die Anwendung einer solchen eigenen Vererbungshierarchie sollte jedoch wohl durchdacht sein, da eine JSP-Umgebung eine optimale Oberklasse anbietet, die laufzeitoptimiert arbeitet.
Attribut info
Der Autor einer Seite kann sie näher beschreiben. In der Regel befinden sich Informationen über Autor, Erstellungsdatum und Version in dem Attribut.
<%@ page info="(c) C.Ullenboom, Januar 2004, Version 1.04" %>
Diese Information ist sinnvoll, wenn in der nachfolgenden Verarbeitung, etwa durch den JSP-Container, Veränderungen vorgenommen werden.
Attribut language
Sie gibt an, welche Skriptsprache in diesem JSP benutzt wird. Zur Zeit wird nur »java« unterstützt.
| Attribut
|
Vorgabewert
|
Beispiel
|
| autoFlush
|
true
|
autoFlush="false"
|
| buffer
|
min. 8kb
|
buffer="16kb"
|
| contentType
|
text/html
|
contentType="image/gif"
|
| errorPage
|
-
|
errorPage="/jsp/error.jsp"
|
| extends
|
-
|
extends="SuperServlet"
|
| import
|
-
|
import="java.io.*,java.util.*"
|
| isErrorPage
|
false
|
isErrorPage="true"
|
| isThreadSave
|
true
|
isThreadSave="false"
|
| language
|
java
|
language="java"
|
| session
|
true
|
session="false"
|
Tabelle 17.2 page-Attribute
17.12.2 include-Direktive
Die Direktive mit dem Namen include bindet eine externe Datei zur Laufzeit in die JSP ein:
<%@ include file="copyright.html" %>
Auf diese Weise können externe Informationen wie Copyright-Informationen, Kopf- und Fußzeilen oder externe Skripte eingebunden werden. Da die Include-Seite vor der Übersetzung der JSP in ein Servlet eingebunden wird, lassen sich durch Fallunterscheidungen zur Laufzeit keine unterschiedlichen Seiten einbinden. In den Unterseiten lässt sich aber auf deklarierte Variablen der Oberseite zugreifen, genauso wie auf lokale Variablen, die vor include definiert wurden.
| Beispiel Betrachten wir noch einmal unser Punkt-Beispiel, bei dem wir bisher eine absolute Qualifizierung verwendet haben. Wir binden das Paket java.awt ein und importieren gleich noch einmal unser altes datum.jsp.
|
Listing 17.12 importJavaAwt.jsp
<%@ page import="java.awt.*" %>
<%! double d; %>
<%! Point p = new Point(2,3),
q = new Point(5,8); %>
<%! public Point zufall(
Point p, Point q ) {
return ( Math.random() > 0.5 ) ? p : q; } %>
<%= zufall(p,q) %>
<p>
<%@ include file="datum.jsp" %>
<p>
Das war's.
|
