Eingangsbeispiel

Eingangsbeispiel - Installation
Table of contents
1
Installation des ersten Beispiels......................................................................................... 2
1.1
Installation von Java...................................................................................................... 2
1.2
Installation von Eclipse................................................................................................. 2
1.3
Beispiel Projekt importieren..........................................................................................2
1.4
Projekt starten................................................................................................................3
1.5
JUnit Tests starten......................................................................................................... 3
1.6
Ant Script einrichten und starten...................................................................................3
Copyright © 2006 Institut fuer Softwaretechnik und interaktive Systeme All rights reserved.
Eingangsbeispiel - Installation
1. Installation des ersten Beispiels
Hier wird die Installation von Java und Eclipse für das erste Beispiel erklärt.
1.1. Installation von Java
Das Beispiel benötigt Java 5 und damit das Java SDK 1.5.
Download des aktuellen JDK 1.5
Benötigt wird das JDK 1.5, nicht NetBeans, nicht J2EE und auch nicht das JRE alleine. Auf
derselben Seite findet man auch die Java 5 API Dokumentation, die einen Download wert ist.
1.2. Installation von Eclipse
In diesem Beispiel wird Eclipse und alle Eclipse-Projekte unter C:\java abgelegt. Natürlich
kann die Installation auch in ein anderes Verzeichnis erfolgen und die Eclipse Projekte in
einem anderen Verzeichnis gespeichert werden.
1. Download von Eclipse von der Eclipse Homepage
2. Entpacken bzw. Installation nach c:\java\eclipse\
3. Start mit c:\java\eclipse\eclipse.exe
Beim ersten Start verlangt Eclipse nach dem Workspace. In diesem Verzeichnis werden alle
Projektdateien abgelegt.
Eclipse fragt nach dem Workspace
Wir legen den Workspace in C:\java\workspace an und wählen außerdem die Option "Use
this as default and don't ask again".
Workspace anlegen
Eclipse präsentiert beim ersten Start einen Willkommensbildschirm, der Links zur Hilfe
anbietet. Klickt man diesen weg, kommt man zur Arbeitsoberfläche (der "Workbench").
1.3. Beispiel Projekt importieren
1. Der Ordner mit dem Beispielprojekt wird in unseren Workspace (C:\java\workspace\)
kopiert.
2. In Eclipse wird im Menü "File" die Option "Import" ausgewählt.
3. Auswahl "Existing projects into workspace" - Next
4. Nun geben wir das Verzeichnis mit dem Beispiel an (in unserem Beispiel
c:\java\workspace\telefonbuch).
Existing project
5. Danach sollte das Projekt unter "Projects" erscheinen.
Page 2
Copyright © 2006 Institut fuer Softwaretechnik und interaktive Systeme All rights reserved.
Eingangsbeispiel - Installation
Projekt Telefonbuch ist angewählt
6. Mit Finish wird das Projekt importiert
1.4. Projekt starten
Wurde ein Projekt noch nie gestartet, kennt Eclipse noch keine Runtime Configuration.
Darunter versteht man alle Einstellungen für den Start des Projekts, zum Beispiel die Klasse
mit dem Einstiegspunkt (public static void main), das Java Runtime Environment (kurz JRE)
das zu verwenden ist und Laufzeitparameter.
Um eine Runtime Configuration zu erstellen, öffnet man jene Klasse, die den Einstiegspunkt
enthält - in unserem Beispiel ist das at.ac.tuwien.ifs.qse.se1.basis.Basis.
Nun klappt man neben Symbol mit dem grünen Pfeil das Kontextmenü auf und wählt "Run
As" -> "Java Application".
Projekt starten
Nun startet die Applikation mit den Standardeinstellungen. Diese Runtime Configuration
wird auch gespeichert und steht ab jetzt zur Verfügung.
1.5. JUnit Tests starten
Das Beispielprojekt enthält TestCases (Testfälle), mit denen Funktionalität automatisch
getestet werden kann. Eclipse hat ein Plug-In für JUnit, mit dem sich diese Tests bequem
starten lassen.
• Dazu öffnet man die Klasse at.ac.tuwien.ifs.qse.se1.basis.test.AllTests, die alle TestCase
Klassen referenziert.
• Mit "Run As" -> JUnit Testcase können die Tests gestartet werden
JUnit Testcases starten
Eclipse
blendet
nun
das
JUnit
Panel
ein, dass den Fortlauf und die Ergebnisse der Tests
•
darstellt.
JUnit Panel
• Der zuletzt durchgeführte Test kann mit einem Klick auf das Icon mit dem grünen Pfeil
im JUnit Panel erneut gestartet werden.
1.6. Ant Script einrichten und starten
Eclipse bietet ein Plug-In, mit dem Ant Scripts direkt aus Eclipse heraus gestartet werden
können. Das Beispielprojekt hat bereits ein fertiges Ant Script, dass die Klassen kompiliert,
die Testfälle durchführt, die JavaDoc erzeugt und auch den DBManager (eine kleine
Applikation zum Betrachten und Bearbeiten der hsql Datenbank) starten kann.
Page 3
Copyright © 2006 Institut fuer Softwaretechnik und interaktive Systeme All rights reserved.
Eingangsbeispiel - Installation
•
•
•
Per Default ist der Ant View nicht eingeblendet. Über "Windows" -> "Show View" ->
"Ant" wird der View rechts eingeblendet.
Nun wählt man den Button "Add Buildfiles" und wählt die Datei "build.xml" an - oder
man zieht die Datei einfach vom Package Explorer in den Ant View.
Ant Script einrichten
Nun erscheint das Buildfile im Ant View. Mit "+" sieht man die einzelnen Targets des
Buildfiles. Ein Doppelklick auf ein Target führt dieses Target aus. Ein Doppelklick auf
den Namen des Buildfiles selbst startet das "Default Target". Im Beispielprogramm wird
damit das Projekt kompiliert und die JavaDoc erzeugt.
Page 4
Copyright © 2006 Institut fuer Softwaretechnik und interaktive Systeme All rights reserved.