3.10 Eigene Pakete schnüren
 
Ein Java-Paket ist eine logische Gruppierung von Klassen. Klassen, die zu einem Paket gehören, befinden sich normalerweise1
im gleichen Verzeichnis. Der Name des Pakets ist dann gleich dem Namen des Verzeichnisses (und natürlich umgekehrt). Nehmen wir folgende Verzeichnisstruktur an:
suessigkeiten/
suessigkeiten/Schokolade.java
Hier ist der Paketname (und somit Verzeichnisname) suessigkeiten. Umlaute sollten vermieden werden, da sie auf dem Dateisystem immer wieder für Ärger sorgen.
3.10.1 Die package-Anweisung
 
Um die Klasse Schokolade in ein Paket suessigkeiten zu setzen, enthält der Quellcode als oberstes eine package-Anweisung. Die package-Anweisung muss die erste Anweisung sein, sonst gibt es einen Übersetzungsfehler. Da Kommentare keine Anweisungen sind, lassen sich selbstverständlich Kommentare vor die package-Anweisung setzen.
package suessigkeiten;
public class Schokolade
{
...
}
3.10.2 Importieren von Klassen mit import
 
Um Klassen außerhalb des eigenen Paketes nutzen zu können, müssen sie dem Compiler präzise beschrieben werden. Die erste Möglichkeit war die volle Qualifizierung.
suessigkeiten.Schokolade s = new suessigkeiten.Schokolade();
Eine alternative und praktischere Möglichkeit ist, den Compiler in einer Klassendefinition mit import auf die Klassen im Paket aufmerksam zu machen.
import suessigkeiten.Schokolade;
class Weihnachtsmann
{
Schokolade s; // sonst suessigkeiten.Schokolade
}
Damit nicht alle Klassen eines Pakets einzeln aufgeführt werden müssen, lässt sich mit dem Sternchen als einer Art Wildcard auf alle sichtbaren Klassen zugreifen.
import suessigkeiten.*;
Das macht alle Typen aus dem Paket suessigkeiten dem Compiler bekannt.
3.10.3 Paketnamen
 
Prinzipiell kann ein Paketname beliebig sein, doch Hierarchien bestehen in der Regel aus umgedrehten Domänennamen. Aus der Domäne zur Webseite http://javatutor.de wird also de.javatutor. Diese Namensgebung gewährleistet, dass Klassen auch weltweit eindeutig bleiben. Ein Paketname wird in aller Regel komplett kleingeschrieben.
Die Paketnamen java, javax und sun
Sun hat für sich selbst einige Paketnamen reserviert, die von eigenen Klassen nicht genutzt werden sollen. So liegt unser java.awt.Point in einem Sun-Paket, und das ist leicht durch den Teil java zu erkennen. Wenn jemand eigene Klassen in Pakete mit dem Präfix java setzen würde, etwa java.ui, schafft er damit Verwirrung, da nicht mehr nachvollziehbar ist, ob das Paket bei jeder Distribution dabei ist (wie das bei den Sun-Klassen der Fall ist).
3.10.4 Hierarchische Strukturen und das Default-Package
 
Pakete lassen sich in Hierarchien ordnen, so dass in einem Paket wieder ein anderes Paket liegen kann; das ist genauso wie bei der Verzeichnisstruktur des Dateisystems. Sun definiert das Paket java für einen Hauptzweig, aber auch javax. Unter dem Paket java liegen dann zum Beispiel awt, util und weitere. Es werden durch import java.* nicht automatisch alle Klassen der Unterpakete mit eingebunden. Die import-Anweisung bezieht sich nur auf ein Verzeichnis und schließt die Unterverzeichnisse nicht mit ein.
Unbekanntes Paket (Default package)
Falls eine Klasse ohne Paket-Definition implementiert wird, so befindet sie sich standardmäßig im umbenannten Paket (engl. unnamed package), oder Default-Paket. Es ist eine gute Idee, eigene Klassen immer in Paketen zu organisieren. Das erlaubt auch feinere Sichtbarkeiten.
 Hier klicken, um das Bild zu Vergrößern
Abbildung 3.6
Eclipse sieht für das unbekannte Paket ein »virtuelles« Verzeichnis vor. Es nennt sich »default package«.
3.10.5 Klassen mit gleichen Namen in unterschiedlichen Paketen
 
Ein Problem gibt es bei mehreren gleich benannten Klassen in unterschiedlichen Paketen. Hier ist eine volle Qualifizierung nötig. So gibt es im Paket java.awt und java.util eine Liste. Ein einfaches import java.awt.* und java.util.* hilft da nicht, weil der Compiler nicht weiß, ob die GUI-Komponente oder die Datenstruktur gemeint ist. Auch sagt ein import nichts darüber aus, ob die Klassen in der importierenden Datei jemals gebraucht werden. Das Gleiche gilt für die Klasse Date, die einmal in java.util und einmal in java.sql zu finden ist. Lustigerweise erweitert java.sql.Date die Klasse java.util.Date. Dass der Compiler hier nicht durcheinander kommt, ist ganz einfach dadurch zu erklären, dass er die Klassen nicht nur anhand ihres Namens unterscheidet, sondern vielmehr auch anhand ihrer Pakete. Der Compiler betrachtet intern immer eine volle Qualifizierung.
3.10.6 Statisches Import
 
Das import hat in Java die Bedeutung, den Compiler über die Pakete zu informieren, sodass eine Klasse nicht mehr voll qualifiziert werden muss, wenn sie im import-Teil explizit oder das Paket der Klasse genannt ist.
Falls eine Klasse statische Funktionen oder Konstanten vorschreibt, werden ihre Eigenschaften immer über den Klassennamen angesprochen. Es gibt nun mit dem statischen Import die Möglichkeit, die Klasseneigenschaften wie eigene Funktionen oder Variablen ohne Klassennamen sofort zu nutzen. Nehmen wir an, wir wollten das Maximum dreier Ganzzahlen a, b, c bestimmen. Wir würden das etwa so lösen können:
static int max( int a, int b, int c )
{
return Math.max( a, Math.max(b, c) );
}
Über das statische Import kann die Funktion max() aus Math »importiert« werden, sodass der Klassenname entfallen kann. (Dass es mehrere überladene Varianten von max() gibt, ist kein Problem.)
import _saito_fett_ static _saito_fettout_ java.lang.Math.max;
class StatischesImport
{
static int max( int a, int b, int c )
{
return max( a, max(b, c) );
}
}
Das statische Import bindet jetzt aber nur die max()-Funktion ein. Besteht Bedarf für die min()-Funktion, gibt es zwei Möglichkeiten: Zum einen lässt sich ein zweites statisches Import nachschieben oder gleich alles aus der Math-Klasse statisch importieren:
import static java.lang.Math.*;
Auch wenn Java seit Version 5 diese Möglichkeit bietet, sollte der Einsatz maßvoll erfolgen. Die Möglichkeit der statischen Importe wird dann nützlicher, wenn Klassen Konstanten nutzen wollen. Doch dazu später mehr.
Hinweis Eine Objektmethode aus der eigenen Klasse überdeckt statische importierte Methoden, was im Fall der toString()-Methode auffällt, die statisch aus der Utility-Klasse Arrays definiert wird. Der Compiler interpretiert toString() als Auruf einer Objektmethode. (Auch dann, wenn die aufrufende Methode selbst statisch ist.)
|
3.10.7 Eine Verzeichnisstruktur für eigene Projekte
 
Neben der Einteilung in Pakete für das eigene Programm ist es auch sinnvoll, die gesamte Applikation in verschiedenen Verzeichnissen aufzubauen. Im Allgemeinen finden sich drei wichtige Hauptverzeichnisse: src für die Quellen, lib für externe Bibliotheken, auf die das Programm aufbaut, und bin (oder build) für die erzeugen Klassen-Dateien. Das Verzeichnis src lässt sich noch weiter unterteilen, etwa für Quellen, die Testfälle implementieren, oder für Beispiele:
src/
core/
examples/
test/
lib/
bin/
Mehr zu diesem Thema unter http://java.sun.com/blueprints/code/projectconventions.html.
1 Ich schreibe »normalerweise«, da die Paketstruktur nicht zwingend auf Verzeichnisse abgebildet werden muss. Pakete könnten beispielsweise vom Klassenlader aus einer Datenbank gelesen werden. Im Folgenden wollen wir aber immer von Verzeichnissen ausgehen.
|