Package aQute.bnd.osgi

Class Jar

java.lang.Object

aQute.bnd.osgi.Jar

All Implemented Interfaces:

java.io.Closeable, java.lang.AutoCloseable

public class Jar
extends java.lang.Object
implements java.io.Closeable

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	Jar.Compression

Field Summary

Fields

Modifier and Type	Field	Description
static java.lang.Object[]	EMPTY_ARRAY

Constructor Summary

Constructors

Constructor	Description
Jar(java.io.File f)
Jar(java.lang.String name)
Jar(java.lang.String string, java.io.File file)
Jar(java.lang.String name, java.io.File dirOrFile, java.util.regex.Pattern doNotCopy)
Jar(java.lang.String string, java.io.InputStream resourceAsStream)
Jar(java.lang.String name, java.io.InputStream in, long lastModified)
Jar(java.lang.String name, java.lang.String path)

Method Summary

Modifier and Type	Method	Description
boolean	addAll(Jar src)
boolean	addAll(Jar sub, Instruction filter)	Add all the resources in the given jar that match the given filter.
boolean	addAll(Jar sub, Instruction filter, java.lang.String destination)	Add all the resources in the given jar that match the given filter.
boolean	addDirectory(java.util.Map<java.lang.String,Resource> directory, boolean overwrite)
void	calcChecksums(java.lang.String[] algorithms)	Calculate the checksums and set them in the manifest.
void	close()
void	copy(Jar srce, java.lang.String path, boolean overwrite)
void	doChecksums(java.io.OutputStream out)
void	ensureManifest()	Make sure we have a manifest
boolean	exists(java.lang.String path)
void	expand(java.io.File dir)	Expand the JAR file to a directory.
static Jar	fromResource(java.lang.String name, Resource resource)
java.lang.String	getBsn()	Get the jar bsn from the Constants.BUNDLE_SYMBOLICNAME manifest header.
java.net.URI	getDataURI(java.lang.String path, java.lang.String mime, int max)	Return a data uri from the JAR.
java.util.Map<java.lang.String,java.util.Map<java.lang.String,Resource>>	getDirectories()
java.util.jar.Manifest	getManifest()
java.lang.String	getName()
java.util.List<java.lang.String>	getPackages()
Resource	getResource(java.lang.String path)
java.util.Map<java.lang.String,Resource>	getResources()
java.io.File	getSource()
byte[]	getTimelessDigest()
java.lang.String	getVersion()	Get the jar version from the Constants.BUNDLE_VERSION manifest header.
Jar.Compression	hasCompression()
boolean	hasDirectory(java.lang.String path)
boolean	isManifestFirst()	Answer if the manifest was the first entry
long	lastModified()
static void	outputManifest(java.util.jar.Manifest manifest, java.io.OutputStream out)	Main function to output a manifest properly in UTF-8.
boolean	putResource(java.lang.String path, Resource resource)
boolean	putResource(java.lang.String path, Resource resource, boolean overwrite)
Resource	remove(java.lang.String path)
void	removePrefix(java.lang.String prefixLow)
boolean	rename(java.lang.String oldPath, java.lang.String newPath)
void	setCompression(Jar.Compression compression)
void	setDigestAlgorithms(java.lang.String[] algorithms)
void	setDoNotTouchManifest()	Make sure nobody touches the manifest! If the bundle is signed, we do not want anybody to touch the manifest after the digests have been calculated.
void	setManifest(java.io.File file)
void	setManifest(java.util.jar.Manifest manifest)
void	setManifestName(java.lang.String manifestName)
void	setName(java.lang.String name)
void	setReporter(aQute.service.reporter.Reporter reporter)
void	stripSignatures()
java.lang.String	toString()
void	updateModified(long time, java.lang.String reason)
void	write(java.io.File file)
void	write(java.io.OutputStream out)
void	write(java.lang.String file)
void	writeFolder(java.io.File dir)
void	writeManifest(java.io.OutputStream out)	Cleanup the manifest for writing.
static void	writeManifest(java.util.jar.Manifest manifest, java.io.OutputStream out)

Methods inherited from class java.lang.Object

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

Field Detail

EMPTY_ARRAY

public static final java.lang.Object[] EMPTY_ARRAY

Constructor Detail

Jar

public Jar(java.lang.String name)

Jar

public Jar(java.lang.String name,
           java.io.File dirOrFile,
           java.util.regex.Pattern doNotCopy)
    throws java.util.zip.ZipException,
           java.io.IOException

Throws:

java.util.zip.ZipException

java.io.IOException

Jar

public Jar(java.lang.String name,
           java.io.InputStream in,
           long lastModified)
    throws java.io.IOException

Throws:

java.io.IOException

Jar

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

Throws:

java.io.IOException

Jar

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

Throws:

java.io.IOException

Jar

public Jar(java.lang.String string,
           java.io.InputStream resourceAsStream)
    throws java.io.IOException

Throws:

java.io.IOException

Jar

public Jar(java.lang.String string,
           java.io.File file)
    throws java.util.zip.ZipException,
           java.io.IOException

Throws:

java.util.zip.ZipException

java.io.IOException

Method Detail

fromResource

public static Jar fromResource(java.lang.String name,
                               Resource resource)
                        throws java.lang.Exception

Throws:

java.lang.Exception

setName

public void setName(java.lang.String name)

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object

putResource

public boolean putResource(java.lang.String path,
                           Resource resource)

putResource

public boolean putResource(java.lang.String path,
                           Resource resource,
                           boolean overwrite)

getResource

public Resource getResource(java.lang.String path)

getDirectories

public java.util.Map<java.lang.String,java.util.Map<java.lang.String,Resource>> getDirectories()

getResources

public java.util.Map<java.lang.String,Resource> getResources()

addDirectory

public boolean addDirectory(java.util.Map<java.lang.String,Resource> directory,
                            boolean overwrite)

getManifest

public java.util.jar.Manifest getManifest()
                                   throws java.lang.Exception

Throws:

java.lang.Exception

exists

public boolean exists(java.lang.String path)

setManifest

public void setManifest(java.util.jar.Manifest manifest)

setManifest

public void setManifest(java.io.File file)
                 throws java.io.IOException

Throws:

java.io.IOException

setManifestName

public void setManifestName(java.lang.String manifestName)

write

public void write(java.io.File file)
           throws java.lang.Exception

Throws:

java.lang.Exception

write

public void write(java.lang.String file)
           throws java.lang.Exception

Throws:

java.lang.Exception

write

public void write(java.io.OutputStream out)
           throws java.lang.Exception

Throws:

java.lang.Exception

writeFolder

public void writeFolder(java.io.File dir)
                 throws java.lang.Exception

Throws:

java.lang.Exception

doChecksums

public void doChecksums(java.io.OutputStream out)
                 throws java.io.IOException,
                        java.lang.Exception

Throws:

java.io.IOException

java.lang.Exception

writeManifest

public void writeManifest(java.io.OutputStream out)
                   throws java.lang.Exception

Cleanup the manifest for writing. Cleaning up consists of adding a space after any \n to prevent the manifest to see this newline as a delimiter.

Parameters:

out - Output

Throws:

java.io.IOException

java.lang.Exception

writeManifest

public static void writeManifest(java.util.jar.Manifest manifest,
                                 java.io.OutputStream out)
                          throws java.io.IOException

Throws:

java.io.IOException

outputManifest

public static void outputManifest(java.util.jar.Manifest manifest,
                                  java.io.OutputStream out)
                           throws java.io.IOException

Main function to output a manifest properly in UTF-8.

Parameters:

manifest - The manifest to output

out - The output stream

Throws:

java.io.IOException - when something fails

getName

public java.lang.String getName()

addAll

public boolean addAll(Jar sub,
                      Instruction filter)

Add all the resources in the given jar that match the given filter.

Parameters:

sub - the jar

filter - a pattern that should match the resoures in sub to be added

addAll

public boolean addAll(Jar sub,
                      Instruction filter,
                      java.lang.String destination)

Add all the resources in the given jar that match the given filter.

Parameters:

sub - the jar

filter - a pattern that should match the resoures in sub to be added

close

public void close()

Specified by:

close in interface java.lang.AutoCloseable

Specified by:

close in interface java.io.Closeable

lastModified

public long lastModified()

updateModified

public void updateModified(long time,
                           java.lang.String reason)

setReporter

public void setReporter(aQute.service.reporter.Reporter reporter)

hasDirectory

public boolean hasDirectory(java.lang.String path)

getPackages

public java.util.List<java.lang.String> getPackages()

getSource

public java.io.File getSource()

addAll

public boolean addAll(Jar src)

rename

public boolean rename(java.lang.String oldPath,
                      java.lang.String newPath)

remove

public Resource remove(java.lang.String path)

setDoNotTouchManifest

public void setDoNotTouchManifest()

Make sure nobody touches the manifest! If the bundle is signed, we do not want anybody to touch the manifest after the digests have been calculated.

calcChecksums

public void calcChecksums(java.lang.String[] algorithms)
                   throws java.lang.Exception

Calculate the checksums and set them in the manifest.

Throws:

java.lang.Exception

getBsn

public java.lang.String getBsn()
                        throws java.lang.Exception

Get the jar bsn from the Constants.BUNDLE_SYMBOLICNAME manifest header.

Returns:

null when the jar has no manifest, when the manifest has no Constants.BUNDLE_SYMBOLICNAME header, or when the value of the header is not a valid bsn according to BSN.

Throws:

java.lang.Exception - when the jar is closed or when the manifest could not be retrieved.

getVersion

public java.lang.String getVersion()
                            throws java.lang.Exception

Get the jar version from the Constants.BUNDLE_VERSION manifest header.

Returns:

null when the jar has no manifest or when the manifest has no Constants.BUNDLE_VERSION header

Throws:

java.lang.Exception - when the jar is closed or when the manifest could not be retrieved.

expand

public void expand(java.io.File dir)
            throws java.lang.Exception

Expand the JAR file to a directory.

Parameters:

dir - the dst directory, is not required to exist

Throws:

java.lang.Exception - if anything does not work as expected.

ensureManifest

public void ensureManifest()
                    throws java.lang.Exception

Make sure we have a manifest

Throws:

java.lang.Exception

isManifestFirst

public boolean isManifestFirst()

Answer if the manifest was the first entry

copy

public void copy(Jar srce,
                 java.lang.String path,
                 boolean overwrite)

setCompression

public void setCompression(Jar.Compression compression)

hasCompression

public Jar.Compression hasCompression()

getDataURI

public java.net.URI getDataURI(java.lang.String path,
                               java.lang.String mime,
                               int max)
                        throws java.lang.Exception

Return a data uri from the JAR. The data must be less than 32k

Parameters:

path - the path in the jar

mime - the mime type

Returns:

a URI or null if conversion could not take place

Throws:

java.lang.Exception

setDigestAlgorithms

public void setDigestAlgorithms(java.lang.String[] algorithms)

getTimelessDigest

public byte[] getTimelessDigest()
                         throws java.lang.Exception

Throws:

java.lang.Exception

stripSignatures

public void stripSignatures()

removePrefix

public void removePrefix(java.lang.String prefixLow)