Datei web.xml
Die Datei web.xml enthält Konfigurations- und Deployment-Informationen für die Webkomponenten, die eine Webanwendung enthalten.
Die Java-Servletspezifikation definiert die Implementierungsdeskriptordatei web.xml als XML-Schemadokument. Für die Abwärtskompatibilität wird jede Datei web.xml, die für Servlet 2.2 oder höher geschrieben wurde und in den früheren Versionen von WebSphere Application Server funkioniert hat, vom Web-Container unterstützt.
<taglib id="PortletTLD">
<taglib-uri>http://java.sun.com/portlet</taglib-uri>
<taglib-location>/WEB-INF/tld/std-portlet.tld</taglib-location>
</taglib>
Position
Die Datei web.xml muss sich im Verzeichnis WEB-INF unterhalb des Kontexts der Verzeichnishierarchie für eine bestimmte Webanwendung befinden.
Wenn die Anwendung z. B. den
Namen client.war hat, wird die Datei web.xml
in das Verzeichnis Installationsstammverzeichnis/client war/WEB-INF
gestellt.
Wenn die Anwendung beispielsweise den Namen client.war hat, wird die Datei
web.xml im Verzeichnis Profilstammverzeichnis/installedApps/Zellenname/client.ear/client.war/WEB-INF (in der Standardinstallation) gespeichert.
"edition" wird je nach verwendeter Edition durch "base" oder
WebSphere Application Server Network Deployment ersetzt.
Verwendungshinweise
- Ist diese Datei schreibgeschützt (Read-Only)?
Nein.
- Wird diese Datei von einer Produktkomponente aktualisiert?
Diese Datei wird vom Assembliertool aktualisiert.
- Wenn ja, wie wird die Aktualisierung ausgelöst?
Das Assembliertool aktualisiert die Datei web.xml, wenn Sie Webkomponenten zu einem Webmodul assemblieren oder wenn Sie die Eigenschaften der Webkomponenten oder des Webmoduls ändern.
- Wie und wann wird der Inhalt der Datei verwendet?
Die Funktionen von WebSphere Application Server verwenden die in dieser Datei enthaltenen Informationen in den Konfigurations- Deployment-Phasen während der Entwicklung der Webanwendung.
Beispieldateieintrag
Unterstützte Konfigurationen: Die Datei "web.xml" stellt nicht die gesamte Konfiguration dar, die für die Webanwendung verfügbar ist.
Es gibt andere Servletfilter und Listener, die über programmgesteuerte Konfigurationen,
Annotationen und Webfragmente definiert werden können.sptcfg
Fehler vermeiden: Werden die Metadaten der Webanwendung
als vollständig gekennzeichnet, wird verhindert, dass Annotationen und Webfragmente Komponenten konfigurieren können.gotcha<?xml version="1.0" encoding="UTF-8"?>
<web-app id="WebApp_9" version="3.0" xmlns="http://java.sun.com/xml/ns/javaee"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://java.sun.com/xml/ns/javaee
http://java.sun.com/xml/ns/javaee/web-app_3_0.xsd">
<display-name>Servlet 3.0 application</display-name>
<filter>
<filter-name>ServletMappedDoFilter_Filter</filter-name>
<filter-class>tests.Filter.DoFilter_Filter</filter-class>
<init-param>
<param-name>attribute</param-name>
<param-value>tests.Filter.DoFilter_Filter.SERVLET_MAPPED</param-value>
</init-param>
</filter>
<filter-mapping>
<filter-name>ServletMappedDoFilter_Filter</filter-name>
<url-pattern>/DoFilterTest</url-pattern>
<dispatcher>REQUEST</dispatcher>
</filter-mapping>
<filter-mapping>
<filter-name>ServletMappedDoFilter_Filter</filter-name>
<url-pattern>/IncludedServlet</url-pattern>
<dispatcher>INCLUDE</dispatcher>
</filter-mapping>
<filter-mapping>
<filter-name>ServletMappedDoFilter_Filter</filter-name>
<url-pattern>ForwardedServlet</url-pattern>
<dispatcher>FORWARD</dispatcher>
</filter-mapping>
<listener>
<listener-class>tests.ContextListener</listener-class>
</listener>
<listener>
<listener-class>tests.ServletRequestListener.RequestListener</listener-class>
</listener>
<servlet>
<servlet-name>welcome</servlet-name>
<servlet-class>WelcomeServlet</servlet-class>
</servlet>
<servlet>
<servlet-name>ServletErrorPage</servlet-name>
<servlet-class>tests.Error.ServletErrorPage</servlet-class>
</servlet>
<servlet>
<servlet-name>IncludedServlet</servlet-name>
<servlet-class>tests.Filter.IncludedServlet</servlet-class>
</servlet>
<servlet>
<servlet-name>ForwardedServlet</servlet-name>
<servlet-class>tests.Filter.ForwardedServlet</servlet-class>
</servlet>
<servlet-mapping>
<servlet-name>welcome</servlet-name>
<url-pattern>/hello.welcome</url-pattern>
</servlet-mapping>
<servlet-mapping>
<servlet-name>ServletErrorPage</servlet-name>
<url-pattern>/ServletErrorPage</url-pattern>
</servlet-mapping>
<servlet-mapping>
<servlet-name>IncludedServlet</servlet-name>
<url-pattern>/IncludedServlet</url-pattern>
</servlet-mapping>
<servlet-mapping>
<servlet-name>ForwardedServlet</servlet-name>
<url-pattern>/ForwardedServlet</url-pattern>
</servlet-mapping>
<welcome-file-list>
<welcome-file>hello.welcome</welcome-file>
</welcome-file-list>
<error-page>
<exception-type>java.lang.ArrayIndexOutOfBoundsException</exception-type>
<location>/ServletErrorPage</location>
</error-page>
<error-page>
<error-code>404</error-code>
<location>/error404.html</location>
</error-page>
</web-app>
Bewährtes Verfahren: Wählen Sie für jede Deklaration von <error-page> entweder <exception-type> oder <error-code> aus, aber nicht beides. Das Tag
<location> ist erforderlich. bprac
Referenzartikel