NetBeans externe Bibliotheken bekannt machen

Im Folgenden soll erklärt werden, wie NetBeans externe Bibliotheken bekannt gemacht werden, damit ihre Klassen in Projekte importiert und benutzt und beim Build-Prozess mit im dist-Verzeichnis des Projektes ausgegeben werden können. Der Ablauf untergliedert sich in zwei wesentliche Hauptschritte, die analog für jede zu verwendende Bibliothek durchgeführt werden müssen.

Einleitung

Es gibt zwei Varianten der Einbindung externer Bibliotheken:

1. Gleichzeitiges Einbinden von Bibliotheken in mehrere Projekte
2. Separates Einbinden von Bibliotheken (einzelne Projekte)

Der Unterschied zwischen beiden Varianten ist, dass man mit wenig Aufwand mehreren Projekten aktuelle Versionen externer Bibliotheken zuführen kann, oder die Versionen der externen Bibliotheken separat für einzelne Projekte setzt. Man kann so relativ einfach mehrere Projekte auf den neusten Stand hinsichtlich abhängiger Bibliotheken bringen, oder in jedem einzelnen Projekt eine bestimmte Version einer Bibliothek einsetzen.

In diesem Tutorial wird zunächst Variante 1 beschrieben.

Gleichzeitiges Einbinden von Bibliotheken in mehrere Projekte

Aufruf des Library Managers

Damit der Programmierer externe Bibliotheken in seine Programme einbinden kann, muss er die entsprechenden Bibliotheken zunächst über den Netbeans Library Manager anmelden.

Nach einem Klick auf Tools im Dateimenü wird ein Menü mit einem Menüpunkt Libraries sichtbar.

Der Library Manager

Nach Auswahl des Menüpunktes Libraries wird der Library Manager angezeigt.
Auf der linken Fensterseite werden bereits eingebundene Bibliotheken aufgelistet.

Zum Anmelden einer weiteren Bibliothek im Library Manager muss nun der Button New Library... geklickt werden.

Anlegen eines globalen Namens für die externe Bibliothek

Im sich öffnenden Dialog muss zunächst ein eindeutiger Name für eine Bibliothek vergeben werden. Unter diesem Namen können mehrere Bibliotheken gesammelt werden, die einem Zweck dienen. Für die Benutzung von Hibernate bspw. sind mehrere Bibliotheken notwendig, die unter dem Namen Hibernate-Libs angemeldet werden könnten.

Mit der Bestätigung dieses Dialoges wird der eingebenene Name für die anzumeldende Bibliothek übernommen.

ClassPath für Bibliotheken

Als nächtes wird der Classpath, also der Pfad, in dem der Compiler nach Klassen und Bibliotheken suchen soll, erweitert.

Mit Klick auf den Button Add JAR/Folder... wird der Dialog zur Auswahl der einzufügenden Bibliothek geöffnet.

Externe Bibliothek in Container einfügen

Vorgang abschließen

Bibliothek in den Classpath des Projektes aufnehmen

NetBeans "kennt" nun die externe Bibliothek und kann sie nun in Projekten importieren. Die Quelldatei der Bibliothek darf jetzt nicht mehr umbenannt, verändert oder verschoben werden, da sonst die Datei-Referenz zur Quelldatei in NetBeans unbrauchbar wird.
Wenn es nun ein Projekt gibt, welches eine externe Bibliothek verwenden soll, sind nun folgende Schritte zu durchlaufen.

Aufruf des Property-Fensters des Projektes

Mit einem Rechtsklick auf den Projektnamen im Reiter Projects wird ein Kontextmenü sichtbar.

In diesem Kontextmenü ist der Eintrag Properties auszuwählen, um das Fenster mit den Projekt-Eigenschaften anzuzeigen.

Das Projekt-Property-Fenster

Im Eigenschaftsfenster des aktuellen Projektes ist im linken Teil der Eintrag Libraries auszuwählen.

Danach werden im rechten Teil des Fensters die bereits im Projekt integrierten externen Bibliotheken angezeigt.

An dieser Stelle ist es aber auch möglich, weitere externe Bibliotheken ins Projekt zu holen. Dazu wird auf den Button "Add JAR/Folder" geklickt.

Zu integrierende Bibliothek auswählen

Nach einem Klick auf den Button Add Library am rechten Rand dieses Fensters der Projekt-Eigenschaften öffnet sich ein Dialog, in welchem die dem Projekt hinzuzufügende Bibliothek ausgewählt werden muss.

Nach Auswahl und Bestätigung des Buttons Add Library wird die ausgewählte Bibliothek dem Projekt hinzugefügt.

Operation abschließen

Wie hier zu sehen ist, wurde die ausgewählte MySQL-Bibliothek ins Projekt integriert und ist nun im Code ansprechbar.

Mit dem Klick auf den OK-Button wird die Operation abgeschlossen.
Mit der Ausgabe des Projektes werden auch die abhängigen Bibliotheken mit im /lib-Verzeichnis ausgegeben.