com.github.junrar

Class Archive

java.lang.Object

com.github.junrar.Archive

All Implemented Interfaces:

java.io.Closeable, java.lang.AutoCloseable, java.lang.Iterable<FileHeader>

public class Archive
extends java.lang.Object
implements java.io.Closeable, java.lang.Iterable<FileHeader>

The Main Rar Class; represents a rar Archive

Constructor Summary

Constructors

Constructor and Description
Archive(java.io.File firstVolume)
Archive(java.io.File firstVolume, java.lang.String password)
Archive(java.io.File firstVolume, UnrarCallback unrarCallback)
Archive(java.io.File firstVolume, UnrarCallback unrarCallback, java.lang.String password)
Archive(java.io.InputStream rarAsStream)
Archive(java.io.InputStream rarAsStream, java.lang.String password)
Archive(java.io.InputStream rarAsStream, UnrarCallback unrarCallback)
Archive(java.io.InputStream rarAsStream, UnrarCallback unrarCallback, java.lang.String password)
Archive(VolumeManager volumeManager, UnrarCallback unrarCallback, java.lang.String password)

Method Summary

Modifier and Type	Method and Description
void	bytesReadRead(int count)
void	close() Close the underlying compressed file.
void	extractFile(FileHeader hd, java.io.OutputStream os) Extract the file specified by the given header and write it to the supplied output stream
SeekableReadOnlyByteChannel	getChannel()
java.util.List<FileHeader>	getFileHeaders()
java.util.List<BaseBlock>	getHeaders() Gets all of the headers in the archive.
java.io.InputStream	getInputStream(FileHeader hd) Returns an InputStream that will allow to read the file and stream it.
MainHeader	getMainHeader()
java.lang.String	getPassword()
UnrarCallback	getUnrarCallback()
Volume	getVolume()
VolumeManager	getVolumeManager()
boolean	isEncrypted()
boolean	isOldFormat()
boolean	isPasswordProtected()
java.util.Iterator<FileHeader>	iterator()
FileHeader	nextFileHeader()
void	setPassword(java.lang.String password)
void	setVolume(Volume volume)
void	setVolumeManager(VolumeManager volumeManager)

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.lang.Iterable

forEach, spliterator

Constructor Detail

Archive

public Archive(VolumeManager volumeManager,
               UnrarCallback unrarCallback,
               java.lang.String password)
        throws RarException,
               java.io.IOException

Throws:

RarException

java.io.IOException

Archive

public Archive(java.io.File firstVolume)
        throws RarException,
               java.io.IOException

Throws:

RarException

java.io.IOException

Archive

public Archive(java.io.File firstVolume,
               UnrarCallback unrarCallback)
        throws RarException,
               java.io.IOException

Throws:

RarException

java.io.IOException

Archive

public Archive(java.io.File firstVolume,
               java.lang.String password)
        throws RarException,
               java.io.IOException

Throws:

RarException

java.io.IOException

Archive

public Archive(java.io.File firstVolume,
               UnrarCallback unrarCallback,
               java.lang.String password)
        throws RarException,
               java.io.IOException

Throws:

RarException

java.io.IOException

Archive

public Archive(java.io.InputStream rarAsStream)
        throws RarException,
               java.io.IOException

Throws:

RarException

java.io.IOException

Archive

public Archive(java.io.InputStream rarAsStream,
               UnrarCallback unrarCallback)
        throws RarException,
               java.io.IOException

Throws:

RarException

java.io.IOException

Archive

public Archive(java.io.InputStream rarAsStream,
               java.lang.String password)
        throws java.io.IOException,
               RarException

Throws:

java.io.IOException

RarException

Archive

public Archive(java.io.InputStream rarAsStream,
               UnrarCallback unrarCallback,
               java.lang.String password)
        throws java.io.IOException,
               RarException

Throws:

java.io.IOException

RarException

Method Detail

bytesReadRead

public void bytesReadRead(int count)

getChannel

public SeekableReadOnlyByteChannel getChannel()

getHeaders

public java.util.List<BaseBlock> getHeaders()

Gets all of the headers in the archive.

Returns:

returns the headers.

getFileHeaders

public java.util.List<FileHeader> getFileHeaders()

Returns:

returns all file headers of the archive

nextFileHeader

public FileHeader nextFileHeader()

getUnrarCallback

public UnrarCallback getUnrarCallback()

isEncrypted

public boolean isEncrypted()
                    throws RarException

Returns:

whether the archive is encrypted

Throws:

RarException - when the main header is not present

isPasswordProtected

public boolean isPasswordProtected()
                            throws RarException

Returns:

whether the archive content is password protected

Throws:

RarException - when the main header is not present

extractFile

public void extractFile(FileHeader hd,
                        java.io.OutputStream os)
                 throws RarException

Extract the file specified by the given header and write it to the supplied output stream

Parameters:

hd - the header to be extracted

os - the outputstream

Throws:

RarException - .

getInputStream

public java.io.InputStream getInputStream(FileHeader hd)
                                   throws java.io.IOException

Returns an InputStream that will allow to read the file and stream it.
Please note that this method will create a pair of Pipe streams and either:

• delegate the work to a ThreadPoolExecutor, via ExtractorExecutorHolder; or
• delegate the work to a newly created thread on each call

You can choose which strategy to use by setting the junrar.extractor.use-executor system property.
Defaults to using the ThreadPoolExecutor.

Parameters:

hd - the header to be extracted

Returns:

an InputStream from which you can read the uncompressed bytes

Throws:

java.io.IOException - if any I/O error occur

See Also:

ExtractorExecutorHolder

getMainHeader

public MainHeader getMainHeader()

Returns:

returns the main header of this archive

isOldFormat

public boolean isOldFormat()

Returns:

whether the archive is old format

close

public void close()
           throws java.io.IOException

Close the underlying compressed file.

Specified by:

close in interface java.io.Closeable

Specified by:

close in interface java.lang.AutoCloseable

Throws:

java.io.IOException

getVolumeManager

public VolumeManager getVolumeManager()

Returns:

the volumeManager

setVolumeManager

public void setVolumeManager(VolumeManager volumeManager)

Parameters:

volumeManager - the volumeManager to set

getVolume

public Volume getVolume()

Returns:

the volume

getPassword

public java.lang.String getPassword()

setPassword

public void setPassword(java.lang.String password)

setVolume

public void setVolume(Volume volume)
               throws java.io.IOException,
                      RarException

Parameters:

volume - the volume to set

Throws:

java.io.IOException - .

RarException - .

iterator

public java.util.Iterator<FileHeader> iterator()

Specified by:

iterator in interface java.lang.Iterable<FileHeader>