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.

Wenn Sie Rational Application Developer Version 6 zum Erstellen Ihrer Portlets verwenden, müssen Sie die folgende Referenz auf die Datei std-portlet.tld aus der Datei web.xml entfernen:
<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.

[AIX Solaris HP-UX Linux Windows][z/OS]Wenn die Anwendung z. B. den Namen client.war hat, wird die Datei web.xml in das Verzeichnis Installationsstammverzeichnis/client war/WEB-INF gestellt.

[IBM i]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 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 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 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

Symbol, das den Typ des Artikels anzeigt. Referenzartikel



Symbol für Zeitmarke Letzte Aktualisierung: 25.05.2016
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rweb_webxf
Dateiname:rweb_webxf.html