Start of Tutorial > Start of Trail > Start of Lesson |
Search
Feedback Form |
The Jar tool in version 1.2 of the JavaTM Development Kit provides a u option which you can use to update the contents of an existing JAR file by modifying its manifest or by adding files.The basic command for adding files has this format:
jar uf jar-file input-file(s)In this command:
- The u option indicates that you want to update an existing JAR file.
- The f option indicates that the JAR file to update is specified on the command line. If the f option is not present, the Jar tool will expect a JAR filename on stdin.
- jar-file is the existing JAR file that's to be updated.
- input-file(s) is a space-deliminated list of one or more files that you want to add to the Jar file.
Any files already in the archive having the same pathname as a file being added will be overwritten.
As when creating a new JAR file, you can optionally use the -C option to indicate a change of directory.
You can combine the u option with the m option to update an existing JAR file's manifest:
jar umf manifest jar-fileIn this command:
- The m option indicates that you want to update the JAR file's manifest.
- manifest is the manifest whose contents you want to merge into the manifest of the existing JAR file.
Recall that TicTacToe.jar has these contents:META-INF/MANIFEST.MF TicTacToe.class audio/ audio/beep.au audio/ding.au audio/return.au audio/yahoo1.au audio/yahoo2.au images/ images/cross.gif images/not.gifSuppose that you want to add the file images/new.gif to the JAR file. You could accomplish that by issuing this command from the parent directory of the images directory:
jar uf TicTacToe.jar images/new.gifThe revised JAR file would have this table of contents:
META-INF/MANIFEST.MF TicTacToe.class audio/ audio/beep.au audio/ding.au audio/return.au audio/yahoo1.au audio/yahoo2.au images/ images/cross.gif images/not.gif images/new.gifYou can use the -C option to "change directories" during execution of the command. For example:
This command would change to the images directory before adding new.gif to the JAR file. The images directory would not be included in the pathname of new.gif when it's added to the archive, resulting in a table of contents that looks like this:jar uf TicTacToe.jar -C images new.gifMETA-INF/MANIFEST.MF TicTacToe.class audio/ audio/beep.au audio/ding.au audio/return.au audio/yahoo1.au audio/yahoo2.au images/ images/cross.gif images/not.gif new.gifAs a final example, suppose you want to modify the default manifest of TicTacToe.jar by adding some version and vendor information. (Version and vendor information is contained in special headers that you can add to a JAR file's manifest. See the section on Understanding the Manifest for information about special headers.) You would first prepare a text file containing the headers that you wish to add to the default manifest. Your text file might consist of this information, for example:
Name: TicTacToe.class Implementation-Title: "TicTacToe demo" Implementation-Version: "build57" Implementation-Vendor: "Sun Microsystems, Inc."If the file containing this information was called versionInfo, you would add the information to the manifest in TicTacToe.jar by using this command:
After running this command, TicTacToe.jar's manifest would contain the information from your versionInfo file.jar umf versionInfo TicTacToe.jar
Start of Tutorial > Start of Trail > Start of Lesson |
Search
Feedback Form |