Package org.apache.commons.compress.archivers.dump

Class DumpArchiveInputStream

java.lang.Object

java.io.InputStream

org.apache.commons.compress.archivers.ArchiveInputStream

org.apache.commons.compress.archivers.dump.DumpArchiveInputStream

All Implemented Interfaces:

java.io.Closeable, java.lang.AutoCloseable

public class DumpArchiveInputStream
extends ArchiveInputStream

The DumpArchiveInputStream reads a UNIX dump archive as an InputStream. Methods are provided to position at each successive entry in the archive, and the read each entry as a normal input stream using read(). There doesn't seem to exist a hint on the encoding of string values in any piece documentation. Given the main purpose of dump/restore is backing up a system it seems very likely the format uses the current default encoding of the system.

Field Summary

Fields

Modifier and Type	Field	Description
private DumpArchiveEntry	active
private byte[]	blockBuffer
(package private) java.lang.String	encoding
private long	entryOffset
private long	entrySize
private long	filepos
private boolean	hasHitEOF
private boolean	isClosed
private java.util.Map<java.lang.Integer,Dirent>	names
private java.util.Map<java.lang.Integer,DumpArchiveEntry>	pending
private java.util.Queue<DumpArchiveEntry>	queue
protected TapeInputStream	raw
private byte[]	readBuf
private int	readIdx
private int	recordOffset
private DumpArchiveSummary	summary
private ZipEncoding	zipEncoding	The encoding to use for file names and labels.

Constructor Summary

Constructors

Constructor	Description
DumpArchiveInputStream(java.io.InputStream is)	Constructor using the platform's default encoding for file names.
DumpArchiveInputStream(java.io.InputStream is, java.lang.String encoding)	Constructor.

Method Summary

Modifier and Type	Method	Description
void	close()	Closes the stream for this entry.
long	getBytesRead()	Returns the current number of bytes read from this stream.
int	getCount()	Deprecated.
DumpArchiveEntry	getNextDumpEntry()	Read the next entry.
DumpArchiveEntry	getNextEntry()	Returns the next Archive Entry in this Stream.
private java.lang.String	getPath(DumpArchiveEntry entry)	Get full path for specified archive entry, or null if there's a gap.
DumpArchiveSummary	getSummary()	Return the archive summary information.
static boolean	matches(byte[] buffer, int length)	Look at the first few bytes of the file to decide if it's a dump archive.
int	read(byte[] buf, int off, int len)	Reads bytes from the current dump archive entry.
private void	readBITS()	Read BITS segment.
private void	readCLRI()	Read CLRI (deleted inode) segment.
private void	readDirectoryEntry(DumpArchiveEntry entry)	Read directory entry.

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

canReadEntryData, count, count, 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

summary

private final DumpArchiveSummary summary

active

private DumpArchiveEntry active

isClosed

private boolean isClosed

hasHitEOF

private boolean hasHitEOF

entrySize

private long entrySize

entryOffset

private long entryOffset

readIdx

private int readIdx

readBuf

private final byte[] readBuf

blockBuffer

private byte[] blockBuffer

recordOffset

private int recordOffset

filepos

private long filepos

raw

protected TapeInputStream raw

names

private final java.util.Map<java.lang.Integer,Dirent> names

pending

private final java.util.Map<java.lang.Integer,DumpArchiveEntry> pending

queue

private final java.util.Queue<DumpArchiveEntry> queue

zipEncoding

private final ZipEncoding zipEncoding

The encoding to use for file names and labels.

encoding

final java.lang.String encoding

Constructor Detail

DumpArchiveInputStream

public DumpArchiveInputStream(java.io.InputStream is)
                       throws ArchiveException

Constructor using the platform's default encoding for file names.

Parameters:

is - stream to read from

Throws:

ArchiveException - on error

DumpArchiveInputStream

public DumpArchiveInputStream(java.io.InputStream is,
                              java.lang.String encoding)
                       throws ArchiveException

Constructor.

Parameters:

is - stream to read from

encoding - the encoding to use for file names, use null for the platform's default encoding

Throws:

ArchiveException - on error

Since:

1.6

Method Detail

getCount

@Deprecated
public int getCount()

Deprecated.

Description copied from class: ArchiveInputStream

Returns the current number of bytes read from this stream.

Overrides:

getCount in class ArchiveInputStream

Returns:

the number of read bytes

getBytesRead

public long getBytesRead()

Description copied from class: ArchiveInputStream

Returns the current number of bytes read from this stream.

Overrides:

getBytesRead in class ArchiveInputStream

Returns:

the number of read bytes

getSummary

public DumpArchiveSummary getSummary()

Return the archive summary information.

Returns:

the summary

readCLRI

private void readCLRI()
               throws java.io.IOException

Read CLRI (deleted inode) segment.

Throws:

java.io.IOException

readBITS

private void readBITS()
               throws java.io.IOException

Read BITS segment.

Throws:

java.io.IOException

getNextDumpEntry

public DumpArchiveEntry getNextDumpEntry()
                                  throws java.io.IOException

Read the next entry.

Returns:

the next entry

Throws:

java.io.IOException - on error

getNextEntry

public DumpArchiveEntry 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

readDirectoryEntry

private void readDirectoryEntry(DumpArchiveEntry entry)
                         throws java.io.IOException

Read directory entry.

Throws:

java.io.IOException

getPath

private java.lang.String getPath(DumpArchiveEntry entry)

Get full path for specified archive entry, or null if there's a gap.

Parameters:

entry -

Returns:

full path for specified archive entry, or null if there's a gap.

read

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

Reads bytes from the current dump archive entry. This method is aware of the boundaries of the current entry in the archive and will deal with them as if they were this stream's start and EOF.

Overrides:

read in class java.io.InputStream

Parameters:

buf - The buffer into which to place bytes read.

off - The offset at which to place bytes read.

len - The number of bytes to read.

Returns:

The number of bytes read, or -1 at EOF.

Throws:

java.io.IOException - on error

close

public void close()
           throws java.io.IOException

Closes the stream for this entry.

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

matches

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

Look at the first few bytes of the file to decide if it's a dump archive. With 32 bytes we can look at the magic value, with a full 1k we can verify the checksum.

Parameters:

buffer - data to match

length - length of data

Returns:

whether the buffer seems to contain dump data