co.paralleluniverse.capsule

Class Jar

java.lang.Object

co.paralleluniverse.capsule.Jar

public class Jar
extends java.lang.Object

A JAR file that can be easily modified. This class is not thread-safe.

Constructor Summary

Constructors

Constructor and Description
Jar() Creates a new, empty, JAR
Jar(java.io.File jar) Reads in the JAR from the given File.
Jar(java.io.InputStream jar) Reads in the JAR from the given InputStream.
Jar(java.nio.file.Path jar) Reads in the JAR from the given Path.
Jar(java.lang.String jar) Reads in the JAR from the given path.

Method Summary

Methods

Modifier and Type	Method and Description
Jar	addClass(java.lang.Class<?> clazz) Adds a class entry to this JAR.
Jar	addEntries(java.nio.file.Path path, java.nio.file.Path dirOrZip) Adds a directory (with all its subdirectories) or the contents of a zip/JAR to this JAR.
Jar	addEntries(java.nio.file.Path path, java.util.zip.ZipInputStream zip) Adds the contents of the zip/JAR contained in the given byte array to this JAR.
Jar	addEntries(java.lang.String path, java.nio.file.Path dirOrZip) Adds a directory (with all its subdirectories) or the contents of a zip/JAR to this JAR.
Jar	addEntry(java.nio.file.Path path, java.io.InputStream is) Adds an entry to this JAR.
Jar	addEntry(java.nio.file.Path path, java.nio.file.Path file) Adds an entry to this JAR.
Jar	addEntry(java.nio.file.Path path, java.lang.String file) Adds an entry to this JAR.
Jar	addEntry(java.lang.String path, byte[] content) Adds an entry to this JAR.
Jar	addEntry(java.lang.String path, java.io.File file) Adds an entry to this JAR.
Jar	addEntry(java.lang.String path, java.io.InputStream is) Adds an entry to this JAR.
Jar	addEntry(java.lang.String path, java.lang.String file) Adds an entry to this JAR.
Jar	addPackageOf(java.lang.Class<?> clazz) Adds the contents of a Java package to this JAR.
java.lang.String	getAttribute(java.lang.String name) Returns an attribute's value from this JAR's manifest's main section.
java.lang.String	getAttribute(java.lang.String section, java.lang.String name) Returns an attribute's value from a non-main section of this JAR's manifest.
java.util.List<java.lang.String>	getListAttribute(java.lang.String name) Returns an attribute's list value from this JAR's manifest's main section.
java.util.List<java.lang.String>	getListAttribute(java.lang.String section, java.lang.String name) Returns an attribute's list value from a non-main section of this JAR's manifest.
java.util.jar.Manifest	getManifest() Returns the manifest of this JAR.
java.util.Map<java.lang.String,java.lang.String>	getMapAttribute(java.lang.String name, java.lang.String defaultValue) Returns an attribute's map value from this JAR's manifest's main section.
java.util.Map<java.lang.String,java.lang.String>	getMapAttribute(java.lang.String section, java.lang.String name, java.lang.String defaultValue) Returns an attribute's map value from a non-main section of this JAR's manifest.
Jar	setAttribute(java.lang.String name, java.lang.String value) Sets an attribute in the main section of the manifest.
Jar	setAttribute(java.lang.String section, java.lang.String name, java.lang.String value) Sets an attribute in a non-main section of the manifest.
Jar	setJarPrefix(java.nio.file.Path file) Sets a file whose contents will be prepended to the JAR file's data.
Jar	setJarPrefix(java.lang.String value) Sets a string that will be prepended to the JAR file's data.
Jar	setListAttribute(java.lang.String name, java.util.List<java.lang.String> values) Sets an attribute in the main section of the manifest to a list.
Jar	setListAttribute(java.lang.String section, java.lang.String name, java.util.List<java.lang.String> values) Sets an attribute in a non-main section of the manifest to a list.
Jar	setMapAttribute(java.lang.String name, java.util.Map<java.lang.String,java.lang.String> values) Sets an attribute in the main section of the manifest to a map.
Jar	setMapAttribute(java.lang.String section, java.lang.String name, java.util.Map<java.lang.String,java.lang.String> values) Sets an attribute in a non-main section of the manifest to a map.
Jar	setPacker(java.util.jar.Pack200.Packer packer) Sets a Pack200 packer to use when writing the JAR.
Jar	setReallyExecutable(boolean value) If set to true true, a header will be added to the JAR file when written, that will make the JAR an executable file in POSIX environments.
byte[]	toByteArray() Returns this JAR file as an array of bytes.
static java.io.InputStream	toInputStream(java.lang.String str, java.nio.charset.Charset charset) Turns a String into an InputStream containing the string's encoded characters.
java.io.File	write(java.io.File file) Writes this JAR to a file.
java.nio.file.Path	write(java.nio.file.Path path) Writes this JAR to a file.
void	write(java.lang.String file) Writes this JAR to a file.
<T extends java.io.OutputStream> T	write(T os) Writes this JAR to an output stream, and closes the stream.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

Jar

public Jar()

Creates a new, empty, JAR

Jar

public Jar(java.io.InputStream jar)
    throws java.io.IOException

Reads in the JAR from the given InputStream. Modifications will not be made to the original JAR file, but to a new copy, which is then written with write().

Throws:

java.io.IOException

Jar

public Jar(java.nio.file.Path jar)
    throws java.io.IOException

Reads in the JAR from the given Path. Modifications will not be made to the original JAR file, but to a new copy, which is then written with write().

Throws:

java.io.IOException

Jar

public Jar(java.io.File jar)
    throws java.io.IOException

Reads in the JAR from the given File. Modifications will not be made to the original JAR file, but to a new copy, which is then written with write().

Throws:

java.io.IOException

Jar

public Jar(java.lang.String jar)
    throws java.io.IOException

Reads in the JAR from the given path. Modifications will not be made to the original JAR file, but to a new copy, which is then written with write().

Throws:

java.io.IOException

Method Detail

getManifest

public java.util.jar.Manifest getManifest()

Returns the manifest of this JAR. Modifications to the manifest will be reflected in the written JAR, provided they are done before any entries are added with addEntry().

setAttribute

public final Jar setAttribute(java.lang.String name,
               java.lang.String value)

Sets an attribute in the main section of the manifest.

Parameters:

name - the attribute's name

value - the attribute's value

Returns:

this

Throws:

java.lang.IllegalStateException - if entries have been added or the JAR has been written prior to calling this methods.

setAttribute

public final Jar setAttribute(java.lang.String section,
               java.lang.String name,
               java.lang.String value)

Sets an attribute in a non-main section of the manifest.

Parameters:

section - the section's name

name - the attribute's name

value - the attribute's value

Returns:

this

Throws:

java.lang.IllegalStateException - if entries have been added or the JAR has been written prior to calling this methods.

setListAttribute

public Jar setListAttribute(java.lang.String name,
                   java.util.List<java.lang.String> values)

Sets an attribute in the main section of the manifest to a list. The list elements will be joined with a single whitespace character.

Parameters:

name - the attribute's name

values - the attribute's value

Returns:

this

Throws:

java.lang.IllegalStateException - if entries have been added or the JAR has been written prior to calling this methods.

setListAttribute

public Jar setListAttribute(java.lang.String section,
                   java.lang.String name,
                   java.util.List<java.lang.String> values)

Sets an attribute in a non-main section of the manifest to a list. The list elements will be joined with a single whitespace character.

Parameters:

section - the section's name

name - the attribute's name

values - the attribute's value

Returns:

this

Throws:

java.lang.IllegalStateException - if entries have been added or the JAR has been written prior to calling this methods.

setMapAttribute

public Jar setMapAttribute(java.lang.String name,
                  java.util.Map<java.lang.String,java.lang.String> values)

Sets an attribute in the main section of the manifest to a map. The map entries will be joined with a single whitespace character, and each key-value pair will be joined with a '='.

Parameters:

name - the attribute's name

values - the attribute's value

Returns:

this

Throws:

java.lang.IllegalStateException - if entries have been added or the JAR has been written prior to calling this methods.

setMapAttribute

public Jar setMapAttribute(java.lang.String section,
                  java.lang.String name,
                  java.util.Map<java.lang.String,java.lang.String> values)

Sets an attribute in a non-main section of the manifest to a map. The map entries will be joined with a single whitespace character, and each key-value pair will be joined with a '='.

Parameters:

section - the section's name

name - the attribute's name

values - the attribute's value

Returns:

this

Throws:

java.lang.IllegalStateException - if entries have been added or the JAR has been written prior to calling this methods.

getAttribute

public java.lang.String getAttribute(java.lang.String name)

Returns an attribute's value from this JAR's manifest's main section.

Parameters:

name - the attribute's name

getAttribute

public java.lang.String getAttribute(java.lang.String section,
                            java.lang.String name)

Returns an attribute's value from a non-main section of this JAR's manifest.

Parameters:

section - the manifest's section

name - the attribute's name

getListAttribute

public java.util.List<java.lang.String> getListAttribute(java.lang.String name)

Returns an attribute's list value from this JAR's manifest's main section. The attributes string value will be split on whitespace into the returned list. The returned list may be safely modified.

Parameters:

name - the attribute's name

getListAttribute

public java.util.List<java.lang.String> getListAttribute(java.lang.String section,
                                                java.lang.String name)

Returns an attribute's list value from a non-main section of this JAR's manifest. The attributes string value will be split on whitespace into the returned list. The returned list may be safely modified.

Parameters:

section - the manifest's section

name - the attribute's name

getMapAttribute

public java.util.Map<java.lang.String,java.lang.String> getMapAttribute(java.lang.String name,
                                                               java.lang.String defaultValue)

Returns an attribute's map value from this JAR's manifest's main section. The attributes string value will be split on whitespace into map entries, and each entry will be split on '=' to get the key-value pair. The returned map may be safely modified.

Parameters:

name - the attribute's name

getMapAttribute

public java.util.Map<java.lang.String,java.lang.String> getMapAttribute(java.lang.String section,
                                                               java.lang.String name,
                                                               java.lang.String defaultValue)

Returns an attribute's map value from a non-main section of this JAR's manifest. The attributes string value will be split on whitespace into map entries, and each entry will be split on '=' to get the key-value pair. The returned map may be safely modified.

Parameters:

section - the manifest's section

name - the attribute's name

addEntry

public Jar addEntry(java.lang.String path,
           java.io.InputStream is)
             throws java.io.IOException

Adds an entry to this JAR.

Parameters:

path - the entry's path within the JAR

is - the entry's content

Returns:

this

Throws:

java.io.IOException

addEntry

public Jar addEntry(java.lang.String path,
           byte[] content)
             throws java.io.IOException

Adds an entry to this JAR.

Parameters:

path - the entry's path within the JAR

content - the entry's content

Returns:

this

Throws:

java.io.IOException

addEntry

public Jar addEntry(java.nio.file.Path path,
           java.io.InputStream is)
             throws java.io.IOException

Adds an entry to this JAR.

Parameters:

path - the entry's path within the JAR

is - the entry's content

Returns:

this

Throws:

java.io.IOException

addEntry

public Jar addEntry(java.nio.file.Path path,
           java.nio.file.Path file)
             throws java.io.IOException

Adds an entry to this JAR.

Parameters:

path - the entry's path within the JAR

file - the file to add as an entry

Returns:

this

Throws:

java.io.IOException

addEntry

public Jar addEntry(java.nio.file.Path path,
           java.lang.String file)
             throws java.io.IOException

Adds an entry to this JAR.

Parameters:

path - the entry's path within the JAR

file - the path of the file to add as an entry

Returns:

this

Throws:

java.io.IOException

addEntry

public Jar addEntry(java.lang.String path,
           java.io.File file)
             throws java.io.IOException

Adds an entry to this JAR.

Parameters:

path - the entry's path within the JAR

file - the file to add as an entry

Returns:

this

Throws:

java.io.IOException

addEntry

public Jar addEntry(java.lang.String path,
           java.lang.String file)
             throws java.io.IOException

Adds an entry to this JAR.

Parameters:

path - the entry's path within the JAR

file - the path of the file to add as an entry

Returns:

this

Throws:

java.io.IOException

addClass

public Jar addClass(java.lang.Class<?> clazz)
             throws java.io.IOException

Adds a class entry to this JAR.

Parameters:

clazz - the class to add to the JAR.

Returns:

this

Throws:

java.io.IOException

addEntries

public Jar addEntries(java.nio.file.Path path,
             java.nio.file.Path dirOrZip)
               throws java.io.IOException

Adds a directory (with all its subdirectories) or the contents of a zip/JAR to this JAR.

Parameters:

path - the path within the JAR where the root of the directory will be placed, or null for the JAR's root

dirOrZip - the directory to add as an entry or a zip/JAR file whose contents will be extracted and added as entries

Returns:

this

Throws:

java.io.IOException

addEntries

public Jar addEntries(java.lang.String path,
             java.nio.file.Path dirOrZip)
               throws java.io.IOException

Adds a directory (with all its subdirectories) or the contents of a zip/JAR to this JAR.

Parameters:

path - the path within the JAR where the root of the directory/zip will be placed, or null for the JAR's root

dirOrZip - the directory to add as an entry or a zip/JAR file whose contents will be extracted and added as entries

Returns:

this

Throws:

java.io.IOException

addEntries

public Jar addEntries(java.nio.file.Path path,
             java.util.zip.ZipInputStream zip)
               throws java.io.IOException

Adds the contents of the zip/JAR contained in the given byte array to this JAR.

Parameters:

path - the path within the JAR where the root of the zip will be placed, or null for the JAR's root

zip - the contents of the zip/JAR file

Returns:

this

Throws:

java.io.IOException

addPackageOf

public Jar addPackageOf(java.lang.Class<?> clazz)
                 throws java.io.IOException

Adds the contents of a Java package to this JAR.

Parameters:

clazz - A class whose package we wish to add to the JAR.

Returns:

this

Throws:

java.io.IOException

setPacker

public Jar setPacker(java.util.jar.Pack200.Packer packer)

Sets a Pack200 packer to use when writing the JAR.

Parameters:

packer -

Returns:

this

setReallyExecutable

public Jar setReallyExecutable(boolean value)

If set to true true, a header will be added to the JAR file when written, that will make the JAR an executable file in POSIX environments.

Parameters:

value -

Returns:

this

setJarPrefix

public Jar setJarPrefix(java.lang.String value)

Sets a string that will be prepended to the JAR file's data.

Parameters:

value - the prefix, or null for none.

Returns:

this

setJarPrefix

public Jar setJarPrefix(java.nio.file.Path file)

Sets a file whose contents will be prepended to the JAR file's data.

Parameters:

file - the prefix file, or null for none.

Returns:

this

write

public <T extends java.io.OutputStream> T write(T os)
                                     throws java.io.IOException

Writes this JAR to an output stream, and closes the stream.

Throws:

java.io.IOException

write

public java.io.File write(java.io.File file)
                   throws java.io.IOException

Writes this JAR to a file.

Throws:

java.io.IOException

write

public java.nio.file.Path write(java.nio.file.Path path)
                         throws java.io.IOException

Writes this JAR to a file.

Throws:

java.io.IOException

write

public void write(java.lang.String file)
           throws java.io.IOException

Writes this JAR to a file.

Throws:

java.io.IOException

toByteArray

public byte[] toByteArray()

Returns this JAR file as an array of bytes.

toInputStream

public static java.io.InputStream toInputStream(java.lang.String str,
                                java.nio.charset.Charset charset)

Turns a String into an InputStream containing the string's encoded characters.

Parameters:

str - the string

charset - the Charset to use when encoding the string.

Returns:

an InputStream containing the string's encoded characters.