JAR-Datei

Eine JAR-Datei (Java Archive), ist ein Archiv, welches auf dem ZIP-Format basiert. JAR-Dateien sind identisch zu ZIP-Dateien nur um einen Ordner META-INF erweitert.

JAR-Dateien werden verwendet, um die einzelnen Dateien eines Projekts zusammen zufassen. So sind in einem Archiv häufig neben Class-Dateien auch multimediale Inhalte zu finden (Bilder, Sound etc.).
Wenn die Manifestdatei mit einem Eintrag für eine Startklasse (Main-Class) versehen wurde, kann eine die JAR-Datei bei passender JRE per Mausklick gestartet werden.

META-INF

Der META-INF Ordner enthält immer eine Datei MANIFEST.MF, in dieser werden Informationen über das Archiv bzw. das Programm beschrieben. Zusätzlich können auch Dateien für die Signatur des Archivs vorhanden sein.

MANIFEST.MF

In der Manifest-Datei werden verschiedene Eigenschaften beschrieben. Die Eigenschaften werden durch einen Tupel von Schlüsselwort und Wert angegeben. Für verschiedene Bereiche der Verwendung, sind auch verschiedene Eigenschaften vorgesehen:

Bereich	Attribut	Beschreibung	Optional
Allgemein	Manifest-Version	Versionsnummer für die Manifest-Datei	Nein
	Created-By	Optionale Angabe des Erstellers	Ja
	Name	Angabe des Namens einer Datei, z.B. für eine Signatur oder Bean	Ja
	SHA1-Digest	SHA1 Signatur für die darüber angegebene Datei	Ja
	Signature-Version	Definiert die Version der Signatur	Ja
	Class-Path	Angabe von Klassen und JAR-Dateien, die zum Classpath hinzugefügt werden sollen, sie sollten immer mit ./ beginend angegeben werden	Ja
	Permissions	Seit Java 7 Update 51 ist die Permissions-Angabe anzugeben. Gültig sind sandbox (keine Rechteerweiterung benötigt) und all-permissions (z.B. für Schreib-/Leserechte). (Mehr dazu unter Permissions)	Nein (nur für Applets und WebStart)
	Application-Name	Hier muss der Name der Anwendung angegeben werden. (Mehr dazu unter Application-Name)	Nein (nur für Applets und WebStart)
	Codebase	Hier muss die Quell-Domain, also der Herkunftsort angegeben werden. (Mehr dazu unter Codebase)	Nein (nur für Applets und WebStart)
Anwendungen	Main-Class	Angabe der Mainclass, sie ist nötig wenn die JAR-Datei ausführbar sein soll	Ja (wenn es kein ausführbares Programm ist)
	SplashScreen-Image	Angabe eines Bildes, das als Splash-Screen angezeigt wird. Das Bild muss in der JAR vorhanden sein.	Ja
Applets	Extension-List
	*-Extension-Name
	*-Specification-Version
	*-Implementation-Version
	*-Implementation-Vendor-Id
	*-Implementation-URL
Extensions	Extension-Name
	Implementation-Title
	Implementation-Vendor
	Implementation-Vendor-Id
	Implementation-URL
	Specification-Title
	Specification-Version
	Specification-Vendor
	Sealed
J2EE	Java-Bean	Definiert eine Java Bean Klasse
	x-Digest-y
	Magic

Jede Manifest-Datei muss mit einer Leerzeile abgeschlossen werden.

Beispiel einer Manifest-Datei

Manifest-Version: 1.0
Created-By: Eagle Projekt Manager 1.1.0.0
Permissions: all-permissions
Codebase: *.eagleside.de
Application-Name: DatabaseDesigner
Main-Class: de.eagleside.databasedesigner.DatabaseDesignerMain
CLASS-PATH: ./lib/jdom.jar ./lib/EagleSwingLibrary.jar ./lib/EagleUtilLibrary.jar
[Leerzeile!]

Es ist üblich, Abhängigkeiten in einem Unterverzeichnis relativ zur Programm-Jar-Datei abzulegen. Laufwerksangaben sind systemabhängig, daher sollte darauf verzichtet werden.

JAR-Datei erstellen

Um eine JAR-Datei aus einem fertig kompilierten Projekt auf einer Kommandozeile zu erstellen, ist prinzipiell folgender Befehl anzuwenden:

jar cvfm  Filename.jar manifest.txt input-file(s)

Das input-file(s) ist eine Liste von einer oder mehreren Dateien, die die Jar-Datei enthalten soll. Mehrere Dateien werden mit einem Leerzeichen voneinander abgegrenzt. Mehrere Dateien gleichen Typs können mit einem Wildcard-Symbol (*) angegeben werden. Wenn ein zu speicherndes Element ein Verzeichnis ist, werden die Inhalte dieses Verzeichnisses rekursiv der Jar-Datei hinzugefügt.

Demnach ist folgender Befehl zu Erzeugen einer Jar-Datei gültig:

jar cvfm MeinJar.jar manifest.txt icons audio *.class Lizenz.txt

Der Jar-Datei wird ein Manifest hinzugefügt. Außerdem wird es Verzeichnisse mit Icons und Audiodateien (icons, audio) enthalten, in denen die Programm-Icons und einige Sound-Dateien abgelegt wurden. Schließlich noch alle Class-Dateien und eine Lizenz-Datei. Die meisten verfügbares IDEs haben bereits Funktionen an Bord, die das komfortabel per Mausklick erledigen können.

Quellen

• JAR File Specification
• Packaging Programs in JAR Files

Links

• Java-Blog-Buch: Jar - Klassen zusammenfassen und ausführen