org.at4j.zip.comp
Class LzmaCompressionMethod

java.lang.Object
  org.at4j.zip.comp.LzmaCompressionMethod

All Implemented Interfaces:

ZipEntryCompressionMethod, ZipEntryCompressionMethodFactory

public class LzmaCompressionMethod
extends Object
implements ZipEntryCompressionMethod, ZipEntryCompressionMethodFactory

This is the LZMA compression method. It is supported using the LzmaInputStream implementation.

This class cannot be instantiated. Use the singleton instance DEFAULT_INSTANCE instead.

Since:

1.0

Author:

Karl Gustafsson

Field Summary

static UnsignedShort	CODE The unique code for this compression method.
static LzmaCompressionMethod	DEFAULT_INSTANCE Singleton instance.
static String	NAME
static UnsignedShort	VERSION_NEEDED_TO_EXTRACT The PK-Zip version needed to extract entries compressed with this compression method.

Constructor Summary

LzmaCompressionMethod(LzmaOutputStreamSettings settings)
Create a new LZMA compression method object with settings for creating compression output streams.

Method Summary

LzmaCompressionMethod	create(ZipGeneralPurposeBitFlags gbBitFlags) Create a compression method instance.
InputStream	createInputStream(InputStream is, long compressedSize, long uncompressedSize) Create an InputStream that clients can use to read uncompressed file data from.
OutputStream	createOutputStream(OutputStream os) Create an OutputStream that compresses the data written to it and writes it to the wrapped output stream.
RandomAccess	createRandomAccess(RandomAccess ra, long compressedSize, long uncompressedSize) This method always throws an UnsupportedOperationException.
ZipEntryCompressionMethod	createWithCompressionLevel(CompressionLevel level) Create a new ZipEntryCompressionMethod object that will have the supplied compression level.
UnsignedShort	getCode() Get the unique code that is used to identify this compression method in a Zip entry's header.
String	getName() Get a human-readable name for the compression method.
UnsignedShort	getVersionNeededToExtract() Get the PK-Zip version needed to extract Zip entries compressed by this compression method.
boolean	isRandomAccessSupported() This method always returns false
String	toString()

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

CODE

public static final UnsignedShort CODE

The unique code for this compression method. The code is used in the Zip entry's header to specify the compression method that is used for compressing the entry's file data.

NAME

public static final String NAME

See Also:

Constant Field Values

VERSION_NEEDED_TO_EXTRACT

public static final UnsignedShort VERSION_NEEDED_TO_EXTRACT

The PK-Zip version needed to extract entries compressed with this compression method. See ZipEntryCompressionMethod.getVersionNeededToExtract().

DEFAULT_INSTANCE

public static final LzmaCompressionMethod DEFAULT_INSTANCE

Singleton instance. This is initialized with the default settings.

Constructor Detail

LzmaCompressionMethod

public LzmaCompressionMethod(LzmaOutputStreamSettings settings)
                      throws IllegalArgumentException

Create a new LZMA compression method object with settings for creating compression output streams.

Parameters:

settings - Settings for the compressing output streams created by this object. This has no effect on the decompressing input streams created by this object. This settings object should have its writeUncompressedDataSize property set to false and its writeStreamProperties property set to true.

Throws:

IllegalArgumentException - If the writeUncompressedDataSize property for the settings object is true or if the writeStreamProperties property is false.

Method Detail

getCode

public UnsignedShort getCode()

Description copied from interface: ZipEntryCompressionMethod

Get the unique code that is used to identify this compression method in a Zip entry's header.

Specified by:

getCode in interface ZipEntryCompressionMethod

Specified by:

getCode in interface ZipEntryCompressionMethodFactory

Returns:

The compression method's unique code.

getName

public String getName()

Description copied from interface: ZipEntryCompressionMethod

Get a human-readable name for the compression method.

Specified by:

getName in interface ZipEntryCompressionMethod

Returns:

The compression method's name.

getVersionNeededToExtract

public UnsignedShort getVersionNeededToExtract()

Description copied from interface: ZipEntryCompressionMethod

Get the PK-Zip version needed to extract Zip entries compressed by this compression method.

Specified by:

getVersionNeededToExtract in interface ZipEntryCompressionMethod

Returns:

An UnsignedShort representing the version number. 10 corresponds to version 1.0, 62 to 6.2, etc.

createInputStream

public InputStream createInputStream(InputStream is,
                                     long compressedSize,
                                     long uncompressedSize)
                              throws IOException

Description copied from interface: ZipEntryCompressionMethod

Create an InputStream that clients can use to read uncompressed file data from.

Specified by:

createInputStream in interface ZipEntryCompressionMethod

Parameters:

is - An open InputStream on the compressed file data.

compressedSize - The total size of the compressed data.

uncompressedSize - The total size of the uncompressed data.

Returns:

An open InputStream containing uncompressed file data.

Throws:

IOException - On I/O errors.

createOutputStream

public OutputStream createOutputStream(OutputStream os)
                                throws IOException,
                                       UnsupportedCompressionMethodException

Description copied from interface: ZipEntryCompressionMethod

Create an OutputStream that compresses the data written to it and writes it to the wrapped output stream. This is used when building Zip files.

Specified by:

createOutputStream in interface ZipEntryCompressionMethod

Parameters:

os - The wrapped output stream.

Returns:

A compressing output stream.

Throws:

IOException - On I/O errors.

UnsupportedCompressionMethodException - If the compression method is not supported.

createRandomAccess

public RandomAccess createRandomAccess(RandomAccess ra,
                                       long compressedSize,
                                       long uncompressedSize)
                                throws UnsupportedOperationException

This method always throws an UnsupportedOperationException.

Specified by:

createRandomAccess in interface ZipEntryCompressionMethod

Parameters:

ra - An open random access object on the file entry's data.

compressedSize - The total size of the compressed data.

uncompressedSize - The total size of the uncompressed data.

Returns:

On open RandomAccess that can be used to read uncompressed data.

Throws:

UnsupportedOperationException - Always.

isRandomAccessSupported

public boolean isRandomAccessSupported()

This method always returns false

Specified by:

isRandomAccessSupported in interface ZipEntryCompressionMethod

Returns:

false, always.

toString

public String toString()

Overrides:

toString in class Object

create

public LzmaCompressionMethod create(ZipGeneralPurposeBitFlags gbBitFlags)

Description copied from interface: ZipEntryCompressionMethodFactory

Create a compression method instance.

Specified by:

create in interface ZipEntryCompressionMethodFactory

Parameters:

gbBitFlags - The Zip entry's general purpose bit flags. They may contain compression algorithm parameters.

Returns:

The Zip entry compression method.

createWithCompressionLevel

public ZipEntryCompressionMethod createWithCompressionLevel(CompressionLevel level)

Description copied from interface: ZipEntryCompressionMethod

Create a new ZipEntryCompressionMethod object that will have the supplied compression level.

The reason for this method is that it makes it easier to set a custom compression level for a compression method, without having to create a new compression method object from scratch manually.

Specified by:

createWithCompressionLevel in interface ZipEntryCompressionMethod

Parameters:

level - The compression level.

Returns:

A new compression method object. If the new object would have been created with the same settings as this object, this method may return this since ZipEntryCompressionMethod objects are immutable.