com.mucommander.file.impl.zip.provider
Class ZipLong

java.lang.Object
  com.mucommander.file.impl.zip.provider.ZipLong

All Implemented Interfaces:

java.lang.Cloneable

public final class ZipLong
extends java.lang.Object
implements java.lang.Cloneable

Utility class that represents a four byte integer with conversion rules for the big endian byte order of ZIP files.

--------------------------------------------------------------------------------------------------------------

This class is based off the org.apache.tools.zip package of the Apache Ant project. The Ant code has been modified under the terms of the Apache License which you can find in the bundled muCommander license file. It was forked at version 1.7.0 of Ant.

Author:

Apache Ant, Maxence Bernard

Constructor Summary

ZipLong(byte[] bytes)
Create instance from bytes.

ZipLong(byte[] bytes, int offset)
Create instance from the four bytes starting at offset.

ZipLong(long value)
Create instance from a number.

Method Summary

boolean	equals(java.lang.Object o) Override to make two instances with same value equal.
byte[]	getBytes() Get value as four bytes in big endian byte order.
static byte[]	getBytes(long value) Converts the given int value as four bytes in big endian byte order.
static byte[]	getBytes(long value, byte[] result) Converts the given int value as four bytes in big endian byte order.
static byte[]	getBytes(long value, byte[] result, int off) Converts the given int value as four bytes in big endian byte order.
long	getValue() Get value as Java long.
static long	getValue(byte[] bytes) Helper method to get the value as a Java long from a four-byte array
static long	getValue(byte[] bytes, int offset) Helper method to get the value as a Java long from four bytes starting at given array offset
int	hashCode() Override to make two instances with same value equal.

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

ZipLong

public ZipLong(long value)

Create instance from a number.

Parameters:

value - the long to store as a ZipLong

ZipLong

public ZipLong(byte[] bytes)

Create instance from bytes.

Parameters:

bytes - the bytes to store as a ZipLong

ZipLong

public ZipLong(byte[] bytes,
               int offset)

Create instance from the four bytes starting at offset.

Parameters:

bytes - the bytes to store as a ZipLong

offset - the offset to start

Method Detail

getBytes

public byte[] getBytes()

Get value as four bytes in big endian byte order.

Returns:

value as four bytes in big endian order

getValue

public long getValue()

Get value as Java long.

Returns:

value as a long

getBytes

public static byte[] getBytes(long value)

Converts the given int value as four bytes in big endian byte order.

Parameters:

value - the unsigned int value (stored as a long) to convert

Returns:

the converted value as a byte array in big endian byte order

getBytes

public static byte[] getBytes(long value,
                              byte[] result)

Converts the given int value as four bytes in big endian byte order. The specified byte array is used to store the result, starting at offset 0. The returned byte array is the same as the given one.

Parameters:

value - the unsigned int value (stored as a long) to convert

result - the byte array in which to store the value in big endian byte order

Returns:

the converted value as a byte array in big endian byte order

getBytes

public static byte[] getBytes(long value,
                              byte[] result,
                              int off)

Converts the given int value as four bytes in big endian byte order. The specified byte array is used to store the result, starting at the given offset. The returned byte array is the same as the given one.

Parameters:

value - the unsigned int value (stored as a long) to convert

result - the byte array in which to store the value in big endian byte order

off - offset at which to start writing the result in the array

Returns:

the converted value as a byte array in big endian byte order

getValue

public static long getValue(byte[] bytes,
                            int offset)

Helper method to get the value as a Java long from four bytes starting at given array offset

Parameters:

bytes - the array of bytes

offset - the offset to start

Returns:

the correspondanding Java long value

getValue

public static long getValue(byte[] bytes)

Helper method to get the value as a Java long from a four-byte array

Parameters:

bytes - the array of bytes

Returns:

the correspondanding Java long value

equals

public boolean equals(java.lang.Object o)

Override to make two instances with same value equal.

Overrides:

equals in class java.lang.Object

Parameters:

o - an object to compare

Returns:

true if the objects are equal

hashCode

public int hashCode()

Override to make two instances with same value equal.

Overrides:

hashCode in class java.lang.Object

Returns:

the value stored in the ZipLong