JarFile (snappy-loader 0.3 API)

java.lang.Object
- java.util.zip.ZipFile
- - java.util.jar.JarFile
  - - io.joshworks.snappy.loader.jar.JarFile

All Implemented Interfaces:

java.io.Closeable, java.lang.AutoCloseable, java.lang.Iterable<JarEntryData>
```
public class JarFile
extends java.util.jar.JarFile
implements java.lang.Iterable<JarEntryData>
```
Extended variant of JarFile that behaves in the same way but offers the following additional functionality.
- New filtered files can be created from existing files.
- A nested JarFile can be obtained based on any directory entry.
- A nested JarFile can be obtained for embedded JAR files (as long as their entry is not compressed).
- Entry data can be accessed as RandomAccessData.
Author:

Phillip Webb

Field Summary

Fields
Modifier and Type	Field	Description
`static int`	`CENATT`
`static int`	`CENATX`
`static int`	`CENCOM`
`static int`	`CENCRC`
`static int`	`CENDSK`
`static int`	`CENEXT`
`static int`	`CENFLG`
`static int`	`CENHDR`
`static int`	`CENHOW`
`static int`	`CENLEN`
`static int`	`CENNAM`
`static int`	`CENOFF`
`static long`	`CENSIG`
`static int`	`CENSIZ`
`static int`	`CENTIM`
`static int`	`CENVEM`
`static int`	`CENVER`
`static int`	`ENDCOM`
`static int`	`ENDHDR`
`static int`	`ENDOFF`
`static long`	`ENDSIG`
`static int`	`ENDSIZ`
`static int`	`ENDSUB`
`static int`	`ENDTOT`
`static int`	`EXTCRC`
`static int`	`EXTHDR`
`static int`	`EXTLEN`
`static long`	`EXTSIG`
`static int`	`EXTSIZ`
`static int`	`LOCCRC`
`static int`	`LOCEXT`
`static int`	`LOCFLG`
`static int`	`LOCHDR`
`static int`	`LOCHOW`
`static int`	`LOCLEN`
`static int`	`LOCNAM`
`static long`	`LOCSIG`
`static int`	`LOCSIZ`
`static int`	`LOCTIM`
`static int`	`LOCVER`

Fields inherited from class java.util.jar.JarFile
MANIFEST_NAME

Fields inherited from class java.util.zip.ZipFile
OPEN_DELETE, OPEN_READ

Constructor Summary

Constructors
Constructor Description

JarFile(java.io.File file)
Create a new JarFile backed by the specified file.

Constructors
Constructor	Description
`JarFile(java.io.File file)`	Create a new `JarFile` backed by the specified file.

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method	Description
`void`	`close()`
`java.util.Enumeration<java.util.jar.JarEntry>`	`entries()`
`java.util.zip.ZipEntry`	`getEntry(java.lang.String name)`
`JarFile`	`getFilteredJarFile(JarEntryFilter... filters)`	Return a new jar based on the filtered contents of this file.
`java.io.InputStream`	`getInputStream(java.util.zip.ZipEntry ze)`
`JarEntry`	`getJarEntry(java.lang.String name)`
`JarEntryData`	`getJarEntryData(AsciiBytes name)`
`JarEntryData`	`getJarEntryData(java.lang.String name)`
`java.util.jar.Manifest`	`getManifest()`
`java.lang.String`	`getName()`
`JarFile`	`getNestedJarFile(JarEntryData sourceEntry)`	Return a nested `JarFile` loaded from the specified entry.
`JarFile`	`getNestedJarFile(java.util.zip.ZipEntry entry)`	Return a nested `JarFile` loaded from the specified entry.
`protected RandomAccessDataFile`	`getRootJarFile()`
`java.net.URL`	`getUrl()`	Return a URL that can be used to access this JAR file.
`java.util.Iterator<JarEntryData>`	`iterator()`
`static void`	`registerUrlProtocolHandler()`	Register a 'java.protocol.handler.pkgs' property so that a `URLStreamHandler` will be located to deal with jar URLs.
`int`	`size()`
`java.lang.String`	`toString()`

Methods inherited from interface java.lang.Iterable
forEach, spliterator

Methods inherited from class java.util.jar.JarFile
baseVersion, getVersion, isMultiRelease, runtimeVersion, stream, versionedStream

Methods inherited from class java.lang.Object
clone, equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from class java.util.zip.ZipFile
finalize, getComment

- Field Detail
  - LOCSIG
```
public static final long LOCSIG
```
    See Also:
    
    Constant Field Values
  - EXTSIG
```
public static final long EXTSIG
```
    See Also:
    
    Constant Field Values
  - CENSIG
```
public static final long CENSIG
```
    See Also:
    
    Constant Field Values
  - ENDSIG
```
public static final long ENDSIG
```
    See Also:
    
    Constant Field Values
  - LOCHDR
```
public static final int LOCHDR
```
    See Also:
    
    Constant Field Values
  - EXTHDR
```
public static final int EXTHDR
```
    See Also:
    
    Constant Field Values
  - CENHDR
```
public static final int CENHDR
```
    See Also:
    
    Constant Field Values
  - ENDHDR
```
public static final int ENDHDR
```
    See Also:
    
    Constant Field Values
  - LOCVER
```
public static final int LOCVER
```
    See Also:
    
    Constant Field Values
  - LOCFLG
```
public static final int LOCFLG
```
    See Also:
    
    Constant Field Values
  - LOCHOW
```
public static final int LOCHOW
```
    See Also:
    
    Constant Field Values
  - LOCTIM
```
public static final int LOCTIM
```
    See Also:
    
    Constant Field Values
  - LOCCRC
```
public static final int LOCCRC
```
    See Also:
    
    Constant Field Values
  - LOCSIZ
```
public static final int LOCSIZ
```
    See Also:
    
    Constant Field Values
  - LOCLEN
```
public static final int LOCLEN
```
    See Also:
    
    Constant Field Values
  - LOCNAM
```
public static final int LOCNAM
```
    See Also:
    
    Constant Field Values
  - LOCEXT
```
public static final int LOCEXT
```
    See Also:
    
    Constant Field Values
  - EXTCRC
```
public static final int EXTCRC
```
    See Also:
    
    Constant Field Values
  - EXTSIZ
```
public static final int EXTSIZ
```
    See Also:
    
    Constant Field Values
  - EXTLEN
```
public static final int EXTLEN
```
    See Also:
    
    Constant Field Values
  - CENVEM
```
public static final int CENVEM
```
    See Also:
    
    Constant Field Values
  - CENVER
```
public static final int CENVER
```
    See Also:
    
    Constant Field Values
  - CENFLG
```
public static final int CENFLG
```
    See Also:
    
    Constant Field Values
  - CENHOW
```
public static final int CENHOW
```
    See Also:
    
    Constant Field Values
  - CENTIM
```
public static final int CENTIM
```
    See Also:
    
    Constant Field Values
  - CENCRC
```
public static final int CENCRC
```
    See Also:
    
    Constant Field Values
  - CENSIZ
```
public static final int CENSIZ
```
    See Also:
    
    Constant Field Values
  - CENLEN
```
public static final int CENLEN
```
    See Also:
    
    Constant Field Values
  - CENNAM
```
public static final int CENNAM
```
    See Also:
    
    Constant Field Values
  - CENEXT
```
public static final int CENEXT
```
    See Also:
    
    Constant Field Values
  - CENCOM
```
public static final int CENCOM
```
    See Also:
    
    Constant Field Values
  - CENDSK
```
public static final int CENDSK
```
    See Also:
    
    Constant Field Values
  - CENATT
```
public static final int CENATT
```
    See Also:
    
    Constant Field Values
  - CENATX
```
public static final int CENATX
```
    See Also:
    
    Constant Field Values
  - CENOFF
```
public static final int CENOFF
```
    See Also:
    
    Constant Field Values
  - ENDSUB
```
public static final int ENDSUB
```
    See Also:
    
    Constant Field Values
  - ENDTOT
```
public static final int ENDTOT
```
    See Also:
    
    Constant Field Values
  - ENDSIZ
```
public static final int ENDSIZ
```
    See Also:
    
    Constant Field Values
  - ENDOFF
```
public static final int ENDOFF
```
    See Also:
    
    Constant Field Values
  - ENDCOM
```
public static final int ENDCOM
```
    See Also:
    
    Constant Field Values
- Constructor Detail
  - JarFile
```
public JarFile(java.io.File file)
        throws java.io.IOException
```
    Create a new JarFile backed by the specified file.
    
    Parameters:
    
    file - the root jar file
    
    Throws:
    
    java.io.IOException - if the file cannot be read
- Method Detail
  - registerUrlProtocolHandler
```
public static void registerUrlProtocolHandler()
```
    Register a 'java.protocol.handler.pkgs' property so that a URLStreamHandler will be located to deal with jar URLs.
  - getRootJarFile
```
protected final RandomAccessDataFile getRootJarFile()
```
  - getManifest
```
public java.util.jar.Manifest getManifest()
                                   throws java.io.IOException
```
    Overrides:
    
    getManifest in class java.util.jar.JarFile
    
    Throws:
    
    java.io.IOException
  - entries
```
public java.util.Enumeration<java.util.jar.JarEntry> entries()
```
    Overrides:
    
    entries in class java.util.jar.JarFile
  - iterator
```
public java.util.Iterator<JarEntryData> iterator()
```
    Specified by:
    
    iterator in interface java.lang.Iterable<JarEntryData>
  - getJarEntry
```
public JarEntry getJarEntry(java.lang.String name)
```
    Overrides:
    
    getJarEntry in class java.util.jar.JarFile
  - getEntry
```
public java.util.zip.ZipEntry getEntry(java.lang.String name)
```
    Overrides:
    
    getEntry in class java.util.jar.JarFile
  - getJarEntryData
```
public JarEntryData getJarEntryData(java.lang.String name)
```
  - getJarEntryData
```
public JarEntryData getJarEntryData(AsciiBytes name)
```
  - getInputStream
```
public java.io.InputStream getInputStream(java.util.zip.ZipEntry ze)
                                   throws java.io.IOException
```
    Overrides:
    
    getInputStream in class java.util.jar.JarFile
    
    Throws:
    
    java.io.IOException
  - getNestedJarFile
```
public JarFile getNestedJarFile(java.util.zip.ZipEntry entry)
                         throws java.io.IOException
```
    Return a nested JarFile loaded from the specified entry.
    
    Parameters:
    
    entry - the zip entry
    
    Returns:
    
    a JarFile for the entry
    
    Throws:
    
    java.io.IOException - if the nested jar file cannot be read
  - getNestedJarFile
```
public JarFile getNestedJarFile(JarEntryData sourceEntry)
                         throws java.io.IOException
```
    Return a nested JarFile loaded from the specified entry.
    
    Parameters:
    
    sourceEntry - the zip entry
    
    Returns:
    
    a JarFile for the entry
    
    Throws:
    
    java.io.IOException - if the nested jar file cannot be read
  - getFilteredJarFile
```
public JarFile getFilteredJarFile(JarEntryFilter... filters)
                           throws java.io.IOException
```
    Return a new jar based on the filtered contents of this file.
    
    Parameters:
    
    filters - the set of jar entry filters to be applied
    
    Returns:
    
    a filtered JarFile
    
    Throws:
    
    java.io.IOException - if the jar file cannot be read
  - size
```
public int size()
```
    Overrides:
    
    size in class java.util.zip.ZipFile
  - close
```
public void close()
           throws java.io.IOException
```
    Specified by:
    
    close in interface java.lang.AutoCloseable
    
    Specified by:
    
    close in interface java.io.Closeable
    
    Overrides:
    
    close in class java.util.zip.ZipFile
    
    Throws:
    
    java.io.IOException
  - getUrl
```
public java.net.URL getUrl()
                    throws java.net.MalformedURLException
```
    Return a URL that can be used to access this JAR file. NOTE: the specified URL cannot be serialized and or cloned.
    
    Returns:
    
    the URL
    
    Throws:
    
    java.net.MalformedURLException - if the URL is malformed
  - toString
```
public java.lang.String toString()
```
    Overrides:
    
    toString in class java.lang.Object
  - getName
```
public java.lang.String getName()
```
    Overrides:
    
    getName in class java.util.zip.ZipFile

Class JarFile

Field Summary

Fields inherited from class java.util.jar.JarFile

Fields inherited from class java.util.zip.ZipFile

Constructor Summary

Method Summary

Methods inherited from interface java.lang.Iterable

Methods inherited from class java.util.jar.JarFile

Methods inherited from class java.lang.Object

Methods inherited from class java.util.zip.ZipFile

Field Detail

LOCSIG

EXTSIG

CENSIG

ENDSIG

LOCHDR

EXTHDR

CENHDR

ENDHDR

LOCVER

LOCFLG

LOCHOW

LOCTIM

LOCCRC

LOCSIZ

LOCLEN

LOCNAM

LOCEXT

EXTCRC

EXTSIZ

EXTLEN

CENVEM

CENVER

CENFLG

CENHOW

CENTIM

CENCRC

CENSIZ

CENLEN

CENNAM

CENEXT

CENCOM

CENDSK

CENATT

CENATX

CENOFF

ENDSUB

ENDTOT

ENDSIZ

ENDOFF

ENDCOM

Constructor Detail

JarFile

Method Detail

registerUrlProtocolHandler

getRootJarFile

getManifest

entries

iterator

getJarEntry

getEntry

getJarEntryData

getJarEntryData

getInputStream

getNestedJarFile

getNestedJarFile

getFilteredJarFile

size

close

getUrl

toString

getName