bugfix: Erkenntnisse aus der gestrigen SE2-Übung

Thomas Ziemer
1 parent 6a4fd2b7
Showing 2 changed files with 94 additions and 40 deletions
README.md
src/test/resources/net/ziemers/swxercise/testdata/UserServiceTestData.xml
 # Ein Java-Beispielprojekt für die Lehrveranstaltungen "Software Engineering 2" (SE2) und "Softwarequalität und Test" (SwQT).
+Anmerkung: Dieses Tutorial lebt! Es wird ständig verbessert, um Problemlösungen noch genauer zu beschreiben. Bitte melden Sie auftretende Probleme deshalb.
+
 ## Projekt-Voraussetzungen
 - Versionsverwaltungswerkzeug "Git"
-- Installiertes Java 8 JDK (mit Dokumentation)
+- 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" (optional)
+- Build-System "maven" (unter Windows optional)
 - Ein relationales Datenbankverwaltungssystem mit JDBC-Anbindung ("MySQL" empfohlen, oder "MariaDB", "PostgreSQL", "Oracle Express" etc.)
-- Ein REST-Client (empfohlen "Advanced Rest Client Application" für Chrome)
+- 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.
+
+Unter Linux installiert man Git folgendermaßen:
+
+> sudo apt-get update
+
+> sudo apt-get install git
+
+Unter Windows muss der Git-Installer aus dem Internet heruntergeladen und installiert werden.
 ## Java-Projekt herunterladen
@@ -16,35 +30,69 @@ In einem beliebigen Verzeichnis ausführen:
 > git clone https://git.ziemers.de/edu/swXercise.git
-Danach das entstandene Projektverzeichnis swXercise in der Entwicklungsumgebung als existierendes Maven-Projekt importieren.
+Es wird hierbei ein neues Verzeichnis namens "swXercise" erstellt, in dem sich nun das Projekt befindet.
+
+## Projekt in die Entwicklungsumgebung integrieren
+
+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!).
+
+Bei "Eclipse" das Menü "File -> Import... -> Maven -> Existing Maven Projects" aufrufen und den Dialogen folgen (Datei "pom.xml" auswählen!).
+
+## MySQL-Datenbanksystem installieren
+
+### Windows und Mac OS
+
+Unter Windows und auf dem Mac einfach den entsprechenden MySQL-Installer von den Oracle-Webseiten herunterladen und installieren.
+
+### Unter Linux
+
+> sudo apt-get update
+
+> sudo apt-get install mysql-server
+
+Danach (ohne Aktivierung des "Validating password plugin"s!):
+
+> sudo mysql_secure_installation
+
+Während der Installation wird ein temporäres Root-Kennwort generiert. Das muss man sich gut merken.
 ## MySQL konfigurieren
-Zunächst muss das MySQL-Datenbanksystem installiert werden. Dies ist betriebssystemspezifisch. Während der Installation wird ein temporäres Root-Kennwort generiert.
+Unter Windows muss man ein beliebiges MySQL-Frontend installieren, beispielsweise "phpMyAdmin" o.ä. Damit müssen die beiden erforderlichen Datenbanken "swxercise" und "swxercise_test" erstellt werden.
-Dann kann das MySQL-Frontend gestartet werden (es wird zunächst nach dem temporären Kennwort gefragt):
+Unter Linux und auf dem Mac kann stattdessen das MySQL-Frontend gestartet werden:
 > mysql -u root -p
-Dann kann/muss das Kennwort geändert werden, beispielsweise in 'root':
+Es wird zunächst nach dem temporären Kennwort gefragt. Dieses kann/muss geändert werden, beispielsweise in 'root':
 > 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;
+> CREATE DATABASE swxercise;
-> create database swxercise_test;
+> CREATE DATABASE swxercise_test;
-> grant all privileges on swxercise.* to 'root'@'localhost' identified by 'root';
+> GRANT ALL PRIVILEGES ON swxercise.* TO 'root'@'localhost' IDENTIFIED BY 'root';
-> grant all privileges on swxercise_test.* to 'root'@'localhost' identified by 'root';
+> GRANT ALL PRIVILEGES ON on swxercise_test.* TO 'root'@'localhost' IDENTIFIED BY 'root';
 ## MySQL-Datenbank im WildFly einbinden
 Zunächst muss der JBoss WildFly Application Server installiert werden. Dies ist betriebssystemspezifisch.
-### Datei module.xml im Verzeichnis $JBOSS_HOME/modules/system/layers/base/com/mysql/driver/main erstellen mit folgendem Inhalt:
+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.
+
+Unter Windows dem WildFly-Installer von den JBoss-Webseiten herunterladen und installieren.
+
+### Datei "module.xml" im Verzeichnis "$JBOSS_HOME/modules/system/layers/base/com/mysql/driver/main" erstellen
+
+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:
 ```
 <module xmlns="urn:jboss:module:1.3" name="com.mysql.driver">
@@ -58,15 +106,16 @@ Zunächst muss der JBoss WildFly Application Server installiert werden. Dies ist
 </module>
 ```
-Und natürlich die jar-datei mit dem angegebenen MySQL-Treiber in dieses Verzeichnis hineinkopieren. Er muss von den Oracle-Internetseiten heruntergeladen werden.
+Und die jar-datei mit dem angegebenen MySQL-Treiber in dieses Verzeichnis hineinkopieren (im Beispiel in der Version "5.1.41-bin"). Er muss von den Oracle-Internetseiten heruntergeladen werden.
-Aufgepasst bei der Version des MySQL-Konnektors in der module.xml!
+### In der Datei "standalone.xml" im Verzeichnis "$JBOSS_HOME/standalone/configuration" folgenden Inhalt unterhalb der WildFly-Beispieldatenbank "com.h2database.h2" ergänzen:
-### In der standalone.xml im Verzeichnis $JBOSS_HOME/standalone/configuration folgenden Inhalt unterhalb der WildFly-Beispieldatenbank com.h2database.h2 ergänzen:
+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!!!
 ```
 <drivers>
-  ... (hier befindet sich der H2-Treiber; unserer kommt darunter)
+  <!-- (hier befindet sich der bereits vorhandene Eintrag für den "H2"-Treiber; unserer kommt direkt darunter) -->
+
   <driver name="mysql" module="com.mysql.driver">
     <driver-class>com.mysql.jdbc.Driver</driver-class>
   </driver>
@@ -75,30 +124,34 @@ Aufgepasst bei der Version des MySQL-Konnektors in der module.xml!
 ## MySQL-Datasource im WildFly definieren
-### In der standalone.xml im Verzeichnis $JBOSS_HOME/standalone/configuration folgenden Inhalt innerhalb der Datasources ergänzen:
+### In der Datei "standalone.xml" im "Verzeichnis $JBOSS_HOME/standalone/configuration" folgenden Inhalt innerhalb der Datasources ergänzen:
+
+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!!!
 ```
-... (hier befindet sich die H2-Datasource; unsere kommt darunter)
-</datasource>
-<datasource jndi-name="java:jboss/datasources/swXerciseDS" pool-name="swXerciseDS" enabled="true" use-java-context="true" jta="true">
-  <connection-url>jdbc:mysql://localhost:3306/swxercise?useSSL=false</connection-url>
-  <driver>mysql</driver>
-  <!-- der Default-Eintrag "TRANSACTION_REPEATABLE_READ" kann zu Camunda-Deadlocks kommen (ThZ, 24.04.2017) -->
-  <transaction-isolation>TRANSACTION_READ_COMMITTED</transaction-isolation>
-  <pool>
-    <min-pool-size>10</min-pool-size>
-    <max-pool-size>100</max-pool-size>
-    <prefill>true</prefill>
-  </pool>
-  <security>
-    <user-name>root</user-name>
-    <password>root</password>
-  </security>
-  <statement>
-    <prepared-statement-cache-size>32</prepared-statement-cache-size>
-    <share-prepared-statements>true</share-prepared-statements>
-  </statement>
-</datasource>
+<datasources>
+  <!-- (hier befindet sich die bereits vorhandene "H2"-Datasource; unsere kommt direkt darunter) -->
+
+  <datasource jndi-name="java:jboss/datasources/swXerciseDS" pool-name="swXerciseDS" enabled="true" use-java-context="true" jta="true">
+    <connection-url>jdbc:mysql://localhost:3306/swxercise?useSSL=false</connection-url>
+    <driver>mysql</driver>
+    <!-- der Default-Eintrag "TRANSACTION_REPEATABLE_READ" kann zu Camunda-Deadlocks kommen (ThZ, 24.04.2017) -->
+    <transaction-isolation>TRANSACTION_READ_COMMITTED</transaction-isolation>
+    <pool>
+      <min-pool-size>10</min-pool-size>
+      <max-pool-size>100</max-pool-size>
+      <prefill>true</prefill>
+    </pool>
+    <security>
+      <user-name>root</user-name>
+      <password>root</password>
+    </security>
+    <statement>
+      <prepared-statement-cache-size>32</prepared-statement-cache-size>
+      <share-prepared-statements>true</share-prepared-statements>
+    </statement>
+  </datasource>
+</datasources>
 ```
 ## JBoss WildFly in Eclipse einbinden
 <?xml version="1.0" encoding="UTF-8"?>
 <dataset>
-    <profile id="1" username="username_profile" passwordHash="passwordHash_profile" hashAlgorithm="hashAlgorithm_profile" salt="salt_profile"/>
-    <user id="2" firstname="firstname_user" lastname="lastname_user" profile_id="1"/>
+    <!-- die Grosz-/Kleinschreibung scheint unter bestimmten Bedingungen von Bedeutung zu sein! -->
+    <Profile id="1" username="username_profile" passwordHash="passwordHash_profile" hashAlgorithm="hashAlgorithm_profile" salt="salt_profile"/>
+    <User id="2" firstname="firstname_user" lastname="lastname_user" profile_id="1"/>
 </dataset>