Der JAX-RS-Web-Service muss sich in einem Projekt befinden, bei dem die JAX-RS-Facette aktiviert ist.
- Klicken Sie in der Java EE-Perspektive mit der rechten Maustaste auf Ihr EAR-Projekt und wählen Sie aus, um den Webprojektassistenten zu öffnen.
- Geben Sie im Feld Name einen Namen für Ihr neues Webprojekt ein. Wählen Sie für dieses Lernprogramm JAXRS aus.
- Wählen Sie im Abschnitt für die Projektschablonen den Typ der Webschablone aus, den Sie verwenden möchten: Wählen Sie für dieses Lernprogramm Einfach aus.
Option |
Bezeichnung |
Dojo Toolkit |
Konfiguriert das Projekt, sodass es Dojo-Funktionalität aufweist. Die Dojo-Ressourcen können sich im Projekt selbst, in einem separaten Projekt oder an einer fernen Position befinden, auf die über HTTP zugegriffen werden kann. |
JavaServer Faces |
Ermöglicht die Implementierung des Projekts mit JSF-Funktionalität.
Konfiguration wird entweder für JSP oder Facelets bereitgestellt. |
REST-Services |
Ein Projekt, das für REST-Services auf der Basis von JAX-RS konfiguriert wurde. |
Einfach |
Es wird ein Basiswebprojekt erstellt. |
- Wählen Sie im Abschnitt "Programmiermodell" das Programmiermodell aus, das Sie verwenden möchten: Wählen Sie für dieses Lernprogramm Java EE aus.
- Nur clientseitig (HTML, JavaScript,...)
- Java EE
- OSGi
- Klicken Sie auf Weiter, um Ihr neues Webprojekt zu konfigurieren.
- Klicken Sie auf der Implementierungsseite in der Liste der verfügbaren Konfigurationsoptionen
auf Implementierung, um die Seite
"Implementierungskonfiguration" zu öffnen.
- Wählen Sie im Feld Ziellaufzeit die Version von WebSphere Application Server aus, die Sie zuvor in diesem Lernprogramm installiert haben.
- Übernehmen Sie im Feld Version des Webmoduls den Standardwert, der basierend auf der von Ihnen ausgewählten Version von WebSphere Application Server bereits automatisch ausgewählt ist.
- Klicken Sie im Feld EAR-Zugehörigkeit auf Projekt einer EAR hinzufügen und stellen Sie sicher, dass der Name des EAR-Projekts JAXRSEAR ist.
- Wählen Sie im Abschnitt "Implementierung" den Eintrag Features ändern aus.
Wählen Sie auf der Seite mit den Projektfacetten JAX-RS (REST Web Services), Version 1.1 aus und klicken Sie dann auf OK.
- Klicken Sie in der Liste der verfügbaren Konfigurationsoptionen auf Java, um die
Java-Konfigurationsseite zu öffnen.
- Akzeptieren Sie im Feld
Quellenordner im Buildpfad das Standardverzeichnis
src oder klicken Sie auf Ordner hinzufügen, Bearbeiten... oder Entfernen, um einen Ordner für Ihre Quellendateien anzugeben.
- Geben Sie im Feld Standardausgabeordner: einen Ordner für Ihre
Ausgabedateien an oder übernehmen Sie den Standardwert
(WebContent\WEB-INF\classes).
Wichtig: Wenn Sie als Standardausgabeordner einen anderen Ordner als "WebContent\WEB-INF\classes" angeben, wird in der Problemsicht eine Warnung angezeigt:
Bei Problemen mit einzelnen Stammordnern werden standardmäßig Warnungen angezeigt. Verwenden Sie die Seite
Prüfungsfilter für Projektstruktur-Prüfprogramm, um diese Einstellung zu ändern:
- Klicken Sie auf und anschließend auf die Schaltfläche ... für die Einstellungen.
- Geben Sie auf der Seite Prüfungsfilter für Projektstruktur-Prüfprogramm die Standardwertigkeitsstufe an. Verfügbare Wertigkeitsstufen sind Fehler, Warnung und Ignorieren.
- Klicken Sie in der Liste der verfügbaren Konfigurationsoptionen auf REST-Services, um die Konfigurationsseite für die REST-Services zu öffnen.
Wählen Sie im Feld JAX-RS-Implementierungbibliothek die Bibliothek für Ihre Serverversion aus: IBM WebSphere Application Server v<x> JAX-RS-Bibliothek. Stellen Sie sicher, dass die folgenden Werte angezeigt werden:
- Stellen Sie sicher, dass JAX-RS-Servlet im Feld JAX-RS-Servletname: angezeigt wird.
- Stellen Sie sicher, dass com.ibm.websphere.jaxrs.server.IBMRestServlet im Feld JAX-RS-Servletklassename: angezeigt wird.
- Stellen Sie sicher, dass /jaxrs/* im Feld URL-Zuordnungsmuster: angezeigt wird.
Weitere Informationen zu Bibliotheken: Die JAX-RS-Bibliotheken der
von Ihnen installierten WebSphere Application Server-Instanzen sind in dieser Dropdown-Liste aufgeführt. Falls Sie eine Nicht-WebSphere-Bibliothek verwenden möchten, kann diese
mithilfe der Vorgabenseite für Benutzerbibliotheken importiert werden. Falls Sie "Benutzerbibliothek" auswählen, können Sie die Vorgabenseite für Benutzerbibliotheken
aufrufen und eine Bibliothek hinzufügen. Sobald ein Projekt erstellt wurde, können Sie die Bibliothek unter
ändern.
- Klicken Sie in der Liste der verfügbaren Konfigurationsoptionen auf Webmodul. Gehen Sie auf der Seite Webmodulkonfiguration wie folgt vor:
- Geben Sie im Feld Kontextstammverzeichnis den Namen Ihre Webprojektstammverzeichnisses ein oder akzeptieren Sie den Standardwert (den Namen Ihres Webprojekts).
- Geben Sie im Feld
Inhaltsverzeichnis den Namen Ihres Inhaltsverzeichnisses ein oder akzeptieren Sie die Standardeinstellung
(WebContent).
- Wählen Sie die Option zum Generieren des
Implementierungsdeskriptors "web.xml" aus, wenn Sie einen Implementierungsdeskriptor erstellen möchten. Sie können Ihrem Webmodul auch später einen Implementierungsdeskriptor hinzufügen. Sie müssen die Datei web.xml verwenden, um Integritätsbedingungen für die Sicherheit und ein anderes Verhalten zu konfigurieren.
- Klicken Sie auf Fertigstellen.
Die Facette fügt die Bibliothek, Servletinformationen und Unterstützung für die Verarbeitung von JAX-RS-Annotationen und JAX-RS-Schnellkorrekturen hinzu.
Sie können jetzt mit dem nächsten
Modul Web-Service erstellen und testen beginnen.