Java Development Kit

Einen aktuellen JDK von Oracle mit den Java-Quelltexten installieren.

Maven

Es ist sinnvoll, für Maven einen Mirror in $HOME/settings.xml zu definieren. Für Deutschland sollte diese Datei enthalten:

<settings>
  <mirrors>
    <!-- Einstellung eines Mirrors des Maven Central Repository in Deutschland: -->
    <mirror>
      <id>netcologne.de</id>
      <url>http://mirror.netcologne.de/maven2</url>
      <mirrorOf>central</mirrorOf>
      <!-- Germany, Cologne -->
    </mirror>
  </mirrors>
</settings>

Nach dem clone aus dem Git-Quelltext-Repository geht man mit cd auf das Verzeichnis mit dem pom.xml.

Dort führt man aus:

mvn test

Man muss ein Verzeichnis /www/derby anlegen und dahinein die aktuelle Lehrkraftnews-Datenbank in das Verzeichnis lehrkraftnews-test kopieren. Für den Produktionsbetrieb benutzt Tomcat das Verzeichnis lehrkraftnews-prod.

Durch die Testsuite wird das Verzeichnis target erzeugt. target enthält alles von Maven generierte.

target muss gegenüber dem Versionsverwaltungssystem als nicht versioniert konfiguriert werden.

Dann muss man den Derby-Server starten.
Desweiteren führt man aus:

cd /www/LiftLehrkraftnews
mvn jetty:run

Dadurch wird Jetty als lokaler Webserver auf dem Port 8080 gestartet. Wenn man zu http://localhost:8080/ browst, erhält man die Startseite der Web-Applikation Lehrkraftnews im Testbetrieb. Man darf Jetty guten Gewissens mittels <Strg/C> abbrechen.

Einrichten der IDE IntelliJ IDEA
Für die Lehrkraftnews-Entwicklung bevorzuge ich IDEA, da

das Scala-Plugin toleranter bezüglich der Scala-Sprachversionen ist. Man benötigt nicht verschiedene IDEA-Installationen für Scala-Projekte verschiedener Versionen.
das Refactoring besser funktioniert.
Vorgehen:
Versionierung ausschließen: Datei .gitignore anlegen mit den beiden Verzeichnisnamen .idea und target auf je einer eigenen Zeile. Die IDE-Einstellungen sind teilweise persönlicher Natur, das Target ist temporär. Beide Verzeichnisse sollten daher nicht versioniert werden.
Auf der Scala-Plugin-Seite http://plugins.jetbrains.com/plugin/?id=1347 nachschauen, zu welchem IDEA-Build die aktuellste Plugin-Version vorhanden ist. Nicht immer gibt es für die neuste IDEA-Version schon ein Scala-Plugin. Diese IDEA-Version auswählen.
IntelliJ IDEA Community Edition in der ausgewählten Version downloaden, entpacken, bin/idea.sh starten.
Einen JDK konfigurieren: Gemäß IDEA Help mittels File > Project Structure > Project einen JDK wählen oder mit New anlegen. Bei Ubuntu den unter /usr/lib/jvm/java-7-oracle .
In IDEA unter File > Settings > IDE Settings > Plugins > Install JetBrains plugin… > Category: Custom Languages > Scala > Install plugin > Yes das Scala-Plugin installieren.
Unter File > New Project wählen Import project from external model
Im Folgedialog Maven wählen und Next klicken
Im Folgedialog das Verzeichnis mit der Datei pom.xml als Root directory wählen, als Project format .idea wählen, ankreuzen: Automatically download Sources, dann Next klicken.
und die Datei pom.xml öffnen.
Es sollte die Fehlermeldung erscheinen “No Scala SDK in module”. Dadrin den Link “Setup Scala SDK” klicken. Im Dialog “Add Scala Support” Use Library > Create… > Select JAR’s for the new Scala SDK > Maven 2.10.5
Bis IDEA 13: Unter File > Project Structure > Modules prüfen, dass die Scala-Facet unter dem Projektknoten sichtbar ist.
Unter File > Settings > Project Settings > File Encodings > IDE Encoding für das gesamte Projekt auf UTF-8 einstellen.
Unter File > Settings > Project Settings > Maven > Maven home directory diese angeben : /usr/share/maven2 einstellen.
Unter File > Settings > Project Settings > Version Control > VCSs > Git konfigurieren:
Path to git executable: Auf Windows z.B. C:\Programme\Git\bin\git.exe
SSH Executable: IDEA ssh
Ebenso die zu ignorierenden Verzeichnisse konfigurieren:
Unter File > Settings > Project settings > Version Control > Ignored Files
die Verzeichnisse target und .idea angeben.
Zu allen Dependencies die Quelltexte downloaden:
Unter Window > Tool Windows > Maven Projects
das Projekt auswählen und in der zweiten Titelzeile auf das Symbol klicken. Dann “Download Sources[and Documentation]” wählen.
Dies ist sehr praktisch für das Verständnis von schlecht dokumentierter Fremdsoftware oder die Fehlereingrenzung bei Ausnahmen, die in der eingesetzten Fremdsoftware aufgetreten sind. Man kann von Typ/Objekt/Methoden-Namen oder von Stack-Trace-Zeilen zu der entsprechenden Quelltextstelle in der Fremdsoftware navigieren.
Hinweis: Das IDEA-Scala-Plugin ist längst nicht so stabil, wie man es von von Java-IDEs gewohnt ist. Wenn man den Eindruck hat, die IDE sieht Fehler, wo keine sind , dann sollte man versuchen: Das Verzeichnis target manuell löschen und dann in IDEA Build > Rebuild Project .
Problem: Wenn IDEA zu langsam wird, sollte man rechts unten beobachten, wieviel Arbeitsspeicher aktuell von wieviel belegt ist . Nötigenfalls in Datei Installationsverzeichnis/ bin/idea.vmoptions angeben: -Xmx1024m oder größer. Es handelt sich um die maximale Speicheranforderung durch die IDEA-JVM.