20.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:
<%@ direktivenname attribut="wert" attribut2="wert" ... %>
Jede Direktive besitzt einen Namen. Es gibt zum Beispiel Direktiven für die Einbettung von fremden Seiten (include) und die Definition der Seitenattribute (page), die Startinformationen für die Servlet-Umgebung definiert. Mit dem Namen können wir auch eine XML-Form nutzen:
<jsp:directive direktivenname attrib1="wert" attrib2="wert" ... />
20.10.1 page-Direktiven im Überblick 

Die page-Direktive ist die komplexeste aller Direktiven. Sie hat eine Reihe von Attributen, die vorgestellt werden sollen.
Das 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.
Das Attribut contentType
Der Content-Type ist der MIME-Typ der JSP. Ä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 JavaServer 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. |
Das Attribut language
Dieses Attribut gibt an, welche Skriptsprache in diesem JSP benutzt wird. Zurzeit 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" |
20.10.2 Mit JSPs Bilder generieren 

Soll ein 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, eine Grafik zu laden, steht gewöhnlich in einer anderen Webseite, etwa so:
<img src=" http://localhost:8080/web/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. 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.
Damit beginnt die JSP mit:
Listing 20.18 JpegImage.jsp
<%@ page contentType="image/jpeg" %><%@ 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.