Package aQute.bnd.osgi

Class Jar

  • All Implemented Interfaces:
    java.io.Closeable, java.lang.AutoCloseable
    public class Jar
extends java.lang.Object
implements java.io.Closeable

    • Field Detail

      • EMPTY_ARRAY

        public static final java.lang.Object[] EMPTY_ARRAY

      • METAINF_SIGNING_P

        public static final java.util.regex.Pattern METAINF_SIGNING_P

    • 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.io.IOException
        Throws:
        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 name,
           java.io.InputStream in)
    throws java.io.IOException
        Throws:
        java.io.IOException

      • Jar

        public Jar​(java.lang.String string,
           java.io.File file)
    throws java.io.IOException
        Throws:
        java.io.IOException

    • Method Detail

      • fromResource

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

      • getResources

        public static java.util.stream.Stream<Resource> getResources​(Resource jarResource,
                                                             java.util.function.Predicate<java.lang.String> filter)
                                                      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)

      • getResourceNames

        public java.util.stream.Stream<java.lang.String> getResourceNames​(java.util.function.Predicate<java.lang.String> matches)

      • getResources

        public java.util.stream.Stream<Resource> getResources​(java.util.function.Predicate<java.lang.String> matches)

      • getDirectories

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

      • getDirectory

        public java.util.Map<java.lang.String,​Resource> getDirectory​(java.lang.String path)

      • 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

      • getModuleName

        public java.lang.String getModuleName()
                               throws java.lang.Exception
        Throws:
        java.lang.Exception

      • getModuleVersion

        public java.lang.String getModuleVersion()
                                  throws java.lang.Exception
        Throws:
        java.lang.Exception

      • exists

        public boolean exists​(java.lang.String path)

      • isEmpty

        public boolean isEmpty()

      • 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

      • getManifestName

        public java.lang.String getManifestName()

      • 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 to)
           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.lang.Exception
        Throws:
        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)

      • hasDirectory

        public boolean hasDirectory​(java.lang.String path)

      • getPackages

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

      • getSource

        public java.io.File getSource()

      • setSource

        public void setSource​(java.io.File source)

      • 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

      • isReproducible

        public boolean isReproducible()

      • setReproducible

        public void setReproducible​(java.lang.String outputTimestamp)

      • setReproducible

        @Deprecated
public void setReproducible​(boolean reproducible)
        Deprecated.
        Replaced by setReproducible(String).

      • copy

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

      • setCompression

        public void setCompression​(Jar.Compression compression)

      • 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)

      • removeSubDirs

        public void removeSubDirs​(java.lang.String dir)

      • getPomXmlResources

        public java.util.stream.Stream<Resource> getPomXmlResources()

      • setCalculateFileDigest

        public Jar setCalculateFileDigest​(boolean onOrOff)
        Make this jar calculate the SHA256 when it is saved as a file. When this JAR is written, the digest is always cleared. If this flag is on, it will be calculated and set when the file is successfully saved.
        Parameters:
        onOrOff - state of calculating the digest when writing this jar. true is on, otherwise off

      • getSHA256

        public java.util.Optional<byte[]> getSHA256()
        Get the SHA256 digest of the last write operation when setCalculateFileDigest(boolean) was on.
        Returns:
        the SHA 256 digest or empty

      • getLength

        public int getLength()
        Get the length of the last written file or -1 if unavailable. The length is only calculated when the checksum calculation was on during the write.
        Returns:
        the length of the last written file or -1 if unavailable.