org.codehaus.plexus.archiver.zip

Class ZipEntry

public class ZipEntry extends ZipEntry implements Cloneable

Extension that adds better handling of extra fields and provides access to the internal and external file attributes.

Version: $Revision: 2436 $ $Date: 2005-09-01 13:20:41 -0400 (Thu, 01 Sep 2005) $ from org.apache.ant.tools.zip.ZipEntry v1.16

Field Summary
Long	compressedSize Helper for JDK 1.1 <-> 1.2 incompatibility.
long	externalAttributes
Vector	extraFields
int	internalAttributes
static Object	lockReflection Helper for JDK 1.1
String	name
int	platform
static int	PLATFORM_FAT
static int	PLATFORM_UNIX
static Method	setCompressedSizeMethod Helper for JDK 1.1
static boolean	triedToGetMethod Helper for JDK 1.1

Constructor Summary
	ZipEntry(String name) Creates a new zip entry with the specified name.
	ZipEntry(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.
protected	ZipEntry()

Method Summary
void	addExtraField(ZipExtraField ze) Adds an extra fields - replacing an already present extra field of the same type.
static void	checkSCS() Try to get a handle to the setCompressedSize method.
Object	clone() Overwrite clone
byte[]	getCentralDirectoryExtra() Retrieves the extra data for the central directory.
long	getCompressedSize() Override to make this class work in JDK 1.1 like a 1.2 class.
long	getExternalAttributes() Retrieves the external file attributes.
ZipExtraField[]	getExtraFields() Retrieves extra fields.
int	getInternalAttributes() Retrieves the internal file attributes.
byte[]	getLocalFileDataExtra() Retrieves the extra data for the local file data.
String	getName()
int	getPlatform() Platform specification to put into the "version made by" part of the central file header.
int	getUnixMode() Unix permission.
static boolean	haveSetCompressedSize() Are we running JDK 1.2 or higher?
boolean	isDirectory()
static void	performSetCompressedSize(ZipEntry ze, long size) Invoke setCompressedSize via reflection.
void	removeExtraField(ZipShort type) Remove an extra fields.
void	setComprSize(long size) Make this class work in JDK 1.1 like a 1.2 class.
void	setExternalAttributes(long value) Sets the external file attributes.
void	setExtra(byte[] extra) Throws an Exception if extra data cannot be parsed into extra fields.
protected void	setExtra() Unfortunately `java.util.zip.ZipOutputStream 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	setExtraFields(ZipExtraField[] fields) Replaces all currently attached extra fields with the new array.
void	setInternalAttributes(int value) Sets the internal file attributes.
protected void	setName(String name)
protected void	setPlatform(int platform)
void	setUnixMode(int mode) Sets Unix permissions in a way that is understood by Info-Zip's unzip command.

Field Detail

compressedSize

private Long compressedSize

Helper for JDK 1.1 <-> 1.2 incompatibility.

Since: 1.2

externalAttributes

private long externalAttributes

extraFields

private Vector extraFields

internalAttributes

private int internalAttributes

lockReflection

private static final Object lockReflection

Helper for JDK 1.1

Since: 1.2

name

private String name

platform

private int platform

PLATFORM_FAT

private static final int PLATFORM_FAT

PLATFORM_UNIX

private static final int PLATFORM_UNIX

setCompressedSizeMethod

private static Method setCompressedSizeMethod

Helper for JDK 1.1

Since: 1.2

triedToGetMethod

private static boolean triedToGetMethod

Helper for JDK 1.1

Since: 1.2

Constructor Detail

ZipEntry

public ZipEntry(String name)

Creates a new zip entry with the specified name.

Since: 1.1

ZipEntry

public ZipEntry(ZipEntry entry)

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

Since: 1.1

ZipEntry

public ZipEntry(ZipEntry entry)

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

Since: 1.1

ZipEntry

protected ZipEntry()

Since: 1.9

Method Detail

addExtraField

public void addExtraField(ZipExtraField ze)

Adds an extra fields - replacing an already present extra field of the same type.

Since: 1.1

checkSCS

private static void checkSCS()

Try to get a handle to the setCompressedSize method.

Since: 1.2

clone

public Object clone()

Overwrite clone

Since: 1.1

getCentralDirectoryExtra

public byte[] getCentralDirectoryExtra()

Retrieves the extra data for the central directory.

Since: 1.1

getCompressedSize

public long getCompressedSize()

Override to make this class work in JDK 1.1 like a 1.2 class.

Since: 1.2

getExternalAttributes

public long getExternalAttributes()

Retrieves the external file attributes.

Since: 1.1

getExtraFields

public ZipExtraField[] getExtraFields()

Retrieves extra fields.

Since: 1.1

getInternalAttributes

public int getInternalAttributes()

Retrieves the internal file attributes.

Since: 1.1

getLocalFileDataExtra

public byte[] getLocalFileDataExtra()

Retrieves the extra data for the local file data.

Since: 1.1

getName

public String getName()

Since: 1.9

getPlatform

public int getPlatform()

Platform specification to put into the "version made by" part of the central file header.

Returns: 0 (MS-DOS FAT) unless setUnixMode has been called, in which case 3 (Unix) will be returned.

Since: Ant 1.5.2

getUnixMode

public int getUnixMode()

Unix permission.

Since: Ant 1.6

haveSetCompressedSize

private static boolean haveSetCompressedSize()

Are we running JDK 1.2 or higher?

Since: 1.2

isDirectory

public boolean isDirectory()

Since: 1.10

performSetCompressedSize

private static void performSetCompressedSize(ZipEntry ze, long size)

Invoke setCompressedSize via reflection.

Since: 1.2

removeExtraField

public void removeExtraField(ZipShort type)

Remove an extra fields.

Since: 1.1

setComprSize

public void setComprSize(long size)

Make this class work in JDK 1.1 like a 1.2 class.

This either stores the size for later usage or invokes setCompressedSize via reflection.

Since: 1.2

setExternalAttributes

public void setExternalAttributes(long value)

Sets the external file attributes.

Since: 1.1

setExtra

public void setExtra(byte[] extra)

Throws an Exception if extra data cannot be parsed into extra fields.

Since: 1.1

setExtra

protected void setExtra()

Unfortunately

java.util.zip.ZipOutputStream
 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

setExtraFields

public void setExtraFields(ZipExtraField[] fields)

Replaces all currently attached extra fields with the new array.

Since: 1.1

setInternalAttributes

public void setInternalAttributes(int value)

Sets the internal file attributes.

Since: 1.1

setName

protected void setName(String name)

setPlatform

protected void setPlatform(int platform)

Since: 1.9

setUnixMode

public void setUnixMode(int mode)

Sets Unix permissions in a way that is understood by Info-Zip's unzip command.

Since: Ant 1.5.2