.jar file extension.
Design
A JAR file allows Java runtimes to efficiently deploy an entire application, including its classes and their associated resources, in a single request. JAR file elements may be compressed, shortening download times. A JAR file may contain a manifest file, that is located atMETA-INF/MANIFEST.MF. The entries in the manifest file describe how to use the JAR file. For instance, a Classpath entry can be used to specify other JAR files to load with the JAR.
Extraction
The contents of a file may be extracted using any archive extraction software that supports the ZIP format, or thejar command line utility provided by the Java Development Kit.
Security
Developers can attributed sign JAR files. In that case, the signature information becomes part of the embedded manifest file. The JAR itself is not signed, but instead every file inside the archive is listed along with its checksum; it is these checksums that are signed. Multiple entities may sign the JAR file, changing the JAR file itself with each signing, although the signed files themselves remain valid. When the Java runtime loads signed JAR files, it can validate the signatures and refuse to load classes that do not match the signature. It can also support 'sealed' packages, in which the Classloader will only permit Java classes to be loaded into the same package if they are all signed by the same entities. This prevents malicious code from being inserted into an existing package, and so gaining access to package-scoped classes and data. The content of JAR files may be obfuscated to makeExecutable JAR files
An executable Java program can be packaged in a JAR file, along with any libraries the program uses. Executable JAR files have the manifest specifying theMain-Class: myPrograms.MyClass and an explicit Class-Path (and the -cp argument is ignored). Some operating systems can run these directly when clicked. The typical invocation is java -jar foo.jar from a command line.
Native launchers can be created on most platforms. For instance, Microsoft Windows users who prefer having Windows EXE files can use tools such as JSmooth, Launch4J, WinRun4J or Nullsoft Scriptable Install System to wrap single JAR files into executables.
Manifest
A manifest file is aMANIFEST.MF. The manifest directory has to be the first entry of the compressed archive.
Specifications
The manifest appears at the canonical locationMETA-INF/MANIFEST.MF. There can be only one manifest file in an archive and it must be at that location.
The content of the manifest file in a JAR file created with version 1.0 of the Special-Purpose Manifest Headers
JAR files created only for the purpose of archiving do not use theMANIFEST.MF file.
Most uses of JAR files go beyond simple archiving and compression and require special information in the manifest file.
Features
The manifest allows developers to define several useful features for their jars. Properties are specified in key-value pairs.Applications
If an application is contained in a JAR file, thepublic static void main(String[] args) method. This information is provided in the manifest Main-Class header, which has the general form:
Main-Class: com.example.MyClassName
In this example com.example.MyClassName.main() executes at application launch.
Package Sealing
Optionally, a package within a JAR file can be sealed, which means that all classes defined in that package are archived in the same JAR file. A package might be sealed to ensure version consistency among the classes in the software or as a security measure. To seal a package, a Name entry needs to appear, followed by a Sealed header, such as:Sealed header occurs after the Name: myCompany/myPackage header with no intervening blank lines, the Sealed header applies (only) to the package myCompany/myPackage.
The feature of sealed packages is outmoded by the Java Platform Module System introduced in Java 9, in which modules cannot split packages.
Package Versioning
Several manifest headers hold versioning information. One set of headers can be assigned to each package. The versioning headers appear directly beneath the Name header for the package. This example shows all the versioning headers:Multi-Release
A jar can be optionally marked as a multi-release jar. Using the multi-release feature allows library developers to load different code depending on the version of the Java runtime. This in turn allows developers to leverage new features without sacrificing compatibility. A multi-release jar is enabled using the following declaration in the manifest:Dependencies
TheMANIFEST.MF file can be used to specify all the classes that must be loaded for an application to be able to run.
Note that Class-Path entries are delimited with spaces, not with the system path delimiter:
Apache Ant Zip/JAR support
The Apache Ant build tool has its own package to read and write Zip and JAR archives, including support forRelated formats
Several related file formats build on the JAR format: * WAR (Web application archive) files, also Java archives, storeservice.xml file and accompanying JAR files.
* APK (Android application package), a variant of the Java archive format, is used for Android applications.
* AAR (Android archive) is used for distribution of Android libraries, typically via Maven.
* PAR (plan archive) – supported by Eclipse Virgo OSGi application server, allows the deployment of multi-bundle OSGi applications as a single archive and provides isolation from other PAR-based applications deployed in the same server.
* KAR (Karaf archive) – supported by Apache Karaf OSGi application server, allows the deployment of multi-bundle, multi-feature OSGi applications.
See also
* JAR hell * Java Platform Module System * Open Packaging Conventions * JAD (file format) * GIFAR attack * .a static librariesReferences
External links