= Arbeitsumgebung =
[[PageOutline(1-100)]]

Ab dem ersten Praktikum im ersten Semester benötigen Sie eine auf [[http://www.oracle.com/technetwork/java/javase/overview/index.html|Java]] und [[http://www.eclipse.org|Eclipse]] basierende Arbeitsumgebung. Diese ist in den Computerpools zwar installiert, es empfiehlt sich jedoch '''dringend''', sie auf Ihrem privaten Computer ebenfalls einzurichten. Im Optimalfall verfügen Sie über ein Laptop, welches Sie stets in der Hochschule dabei haben. Auf diesem sollten Sie die Arbeitsumgebung einrichten.

== Einrichtung Java ==
Falls nötig (Java Programme in Eclipse laufen nicht und Eclipse meldet, dass keine Laufzeitumgebung (JRE) existiert): Laden Sie das Java Development Kit (JDK) der Java Standard Edition (Java SE) von

[[http://www.oracle.com/technetwork/java/javase/downloads/index.html]]

== Eclipse ==
Installieren Sie die Version '''Eclipse IDE for Java Developers''' von

[[http://www.eclipse.org/downloads/packages/]]

{{{
#!html
<iframe width="560" height="315" src="https://www.youtube.com/embed/6J9nkFDs464" frameborder="0" allow="autoplay; encrypted-media" allowfullscreen></iframe>
}}}

=== Erste Einrichtung ===

{{{
#!html
<iframe width="560" height="315" src="https://www.youtube.com/embed/VWsIyUEqDfc" frameborder="0" allow="autoplay; encrypted-media" allowfullscreen></iframe>
}}}

==== Workspace festlegen ====
Beim ersten Start von Eclipse (und evtl. auch bei weiteren Starts) werden Sie nach dem Ort des Workspace gefragt. Im Workspace liegen alle administrativen Daten Ihrer Projekte und - falls Sie die Standardeinstellungen beibehalten - auch Ihre Projekte selbst. Legen Sie für den Workspace ein neues Verzeichnis an einem Ort im Dateisystem an, den sie leicht wiederfinden. Eclipse schlägt meist vor, dass ein neuer Workspace mit dem Namen "workspace" in Ihrem Benutzerverzeichnis angelegt wird. Das ist üblicherweise eine gute Wahl.

==== Zeichenkodierung ====
Achten Sie darauf, dass die Zeichenkodierung von Eclipse auf UTF-8 eingestellt ist:

 Einstellungen -> General -> Workspace -> Text file encoding -> Other -> UTF-8

Einstellungen öffnen:
* Mac: Command Komma oder Menü Eclipse > Einstellungen
* Windows: Menü Window > Preferences

==== Zeilennummern einblenden ====
1. Eclipse-Einstellungen öffnen (nicht die Projekteinstellungen)
* Mac: Command Komma
* Windows: Menü Window > Preferences
* Linux: Wenn Sie Linux verwenden finden Sie das auch selbst heraus
2. im linken Navigationsbereich General öffnen
1. im linken Navigationsbereich Editors öffnen
1. im linken Navigationsbereich auf Text Editors klicken
1. die Option "Show line numbers" aktivieren
1. OK

=== Projekte ===

==== Projekt neu anlegen ====

{{{
#!html
<iframe width="560" height="315" src="https://www.youtube.com/embed/2ONyyddA_aw" frameborder="0" allow="autoplay; encrypted-media" allowfullscreen></iframe>
}}}

Um in Eclipse Java-Dateien bearbeiten und ausführen zu können müssen diese einem Java-Projekt zugeordnet sein.

1. Menü File > New > Java Project
1. Im folgenden Dialog den Projektnamen eintragen
1. Finish klicken
1. Das Projekt liegt jetzt als neues Unterverzeichnis im Workspace

==== Projekt exportieren ====
Falls Sie Fragen zu Ihren Übungslösungen haben exportieren Sie Ihr Projekt bitte als Archiv und senden es per e-Mail ein:

Anleitung (PDF): [[attachment:HowTo_export_eclipse_project.pdf|Export HowTo]]

==== Projekt importieren ====
Falls Sie Ihre Lösungen von den Poolcomputern sichern wollen sollten Sie Ihr Projekt exportieren (s. o.) und dann zu Hause wieder importieren.

Anleitung (PDF): [[attachment:HowTo_import_eclipse_project.pdf|Import HowTo]]

==== JUnit in Projekt einbinden ====
Bevor Sie [[http://junit.org|JUnit]] mit Eclipse verwenden können, müssen Sie die JUnit-Library in das Projekt einbinden:

{{{
#!html
<iframe width="560" height="315" src="https://www.youtube.com/embed/nTtMI4KDJ8Y" frameborder="0" allow="autoplay; encrypted-media" allowfullscreen></iframe>
}}}

=== Nützliche Tips ===

==== Quellcode automatisch sauber formatieren ====
 Menü Source -> Format formatiert den Quelltext einmalig neu.

==== Eingebundene Subversion Quellen aktualisieren ====
Um den aktuellen Stand der Quellcodes aus der Vorlesung zu laden:

1. Rechtsklick auf den Projektordner
1. Team -> Update

=== Java Insel ===
[[http://openbook.rheinwerk-verlag.de/javainsel/01_007.html#u1.7|Eclipse im Speziellen]]

== Subversion (SVN) ==
Alle Beispielquellcodes und -programme werden per Subversion bereitgestellt. Subversion ist ein serverbasiertes Werkzeug zur Versionsverwaltung.

Sie können die Quellen direkt [[source:/Java_Quellcode_SOOP|hier auf dem Trac-System einsehen]].

Um die Dateien auf einem SVN-Server zu speichern und von dort abzurufen benötigt man einen SVN-Client. Für Eclipse existiert das [[http://subclipse.tigris.org/|Subclipse Plugin]]. Dieses stellt die benötigten Clientfunktionen zur Verfügung. Damit können Sie die Beispiele direkt vom Server in der jeweils aktuellsten Form abrufen. Die Installation des Plugins erfolgt über die in Eclipse eingebaute Installationsfunktion: Help > Eclipse Marketplace...

Video !HowTo der Installation des Plugins für Eclipse 4.4 (Luna):

{{{
#!html
<iframe width="560" height="315" src="https://www.youtube.com/embed/uG_HhGKHfYI" frameborder="0" allow="autoplay; encrypted-media" allowfullscreen></iframe>
}}}

Notwendige Informationen (müssen in Eclipse in die entsprechenden Eingabefelder kopiert werden - siehe !HowTo):

* URL des SVN-Projekts: https://softlab.hochschule-rhein-waal.de/svn/lvprogrammierung/code/trunk


Video !HowTo des Imports der Beispielquellcodes für Eclipse 4.4 (Luna).

{{{
#!html
<iframe width="560" height="315" src="https://www.youtube.com/embed/3Gx0XWyfB3g" frameborder="0" allow="autoplay; encrypted-media" allowfullscreen></iframe>
}}}