$K(Semantik von web.xml)



$R(Objective)

Describe the purpose and semantics for each of the following deployment descriptor elements: 

error-page, init-param, mime-mapping, servlet, servlet-class, servlet-mapping, servlet-name, 

and welcome-file.

$R\



$KK(Error-Pages)



Das <i>error-page</i> Element, definiert Seiten die den Anwender

über aufgetretene Fehler informiert.



<b>Die Syntax</b>



$S()

<error-page>

    <error-code>errorCode</error-code> | 

        <exception-type>className</exception-type>

    <location>pagePath</location>

</error-page>

$S\



Ein Fehler auf der Server-Seite kann durch eine Exception ausgelöst werden,

oder durch die Anweisung <i>sendError(anInteger) bzw. sendError(anInteger, aString)</i>



Folgende Exception kann ein Servlet oder ein Filter auslösen:



* ServletException oder Unterklassen davon

* IO Exception oder Unterklassen davon



Treten andere Fehler auf, so können sie in ein ServletException gewrappt werden.



$S()

try()

   // Code der auf Datenbank zugreift

catch(SQLException e){

   throw new ServletException("SQL Exception",e);

}

$S\



Die standardmaessige Fehlerroutine wird nur aufgerufen, falls der Container in der

<i>error-page</i> Deklaration keine entsprechende Location findet. Es wird durch die 

durch die URL spezifizierte Ressource aufgerufen.



Erhält der ServletContainer eine ServletException oder eine Unterklasse, so ermittelt er mit

der Methode <i>ServletException.getRootCause</i> die gewrappte Exception und benutzt die <i>error-page</i>

Dekleration um eine Fehlerseite zu finden und umzuleiten.



<i>Location</i> ist eine relative URL zur Wurzelverzeichnis der Webapplikation. 

Sie spezifiziert einer HTML-Seite, Servlet oder

Java Servlet Page. <i>Location</i> muss mit einem Slash "/" beginnen.



<b>Beispiel</b>



$S()

<error-page>

   <error-code>404</error-code>

   <location>/errors/404.html</location>

</error-page>

<error-page>

   <exception-type>javax.servlet.ServletException</exception-type>

   <location>/errors/excepton.jsp</location>

</error-page>

$S\



Hat der Container eine Fehlerseite gefunden, so können über folgende Attribute in der 

Anfrage genauere Information ausgelesen werden:



* javax.servlet.error.status_code  - Integer mit dem Code der von sendError mitgeben wurde.

* javax.servlet.error.exception_type - Class Exception die ausgelöst wurde

* javax.servlet.error.message - String der bei sendError bzw. der nicht aufgefangen Exception mitgegebem wurde

* javax.servlet.error.exception - Die Exception die den Fehler ausgelöst hat

* javax.servlet.error.request_uri - Die aktuelle URI der Fehlerseite

* javax.servlet.error.servlet_uri - URI der Seite die den Fehler ausgelöst hat



$KK(Init-Parameter)

$S()

<init-param>

   <param-name>aKey</param-name>

   <param-value>aValue</param-value>

   [<description>ein beschreibender Kommentar</description>]

</init-param>

$S\

<b>Syntax</b>



$S()



$S\



Das <i>init-param</i> ist dem <i>servlet</i> untergeordnet, und kann dort beliebig oft 

vorkommen. Es wird verwendet um ein Servlet mit Parameter zu initialisieren. 

Diese Parameter werden nachdem instantiieren

eines Servlets eingelesen.Innerhalb eines Servlets muss der <i>param-name</i> eindeutig sein. 



Die Klasse <i>ServleConfig</i> enthält speichert diese initialen Werte und können mit

folgenden Methoden ausgelesen werden:



* getInitParameterNames()  - Gibt als Enumeration alle Parameternamen zurück, ggf. eine leere Enumeration   

* getInitParameter(String) - Gibt als String den Wert des Parameters zurück, oder null



$KK(mime-mapping)



Das <i>mime-mapping</i> Element definiert Zuordnungen von Daten zu Applikationen, die sie

benötigen.



<b>Syntax</b>



$S()

<mime-mapping>

   <extension>fileExtension</extension>

   <mime-type>mimeType</mime-type>

</mime-mapping>

$S\



Die meisten Container haben standardmaessig Mappings für die gebräuchlichsten Dateiendungen

(wie .htm , .gif, ) definiert.