style: Readme-Datei für SwQT konkretisiert

Thomas Ziemer
1 parent 00097b5c
Showing 1 changed file with 30 additions and 11 deletions
README.md
@@ -6,15 +6,18 @@ Anmerkung: Dieses Tutorial lebt! Es wird ständig verbessert, um Problemlösunge
 - Versionsverwaltungswerkzeug "Git"
 - Installiertes "Java 8 JDK" (mit Dokumentation)
-- Eine Java-Entwicklungsumgebung ("Eclipse", "JetBrains IntelliJ IDEA", "NetBeans" o.ä.)
-- JEE-Application Server "JBoss WildFly Version 8.2.1-final"
 - Build-System "maven" (unter Windows optional)
 - Ein relationales Datenbankverwaltungssystem mit JDBC-Anbindung ("MySQL" empfohlen, oder "MariaDB", "PostgreSQL", "Oracle Express" etc.)
+
+Für die Weiterentwicklung am Projekt in der Veranstaltung SE2 (jedoch nicht für die Implementierung von JUnit-Tests in der Veranstaltung SwQT) sind ferner erforderlich:
+
+- Eine Java-Entwicklungsumgebung ("Eclipse", "JetBrains IntelliJ IDEA", "NetBeans" o.ä.)
+- JEE-Application Server "JBoss WildFly Version 8.2.1-final"
 - Ein REST-Client (empfohlen "Advanced Rest Client Application" für den Chrome Browser)
 ## Git installieren
-Auf dem Mac ist Git bereits vorhanden, sofern Xcode installiert ist.
+Auf dem Mac ist Git bereits vorhanden, sofern "Xcode" installiert ist.
 Unter Linux installiert man Git folgendermaßen:
@@ -34,6 +37,8 @@ Es wird hierbei ein neues Verzeichnis namens &quot;swXercise&quot; erstellt, in dem sich n
 ## Projekt in die Entwicklungsumgebung integrieren
+(Hinweis: Nicht unbedingt für die Implementierung von JUnit-Tests in der Veranstaltung SwQT erforderlich)
+
 Danach das entstandene Projektverzeichnis "swXercise" in der Entwicklungsumgebung als "existierendes Maven-Projekt" importieren, indem man die im Wurzelverzeichnis des Projekts vorhandene Datei "pom.xml" auswählt:
 Unter "IntelliJ IDEA" das Menü "File -> New... -> Project from Existing Sources..." aufrufen und den Dialogen folgen (wie geschrieben: die "pom.xml" muss ausgewählt werden!).
@@ -70,18 +75,22 @@ Es wird zunächst nach dem temporären Kennwort gefragt. Dieses kann/muss geänd
 > ALTER USER 'root'@'localhost' IDENTIFIED BY ‘root‘;
-Dann müssen die beiden projektspezifischen Datenbanken (für Test und "Produktion") erstellt und mit den nötigen Rechten versehen werden:
-
-> CREATE DATABASE swxercise;
+Dann müssen die beiden projektspezifischen Datenbanken (für "Test" und "Produktion") erstellt und mit den nötigen Rechten versehen werden:
 > CREATE DATABASE swxercise_test;
-> GRANT ALL PRIVILEGES ON swxercise.* TO 'root'@'localhost' IDENTIFIED BY 'root';
-
 > GRANT ALL PRIVILEGES ON on swxercise_test.* TO 'root'@'localhost' IDENTIFIED BY 'root';
+(Hinweis: Das Folgende ist nicht unbedingt für die Implementierung von JUnit-Tests in der Veranstaltung SwQT erforderlich)
+
+> CREATE DATABASE swxercise;
+
+> GRANT ALL PRIVILEGES ON swxercise.* TO 'root'@'localhost' IDENTIFIED BY 'root';
+
 ## MySQL-Datenbank im WildFly einbinden
+(Hinweis: Nicht unbedingt für die Implementierung von JUnit-Tests in der Veranstaltung SwQT erforderlich)
+
 Zunächst muss der JBoss WildFly Application Server installiert werden. Dies ist betriebssystemspezifisch.
 Unter Linux und auf dem Mac einfach das Tar- oder Zip-Archiv mit dem WildFly-Server von den JBoss-Webseiten herunterladen und in ein beliebiges Verzeichnis kopieren. Auf dem Mac wird hierzu standardmäßig "/Library/JBoss" verwendet. Darin die Archivdatei entpacken. Fertig.
@@ -90,6 +99,8 @@ Unter Windows dem WildFly-Installer von den JBoss-Webseiten herunterladen und in
 ### Datei "module.xml" im Verzeichnis "$JBOSS_HOME/modules/system/layers/base/com/mysql/driver/main" erstellen
+(Hinweis: Nicht unbedingt für die Implementierung von JUnit-Tests in der Veranstaltung SwQT erforderlich)
+
 Vermutlich existiert im Verzeichnis "com" schon das Unterverzeichnis "mysql" nicht. Also muss dieses Verzeichnis (und die entsprechenden Unterverzeichnisse ebenfalls) erstellt werden.
 Dann **module.xml** erstellen mit folgendem Inhalt:
@@ -110,6 +121,8 @@ Und die jar-datei mit dem angegebenen MySQL-Treiber in dieses Verzeichnis hinein
 ### In der Datei "standalone.xml" im Verzeichnis "$JBOSS_HOME/standalone/configuration" folgenden Inhalt unterhalb der WildFly-Beispieldatenbank "com.h2database.h2" ergänzen:
+(Hinweis: Nicht unbedingt für die Implementierung von JUnit-Tests in der Veranstaltung SwQT erforderlich)
+
 Aufgepasst: Der WildFly-Server darf während der Bearbeitung der XML-Datei nicht laufen, da er Ihre Änderungen ansonsten beim späteren Beenden wieder überschreiben würde!!!
 ```
@@ -126,6 +139,8 @@ Aufgepasst: Der WildFly-Server darf während der Bearbeitung der XML-Datei nicht
 ### In der Datei "standalone.xml" im "Verzeichnis $JBOSS_HOME/standalone/configuration" folgenden Inhalt innerhalb der Datasources ergänzen:
+(Hinweis: Nicht unbedingt für die Implementierung von JUnit-Tests in der Veranstaltung SwQT erforderlich)
+
 Aufgepasst: Der WildFly-Server darf während der Bearbeitung der XML-Datei nicht laufen, da er Ihre Änderungen ansonsten beim späteren Beenden wieder überschreiben würde!!!
 ```
@@ -156,12 +171,14 @@ Aufgepasst: Der WildFly-Server darf während der Bearbeitung der XML-Datei nicht
 ## JBoss WildFly in Eclipse einbinden
+(Hinweis: Nicht unbedingt für die Implementierung von JUnit-Tests in der Veranstaltung SwQT erforderlich)
+
 ### JBoss Tools-Plugin installieren (nur für Eclipse)
 - Auswählen "Help -> Eclipse Marketplace..."
-- Find: "JBoss Tools (Neon)" (oder was halt gerade aktuell ist)
-- "Install" klicken
-- Auswählen "JBoss AS, Wildfly & EAP Server Tools"
+- Find: "JBoss Tools"
+- die gefundenen "JBoss Tools" installieren (zum Zeitpunkt des Schreibens dieser Zeilen ist "JBoss Tools 4.4.3 Final" aktuell)
+- Auswählen "JBoss AS, Wildfly & EAP Server Tools" mit allen Unter-Plugins, die dranhängen
 Quelle: https://tools.jboss.org/downloads/jbosstools/neon/4.4.3.Final.html
@@ -186,6 +203,8 @@ Quelle: https://tools.jboss.org/downloads/jbosstools/neon/4.4.3.Final.html
 ## JBoss WildFly in IntelliJ IDEA einbinden
+(Hinweis: Nicht unbedingt für die Implementierung von JUnit-Tests in der Veranstaltung SwQT erforderlich)
+
 ### JBoss WildFly-Server initial bekanntmachen (nur für IntelliJ IDEA)
 - IDE-Menü "Run -> Edit Configurations..."