Datei "web.xml" für JAX-RS-Servlets konfigurieren
Die Datei web.xml enthält Informationen zur Struktur und zu den externen Abhängigkeiten von Webkomponenten im Modul und beschreibt, wie die Komponenten zur Laufzeit verwendet werden. Damit der Web-Container JAX-RS-Anwendungen (Java™ API for RESTful Web Services) ausführen kann, können Sie die Datei web.xml so konfigurieren, dass sie direkt auf das IBM® JAX-RS-Servlet zeigt. Wenn Sie Servlets verwenden möchten, können Sie einen Servletpfad in der Datei web.xml definieren, der an den Basis-URL angefügt wird.
Informationen zu diesem Vorgang
Sie können die Datei web.xml für Ihre Webanwendung konfigurieren, um den JAX-RS-Anwendungscode zu aktivieren. Sie können ein IBM spezifisches JAX-RS-Servlet für die Ausführung Ihres JAX-RS-Codes an. Die Datei web.xml enthält Konfigurations- und Implementierungsinformationen für die Webkomponenten, die eine Webanwendung enthalten. Weitere Informationen zu dieser Implementierungsdeskriptordatei finden Sie in den Informationen zur Konfiguration der Datei web.xml für JAX-RS.
Wenn Sie Servlets verwenden möchten, wird jeder Servletpfad, der in der Datei web.xml definiert ist, an den Basis-URL angefügt. Wenn beispielsweise eine Stammressource den Wert myresource für "@javax.ws.rs.Path" und den Servletpfad myservletpath hat, lautet der endgültige URL der Ressource http://<Hostname>:<Web-Container-Port>/<Kontextstammverzeichnis_der_Webanwendung>//myservletpath/myresource.
Vorgehensweise
Ergebnisse
Beispiel
Das folgende Beispiel veranschaulicht eine Datei WEB-INF/web.xml, die einen Servletpfad für eine JAX-RS-Anwendung konfiguriert. Der Servletpfad, der in der Datei web.xml definiert ist, wird an den Basis-URL angefügt.
<?xml version="1.0" encoding="UTF-8"?>
<web-app id="WebApp_9" version="2.4"
xmlns=http://java.sun.com/xml/ns/j2ee
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee http://java.sun.com/xml/ns/j2ee/web-app_2_4.xsd">
<servlet>
<servlet-name>RestApplication1</servlet-name>
<servlet-class>com.ibm.websphere.jaxrs.server.IBMRestServlet</servlet-class>
<init-param>
<param-name>javax.ws.rs.Application</param-name>
<param-value>com.ibm.rest.sample.app1.MyApplication</param-value>
</init-param>
<init-param>
<param-name>requestProcessorAttribute</param-name>
<param-value>restApplication1ProcessorID</param-value>
</init-param>
<load-on-startup>1</load-on-startup>
</servlet>
<servlet>
<servlet-name>OtherRestApplicationServlet</servlet-name>
<servlet-class>com.ibm.websphere.jaxrs.server.IBMRestServlet</servlet-class>
<init-param>
<param-name>javax.ws.rs.Application</param-name>
<param-value>com.ibm.rest.other.sample.OtherApplication </param-value>
</init-param>
<init-param>
<param-name>requestProcessorAttribute</param-name>
<param-value>otherRestApplicationID </param-value>
</init-param>
<load-on-startup>1</load-on-startup>
</servlet>
<servlet-mapping>
<servlet-name> RestApplication1</servlet-name>
<url-pattern>/rest/api/*</url-pattern>
</servlet-mapping>
<servlet-mapping>
<servlet-name>OtherRestApplicationServlet /servlet-name>
<url-pattern>/other/*</url-pattern>
</servlet-mapping>
</web-app>
Nächste Schritte
Assemblieren Sie die Webanwendung.