Installation

Probieren geht bekanntlich über studieren….

… aus diesem Grund befindet sich auf dieser Internetseite eine ausführbares Beispiel zur POC-UI-Methode. Diese Seite beschreibt, wie Sie das Beispiel herunterladen und in Ihre Entwicklungsumgebung einbinden können. Aufgrund der Fülle von verschiedenen Entwicklungsumgebungen können nicht alle detaillierte Anleitungen gegeben werden. Wir beschränken uns daher auf die verbreiteten OpenSource-IDEs Eclipse und Netbeans.

Vorraussetzungen

Da das verfügbare Beispiel ist in Java (>= 1.6) implementiert worden ist, benötigen Sie eine kompatible Java-Installation.

Anstelle einer proprietären Projektstruktur (z.B. Java-Projekte von Eclipse) werden die Konventionen des Werkzeugs Maven 2 verwendet. Über Maven werden zudem die Abhängigkeiten der Beispielprojekte untereinander verwaltet (als JARs). Sie sollten dieses Werkzeug daher installieren, um die Sourcen komfortabel kompilieren zu können.

Download

  1. Laden Sie die Sourcen der drei beteiligten Projekte als ZIP-Archive bei Sourceforge herunter. Sie erkennen die Source-ZIPs am Postfix “src” im Dateinamen.
  2. Legen Sie ein Projektverzeichnis an und entpacken Sie den Inhalt der drei Archive in dieses Verzeichnis. Sie erhalten nun die folgende Struktur:<PROJEKTVEREZEICHNIS>
    +–org.pocui.core
    | +–src
    | | +– [...]
    | +–pom.xml
    +–org.pocui.example
    | +–src
    | | +– [...]
    | +–pom.xml
    +–org.pocui.swing
    +–src
    | +– [...]
    +–pom.xml

Sie können sich die Sourcen natürlich auch ohne IDE anschauen. Erfahrungsgemäß ist es aber hilfreich die Sourcen in eine IDE einzubinden um dort die die Quellen zu navigieren.

Einbindung der Sourcen in Eclipse

“Out of the box” unterstützt Eclipse die Maven 2 - Projektstruktur nicht. Sie können Ihr Eclipse aber entsprechend aufrüsten. Alternativ enthält Maven 2 einen eingebauten Konvertor zur Erzeugung von Eclipse-Projekten.

Erzeugen von Eclipse-Projekten

  1. Öffnen Sie eine Kommando-Konsole und wechseln Sie in den Ordner “org.pocui.core” im Projektverzeichnis.
  2. Starten Sie den Konvertor mit dem Befehl “mvn eclipse:eclipse”.
  3. Wenn Maven “BUILD SUCCESSFUL” auf der Konsole ausgibt, hat alles geklappt. Falls Sie auf Probleme gestoßen sind, dann können Sie z.B. hier nach Abhilfe schauen.

Projektimport in den Eclipse Workspace

  1. Starten Sie Eclipse und öffnen Sie einen Workspace.
  2. Nachdem Eclipse geladen worden ist, öffnen Sie die Java-Perspektive (Window > Open Perspective > Java).
  3. Öffnen Sie das Kontextmenü des Package Explorers über einen Rechtsklick.
  4. Wählen Sie den Menüeintrag “Import …” aus.
  5. Selektieren Sie die Option “General > Existing Projects into Workspace” im aufklappenden Dialog und klicken Sie auf “Next”.
  6. Selektieren Sie den Radio-Button “Select root directory” und geben Sie den Pfad zu Ihrem <PROJEKTVERZEICHNIS> ein (siehe “Browse”).
  7. Selektieren Sie alle drei gefundenen Projekte und klicken Sie auf “Finish”.

Anbindung des lokalen Maven-Repositories

Maven lädt alle benötigten JARs in ein Verzeichnis auf Ihrer Festplatte (sog. lokales Repository). Dieses müssen Sie in Eclipse angeben, sodass die JARs zum Kompilieren verwendet werden können.

  1. Öffnen Sie das Projektkontextmenü eines der drei Projekte, z.B. “org.pocui.core” über einen Rechtsklick.
  2. Selektieren Sie den Eintrag “Properties”.
  3. Im folgenden Dialog öffnen Sie die Präferenzseite “Java Build Path” und klicken dort auf den Reiter “Libraries”.
  4. Klicken Sie auf “Add variables”, anschließend auf “Configure variables” und abschließend auf “New …”.
  5. Geben Sie als Namen der neuen Variablen “M2_REPO” ein. Der Pfad zum lokalen Maven-Repository lautet standardmäßig <USER_HOME_DIR>/.m2/repository. Bitte ersetzen Sie <USER_HOME_DIR> durch den Pfad zu Ihrem Heimatverzeichnis.
  6. Bestätigen Sie mit mehrfach mit “OK”. Den Eigenschaftendialog des Projektes können Sie über das X in der Fensterleiste bzw. den Cancel-Knopf schließen.

Herzlichen Glückwunsch. Sie können die POC-UI-Methode nun anhand eines konkreten und ausführbaren Beispiels nachvollziehen. Wir freuen uns auf Ihr Feedback.

Einbindung der Sourcen in Netbeans

NetBeans bringt von Haus aus eine gute Maven-Unterstützung mit. Dazu muss lediglich das Maven-PlugIn für Netbeans aktiviert sein. Sollte das PlugIn bei Ihnen deaktiviert sein, so finden Sie hier weiterführende Informationen.

Projektimport in NetBeans

  1. Starten Sie NetBeans.
  2. Erzeugen Sie ein neues Projekt (Kategorie “Maven”>”Maven Project with existing POM”).
  3. Klicken Sie auf “Next” und “Finish”.
  4. Im Auswahldialog für die POM-Datei wählen Sie die POM des Projektes aus, welches Sie importieren möchten.
  5. Bestätigen Sie mit “Ok”.