Kapitel 3. Entwicklung von Anwendungen, die die JBoss EAP verwenden

3.1. Überblick

Dieses Handbuch gibt Ihnen Information zum Einstieg in die Anwendungsentwicklung mithilfe des Red Hat JBoss Developer Studio und JBoss EAP 7 Quickstart-Beispielen.

Das Red Hat JBoss Developer Studio ist eine auf Eclipse basierende, integrierte Entwicklungsumgebung (Integrated Development Environment, IDE), die Plugins der JBoss Anwendungsentwicklung integriert. Das JBoss Developer Studio kann Ihnen bei der Entwicklung Ihrer Anwendung durch die Verfügbarkeit von JBoss-spezifischen Assistenten und durch die Fähigkeit, Anwendungen auf JBoss Servern bereitzustellen, helfen. Viele Quickstart-Codebeispiele werden mit der JBoss EAP 7 bereitgestellt um den Benutzern den Einstieg beim Schreiben von Anwendungen mittels verschiedener Java EE 7 Technologien zu erleichtern.

This guide provides basic installation instructions for JBoss Developer Studio. See the Install Red Hat JBoss Developer Studio guide for complete installation instructions.

3.2. Einrichten der Entwicklungsumgebung

3.2.1. Download des JBoss Developer Studio

Das JBoss Developer Studio kann aus dem Red Hat Kundenportal heruntergeladen werden.

Melden Sie sich beim Red Hat Kundenportal an.
Klicken Sie auf Downloads.
Klicken Sie in der Produkt Downloads Liste auf Red Hat JBoss Developer Studio.
Wählen Sie die gewünschte Version auf der Auswahlliste.
Anmerkung
It is recommended to use JBoss Developer Studio version 9.1 or later.
Find the Red Hat JBoss Developer Studio 9.x.x Stand-alone Installer entry in the table and click Download.
Speichern Sie die JAR Datei im gewünschten Verzeichnis.

3.2.2. Installation des JBoss Developer Studio

Öffnen Sie ein Terminal und gehen Sie zu dem Verzeichnis mit der heruntergeladenen JAR Datei.
Führen Sie den folgenden Befehl aus, um das GUI Installationsprogramm zu starten:
```
$ java -jar jboss-devstudio-BUILD_VERSION-installer-standalone.jar
```
Anmerkung
Alternativ können Sie das Installationsprogramm mit Doppelklick auf die JAR-Datei starten.
Klicken Sie auf Weiter um den Installationsprozess zu starten.
Wählen Sie I accept the terms of this license agreement und klicken Sie auf Weiter.
Passen Sie den Installationspfad an und klicken Sie auf Weiter.
Anmerkung
Falls das Verzeichnis auf dem Installationspfad nicht existiert, erscheint ein Dialogfeld. Klicken Sie auf OK um den Ordner zu erstellen.
Wählen Sie eine JVM oder lassen Sie die standardmäßige JVM ausgewählt und klicken Sie auf Weiter.
Click Next when asked to select platforms and servers.
Überprüfen Sie die Installationsdetails und klicken Sie auf Weiter.
Klicken Sie auf Weiter, wenn der Installationsprozess abgeschlossen ist.
Konfigurieren Sie die Desktop-Verknüpfungen für JBoss Developer Studio und klicken Sie auf Weiter.
Klicken Sie auf Fertig.

3.2.3. Starten des JBoss Developer Studio

Zum Start des JBoss Developer Studio können Sie einen Doppelklick auf die Desktop-Verknüpfung machen, die Sie bei der Installation erstellt haben, oder Sie können es direkt von der Befehlszeile aus starten. Folgen Sie den unten angegebenen Schritten um das JBoss Developer Studio über die Befehlszeile zu starten.

Öffnen Sie ein Terminal und wechseln Sie in das Red Hat JBoss Developer Studio Installationsverzeichnis.
Führen Sie den folgenden Befehl aus, um das JBoss Developer Studio zu starten:
```
$ ./jbdevstudio
```
Anmerkung
Benutzen Sie für Windows Server die jbdevstudio.bat Datei.

3.2.4. Hinzufügen des JBoss EAP Servers zum JBoss Developer Studio

Diese Anleitung geht davon aus, dass Sie noch keine JBoss EAP Server zum JBoss Developer Studio hinzugefügt haben. Folgen Sie den hier beschriebenen Schritten um Ihren JBoss EAP Server unter Verwendung des Define New Server Assistenten hinzuzufügen.

Öffnen Sie den Server Reiter.
Anmerkung
If the Servers tab is not shown, add it to the panel by selecting Window Show View Servers.
Klicken Sie auf den Link Kein Server verfügbar. Klicken Sie auf diesen Link um einen neuen Server zu erstellen.
Abbildung 3.1. Hinzufügen eines neuen Servers
Expand Red Hat JBoss Middleware and choose JBoss Enterprise Application Platform 7.0. Enter a server name, for example, JBoss EAP 7.0, then click Next.
Abbildung 3.2. Definieren eines neuen Servers
Erstellen Sie einen Server-Adapter um das Starten und Stoppen des Servers zu verwalten. Behalten Sie die Standardeinstellungen und klicken Sie auf Weiter.
Abbildung 3.3. Erstellen eines neuen Server-Adapters
Geben Sie einen Namen ein, beispielsweise JBoss EAP 7.0 Runtime. Klicken Sie auf Durchsuchen neben Home Verzeichnis und gehen Sie zu Ihrem JBoss EAP Installationsverzeichnis. Klicken Sie dann auf Weiter.
Abbildung 3.4. Hinzufügen einer neuen Server Laufzeitumgebung
Anmerkung
Manche Quickstarts erfordern, dass Sie den Server mit einem anderen Profil oder zusätzlichen Argumenten ausführen. Um beispielsweise einen Quickstart bereitzustellen, der das full Profil benötigt, müssen Sie einen neuen Server definieren und eine standalone-full.xml im Feld für Konfigurationsdatei angeben. Stellen Sie sicher, dass Sie dem Server einen neuen beschreibenden Namen geben.
Konfigurieren Sie bestehende Projekte für den neuen Server. Da Sie zu diesem Zeitpunkt keine Projekte haben, klicken Sie auf Fertigstellen.
Abbildung 3.5. Bearbeiten Sie die Ressourcen für den neuen Server

Der JBoss EAP 7.0 Server ist jetzt im Server Reiter gelistet.

Abbildung 3.6. Serverliste

The *Servers* tab when the `JBoss EAP 7.0` server is listed.

3.3. Verwendung von Quickstart-Beispielen

Die Quickstart-Beispiele für JBoss EAP sind Maven-Projekte.

3.3.1. Über Maven

Apache Maven ist ein verteiltes Build-Automatisierungstool, das bei der Entwicklung von Java-Anwendungen für Erstellung, Verwaltung und Build von Software-Projekten verwendet wird. Maven verwendet Standard-Konfigurationsdateien namens Project Object Model (POM), die den Build-Prozess definieren und verwalten. POMs beschreiben die Modul- und Komponenten-Abhängigkeiten, die Build-Reihenfolge und die Ziele für resultierendes Projekt-Packaging und Ausgabe unter Verwendung einer XML-Datei. Dies stellt den korrekten und einheitlichen Build des Projekts sicher.

Maven erreicht dies unter Verwendung eines Repositorys. Ein Maven Repository speichert Java-Bibliotheken, Plugins und andere Build-Artefakte. Das standardmäßige öffentliche Repository ist das Maven 2 Central Repository, aber Repositorys können innerhalb eines Unternehmens privat und intern sein, mit dem Ziel gemeinsame Artefakte unter den Entwicklungsteams zu teilen. Repositorys sind auch von Drittanbietern erhältlich. Weitere Informationen finden Sie im Apache Maven Projekt und im Handbuch Einführung in Repositorys.

Die JBoss EAP beinhaltet ein Maven-Repository, das viele Anforderungen enthält, die Java EE Entwickler in der Regel für den Build von Anwendungen auf der JBoss EAP verwenden.

Weitere Informationen zur Verwendung von Maven mit JBoss EAP finden Sie unter Verwendung von Maven mit JBoss EAP im JBoss EAP Entwicklungsleitfaden.

3.3.2. Verwendung von Maven mit Quickstarts

Die für Build und Deployment von Anwendungen auf der JBoss EAP 7 erforderlichen Artefakte und Abhängigkeiten werden auf einem öffentlichen Repository gehostet. Beim Start mit JBoss EAP 7 Quickstarts ist es nicht mehr nötig Ihre Maven settings.xml Datei zur Verwendung dieser Repositorys beim Build von Quickstarts zu konfigurieren. Die Maven Repositorys sind jetzt in den POM Dateien des Quickstart-Projekts konfiguriert. Diese Konfigurationsmethode soll den Einstieg in die Quickstarts erleichtern, wird jedoch im Allgemeinen nicht für Produktionsprojekte empfohlen, da sie Ihren Build verlangsamen kann.

Red Hat JBoss Developer Studio umfasst Maven, dies muss also nicht eigens heruntergeladen und installiert werden. Die Verwendung von JBoss Developer Studio Version 9.1 oder höher wird empfohlen.

Falls Sie die Maven-Befehlszeile für Build und Deployment Ihrer Anwendungen verwenden wollen, müssen Sie zuerst Maven vom Apache Maven Projekt entsprechend der Anleitung in der Maven-Dokumentation herunterladen und installieren.

3.3.3. Download und Ausführung der Quickstarts

3.3.3.1. Download der Quickstarts

Die JBoss EAP kommt mit einem umfassenden Satz an Quickstart-Codebeispielen, die den Benutzern beim Schreiben von Anwendungen mittels verschiedener Java EE 7 Technologien helfen sollen. Die Quickstarts können vom Red Hat Kundenportal heruntergeladen werden.

Melden Sie sich beim Red Hat Kundenportal an.
Klicken Sie auf Downloads.
Klicken Sie in der Produkt Downloads Liste auf Red Hat JBoss Enterprise Application Platform.
Wählen Sie die gewünschte Version auf der Auswahlliste.
Suchen Sie den Eintrag Red Hat JBoss Enterprise Application Platform 7.0.0 Quickstarts in der Tabelle und klicken Sie auf Download.
Speichern Sie die Zip-Datei im gewünschten Verzeichnis.
Entpacken Sie die Zip-Datei.

3.3.3.2. Ausführen der Quickstarts im JBoss Developer Studio

Sobald die Quickstarts heruntergeladen sind, können Sie ins JBoss Developer Studio importiert und in der JBoss EAP bereitgestellt werden.

Importieren der Quickstarts ins JBoss Developer Studio

Jeder Quickstart wird mit einer POM Datei geliefert, die seine Projekt- und Konfigurationsinformationen enthält. Mit dieser POM Datei können Sie den Quickstart einfach ins JBoss Developer Studio importieren.

Wichtig

Befindet sich Ihr Quickstart-Projektordner beim Import ins JBoss Developer Studio innerhalb der IDE-Arbeitsfläche, so generiert IDE einen ungültigen Projektnamen und WAR-Archivnamen. Stellen Sie sicher, dass sich Ihr Quickstart-Projektordner außerhalb der IDE-Arbeitsfläche befindet, ehe Sie anfangen!

Starten Sie das JBoss Developer Studio.
Wählen Sie Datei Import.
Wählen Sie Maven Bestehende Maven Projekte und klicken Sie dann auf Weiter.
Abbildung 3.7. Import bestehender Maven Projekte
Gehen Sie zum gewünschten Quickstart-Verzeichnis (zum Beispiel helloworld Quickstart) und klicken Sie auf OK. Das Projekte Listenfeld wird mit der pom.xml Datei des gewählten Quickstart-Projekts bestückt.
Abbildung 3.8. Auswahl von Maven-Projekten
Klicken Sie auf Fertigstellen.

Führen Sie den helloworld Quickstart aus

Durch die Ausführung des helloworld Quickstarts kann man ganz einfach prüfen, ob der JBoss EAP Server konfiguriert ist und ordnungsgemäß läuft.

If you have not yet defined a server, add the JBoss EAP server to JBoss Developer Studio.
Wählen Sie per Rechtsklick auf das jboss-helloworld Projekt im Project Explorer Reiter Ausführen als Ausführen auf Server aus.
Abbildung 3.9. Ausführen als - Ausführen auf Server
Wählen Sie JBoss EAP 7.0 auf der Serverliste und klicken Sie auf Weiter.
Abbildung 3.10. Ausführen auf Server
Der jboss-helloworld Quickstart ist bereits zur Konfiguration auf dem Server aufgelistet. Klicken Sie auf Fertigstellen um den Quickstart bereitzustellen.
Abbildung 3.11. Bearbeiten von auf dem Server konfigurierten Ressourcen
Überprüfen Sie die Ergebnisse.
- Im Server Reiter wechselt der JBoss EAP 7.0 Server Status auf Started .
- Der Konsole Reiter zeigt Nachrichten zum JBoss EAP Server-Start und zum Deployment des helloworld Quickstarts.
```
WFLYUT0021: Registered web context: /jboss-helloworld
WFLYSRV0010: Deployed "jboss-helloworld.war" (runtime-name : "jboss-helloworld.war")
```
- Die helloworld Anwendung ist verfügbar unter http://localhost:8080/jboss-helloworld und zeigt den Text Hello World! an.

Führen Sie den bean-validation Quickstart aus

Einige Quickstarts, wie der bean-validation Quickstart, bieten keine Benutzerschnittstellen-Schicht und stellen stattdessen Arquillian-Tests bereit um ihre Funktionalität zu demonstrieren.

Importieren Sie den bean-validation Quickstart ins JBoss Developer Studio.
Klicken Sie im Server Reiter mit der rechten Maustaste auf den Server und wählen Sie Start aus, um den JBoss EAP Server zu starten. Wenn Sie keinen Server Reiter sehen oder noch keinen Server definiert haben, fügen Sie den JBoss EAP Server zum Red Hat JBoss Developer Studio hinzu.
Wählen Sie per Rechtsklick auf das jboss-bean-validation Projekt im Project Explorer Reiter Ausführen als Maven Build aus.
Geben Sie Folgendes in das Ziele Eingabe-Feld ein und klicken Sie dann auf Ausführen.
```
clean test -Parq-wildfly-remote
```
Abbildung 3.12. Konfiguration bearbeiten

Überprüfen Sie die Ergebnisse.

Der Konsole Reiter zeigt die Ergebnisse des bean-validation Arquillian-Tests:

-------------------------------------------------------
 T E S T S
-------------------------------------------------------
Running org.jboss.as.quickstarts.bean_validation.test.MemberValidationTest
Tests run: 5, Failures: 0, Errors: 0, Skipped: 0, Time elapsed: 2.189 sec

Results :

Tests run: 5, Failures: 0, Errors: 0, Skipped: 0

[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------

3.3.3.3. Ausführen der Quickstarts von der Befehlszeile aus

Build und Bereitstellung von Quickstarts von der Befehlszeile aus sind mit Maven einfach. Wenn Sie Maven noch nicht installiert haben, gehen Sie zum Apache Maven Projekt um es herunterzuladen und zu installieren.

Eine README.md Datei im root Verzeichnis des Quickstarts enthält allgemeine Informationen über Systemanforderungen, über die Konfiguration von Maven, über das Hinzufügen von Benutzern und über die Ausführung von Quickstarts.

Jeder Quickstart enthält zudem seine eigene README.md Datei, die spezifische Anweisungen und Maven-Befehle zur Ausführung des Quickstarts bereitstellt.

Führen Sie den helloworld Quickstart von der Befehlszeile aus

Überprüfen Sie die README.md Datei im root-Verzeichnis des helloworld Quickstarts.
Starten Sie den JBoss EAP-Server.
```
$ EAP_HOME/bin/standalone.sh
```
Gehen Sie zum helloworld Quickstart-Verzeichnis.
Build und Deployment des Quickstarts über den in der README.md Datei angegebenen Maven-Befehl.
```
mvn clean install wildfly:deploy
```
Die helloworld Anwendung ist jetzt verfügbar unter http://localhost:8080/jboss-helloworld und zeigt den Text Hello World! an.