Package org.apache.commons.compress.archivers.arj

Class ArjArchiveInputStream

java.lang.Object

java.io.InputStream

org.apache.commons.compress.archivers.ArchiveInputStream

org.apache.commons.compress.archivers.arj.ArjArchiveInputStream

All Implemented Interfaces:

java.io.Closeable, java.lang.AutoCloseable

public class ArjArchiveInputStream
extends ArchiveInputStream

Implements the "arj" archive format as an InputStream.

Reference 1
Reference 2

Since:

1.6

Field Summary

Fields

Modifier and Type	Field	Description
private static int	ARJ_MAGIC_1
private static int	ARJ_MAGIC_2
private java.lang.String	charsetName
private java.io.InputStream	currentInputStream
private LocalFileHeader	currentLocalFileHeader
private java.io.DataInputStream	in
private MainHeader	mainHeader

Constructor Summary

Constructors

Constructor	Description
ArjArchiveInputStream(java.io.InputStream inputStream)	Constructs the ArjInputStream, taking ownership of the inputStream that is passed in, and using the CP437 character encoding.
ArjArchiveInputStream(java.io.InputStream inputStream, java.lang.String charsetName)	Constructs the ArjInputStream, taking ownership of the inputStream that is passed in.

Method Summary

Modifier and Type	Method	Description
boolean	canReadEntryData(ArchiveEntry ae)	Whether this stream is able to read the given entry.
void	close()
java.lang.String	getArchiveComment()	Gets the archive's comment.
java.lang.String	getArchiveName()	Gets the archive's recorded name.
ArjArchiveEntry	getNextEntry()	Returns the next Archive Entry in this Stream.
static boolean	matches(byte[] signature, int length)	Checks if the signature matches what is expected for an arj file.
int	read(byte[] b, int off, int len)
private int	read16(java.io.DataInputStream dataIn)
private int	read32(java.io.DataInputStream dataIn)
private int	read8(java.io.DataInputStream dataIn)
private void	readExtraData(int firstHeaderSize, java.io.DataInputStream firstHeader, LocalFileHeader localFileHeader)
private byte[]	readHeader()
private LocalFileHeader	readLocalFileHeader()
private MainHeader	readMainHeader()
private byte[]	readRange(java.io.InputStream in, int len)
private java.lang.String	readString(java.io.DataInputStream dataIn)

Methods inherited from class org.apache.commons.compress.archivers.ArchiveInputStream

count, count, getBytesRead, getCount, pushedBackBytes, read

Methods inherited from class java.io.InputStream

available, mark, markSupported, nullInputStream, read, readAllBytes, readNBytes, readNBytes, reset, skip, transferTo

Methods inherited from class java.lang.Object

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

Field Detail

ARJ_MAGIC_1

private static final int ARJ_MAGIC_1

See Also:

Constant Field Values

ARJ_MAGIC_2

private static final int ARJ_MAGIC_2

See Also:

Constant Field Values

in

private final java.io.DataInputStream in

charsetName

private final java.lang.String charsetName

mainHeader

private final MainHeader mainHeader

currentLocalFileHeader

private LocalFileHeader currentLocalFileHeader

currentInputStream

private java.io.InputStream currentInputStream

Constructor Detail

ArjArchiveInputStream

public ArjArchiveInputStream(java.io.InputStream inputStream,
                             java.lang.String charsetName)
                      throws ArchiveException

Constructs the ArjInputStream, taking ownership of the inputStream that is passed in.

Parameters:

inputStream - the underlying stream, whose ownership is taken

charsetName - the charset used for file names and comments in the archive. May be null to use the platform default.

Throws:

ArchiveException - if an exception occurs while reading

ArjArchiveInputStream

public ArjArchiveInputStream(java.io.InputStream inputStream)
                      throws ArchiveException

Constructs the ArjInputStream, taking ownership of the inputStream that is passed in, and using the CP437 character encoding.

Parameters:

inputStream - the underlying stream, whose ownership is taken

Throws:

ArchiveException - if an exception occurs while reading

Method Detail

close

public void close()
           throws java.io.IOException

Specified by:

close in interface java.lang.AutoCloseable

Specified by:

close in interface java.io.Closeable

Overrides:

close in class java.io.InputStream

Throws:

java.io.IOException

read8

private int read8(java.io.DataInputStream dataIn)
           throws java.io.IOException

Throws:

java.io.IOException

read16

private int read16(java.io.DataInputStream dataIn)
            throws java.io.IOException

Throws:

java.io.IOException

read32

private int read32(java.io.DataInputStream dataIn)
            throws java.io.IOException

Throws:

java.io.IOException

readString

private java.lang.String readString(java.io.DataInputStream dataIn)
                             throws java.io.IOException

Throws:

java.io.IOException

readRange

private byte[] readRange(java.io.InputStream in,
                         int len)
                  throws java.io.IOException

Throws:

java.io.IOException

readHeader

private byte[] readHeader()
                   throws java.io.IOException

Throws:

java.io.IOException

readMainHeader

private MainHeader readMainHeader()
                           throws java.io.IOException

Throws:

java.io.IOException

readLocalFileHeader

private LocalFileHeader readLocalFileHeader()
                                     throws java.io.IOException

Throws:

java.io.IOException

readExtraData

private void readExtraData(int firstHeaderSize,
                           java.io.DataInputStream firstHeader,
                           LocalFileHeader localFileHeader)
                    throws java.io.IOException

Throws:

java.io.IOException

matches

public static boolean matches(byte[] signature,
                              int length)

Checks if the signature matches what is expected for an arj file.

Parameters:

signature - the bytes to check

length - the number of bytes to check

Returns:

true, if this stream is an arj archive stream, false otherwise

getArchiveName

public java.lang.String getArchiveName()

Gets the archive's recorded name.

Returns:

the archive's name

getArchiveComment

public java.lang.String getArchiveComment()

Gets the archive's comment.

Returns:

the archive's comment

getNextEntry

public ArjArchiveEntry getNextEntry()
                             throws java.io.IOException

Description copied from class: ArchiveInputStream

Returns the next Archive Entry in this Stream.

Specified by:

getNextEntry in class ArchiveInputStream

Returns:

the next entry, or null if there are no more entries

Throws:

java.io.IOException - if the next entry could not be read

canReadEntryData

public boolean canReadEntryData(ArchiveEntry ae)

Description copied from class: ArchiveInputStream

Whether this stream is able to read the given entry.

Some archive formats support variants or details that are not supported (yet).

Overrides:

canReadEntryData in class ArchiveInputStream

Parameters:

ae - the entry to test

Returns:

This implementation always returns true.

read

public int read(byte[] b,
                int off,
                int len)
         throws java.io.IOException

Overrides:

read in class java.io.InputStream

Throws:

java.io.IOException