Zur Übersicht

Die impliziten Objekte

Im vorigen Beitrag wurde gezeigt, wie man mittels Skiptlets Javacode in JSPs einbetten kann, um so bspw. dynamisch auf Nutzereingaben reagieren zu können. Dazu benötigt man aber über die Möglichkeit, Java zu benutzen, hinaus noch den Zugriff auf Informationen, die die derzeit gültige Session, die Anwendung, den Request oder auch die zu erzeugende Response betreffen. Dazu dienen die impliziten Objekte, auf die man aus Skriptlets heraus zugreifen kann.
Insgesamt stehen neun Objekte zur Verfügung, die in den nächsten Abschnitten detailliert beschrieben werden. Die folgende Übersicht zeigt zunächst einmal die Namen der Objekte und von welchem Typ diese sind. Es lohnt sich, die verfügbaren Methoden dieser Objekte in der API der Java 2 Enterprise Edition anzusehen, da man sie häufig brauchen wird und hier nur die wichtigsten Methoden beschrieben werden. Im Übrigen braucht man Objekte dieser Interfaces/Klassen auch dann häufig, wenn man mit einem FrontController-Ansatz arbeitet.

Das Objekt request

Das Objekt request, ist vermutlich das meistgenutzte implizite Objekt. Das heißt, dass es zu jeder Anfrage auch immer genau ein request-Objekt gibt. Mit Hilfe der request Methoden kannst du auf alle Informationen zu dem jeweiligen Request zugreifen.  Das kann der HTTP-Header sein, oder auch die Request-Parametern (GET-Parameter oder Formular-Eingaben) sein. Das können Cookies sein oder auch die IP Adresse des Client Die wichtigsten Methoden sind in der folgenden Übersicht zu finden.

.....
<% 
    out.print(request.getHeader("user-agent"));
 %>
.....

.....
<% 
    out.print(request.getParameter("name"));
 %>
.....

Das Objekt response

Das response-Objekt ist das Gegenstück zum request-Objekt. In diesem Objekt werden alle Informationen für das HTTP-Response abgelegt, auch hier wieder für das aktuelle. Das response Objekt wird vor allem genutzt, um den Content-Type festzulegen und Response-Header zu erweitern oder um Cookies auf den Client zu setzen.
Auch hier wieder eine Übersicht der wichtigsten Methoden:

Das Objekt session

Beim session Objekt die häufig genutzten Methoden:

Das HTTP-Protokoll ist ein sogenanntes zustand loses Protokoll. Das heißt, dass der Server keine Daten über den Nutzer vorrätig hält und diesen sozusagen unmittelbar nach erfolgreicher Absendung seiner Antwort auf die Anfrage des Clients vergisst. Dies ist natürlich für die meisten Web-Anwendungen völlig inakzeptabel. Daher wurden Möglichkeiten gefunden, diese Beschränkung des HTTP-Protokolls zu umgehen und sogenannte Sessions zu ermöglichen. Sessions können einen kompletten Besuch eines Anwenders auf einer Website über alle von ihm aufgesuchten Seiten abbilden. Somit können bspw. Login-Informationen gespeichert werden, oder auch Warenkorb Inhalte.
Das JSP/Servlet-Modell bietet eine umfassende Unterstützung von Sessions einer Benutzerin über eine Abfolge von Seiten. Dafür stellt der Servlet-Container das session Objekt bereit, das vor allem zur Aufnahme von Session-relevanten Informationen genutzt wird. Beliebige Objekte können mittels der o.g. Methode setAttribute() im Session Scope gespeichert und mittels getAttribute(attributnahme) wieder abgerufen werden.

Das Objekt pageContext

Das pageContext Objekt bietet Zugriff auf Informationen, die die aktuelle JSP-Seite betreffen. Es bietet vor allem die Methode, die den bequemen Zugriff auf alle Objekte in jedem Gültigkeitsbereich erlaubt. Das Konzept der Gültigkeitsbereiche (engl. scope) wird im Beitrag Gültigkeitsbereiche ausführlich erläutert. Ansonsten wird das Objekt vor allem bei der Generierung des aus der JSP erzeugten Servlets genutzt.

Das Objekt application

Das application Objekt enthält wenig Methoden, die man von einer JSP aus nutzen würde. Am ehesten sind noch die setAttribute Methode sinnvoll, die Objekte in dem Gültigkeitsbereich Application abgelegt. Im Application Scope können alle, derzeit auf dem Server, befindliche Benutzer zugreifen. Dort könnten z.b. Der Produktkatalog einer Shop Anwendung optimal abgelegt werden, da der Entwickler Systemressourcen(Arbeitsspeicher, Datenbankzugriffe etc.) einspart

Das Objekt config

Das config Objekt ist vom Typ javax.servlet.ServletConfig. Es dient vor allem dazu, auf Initialisierungs-Parameter zuzugreifen. Es ist in der Praxis absolut unbedeutend. Initialisierungs Parameter werden nahezu ausschließlich für Servlets verwandt. Dennoch ist es auch für JSPs möglich, solche Parameter in der Datei web.xml anzulegen. Die wesentliche Methoden sind daher die getInitParameter() Methode, die einen definierten und benannten Initialisierungs Parameter zurückgibt und die getInitParameterNames() Methode, die eine Enumeration mit allen Namen der definierten Initialisierungs-Parameter zurückgibt.
Ein Beispiel für einen definierten Parameter in einer web.xml-Datei:

<?xml version="1.0" encoding="utf-8"?>

<web-app xmlns= ... >

<!-- andere Konfigurationselemente -->

<servlet>
  <servlet-name>ExampleConfigJsp</servlet-name>
  <jsp-file>/newjsp.jsp</jsp-file>
  <init-param>
   <param-name>sampleParm</param-name>
   <param-value>Just a sample value.</param-value>
 </init-param>
 </servlet>

<servlet-mapping>
   <servlet-name>ExampleConfigJsp</servlet-name>
   <url-pattern>/newjsp.jsp</url-pattern>
 </servlet-mapping>

<!-- weitere konfigurationselemente ... -->

</web-app>

Und so kann man diesen in einer JSP auslesen:

<%@page contentType="text/html" pageEncoding="UTF-8"%>
<!DOCTYPE html>
<html> 
 <head>
    <title>Config Parameter auslesen config</title>
 </head> 
 <body> 
   <h3>"config"</h3> 
   <p>init-parameter:</p>
   <table border="0" cellspacing="0" style="margin-top:10px; margin-bottom:10px;"> 
 
      <tr> <td><b>sampleParm</b></td><td> </td> <td>
     <%=config.getInitParameter("sampleParm") %></td> 
     </tr> 
   </table> 
</body> 
</html>

Das Objekt out

Das out Objekt kann bis auf einige Ausnahmen eine Expression ersetzen. Du erinnerst dich, das waren die Ausgaben innerhalb eines Skriptlets. Will man innerhalb von Skriptlets Ausgaben erzeugen, so stehen mit dem out Objekt diverse print Methoden zur Verfügung. Die Ausgabe wird dabei zunächst stets gepuffert, um ggf. bei Fehlern den Puffer löschen zu können und bspw. spezielle Ausgaben für den Fehlerfall ausgeben zu können. Ein Forwarding(siehe Actions) oder ein Redirect ist nur möglich, solange der Puffer oder Teile des Puffers noch nicht mittels flush() tatsächlich weggeschrieben wurde.

Insofern sind neben den diversen print()-Methoden noch die Methoden clear(), bzw. clearBuffer() und flush() wichtig. Letztere schreibt den Pufferinhalt in den Ausgabestrom, wohingegen die beiden ersten den Puffer löschen. Ist bereits ein Teil des Puffers geflusht worden, so wirft die erste Methode eine IOException,während clearBuffer() einfach den gegenwärtigen Pufferinhalt löscht. Die Größe des Puffers setzt man mittels dem Attribut buffer der Page-Direktive.

Das Objekt exception

Dieses Objekt steht nur auf speziellen Fehlerseiten zur Verfügung. Fehlerseiten sind all die Seiten, bei denen das Attribut isErrorPage der page Direktive auf „true“ gesetzt ist.
Diese Seiten dienen dazu, spezielle Antwortseiten für diverse mögliche Fehlerfälle bereitzustellen. Welche Seite aufgerufen wird, bestimmt sich entweder aus dem errorPage Attribut der Page-Direktive oder aus der Konfiguration, die im Deployment-Deskriptor web.xml festgelegt wurde.
Im Falle eines Fehlers wird dann der Request zur passenden Fehler-Seite weitergeleitet und dort kann mittels des exception Objekts auf die Informationen der Exception zugegriffen werden, die zuvor aufgetreten ist. So kann man für die Nutzerin der Seite klare Fehlermeldungen generieren und erspart ihr den ansonsten üblichen Stacktrace. Genaueres zur Fehlerbehandlung und welche Konfigurationen man dazu im Deployment-Deskriptor vornehmen kann, findet sich im Kapitel Fehler- und Ausnahmenbehandlung.
Folgende Methoden des exception Objekts stehen auf einer Fehlerseite zur Verfügung:

Ein kleines Beispiel: Beachte die page Direktive in beiden jsp Seiten.

<%-- Die jsp hat den Namen handleError.jsp --%>
<%@ page isErrorPage="true" %>

<%-- Zur einfacherer Ausgabe importieren Sie 'PrintWriter' --%>
<%@ page import="java.io.PrintWriter" %>

<html>
<body>
<%-- Hier verwenden Sie die zusätzliche Variable --%>
Es ist zu folgender Ausnahme gekommen: <%= exception %> <br/>
<a href="produceError.jsp"> Erneut versuchen ?! </a> <hr/>

<%-- Zur Ausgabe des Stacktrace in die JSP verwenden Sie
auch hier die vordefinierte Variable 'out'. --%>
Der Stacktrace lautet:
<% exception.printStackTrace(new PrintWriter(out)); %>

</body>
</html>

 

Die Seite die den Fehler provoziert bei Eingabe eines nicht numerischen Werts:

<%-- Hier legen Sie die Fehlerseite fest 
der Name dieser Seite hat den Namen produceError.jsp--%>
<%@ page errorPage="handleError.jsp" %>

<%
// Dieser Code ist fehleranfällig für Falscheingaben
if (request.getParameter("number") != null) {
Double myDouble = new Double(request.getParameter("number"));
}
%>
<!DOCTYPE html>
<html>
 <body>

<!-- Dieses Formular verweist auf sich selbst -->
   <form action="produceError.jsp">
   <p>
     Wenn Sie in das Feld keine Zahl eingeben,
     provozieren Sie einen Fehler:
     </p>

  Eingabe: <input type="text" name="number" />
          <input type="submit" value="Absenden" />
   </form>
 </body>
</html>