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.
| Inhalt | Abbildung | Source | SCWCD | |||
| |< | < | > | >| | Generated by CoCoDiL | ||
| 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. |
Das error-page Element, definiert Seiten die den Anwender über aufgetretene Fehler informiert.
Die Syntax
Ein Fehler auf der Server-Seite kann durch eine Exception ausgelöst werden, oder durch die Anweisung sendError(anInteger) bzw. sendError(anInteger, aString)
Folgende Exception kann ein Servlet oder ein Filter auslösen:
Treten andere Fehler auf, so können sie in ein ServletException gewrappt werden.
Die standardmaessige Fehlerroutine wird nur aufgerufen, falls der Container in der error-page 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 ServletException.getRootCause die gewrappte Exception und benutzt die error-page Dekleration um eine Fehlerseite zu finden und umzuleiten.
Location ist eine relative URL zur Wurzelverzeichnis der Webapplikation. Sie spezifiziert einer HTML-Seite, Servlet oder Java Servlet Page. Location muss mit einem Slash "/" beginnen.
Beispiel
Hat der Container eine Fehlerseite gefunden, so können über folgende Attribute in der Anfrage genauere Information ausgelesen werden:
Syntax
Das init-param ist dem servlet 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 param-name eindeutig sein.
Die Klasse ServleConfig enthält speichert diese initialen Werte und können mit folgenden Methoden ausgelesen werden:
Das mime-mapping Element definiert Zuordnungen von Daten zu Applikationen, die sie benötigen.
Syntax
Die meisten Container haben standardmaessig Mappings für die gebräuchlichsten Dateiendungen (wie .htm , .gif, ) definiert.
| Inhalt | Abbildung | Source | SCWCD | |||
| |< | < | > | >| | Generated by CoCoDiL | ||