Eclipse

Einleitung

Eclipse ist ein Rahmenwerk zur Integration verschiedenster Anwendungen. Eine solche Anwendung ist z.B. die mitgelieferte Java Entwicklungsumgebung JDT (Java Development Toolkit). Diese Anwendungen werden in Form sogenannter Plugins zur Verfügung gestellt und von der Eclipse-Plattform automatisch erkannt und integriert. Plug-Ins werden mit der so genannten Plug-In Development Environment (PDE), die mit ausgeliefert wird, entwickelt. Eclipse bietet weiterhin Funktionalität zum Verwalten von Ressourcen (normalerweise Dateien) auf der Festplatte. Diese befinden sich im so genannten Workspace, einem speziellen Verzeichnis im Dateisystem. Verändert eine Anwendung eine solche Ressource aus Eclipse heraus, werden auch die anderen Anwendungen - über entsprechende Benachrichtigungsmechanismen - davon erfahren. Der Benutzer arbeitet dabei immer in der Workbench, dem grafisch sichtbaren Teil der Eclipse-Plattform. Man kann mehrere Workbench Fenster geöffnet haben. Das konkrete Aussehen der Workbench wird von den gerade ausgewählten Perspektiven bestimmt. Diese fassen jeweils eine Menge von sogenannte Views und Editoren zusammen und stellen spezielle Befehle für die Menü- und Werkzeugleisten zur Verfügung. The first text in the title bar of the Workbench window indicates which perspective is active.

<todo: Grafik einbinden>

The primary use of Views is to provide navigation of the information in the Workbench. Je nach View werden nur Teile oder auch innere Zusammenhänge zwischen den Ressourcen angezeigt. A perspective determines which views may be required and displays these on the Windows->Show View sub-menu.

Ein Editor dient zum Bearbeiten einer Ressource. Hierbei wird ein strikter Laden-Verändern-Speichern Lebenszyklus eingehalten. Erst wenn eine im Editor veränderte Ressource auch gespeichert wird, können alle oben erwähnten Benachrichtigungsmechanismen greifen. Spezielle Views können auch direkt mit einem Editor (und nicht mit der eigentlichen Ressource) gekoppelt werden. Zum Beispiel ist der Outline View der Java-Perspektive direkt an den Java-Quelltexteditor gekoppelt. Eine Besonderheit bei Eclipse - und teilweise Grund zur Frustration - ist nun die äußerste Flexibilität, mit der vorhandene Views und Editoren kombiniert werden können. Nicht nur die Anordnung in der Workbench ist frei wählbar. Man kann in eine geöffnete Perspektive jeden anderen View und jeden Editor hinzufügen - auch wenn diese in einem ganz anderen Plugin definiert wurden. Dies ermöglicht es dem Benutzer, eine auf ihn zugeschnittene Entwicklungsumgebung zusammenzustellen.

Eclipse can be configured (Window->Preferences->General->Workspace->Local History) to keep a local history.

Installation

on E.ON IS Laptop

Plug-In Installation

see http://www.venukb.com/2006/08/20/install-eclipse-plugins-the-easy-way/

Upgrade

Upgrade eclipse itself requires a complete new download. To upgrade plug-ins you can use Help -> Software Update -> Find and Install ...

Views

Project Explorer

• View Menu -> Link with Editor

Logging

Das Logfile liegt unter <eclipse-dir>/workspace/.metadata/.log.

Plug-Ins

Ant

Das Ant-Plug-In ist integraler Bestandteil von Eclipse. Ein Ant-Build fügt man an folgender Stelle in den Properties eines Projekts ein:

"Ant View"

und kann dort editiert werden. Der AntBuild kann entweder mit dem konfigurierten Target (s. 2. in Screeshot) oder aber mit einer manuellen Auswahl des Targets (s. 3. in Screenshot) erfolgen: CallAntFromEclipse.jpg

PDT

• s. Installation of PDT
• adjust php.ini for XDebug
• adjusted Window->Preferences->PHP->Debug and PHP Executables

JBoss Tools

Installation

• Add Site http://download.jboss.org/jbosstools/updates/stable, check checkbox and press install

Description

The JBoss Tools are somehow an extension of the Java EE WTP Tools. The JBoss Tools contain a set of tools for Hibernate among others tools for reverse engineering an existing database and code generation. The documentation is here. My description is here

JDT

The Jave Development Tools adds a Java project nature and Java perspective to the Eclipse Workbench as well as a number of views, editors, wizards, builders, and code merging and refactoring tools. The JDT project allows Eclipse to be a development environment for itself.

Subversive

• installation like http://javathreads.de/2008/07/subversion-unter-eclipse-ganymede-konfigurieren/

Subclipse

Installation

1. Help->Software Updates->Find and Install...
2. Search for new features to install
3. New Remote Site
4. http://subclipse.tigris.org/update_1.2.x
5. Restart

Using

If you add a file to your project, it's not automatically part of version control. Right-click the new file, then choose Team -> Add to Version Control. If you've added a file to the repository that's no longer relevant to your project, you can easily delete it. Right-click the file, then choose Delete. No need for the Team menu. To rename a file or directory under Subclipse's control, right-click it, then choose Rename. Type the item's new name in the entry field and click Enter. The file is renamed in the project, and the rename operation (an Add for the new name, and a Delete for the old one) is queued for your next commit. If your project generates files, or otherwise includes files that you don't want to check in to the Subversion repository, you can tell Subclipse to ignore them. Right-click the file or directory you want to exclude from version control, then choose Team > Add to svn:ignore to display the Add to svn:ignore dialog. To ignore an already added file from a repository delete it with the SVN Repository Perspective and then sign it as svn:ignore.

Bedienung

Create PHP Project from Filesystem

1. right click navigator->new project->PHP
2. insert the path of the root manually (otherwise crash)

Anzeigen der Plug-Ins

1. Help -> About -> Plug-In Details

Perspektiven öffnen

Window -> Open Perspective ...

Source Verzeichnis einrichten

1. Project Properties
2. Java Build Path
3. file card 'source'

Tastatur

CTRL + K	find selection next
CTRL + L	goto line
CTRL + <Space>	Code Completion or Java API Documentation
CTRL + SHIFT + B	Breakpoint einfügen
CTRL + SHIFT + K	find selection previous
F6	Step over

Getter/Setter generieren

1. right click in editor
2. Source->Generate Getter/Setter

Adding a jar file to the build path

You can now either add a JAR file which is contained in your workspace or which is somewhere else:

1. to add a JAR file which is inside your workspace click the Add JARs button
2. to add an external JAR file click the Add External JARs button

Debugging

Java Remote Debugging

For example uweheuer:

1. JBoss for Debug starten
2. set breakpoints
3. Run->Debug Configuration ...
4. Remote Java Application -> (uweheuer_laptop|uweheuer_home)
5. Button Debug

s. auch http://www.torsten-horn.de/techdocs/java-eclipse.htm#Remote-Debugging

Java Applet Debugging

There is a integrated applet viewer but setting breakpoints doesn't work, so it's better to use remote debugging. For example configuration 'uweheuer_applet_laptop'. Precondition is the configuration of the java runtime for applets:

• MS Windows: s. Windows Java Configuration
• Ubuntu: s. Ubuntu Java Configuration

PHP Debugging

s. http://www.eclipse.org/pdt/documents/XDebugGuideForPDT2.0.pdf

• set breapoints
• Run->Debug Configurations...-> e.g Local XT Sport Boeckmann -> Debug

Convert a project to a java project

• open .project
• add

<buildSpec>
  <buildCommand>
    <name>org.eclipse.jdt.core.javabuilder</name>
    <arguments>
    </arguments>
  </buildCommand>
</buildSpec>
<natures>
  <nature>org.eclipse.jdt.core.javanature</nature>
</natures>

Einschränkungen

Eine Aufteilung der Sourcen in unterschiedliche Verzeichnisse unabhängig von der Package Struktur ist nicht vorgesehen.

Sources

1. my own diagrams s. eclipse.vsd in file:///C:/Uwes/jspwiki/graphics/eclipse.vsd
2. Eclipse wiki http://wiki.eclipse.org/