< Zurück | Weiter >

Lerneinheit 1: Server und Webprojekt erstellen

Der Web-Service muss sich in einem Webprojekt befinden, bei dem die JAX-RS-Facette aktiviert ist.

JAX-RS-fähigen Server erstellen

Informationen zu diesem Vorgang

Bevor Sie den Web-Service erstellen können, benötigen Sie einen Server mit definierter und gestarteter JVM-Unterstützung für Java Version 7.0 und höher. Standardmäßig wird ein Server für Sie bei der Installation von WebSphere Application Server erstellt. Dieser Server wird in der Ansicht 'Server' angezeigt. Wenn Sie jedoch einen neuen WebSphere-Anwendungsserver erstellen möchten, gehen Sie wie folgt vor:

Vorgehensweise

  1. Wählen Sie im Menü Datei die Einträge Neu > Andere > Server > Server > Weiter aus.
  2. Wählen Sie als Servertyp die entsprechende Version von WebSphere Application Server aus. Klicken Sie auf Weiter.
  3. Wenn diese Laufzeitumgebung noch nicht in Ihrem Arbeitsbereich erstellt worden ist, werden Sie aufgefordert, das Installationsverzeichnis für den Server auszuwählen. Klicken Sie auf Weiter.
  4. Übernehmen Sie den Standard-Server-Port und den Standardnamen. In diesem Lernprogramm ist der verwendete Standardservername server1. Klicken Sie auf Fertigstellen.
  5. Warten Sie, bis der Serverstart abgeschlossen ist. Nach dem Start wird in der Ansicht "Konsole" die Nachricht Der Server server1 ist für E-Business bereit angezeigt. Wenn der Server nicht automatisch startet, wählen Sie ihn in der Ansicht "Server" aus und klicken Sie auf das Startsymbol Serverstartsymbol.

JAX-RS-fähiges Webprojekt erstellen

Informationen zu diesem Vorgang

Der JAX-RS-Web-Service muss sich in einem Projekt befinden, bei dem die JAX-RS-Facette aktiviert ist.

Vorgehensweise

  1. Klicken Sie in der Java EE-Perspektive mit der rechten Maustaste auf Ihr EAR-Projekt und wählen Sie Neu > Webprojekt aus, um den Webprojektassistenten zu öffnen.
  2. Geben Sie im Feld Name einen Namen für Ihr neues Webprojekt ein. Wählen Sie für dieses Lernprogramm JAXRS aus.
  3. Wählen Sie im Bereich der 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 Basis-Webprojekt erstellt.
  4. Wählen Sie im Abschnitt "Programmiermodell" das Programmiermodell aus, das Sie verwenden möchten: Wählen Sie für diese Lernprogramm Java EE aus.
    • Nur clientseitig (HTML, JavaScript,...)
    • Java EE
    • OSGi
  5. Klicken Sie auf Weiter, um Ihr neues Webprojekt zu konfigurieren.
  6. Klicken Sie auf der Seite für die Implementierung aus der Liste der verfügbaren Konfigurationsoptionen auf Implementierung, um die Seite für die Implementierungskonfiguration zu öffnen.
    • Wählen Sie im Feld Ziellaufzeit die Version von WebSphere Application Server aus, die Sie 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 2.0 aus und klicken Sie dann auf OK.
  7. Klicken Sie in der Liste der verfügbaren Konfigurationsoptionen auf Java, um die Java-Konfigurationsseite zu öffnen.
    • Akzeptieren Sie im Feld zu den Quellenordnern im Erstellungspfad 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 für den Standardausgabeordner einen Ordner für Ihre Ausgabedateien an oder akzeptieren 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:
      Warnung zu einzelnem Stammordner
      Bei Problemen mit einzelnen Stammordnern werden standardmäßig Warnungen angezeigt. Verwenden Sie die Seite mit den Überprüfungsfilter für das Projektstruktur-Prüfprogramm, um diese Einstellung zu ändern:
      1. Klicken Sie auf Fenster > Benutzervorgaben > Prüfung > Projektstruktur-Prüfprogramm und anschließend auf die Schaltfläche ... für die Einstellungen.
      2. Geben Sie auf der Seite mit den Überprüfungsfilter für das Projektstruktur-Prüfprogramm die Standardwertigkeitsstufe an. Verfügbare Wertigkeitsstufen sind Fehler, Warnung und Ignorieren.
  8. 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-Implementierungsbibliothek 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 im Feld JAX-RS-Servletname: JAX-RS-Servlet angezeigt wird.
    • Stellen Sie sicher, dass im Feld JAX-RS-Servletklassename: com.ibm.websphere.jaxrs.server.IBMRestServlet angezeigt wird.
    • Stellen Sie im Feld URL-Zuordnungsmuster: /jaxrs/* angezeigt wird.
    Weitere Informationen zu Bibliotheken: Die JAX-RS-Bibliotheken für alle von Ihnen installierten WebSphere-Anwendungsserver sind in dieser Dropdown-Liste aufgeführt. Falls Sie eine Nicht-WebSphere-Bibliothek verwenden möchten, kann diese mithilfe der Benutzervorgabenseite zur Benutzerbibliothek importiert werden. Falls Sie 'Benutzerbibliothek' auswählen, können Sie die Benutzervorgabenseite zur Benutzerbibliothek aufrufen und eine Bibliothek hinzufügen. Sobald ein Projekt erstellt wurde, können Sie die Bibliothek auf der Seite mit den Benutzervorgaben ändern. Klicken Sie zum Aufrufen dieser Seite auf Benutzervorgaben > Projektfacetten > JAX-RS.
  9. 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 in das Feld für das Content-Verzeichnis den Namen Ihres Content-Verzeichnisses ein oder akzeptieren Sie den Standardwert (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 andere Verhalten zu konfigurieren.
  10. Klicken Sie auf Fertigstellen.

Ergebnisse

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.

< Zurück | Weiter >
Icon that indicates the type of topic Tutorial lesson topic
Timestamp icon Last updated: last_date

File name: jaxrs_exercise12.html