edu / swXercise · Commits

Commit 35cdab48124841c42ad240c018484bc5b9382bf9

Authored by Thomas Ziemer
1 parent 00097b5c
build: skipped

style: Readme-Datei für SwQT konkretisiert

Inline Side-by-side
Showing 1 changed file with 30 additions and 11 deletions
README.md
  View file @35cdab4
... ... @@ -6,15 +6,18 @@ Anmerkung: Dieses Tutorial lebt! Es wird ständig verbessert, um Problemlösunge
6 6  
7 7 - Versionsverwaltungswerkzeug "Git"
8 8 - Installiertes "Java 8 JDK" (mit Dokumentation)
9   -- Eine Java-Entwicklungsumgebung ("Eclipse", "JetBrains IntelliJ IDEA", "NetBeans" o.ä.)
10   -- JEE-Application Server "JBoss WildFly Version 8.2.1-final"
11 9 - Build-System "maven" (unter Windows optional)
12 10 - Ein relationales Datenbankverwaltungssystem mit JDBC-Anbindung ("MySQL" empfohlen, oder "MariaDB", "PostgreSQL", "Oracle Express" etc.)
  11 +
  12 +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:
  13 +
  14 +- Eine Java-Entwicklungsumgebung ("Eclipse", "JetBrains IntelliJ IDEA", "NetBeans" o.ä.)
  15 +- JEE-Application Server "JBoss WildFly Version 8.2.1-final"
13 16 - Ein REST-Client (empfohlen "Advanced Rest Client Application" für den Chrome Browser)
14 17  
15 18 ## Git installieren
16 19  
17   -Auf dem Mac ist Git bereits vorhanden, sofern Xcode installiert ist.
  20 +Auf dem Mac ist Git bereits vorhanden, sofern "Xcode" installiert ist.
18 21  
19 22 Unter Linux installiert man Git folgendermaßen:
20 23  
... ... @@ -34,6 +37,8 @@ Es wird hierbei ein neues Verzeichnis namens "swXercise" erstellt, in dem sich n
34 37  
35 38 ## Projekt in die Entwicklungsumgebung integrieren
36 39  
  40 +(Hinweis: Nicht unbedingt für die Implementierung von JUnit-Tests in der Veranstaltung SwQT erforderlich)
  41 +
37 42 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:
38 43  
39 44 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
70 75  
71 76 > ALTER USER 'root'@'localhost' IDENTIFIED BY ‘root‘;
72 77  
73   -Dann müssen die beiden projektspezifischen Datenbanken (für Test und "Produktion") erstellt und mit den nötigen Rechten versehen werden:
74   -
75   -> CREATE DATABASE swxercise;
  78 +Dann müssen die beiden projektspezifischen Datenbanken (für "Test" und "Produktion") erstellt und mit den nötigen Rechten versehen werden:
76 79  
77 80 > CREATE DATABASE swxercise_test;
78 81  
79   -> GRANT ALL PRIVILEGES ON swxercise.* TO 'root'@'localhost' IDENTIFIED BY 'root';
80   -
81 82 > GRANT ALL PRIVILEGES ON on swxercise_test.* TO 'root'@'localhost' IDENTIFIED BY 'root';
82 83  
  84 +(Hinweis: Das Folgende ist nicht unbedingt für die Implementierung von JUnit-Tests in der Veranstaltung SwQT erforderlich)
  85 +
  86 +> CREATE DATABASE swxercise;
  87 +
  88 +> GRANT ALL PRIVILEGES ON swxercise.* TO 'root'@'localhost' IDENTIFIED BY 'root';
  89 +
83 90 ## MySQL-Datenbank im WildFly einbinden
84 91  
  92 +(Hinweis: Nicht unbedingt für die Implementierung von JUnit-Tests in der Veranstaltung SwQT erforderlich)
  93 +
85 94 Zunächst muss der JBoss WildFly Application Server installiert werden. Dies ist betriebssystemspezifisch.
86 95  
87 96 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
90 99  
91 100 ### Datei "module.xml" im Verzeichnis "$JBOSS_HOME/modules/system/layers/base/com/mysql/driver/main" erstellen
92 101  
  102 +(Hinweis: Nicht unbedingt für die Implementierung von JUnit-Tests in der Veranstaltung SwQT erforderlich)
  103 +
93 104 Vermutlich existiert im Verzeichnis "com" schon das Unterverzeichnis "mysql" nicht. Also muss dieses Verzeichnis (und die entsprechenden Unterverzeichnisse ebenfalls) erstellt werden.
94 105  
95 106 Dann **module.xml** erstellen mit folgendem Inhalt:
... ... @@ -110,6 +121,8 @@ Und die jar-datei mit dem angegebenen MySQL-Treiber in dieses Verzeichnis hinein
110 121  
111 122 ### In der Datei "standalone.xml" im Verzeichnis "$JBOSS_HOME/standalone/configuration" folgenden Inhalt unterhalb der WildFly-Beispieldatenbank "com.h2database.h2" ergänzen:
112 123  
  124 +(Hinweis: Nicht unbedingt für die Implementierung von JUnit-Tests in der Veranstaltung SwQT erforderlich)
  125 +
113 126 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!!!
114 127  
115 128 ```
... ... @@ -126,6 +139,8 @@ Aufgepasst: Der WildFly-Server darf während der Bearbeitung der XML-Datei nicht
126 139  
127 140 ### In der Datei "standalone.xml" im "Verzeichnis $JBOSS_HOME/standalone/configuration" folgenden Inhalt innerhalb der Datasources ergänzen:
128 141  
  142 +(Hinweis: Nicht unbedingt für die Implementierung von JUnit-Tests in der Veranstaltung SwQT erforderlich)
  143 +
129 144 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!!!
130 145  
131 146 ```
... ... @@ -156,12 +171,14 @@ Aufgepasst: Der WildFly-Server darf während der Bearbeitung der XML-Datei nicht
156 171  
157 172 ## JBoss WildFly in Eclipse einbinden
158 173  
  174 +(Hinweis: Nicht unbedingt für die Implementierung von JUnit-Tests in der Veranstaltung SwQT erforderlich)
  175 +
159 176 ### JBoss Tools-Plugin installieren (nur für Eclipse)
160 177  
161 178 - Auswählen "Help -> Eclipse Marketplace..."
162   -- Find: "JBoss Tools (Neon)" (oder was halt gerade aktuell ist)
163   -- "Install" klicken
164   -- Auswählen "JBoss AS, Wildfly & EAP Server Tools"
  179 +- Find: "JBoss Tools"
  180 +- die gefundenen "JBoss Tools" installieren (zum Zeitpunkt des Schreibens dieser Zeilen ist "JBoss Tools 4.4.3 Final" aktuell)
  181 +- Auswählen "JBoss AS, Wildfly & EAP Server Tools" mit allen Unter-Plugins, die dranhängen
165 182  
166 183 Quelle: https://tools.jboss.org/downloads/jbosstools/neon/4.4.3.Final.html
167 184  
... ... @@ -186,6 +203,8 @@ Quelle: https://tools.jboss.org/downloads/jbosstools/neon/4.4.3.Final.html
186 203  
187 204 ## JBoss WildFly in IntelliJ IDEA einbinden
188 205  
  206 +(Hinweis: Nicht unbedingt für die Implementierung von JUnit-Tests in der Veranstaltung SwQT erforderlich)
  207 +
189 208 ### JBoss WildFly-Server initial bekanntmachen (nur für IntelliJ IDEA)
190 209  
191 210 - IDE-Menü "Run -> Edit Configurations..."
... ...