JAR (file format): Difference between revisions
Anarchivist (talk | contribs) No edit summary |
|||
Line 44: | Line 44: | ||
users can enter a command similar to "<code>java -jar foo.jar</code>". |
users can enter a command similar to "<code>java -jar foo.jar</code>". |
||
[[Microsoft Windows]] users who prefer having Windows [[EXE]] files can use tools such as [[JSmooth]], [[Launch4J]], [[WinRun4J]] or [[Nullsoft Scriptable Install System]] to wrap JAR files into executables. |
[[Microsoft Windows]] users who prefer having Windows [[EXE]] files can use tools such as [[JSmooth]], [[Launch4J]], [[WinRun4J]] or [[Nullsoft Scriptable Install System]] to wrap JAR files into executables.. |
||
==Apache Ant Zip/JAR support== |
==Apache Ant Zip/JAR support== |
Revision as of 08:06, 12 August 2013
This article needs additional citations for verification. (June 2008) |
![]() | |
Filename extension |
.jar |
---|---|
Internet media type | |
Uniform Type Identifier (UTI) | com.sun.java-archive |
Developed by | Netscape, Sun Microsystems, Oracle Corporation |
Type of format | file archive, data compression |
Extended from | ZIP |
In software, JAR (Java ARchive) is an archive file format typically used to aggregate many Java class files and associated metadata and resources (text, images and so on) into one file to distribute application software or libraries on the Java platform.[3]
JAR files are built on the ZIP file format and have the .jar
file extension. Computer users can create or extract JAR files using the jar
command that comes with a JDK. They can also use zip
tools to do so; however, the order of entries in the zip file headers is important when compressing, as the manifest often needs to be first.
Inside jar, file names are unicode text.[4]
Design
A JAR file allows Java runtimes to efficiently deploy a set of classes and their associated resources. The elements in a JAR file can be compressed, which, together with the ability to download an entire application in a single request, makes downloading a JAR file much more convenient than separately downloading the many uncompressed files which would form a single Java Application. The package java.util.zip
contains classes that read and write JAR files.
A JAR file has an optional manifest file located in the path META-INF/MANIFEST.MF
. The entries in the manifest file determine how one can use the JAR file. For instance, a Classpath entry can be used to specify other JAR files for loading with the JAR. This entry consists of a list of absolute or relative paths to other JAR files. Although intended to simplify JAR use, in practice it turns out to be notoriously brittle, as it depends on all the relevant JARs being in the exact locations specified when the entry-point JAR was built. To change versions or locations of libraries, a new manifest is needed.
To extract the contents of a JAR file users can use any standard unzip software, or the jar
command which comes with every Java Virtual Machine: "jar -xf foo.jar
".
Developers can digitally 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.
Developers can obfuscate JAR files so that a user of the JAR file doesn't get much information regarding the code it contains, or to reduce its size, which is useful in mobile phone application development.
Executable JAR files
An executable Java program can be packaged in a JAR file, along with any libraries the program uses. Executable JAR files are distinguished by a 'extra field' on the first file with a hexadecimal field code of 0xCAFE.[5]
In addition, the manifest must specify the "main" class, with an entry such as Main-Class: myPrograms.MyClass
. On many operating systems, including Microsoft Windows, Solaris and most Linux distributions, these JAR files can be treated like any other executable file.[5] In any case,
users can enter a command similar to "java -jar foo.jar
".
Microsoft Windows users who prefer having Windows EXE files can use tools such as JSmooth, Launch4J, WinRun4J or Nullsoft Scriptable Install System to wrap JAR files into executables..
Apache Ant Zip/JAR support
The Apache Ant build tool has its own package to read and write Zip and JAR archives, including support for the Unix filesystem extensions. The org.apache.tools.zip package is released under the Apache Software Foundation license and is designed to be usable outside Ant.
Related formats
Several related file formats build on the JAR format:
- WAR (Web application archive) files, also Java archives, store XML files, Java classes, JavaServer Pages and other objects for Web Applications.
- RAR (resource adapter archive) files (not to be confused with the RAR file format), also Java archives, store XML files, Java classes and other objects for J2EE Connector Architecture (JCA) applications.
- EAR (enterprise archive) files provide composite Java archives which combine XML files, Java classes and other objects including JAR, WAR and RAR Java archive files for Enterprise Applications.
- SAR (service archive) is similar to EAR. It provides a service.xml file and accompanying JAR files.
- APK (Android Application Package), a variant of the Java archive format, is used for Android applications.[6]
See also
References
- ^ "File Extension .JAR Details". Retrieved 29 November 2012.
- ^ "MIME : Java Glossary". Retrieved 29 November 2012.
- ^ Java Archive (JAR) Files
- ^ http://download.java.net/jdk8/docs/technotes/guides/jar/jar.html#JAR_Index
- ^ a b "PSARC/1997/123 - javaexec" (Mailing list). Open Solaris website.
- ^ Android Developer's Guide