19.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" ... />

19.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-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" %>

Das 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.

Das 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 2007, Version 1.05" %>

Diese Information ist sinnvoll, wenn in der nachfolgenden Verarbeitung, etwa durch den JSP-Container, Veränderungen vorgenommen werden.

Das Attribut language

Dieses Attribut gibt an, welche Skriptsprache in diesem JSP benutzt wird. Zurzeit wird nur »java« unterstützt.

19.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 19.17 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.

Ihr Kommentar