JAX-RS-Web-Service erstellen
Vorbereitende Schritte
- Bei WebSphere Application Server Version 7.0 oder Version 8.0 wählen Sie aus, dass das Feature Pack for Web 2.0 AND MOBILE und die WebSphere Application Server-Entwicklungstools installiert werden sollen.
Wenn Sie auswählen, dass die Implementierung auf einem anderen Server als dem WebSphere Application Server erfolgen soll, können Sie die IBM JAX-RS-Bibliothek nicht verwenden und müssen Ihre eigenen JAX-RS-Bibliotheken über die Seite mit den Benutzervorgaben für Projektfacetten > JAX-RS konfigurieren.
Detaillierte Informationen zur Verwendung von JAX-RS-Web-Services in WebSphere Application Server finden Sie im WebSphere Application Server Information Center.
JAX-RS-fähiges Webprojekt erstellen
Informationen zu diesem Vorgang
[WebSphere Application Server Traditional] WebSphere Application Server Traditional Version 9 unterstützt JAX-RS 1.1 und JAX-RS 2.0. Die JAX-RS-Version, die Sie in Ihrem Projekt verwenden, muss mit der JAX-RS-Version, die Sie in Ihrer Installation von WebSphere Application Server Traditional Version 9 verwenden, übereinstimmen. Stimmen diese Versionen nicht überein, zeigen die Tools eine Warnung an, wenn Sie Ihr Projekt auf dem Server implementieren. Wenn Sie ein JAX-RS-Projekt erstellen, ohne eine Facettenstufe anzugeben, verwenden die Tools standardmäßig JAX-RS 2.0.
com.ibm.ws.jaxrs.jar
com.ibm.ws.prereq.jaxrs.jar
javax.j2ee.jaxrs.jar
com.ibm.ws.jaxrs20.jar
com.ibm.ws.prereq.jaxrs20.jar
javax.ws.rs-api-2.0.jar
Vorgehensweise
JAX-RS-Web-Service erstellen
Vorgehensweise
- Erstellen Sie in Ihrem Webprojekt ein Paket (klicken Sie mit der rechten Maustaste auf und wählen Sie aus). Importieren Sie die Klassen für den Web-Service in das Paket.
- Öffnen Sie die Datei WebContent/WEB-INF/web.xml. In der Entwurfsansicht wählen Sie das JAX-RS-Servlet aus und klicken auf Hinzufügen. Fügen Sie einen Initialisierungsparameter zum JAX-RS-Servlet hinzu und lassen Sie die Felder für Name und Wert leer. Speichern Sie die Datei web.xml und ignorieren Sie alle Fehler, die möglicherweise angezeigt werden.
- Wählen Sie in der Ansicht mit den Markierungen den web.xml-Fehler bei param-name aus, klicken Sie mit der rechten Maustaste und wählen Sie Schnellkorrektur aus. Blättern Sie zu der Anwendung und treffen Sie Ihre Auswahl.
- Fügen Sie die EAR-Datei mit dem JAX-RS-Projekt zum Server hinzu und starten Sie den Server.
Ergebnisse
Jede Webanwendung muss ein Kontextstammverzeichnis haben, damit die Webanwendung erfolgreich implementiert werden kann. Ein Kontextstammelement für jedes Webmodul wird während der Anwendungsassemblierung oder der Anwendungsimplementierung im Anwendungsimplementierungsdeskriptor definiert. Das Kontextstammverzeichnis wird mit der definierten Servlet-Zuordnung (aus der WAR-Datei) zum vollständigen URL kombiniert, den die Benutzer eingeben müssen, um auf das Servlet zugreifen zu können. Die Kontextstammverzeichnis aller implementierten Webanwendungen müssen auf dem Server eindeutig sein. Das Kontextstammelement kann auch leer sein.
Falls zum Beispiel eine Webanwendung das Kontextstammelement sample/application/ verwendet hat, beginnt die Anforderungs-URL der Webanwendung mit http://<hostname>:<port>/sample/application/. Das URL-Muster eines Servlets wird an das Kontextstammelement der Webanwendung angehängt. Falls das Kontextstammelement sample/application/ lautet und die Servlet-URL-Zuordnung rest/api/* lautet, so ist der Basis-URI für die JAX-RS-Webanwendung http://<Hostname>:<Port>/sample/application/rest/api.
JAX-RS-Projekt bearbeiten
- Bibliothekstyp
- JAX-RS-Servletname
- JAX-RS-Servletklassenname
- URL-Zuordnungsmuster