ZipEntry

java.lang.Object
- java.util.zip.ZipEntry
- - org.apache.tools.zip.ZipEntry

All Implemented Interfaces:

Cloneable
```
public class ZipEntry
extends java.util.zip.ZipEntry
implements Cloneable
```
Extension that adds better handling of extra fields and provides access to the internal and external file attributes.
The extra data is expected to follow the recommendation of APPNOTE.txt:
- the extra byte array consists of a sequence of extra fields
- each extra fields starts by a two byte header id followed by a two byte sequence holding the length of the remainder of data.
Any extra data that cannot be parsed by the rules above will be consumed as "unparseable" extra data and treated differently by the methods of this class. Older versions would have thrown an exception if any attempt was made to read or write extra data not conforming to the recommendation.

Field Summary

Fields
Modifier and Type	Field and 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`	`CRC_UNKNOWN`
`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`
`static int`	`PLATFORM_FAT`
`static int`	`PLATFORM_UNIX`

Fields inherited from class java.util.zip.ZipEntry
DEFLATED, STORED

Constructor Summary

Constructors
Modifier	Constructor and Description
`protected`	`ZipEntry()`
	`ZipEntry(File inputFile, String entryName)` Creates a new zip entry taking some information from the given file and using the provided name.
	`ZipEntry(String name)` Creates a new zip entry with the specified name.
	`ZipEntry(java.util.zip.ZipEntry entry)` Creates a new zip entry with fields taken from the specified zip entry.
	`ZipEntry(ZipEntry entry)` Creates a new zip entry with fields taken from the specified zip entry.

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`void`	`addAsFirstExtraField(ZipExtraField ze)` Adds an extra field - replacing an already present extra field of the same type.
`void`	`addExtraField(ZipExtraField ze)` Adds an extra field - replacing an already present extra field of the same type.
`Object`	`clone()` Overwrite clone.
`boolean`	`equals(Object obj)` Indicates whether some other object is "equal to" this one.
`byte[]`	`getCentralDirectoryExtra()` Retrieves the extra data for the central directory.
`long`	`getExternalAttributes()` Retrieves the external file attributes.
`ZipExtraField`	`getExtraField(ZipShort type)` Looks up an extra field by its header id.
`ZipExtraField[]`	`getExtraFields()` Retrieves all extra fields that have been parsed successfully.
`ZipExtraField[]`	`getExtraFields(boolean includeUnparseable)` Retrieves extra fields.
`GeneralPurposeBit`	`getGeneralPurposeBit()` The "general purpose bit" field.
`int`	`getInternalAttributes()` Retrieves the internal file attributes.
`Date`	`getLastModifiedDate()`
`byte[]`	`getLocalFileDataExtra()` Retrieves the extra data for the local file data.
`int`	`getMethod()` Returns the compression method of this entry, or -1 if the compression method has not been specified.
`String`	`getName()` Get the name of the entry.
`int`	`getPlatform()` Platform specification to put into the "version made by" part of the central file header.
`byte[]`	`getRawName()` Returns the raw bytes that made up the name before it has been converted using the configured or guessed encoding.
`long`	`getSize()` Gets the uncompressed size of the entry data.
`int`	`getUnixMode()` Unix permission.
`UnparseableExtraFieldData`	`getUnparseableExtraFieldData()` Looks up extra field data that couldn't be parsed correctly.
`int`	`hashCode()` Get the hashCode of the entry.
`boolean`	`isDirectory()` Is this entry a directory?
`void`	`removeExtraField(ZipShort type)` Remove an extra field.
`void`	`removeUnparseableExtraFieldData()` Removes unparseable extra field data.
`void`	`setCentralDirectoryExtra(byte[] b)` Sets the central directory part of extra fields.
`void`	`setExternalAttributes(long value)` Sets the external file attributes.
`protected void`	`setExtra()` Unfortunately `java.util.zip.ZipOutputStream` seems to access the extra data directly, so overriding getExtra doesn't help - we need to modify super's data directly.
`void`	`setExtra(byte[] extra)` Parses the given bytes as extra field data and consumes any unparseable data as an `UnparseableExtraFieldData` instance.
`void`	`setExtraFields(ZipExtraField[] fields)` Replaces all currently attached extra fields with the new array.
`void`	`setGeneralPurposeBit(GeneralPurposeBit b)` The "general purpose bit" field.
`void`	`setInternalAttributes(int value)` Sets the internal file attributes.
`void`	`setMethod(int method)` Sets the compression method of this entry.
`protected void`	`setName(String name)` Set the name of the entry.
`protected void`	`setName(String name, byte[] rawName)` Sets the name using the raw bytes and the string created from it by guessing or using the configured encoding.
`protected void`	`setPlatform(int platform)` Set the platform (UNIX or FAT).
`void`	`setSize(long size)` Sets the uncompressed size of the entry data.
`void`	`setUnixMode(int mode)` Sets Unix permissions in a way that is understood by Info-Zip's unzip command.

Methods inherited from class java.util.zip.ZipEntry
getComment, getCompressedSize, getCrc, getCreationTime, getExtra, getLastAccessTime, getLastModifiedTime, getTime, setComment, setCompressedSize, setCrc, setCreationTime, setLastAccessTime, setLastModifiedTime, setTime, toString

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

- Field Detail
  - CRC_UNKNOWN
```
public static final int CRC_UNKNOWN
```
    See Also:
    
    Constant Field Values
  - PLATFORM_FAT
```
public static final int PLATFORM_FAT
```
    See Also:
    
    Constant Field Values
  - PLATFORM_UNIX
```
public static final int PLATFORM_UNIX
```
    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
  - CENCOM
```
public static final int CENCOM
```
    See Also:
    
    Constant Field Values
  - CENCRC
```
public static final int CENCRC
```
    See Also:
    
    Constant Field Values
  - CENDSK
```
public static final int CENDSK
```
    See Also:
    
    Constant Field Values
  - CENEXT
```
public static final int CENEXT
```
    See Also:
    
    Constant Field Values
  - CENFLG
```
public static final int CENFLG
```
    See Also:
    
    Constant Field Values
  - CENHDR
```
public static final int CENHDR
```
    See Also:
    
    Constant Field Values
  - CENHOW
```
public static final int CENHOW
```
    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
  - CENOFF
```
public static final int CENOFF
```
    See Also:
    
    Constant Field Values
  - CENSIG
```
public static final long CENSIG
```
    See Also:
    
    Constant Field Values
  - CENSIZ
```
public static final int CENSIZ
```
    See Also:
    
    Constant Field Values
  - CENTIM
```
public static final int CENTIM
```
    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
  - ENDCOM
```
public static final int ENDCOM
```
    See Also:
    
    Constant Field Values
  - ENDHDR
```
public static final int ENDHDR
```
    See Also:
    
    Constant Field Values
  - ENDOFF
```
public static final int ENDOFF
```
    See Also:
    
    Constant Field Values
  - ENDSIG
```
public static final long ENDSIG
```
    See Also:
    
    Constant Field Values
  - ENDSIZ
```
public static final int ENDSIZ
```
    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
  - EXTCRC
```
public static final int EXTCRC
```
    See Also:
    
    Constant Field Values
  - EXTHDR
```
public static final int EXTHDR
```
    See Also:
    
    Constant Field Values
  - EXTLEN
```
public static final int EXTLEN
```
    See Also:
    
    Constant Field Values
  - EXTSIG
```
public static final long EXTSIG
```
    See Also:
    
    Constant Field Values
  - EXTSIZ
```
public static final int EXTSIZ
```
    See Also:
    
    Constant Field Values
  - LOCCRC
```
public static final int LOCCRC
```
    See Also:
    
    Constant Field Values
  - LOCEXT
```
public static final int LOCEXT
```
    See Also:
    
    Constant Field Values
  - LOCFLG
```
public static final int LOCFLG
```
    See Also:
    
    Constant Field Values
  - LOCHDR
```
public static final int LOCHDR
```
    See Also:
    
    Constant Field Values
  - LOCHOW
```
public static final int LOCHOW
```
    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
  - LOCSIG
```
public static final long LOCSIG
```
    See Also:
    
    Constant Field Values
  - LOCSIZ
```
public static final int LOCSIZ
```
    See Also:
    
    Constant Field Values
  - LOCTIM
```
public static final int LOCTIM
```
    See Also:
    
    Constant Field Values
  - LOCVER
```
public static final int LOCVER
```
    See Also:
    
    Constant Field Values
- Constructor Detail
  - ZipEntry
```
protected ZipEntry()
```
    Since:
    
    1.9
  - ZipEntry
```
public ZipEntry(File inputFile,
                String entryName)
```
    Creates a new zip entry taking some information from the given file and using the provided name.
    The name will be adjusted to end with a forward slash "/" if the file is a directory. If the file is not a directory a potential trailing forward slash will be stripped from the entry name.
  - ZipEntry
```
public ZipEntry(String name)
```
    Creates a new zip entry with the specified name.
    Assumes the entry represents a directory if and only if the name ends with a forward slash "/".
    
    Parameters:
    
    name - the name of the entry
    
    Since:
    
    1.1
  - ZipEntry
```
public ZipEntry(java.util.zip.ZipEntry entry)
         throws java.util.zip.ZipException
```
    Creates a new zip entry with fields taken from the specified zip entry.
    Assumes the entry represents a directory if and only if the name ends with a forward slash "/".
    
    Parameters:
    
    entry - the entry to get fields from
    
    Throws:
    
    java.util.zip.ZipException - on error
    
    Since:
    
    1.1
  - ZipEntry
```
public ZipEntry(ZipEntry entry)
         throws java.util.zip.ZipException
```
    Creates a new zip entry with fields taken from the specified zip entry.
    Assumes the entry represents a directory if and only if the name ends with a forward slash "/".
    
    Parameters:
    
    entry - the entry to get fields from
    
    Throws:
    
    java.util.zip.ZipException - on error
    
    Since:
    
    1.1
- Method Detail
  - addAsFirstExtraField
```
public void addAsFirstExtraField(ZipExtraField ze)
```
    Adds an extra field - replacing an already present extra field of the same type.
    The new extra field will be the first one.
    
    Parameters:
    
    ze - an extra field
    
    Since:
    
    1.1
  - addExtraField
```
public void addExtraField(ZipExtraField ze)
```
    Adds an extra field - replacing an already present extra field of the same type.
    If no extra field of the same type exists, the field will be added as last field.
    
    Parameters:
    
    ze - an extra field
    
    Since:
    
    1.1
  - clone
```
public Object clone()
```
    Overwrite clone.
    
    Overrides:
    
    clone in class java.util.zip.ZipEntry
    
    Returns:
    
    a cloned copy of this ZipEntry
    
    Since:
    
    1.1
    
    See Also:
    
    Cloneable
  - equals
```
public boolean equals(Object obj)
```
    Description copied from class: Object
    Indicates whether some other object is "equal to" this one.
    The equals method implements an equivalence relation on non-null object references:
    - It is reflexive: for any non-null reference value x, x.equals(x) should return true.
    - It is symmetric: for any non-null reference values x and y, x.equals(y) should return true if and only if y.equals(x) returns true.
    - It is transitive: for any non-null reference values x, y, and z, if x.equals(y) returns true and y.equals(z) returns true, then x.equals(z) should return true.
    - It is consistent: for any non-null reference values x and y, multiple invocations of x.equals(y) consistently return true or consistently return false, provided no information used in equals comparisons on the objects is modified.
    - For any non-null reference value x, x.equals(null) should return false.
    The equals method for class Object implements the most discriminating possible equivalence relation on objects; that is, for any non-null reference values x and y, this method returns true if and only if x and y refer to the same object (x == y has the value true).
    Note that it is generally necessary to override the hashCode method whenever this method is overridden, so as to maintain the general contract for the hashCode method, which states that equal objects must have equal hash codes.
    Overrides:
    
    equals in class Object
    
    Parameters:
    
    obj - the reference object with which to compare.
    
    Returns:
    
    true if this object is the same as the obj argument; false otherwise.
    
    See Also:
    
    Object.hashCode(), HashMap
  - getCentralDirectoryExtra
```
public byte[] getCentralDirectoryExtra()
```
    Retrieves the extra data for the central directory.
    
    Returns:
    
    the central directory extra data
    
    Since:
    
    1.1
  - getExternalAttributes
```
public long getExternalAttributes()
```
    Retrieves the external file attributes.
    
    Returns:
    
    the external file attributes
    
    Since:
    
    1.1
  - getExtraField
```
public ZipExtraField getExtraField(ZipShort type)
```
    Looks up an extra field by its header id.
    
    Returns:
    
    null if no such field exists.
  - getExtraFields
```
public ZipExtraField[] getExtraFields()
```
    Retrieves all extra fields that have been parsed successfully.
    
    Returns:
    
    an array of the extra fields
  - getExtraFields
```
public ZipExtraField[] getExtraFields(boolean includeUnparseable)
```
    Retrieves extra fields.
    
    Parameters:
    
    includeUnparseable - whether to also return unparseable extra fields as UnparseableExtraFieldData if such data exists.
    
    Returns:
    
    an array of the extra fields
    
    Since:
    
    1.1
  - getGeneralPurposeBit
```
public GeneralPurposeBit getGeneralPurposeBit()
```
    The "general purpose bit" field.
  - getInternalAttributes
```
public int getInternalAttributes()
```
    Retrieves the internal file attributes.
    
    Returns:
    
    the internal file attributes
    
    Since:
    
    1.1
  - getLastModifiedDate
```
public Date getLastModifiedDate()
```
  - getLocalFileDataExtra
```
public byte[] getLocalFileDataExtra()
```
    Retrieves the extra data for the local file data.
    
    Returns:
    
    the extra data for local file
    
    Since:
    
    1.1
  - getMethod
```
public int getMethod()
```
    Returns the compression method of this entry, or -1 if the compression method has not been specified.
    
    Overrides:
    
    getMethod in class java.util.zip.ZipEntry
    
    Returns:
    
    compression method
  - getName
```
public String getName()
```
    Get the name of the entry.
    
    Overrides:
    
    getName in class java.util.zip.ZipEntry
    
    Returns:
    
    the entry name
    
    Since:
    
    1.9
  - getPlatform
```
public int getPlatform()
```
    Platform specification to put into the "version made by" part of the central file header.
    
    Returns:
    
    PLATFORM_FAT unless setUnixMode has been called, in which case PLATFORM_UNIX will be returned.
    
    Since:
    
    Ant 1.5.2
  - getRawName
```
public byte[] getRawName()
```
    Returns the raw bytes that made up the name before it has been converted using the configured or guessed encoding.
    This method will return null if this instance has not been read from an archive.
  - getSize
```
public long getSize()
```
    Gets the uncompressed size of the entry data.
    
    Overrides:
    
    getSize in class java.util.zip.ZipEntry
    
    Returns:
    
    the entry size
  - getUnixMode
```
public int getUnixMode()
```
    Unix permission.
    
    Returns:
    
    the unix permissions
    
    Since:
    
    Ant 1.6
  - getUnparseableExtraFieldData
```
public UnparseableExtraFieldData getUnparseableExtraFieldData()
```
    Looks up extra field data that couldn't be parsed correctly.
    
    Returns:
    
    null if no such field exists.
  - hashCode
```
public int hashCode()
```
    Get the hashCode of the entry. This uses the name as the hashcode.
    
    Overrides:
    
    hashCode in class java.util.zip.ZipEntry
    
    Returns:
    
    a hashcode.
    
    Since:
    
    Ant 1.7
    
    See Also:
    
    Object.equals(java.lang.Object), System.identityHashCode(java.lang.Object)
  - isDirectory
```
public boolean isDirectory()
```
    Is this entry a directory?
    
    Overrides:
    
    isDirectory in class java.util.zip.ZipEntry
    
    Returns:
    
    true if the entry is a directory
    
    Since:
    
    1.10
  - removeExtraField
```
public void removeExtraField(ZipShort type)
```
    Remove an extra field.
    
    Parameters:
    
    type - the type of extra field to remove
    
    Since:
    
    1.1
  - removeUnparseableExtraFieldData
```
public void removeUnparseableExtraFieldData()
```
    Removes unparseable extra field data.
  - setCentralDirectoryExtra
```
public void setCentralDirectoryExtra(byte[] b)
```
    Sets the central directory part of extra fields.
  - setExternalAttributes
```
public void setExternalAttributes(long value)
```
    Sets the external file attributes.
    
    Parameters:
    
    value - an long value
    
    Since:
    
    1.1
  - setExtra
```
protected void setExtra()
```
    Unfortunately java.util.zip.ZipOutputStream seems to access the extra data directly, so overriding getExtra doesn't help - we need to modify super's data directly.
    
    Since:
    
    1.1
  - setExtra
```
public void setExtra(byte[] extra)
              throws RuntimeException
```
    Parses the given bytes as extra field data and consumes any unparseable data as an UnparseableExtraFieldData instance.
    
    Overrides:
    
    setExtra in class java.util.zip.ZipEntry
    
    Parameters:
    
    extra - an array of bytes to be parsed into extra fields
    
    Throws:
    
    RuntimeException - if the bytes cannot be parsed
    
    RuntimeException - on error
    
    Since:
    
    1.1
  - setExtraFields
```
public void setExtraFields(ZipExtraField[] fields)
```
    Replaces all currently attached extra fields with the new array.
    
    Parameters:
    
    fields - an array of extra fields
    
    Since:
    
    1.1
  - setGeneralPurposeBit
```
public void setGeneralPurposeBit(GeneralPurposeBit b)
```
    The "general purpose bit" field.
  - setInternalAttributes
```
public void setInternalAttributes(int value)
```
    Sets the internal file attributes.
    
    Parameters:
    
    value - an int value
    
    Since:
    
    1.1
  - setMethod
```
public void setMethod(int method)
```
    Sets the compression method of this entry.
    
    Overrides:
    
    setMethod in class java.util.zip.ZipEntry
    
    Parameters:
    
    method - compression method
  - setName
```
protected void setName(String name)
```
    Set the name of the entry.
    
    Parameters:
    
    name - the name to use
  - setName
```
protected void setName(String name,
                       byte[] rawName)
```
    Sets the name using the raw bytes and the string created from it by guessing or using the configured encoding.
    
    Parameters:
    
    name - the name to use created from the raw bytes using the guessed or configured encoding
    
    rawName - the bytes originally read as name from the archive
  - setPlatform
```
protected void setPlatform(int platform)
```
    Set the platform (UNIX or FAT).
    
    Parameters:
    
    platform - an int value - 0 is FAT, 3 is UNIX
    
    Since:
    
    1.9
  - setSize
```
public void setSize(long size)
```
    Sets the uncompressed size of the entry data.
    
    Overrides:
    
    setSize in class java.util.zip.ZipEntry
    
    Parameters:
    
    size - the uncompressed size in bytes
    
    Throws:
    
    IllegalArgumentException - if the specified size is less than 0
  - setUnixMode
```
public void setUnixMode(int mode)
```
    Sets Unix permissions in a way that is understood by Info-Zip's unzip command.
    
    Parameters:
    
    mode - an int value
    
    Since:
    
    Ant 1.5.2

Class ZipEntry

Field Summary

Fields inherited from class java.util.zip.ZipEntry

Constructor Summary

Method Summary

Methods inherited from class java.util.zip.ZipEntry

Methods inherited from class java.lang.Object

Field Detail

CRC_UNKNOWN

PLATFORM_FAT

PLATFORM_UNIX

CENATT

CENATX

CENCOM

CENCRC

CENDSK

CENEXT

CENFLG

CENHDR

CENHOW

CENLEN

CENNAM

CENOFF

CENSIG

CENSIZ

CENTIM

CENVEM

CENVER

ENDCOM

ENDHDR

ENDOFF

ENDSIG

ENDSIZ

ENDSUB

ENDTOT

EXTCRC

EXTHDR

EXTLEN

EXTSIG

EXTSIZ

LOCCRC

LOCEXT

LOCFLG

LOCHDR

LOCHOW

LOCLEN

LOCNAM

LOCSIG

LOCSIZ

LOCTIM

LOCVER

Constructor Detail

ZipEntry

ZipEntry

ZipEntry

ZipEntry

ZipEntry

Method Detail

addAsFirstExtraField

addExtraField

clone

equals

getCentralDirectoryExtra

getExternalAttributes

getExtraField

getExtraFields

getExtraFields

getGeneralPurposeBit

getInternalAttributes

getLastModifiedDate

getLocalFileDataExtra

getMethod

getName

getPlatform

getRawName

getSize

getUnixMode

getUnparseableExtraFieldData

hashCode

isDirectory