17.10 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.10.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" %>
Tipp Um aus einer Java Server Page (oder einem Servlet) Microsoft Excel-Tabellen zu erzeugen, reicht es, eine HTML-Tabelle zu generieren und dann als Content-Type »application/vnd.ms-excel« anzugeben.
|
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 2006, Version 1.05" %>
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.
Tabelle 17.2
page-Attribute
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"
|
17.10.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.
17.10.3 Mit JSPs Bilder generieren
 
Soll eine Bild dynamisch generiert werden, ist das mit JSPs möglich, für Binärdateien sind jedoch Servlets üblich. Die Anforderung an die JSP/das Servlet nach der Grafik steht gewöhnlich in einer anderen Webseite, etwa so:
<img src=" http://localhost:8080/jt/JpegImage.jsp" alt="smile" />
Die JSP JpegImage.jsp soll ein Bild erzeugen und mit dem passenden Encoder von Sun als JPG dem Browser übermitteln. Da der Content-Typ unserer bisherigen JSP nur für Textdateien stand, müssen wir für JPEG-Grafiken den Typ auf »image/jpeg« setzen. Damit beginnt die erste Zeile der JSP:
Listing 17.13
JpegImage.jsp
<%@ page contentType="image/jpeg" %>
Die Grafik soll lediglich zwei einfache Linien darstellen. Zum Zeichnen sind das AWT-Paket, das AWT-Image-Paket für die Hintergrundgrafik und das Encoder-Paket zum Schreiben der JPEG-Datei relevant.
<%@ page import="java.awt.*,java.awt.image.*, com.sun.image.codec.jpeg.* " %>
Jetzt lässt sich die Grafik als Hintergrundbild vom Typ BufferedImage aufbauen. Dieses Objekt bietet getGraphics(), und mit dem bekannten Graphics-Objekt sind Zeichenoperationen möglich.
<%
int width = 200,
height = 200;
BufferedImage image = new BufferedImage( width, height,
BufferedImage.TYPE_INT_RGB );
Graphics g = image.getGraphics();
g.setColor( Color.white );
g.fillRect( 0, 0, width, height );
g.setColor( Color.blue );
g.drawLine( 0, 0, 200, 200 );
g.drawLine( 0, 200, 200, 0 );
g.dispose();
Der letzte Schritt besteht darin, vom impliziten response-Objekt den binären Ausgabestrom zu besorgen und den JPEG-Encoder zu veranlassen, das Bild in den Ausgabestrom zu schreiben.
ServletOutputStream sos = response.getOutputStream();
JPEGImageEncoder encoder = JPEGCodec.createJPEGEncoder( sos );
encoder.encode( image );
%>
Für eine tatsächliche Bildanforderung gibt es also immer zwei Server-Kontakte: Der erste Request fordert die Webseite an, die über ein <img>-Tag die Grafik verlangt. Im zweiten Schritt kontaktiert der Browser den Server erneut, um genau dieses Bild zu erfragen – der Browser weiß nicht, dass es dynamisch produziert wird.
|