Bearbeiten von Hausübungen mit IntelliJ

Dateianzeige

• Am linken Rand finden Sie den Abschnitt "Project". Dort befindet sich eine Übersicht der Dateihierarchie des Projektes. Mit den Pfeilen links von Ordnern/Verzeichnissen können Sie die Ansicht erweitern bzw. verkleinern.
• In dem Verzeichnis src/main/java schreiben Sie den eigentlich Code.
• In dem Verzeichnis src/test/java schreiben Sie Ihre Tests.

Neue Dateien erstellen

• Mit einem Rechtsklick auf ein Package können Sie über new -> Java Class eine neue Java Datei erstellen. Geben Sie dafür den Namen an, wählen Sie aus, ob es eine Klasse, Interface, Enum oder Annotation sein soll und bestätigen Sie das Erstellen, indem Sie Enter drücken.
• Sie können auf dieselbe Weise auch packages erstellen. Wählen Sie dafür "package" anstatt "Java Class" aus.

Gradle Tasks

• Um die Übersicht mit allen Gradle Task zu öffnen, drücken Sie am rechten oberen Rand auf "Gradle" (das Elefantensymbol).
• Klappen Sie den Ordner, der nach dem Projekt benannt ist, sowie den darin enthaltenen Ordner "Tasks" aus. Nun sehen Sie alle Verzeichnisse, in denen Gradle Tasks enthalten sind.
• Anbei ist eine Tabelle mit allen relevanten Tasks. Die jeweiligen Tasks sind im Format "<group-name>/<task-name>" angegeben.
• Sie können eine Task mit einem Doppelklick auf sie ausführen.

Gradle Task	Beschreibung
application/run	Führt die main Methode des Projektes aus
verification/test	Führt Ihre selbstgeschriebenen Tests aus
verification/graderPublicRun	Führt die von uns zur Verfügung gestellten public Tests aus
verification/check	Führt alle (selbstgeschriebenen + public) Tests aus
build/mainBuildSubmission	Erstellt die Abgabedatei im Ordner build/libs
build/assemble	Erstellt eine ausführbare Datei in build/libs
build/build	Führt assemble und check aus

Code ausführen

• In IntelliJ gibt es verschiedene Methoden, wie Sie Ihren Code ausführen können. Sie können eine der folgenden Methoden benutzten:
  1. Wenn Sie eine Klasse mit einer main Methode betrachten, befindet sich bei der Zeilenangabe auf der Höhe der main Methode und der Klassendefinition ein grünes Dreieck. Wenn Sie auf dieses draufdrücken und dann auf "Run '...'" drücken, können Sie das Programm ausführen.
  2. Machen Sie links in der Project Ansicht einen Rechtsklick auf eine Klasse mit einer main Methode und drücken Sie auf "Run '...'".
  3. Führen Sie am rechten oberen Rand in der Gradle Ansicht die Task "run" im Ordner "application" aus.
  4. Drücken Sie am oberen rechten Rand auf das grüne Dreieck.
     • Beachten Sie, dass diese Methode die letzte Aktion, welche links davon angegeben ist, erneut ausführt. Diese ist nicht zwangsläufig immer das Ausführen des Codes.
• Wenn Ihr Code nicht terminiert, können Sie das Programm mit dem roten Quadrat am linken Rand stoppen.

Hinweis

Das ausführen über den Gradle Task "run" oder rechtsklick darauf + debuggen hat sich als die zuverlässigste Methode unabhängig vom Betriebssystem herausgestellt.

Public Tests

• Zu manchen Übungsblättern stellen wir Ihnen Public Tests zur Verfügung, mit welchen Sie Teile Ihrer Implementation testen können.
  • Tragen Sie zunächst in der build.gradle.kts Datei ihre persönlichen Daten ein. Siehe dafür den ersten Punkt im Abschnitt Exportieren.
  • Sie können die Public Tests mittels der Gradle Task verification/graderPublicRun ausführen. Nach der Ausführung werden Ihnen in der Konsole die erreichte Punktzahl, sowie ein Link zu einer Datei mit weiteren Hinweisen angezeigt.
  • Wenn Sie die Vorlage herunterladen bevor die Public Tests veröffentlicht wurden, müssen Sie diese noch hinzufügen. Hinweise dazu finden Sie hier.
  • Beachten Sie unbedingt auch die Hinweise bezüglich den Public Tests auf Moodle.
  • Wenn Java zu wenig Speicher zur Verfügung hat, kann es dazu kommen, dass Sie den Fehler "java.lang.outOfMemoryError: Java heap space" bekommen. Versuchen Sie zunächst die Public Tests erneut auszuführen oder IntelliJ neuzustarten. Falls der Fehler weiterhin auftritt, versuchen Sie Java mehr Speicher zuzuweisen.

Tests ausführen

• Sie können Ihre Tests auf dieselbe Weise ausführen, wie Ihren Code.
  • Anstelle der Gradle Test "application/run" müssen Sie die Task "verification/test" ausführen.
  • Wenn Sie in der Project Ansicht einen Rechtsklick auf einen höher liegendes Package bzw. Verzeichnis machen, können Sie alle Test, die in diesem enthalten sind, auf einmal ausführen.

Fehler und Warnungen erkennen und beheben

• IntelliJ zeigt Ihnen Syntaxfehler in Ihrem Code rot unterstrichenen an. Diese müssen behoben werden.
• Warnungen werden Ihnen gelb unterstrichen angezeigt. Diese müssen zwar nicht behoben werden, sollten es aber.
• Wenn Sie mit der Maus über den rot oder gelb unterstrichenen Text gehen, wird Ihnen eine Beschreibung des Problems, sowie Vorschläge, wie es automatisch behoben werden kann, angezeigt.
• Am linken unteren Rand finden Sie im Abschnitt "Problems" eine Übersicht mit allen Fehlern und Warnungen.

Fehlermeldungen verstehen

• Wenn Sie Ihr Programm ausführen, öffnet sich unten automatisch eine Übersicht über den Verlauf des Programms und die Konsole. Hier werden Ihnen auch die Fehler angezeigt, die während dem Programmablauf auftreten.
• Damit Ihnen die vollständigen Fehlermeldungen angezeigt werden, wählen Sie links von der Konsole die zweite Option von oben aus.
• Eine Fehlermeldung sieht z.B. wie folgt aus:

Fehler

Exception in thread "main" java.lang.ArithmeticException: / by zero

at example.Divider.divide(Main.java:20)

at example.Main.main(Main.java:10)

• Diese Fehlermeldung sagt Ihnen Folgendes:
  • Es ist eine ArithmeticException aufgetreten.
  • Der Grund ist: "/ by zero".
  • Der Fehler ist in der Methode divide der Klasse Divider in Zeile 20 aufgetreten.
  • Diese Methode wurde von der Methode main der Klasse Main in Zeile 10 aufgerufen.

Musterlösung und Private Tests

• Nach Ende der Abgabefrist wird auf Moodle bei der entsprechenden Übung ein Link zur Musterlösung veröffentlicht.
• In der Musterlösung sind in dem Ordner graderPrivate die private Tests enthalten, welche zur automatischen Bewertung ihrer Abgabe verwendet werden.
• Wenn Sie die Musterlösung herunterladen und mit Ihrer eigenen Implementation ersetzten, können Sie die private Tests auf die selbe Art wie die Public Tests ausführen, mit dem Unterschied, dass Sie die graderPrivateRun Task anstatt der graderPublicRun Task verwenden müssen.
• Alternativ können Sie zum Ausführen auch einen Rechtsklick auf den graderPrivate Ordner machen und auf "Run 'All Tests'" gehen um die Tests auszuführen. Diese Methode erlaubt im besonderen das Verwenden des Debuggers, funktioniert aber nicht bei allen Tests.