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
All Methods Static Methods Instance Methods Concrete Methods 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 manifestboolean
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 theConstants.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 theConstants.BUNDLE_VERSION
manifest header.Jar.Compression
hasCompression()
boolean
hasDirectory(java.lang.String path)
boolean
isManifestFirst()
Answer if the manifest was the first entrylong
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)
-
-
-
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 classjava.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 outputout
- 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 jarfilter
- 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 jarfilter
- a pattern that should match the resoures in sub to be added
-
close
public void close()
- Specified by:
close
in interfacejava.lang.AutoCloseable
- Specified by:
close
in interfacejava.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 theConstants.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 toBSN
. - 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 theConstants.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 jarmime
- 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)
-
-