ZipEntry (Java 2 Platform SE v1.4.1_"07")

Overview | Package | Class | Use | Tree | Deprecated | Index | Help

JavaTM 2 Platform
Std. Ed. v1.4.1_"07"

PREV CLASS NEXT CLASS | FRAMES NO FRAMES
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD

## java.util.zip
Class ZipEntry

    java.lang.Object
      |
      +--java.util.zip.ZipEntry

All Implemented Interfaces:
  Cloneable, java.util.zip.ZipConstants

Direct Known Subclasses:
  JarEntry

public class ZipEntry
extends Object
implements java.util.zip.ZipConstants, Cloneable

This class is used to represent a ZIP file entry.

Field Summary
`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` | `DEFLATED` Compression method for compressed (deflated) entries.
`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` | `STORED` Compression method for uncompressed entries.

Constructor Summary
`ZipEntry(String name)` Creates a new zip entry with the specified name.
`ZipEntry(ZipEntry e)` Creates a new zip entry with fields taken from the specified zip entry.

Method Summary
`Object` | `clone()` Returns a copy of this entry.
`String` | `getComment()` Returns the comment string for the entry, or null if none.
`long` | `getCompressedSize()` Returns the size of the compressed entry data, or -1 if not known.
`long` | `getCrc()` Returns the CRC-32 checksum of the uncompressed entry data, or -1 if not known.
`byte[]` | `getExtra()` Returns the extra field data for the entry, or null if none.
`int` | `getMethod()` Returns the compression method of the entry, or -1 if not specified.
`String` | `getName()` Returns the name of the entry.
`long` | `getSize()` Returns the uncompressed size of the entry data, or -1 if not known.
`long` | `getTime()` Returns the modification time of the entry, or -1 if not specified.
`int` | `hashCode()` Returns the hash code value for this entry.
`boolean` | `isDirectory()` Returns true if this is a directory entry.
`void` | `setComment(String comment)` Sets the optional comment string for the entry.
`void` | `setCompressedSize(long csize)` Sets the size of the compressed entry data.
`void` | `setCrc(long crc)` Sets the CRC-32 checksum of the uncompressed entry data.
`void` | `setExtra(byte[] extra)` Sets the optional extra field data for the entry.
`void` | `setMethod(int method)` Sets the compression method for the entry.
`void` | `setSize(long size)` Sets the uncompressed size of the entry data.
`void` | `setTime(long time)` Sets the modification time of the entry.
`String` | `toString()` Returns a string representation of the ZIP entry.

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

Field Detail

### STORED

    public static final int STORED

  Compression method for uncompressed entries.

  See Also:
    Constant Field Values

### DEFLATED

    public static final int DEFLATED

  Compression method for compressed (deflated) entries.

  See Also:
    Constant Field Values

### 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

### ZipEntry

    public ZipEntry(String name)

  Creates a new zip entry with the specified name.

Parameters:
  `name` - the entry name
Throws:
  `NullPointerException` - if the entry name is null
  `IllegalArgumentException` - if the entry name is longer than 0xFFFF bytes

### ZipEntry

    public ZipEntry(ZipEntry e)

  Creates a new zip entry with fields taken from the specified zip entry.

Parameters:
  `e` - a zip Entry object

Method Detail

### getName

    public String getName()

  Returns the name of the entry.

  Returns:
    the name of the entry

### setTime

    public void setTime(long time)

  Sets the modification time of the entry.

  Parameters:
    `time` - the entry modification time in number of milliseconds since the epoch
  See Also:
    `getTime()`

### getTime

    public long getTime()

  Returns the modification time of the entry, or -1 if not specified.

  Returns:
    the modification time of the entry, or -1 if not specified
  See Also:
    `setTime(long)`

### setSize

    public void setSize(long size)

  Sets the uncompressed size of the entry data.

  Parameters:
    `size` - the uncompressed size in bytes
  Throws:
    `IllegalArgumentException` - if the specified size is less than 0 or greater than 0xFFFFFFFF bytes
  See Also:
    `getSize()`

### getSize

    public long getSize()

  Returns the uncompressed size of the entry data, or -1 if not known.

  Returns:
    the uncompressed size of the entry data, or -1 if not known
  See Also:
    `setSize(long)`

### getCompressedSize

    public long getCompressedSize()

  Returns the size of the compressed entry data, or -1 if not known. In the case of a stored entry, the compressed size will be the same as the uncompressed size of the entry.

  Returns:
    the size of the compressed entry data, or -1 if not known
  See Also:
    `setCompressedSize(long)`

### setCompressedSize

    public void setCompressedSize(long csize)

  Sets the size of the compressed entry data.

  Parameters:
    `csize` - the compressed size to set to
  See Also:
    `getCompressedSize()`

### setCrc

    public void setCrc(long crc)

  Sets the CRC-32 checksum of the uncompressed entry data.

  Parameters:
    `crc` - the CRC-32 value
  Throws:
    `IllegalArgumentException` - if the specified CRC-32 value is less than 0 or greater than 0xFFFFFFFF
  See Also:
    `setCrc(long)`

### getCrc

    public long getCrc()

  Returns the CRC-32 checksum of the uncompressed entry data, or -1 if not known.

  Returns:
    the CRC-32 checksum of the uncompressed entry data, or -1 if not known
  See Also:
    `getCrc()`

### setMethod

    public void setMethod(int method)

  Sets the compression method for the entry.

  Parameters:
    `method` - the compression method, either STORED or DEFLATED
  Throws:
    `IllegalArgumentException` - if the specified compression method is invalid
  See Also:
    `getMethod()`

### getMethod

    public int getMethod()

  Returns the compression method of the entry, or -1 if not specified.

  Returns:
    the compression method of the entry, or -1 if not specified
  See Also:
    `setMethod(int)`

### setExtra

    public void setExtra(byte[] extra)

  Sets the optional extra field data for the entry.

  Parameters:
    `extra` - the extra field data bytes
  Throws:
    `IllegalArgumentException` - if the length of the specified extra field data is greater than 0xFFFF bytes
  See Also:
    `getExtra()`

### getExtra

    public byte[] getExtra()

  Returns the extra field data for the entry, or null if none.

  Returns:
    the extra field data for the entry, or null if none
  See Also:
    `setExtra(byte[])`

### setComment

    public void setComment(String comment)

  Sets the optional comment string for the entry.

  Parameters:
    `comment` - the comment string
  Throws:
    `IllegalArgumentException` - if the length of the specified comment string is greater than 0xFFFF bytes
  See Also:
    `getComment()`

### getComment

    public String getComment()

  Returns the comment string for the entry, or null if none.

  Returns:
    the comment string for the entry, or null if none
  See Also:
    `setComment(String)`

### isDirectory

    public boolean isDirectory()

  Returns true if this is a directory entry. A directory entry is defined to be one whose name ends with a '/'.

  Returns:
    true if this is a directory entry

### toString

    public String toString()

  Returns a string representation of the ZIP entry.

  Overrides:
    `toString` in class `Object`
  Returns:
    a string representation of the object.

### hashCode

    public int hashCode()

  Returns the hash code value for this entry.

  Overrides:
    `hashCode` in class `Object`
  Returns:
    a hash code value for this object.
  See Also:
    `Object.equals(java.lang.Object)`, `Hashtable`

### clone

    public Object clone()

  Returns a copy of this entry.

  Overrides:
    `clone` in class `Object`
  Returns:
    a clone of this instance.
  See Also:
    `Cloneable`

Overview | Package | Class | Use | Tree | Deprecated | Index | Help

JavaTM 2 Platform
Std. Ed. v1.4.1_"07"

PREV CLASS NEXT CLASS | FRAMES NO FRAMES
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD

Submit a bug or feature
For further API reference and developer documentation, see Java 2 SDK SE Developer Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.

Copyright 2002 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms.