Package net.sf.sevenzipjbinding.impl

Class OutArchiveImpl<T extends IOutItemBase>

java.lang.Object

net.sf.sevenzipjbinding.impl.OutArchiveImpl<T>

Type Parameters:

T - the type of the item callback implementation

All Implemented Interfaces:

Closeable, AutoCloseable, IOutArchive<T>, IOutArchiveBase, IOutCreateArchive<T>, IOutUpdateArchive<T>

Direct Known Subclasses:

OutArchive7zImpl, OutArchiveBZip2Impl, OutArchiveGZipImpl, OutArchiveTarImpl, OutArchiveXzImpl, OutArchiveZipImpl

public class OutArchiveImpl<T extends IOutItemBase>
extends Object
implements IOutArchive<T>

Common archive create and update class.

Since:

9.20-2.00

Author:

Boris Brodski

See Also:

• OutArchive7zImpl
• OutArchiveZipImpl
• OutArchiveGZipImpl
• OutArchiveBZip2Impl
• OutArchiveTarImpl

Constructor Summary

Constructors

Constructor	Description
OutArchiveImpl()

Method Summary

Modifier and Type	Method	Description
void	close()
void	createArchive(ISequentialOutStream outStream, int numberOfItems, IOutCreateCallback<? extends T> outCreateCallback)	Create new archive.
ArchiveFormat	getArchiveFormat()	Return the archive format of this out-archive instance
IInArchive	getConnectedInArchive()	Get connected IInArchive for update operations.
PrintStream	getTracePrintStream()	Alternative PrintStream for trace output.
boolean	isTrace()	If true, print trace messages during compression and update operations to the System.out or IOutArchiveBase.getTracePrintStream().
void	setTrace(boolean trace)	If true, print trace messages during compression and update operations to the System.out or IOutArchiveBase.getTracePrintStream().
void	setTracePrintStream(PrintStream tracePrintStream)	Set alternative PrintStream for trace output.
void	updateItems(ISequentialOutStream outStream, int numberOfItems, IOutCreateCallback<T> outUpdateCallback)	Update items in archive (actually creating a new one based on the old one).

Methods inherited from class java.lang.Object

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

Constructor Details

OutArchiveImpl

public OutArchiveImpl()

Method Details

getArchiveFormat

public ArchiveFormat getArchiveFormat()

Return the archive format of this out-archive instance

Specified by:

getArchiveFormat in interface IOutCreateArchive<T extends IOutItemBase>

Specified by:

getArchiveFormat in interface IOutUpdateArchive<T extends IOutItemBase>

Returns:

the archive format of this out-archive instance

close

public void close()
           throws IOException

Specified by:

close in interface AutoCloseable

Specified by:

close in interface Closeable

Throws:

IOException

updateItems

public void updateItems(ISequentialOutStream outStream,
 int numberOfItems,
 IOutCreateCallback<T> outUpdateCallback)
                 throws SevenZipException

Update items in archive (actually creating a new one based on the old one).

Specified by:

updateItems in interface IOutUpdateArchive<T extends IOutItemBase>

Parameters:

outStream - output stream to get the new archive

numberOfItems - number of items in the new archive

outUpdateCallback - create call back object to provide more information for archive update operation.

Throws:

SevenZipException - 7-Zip or 7-Zip-JBinding error occurs. Use SevenZipException.printStackTraceExtended() to get stack traces of this SevenZipException and of all thrown 'caused by' exceptions.

createArchive

public void createArchive(ISequentialOutStream outStream,
 int numberOfItems,
 IOutCreateCallback<? extends T> outCreateCallback)
                   throws SevenZipException

Create new archive. To update an existing archive open it first and then use IInArchive.getConnectedOutArchive() to get an instance of the IOutUpdateArchive interface.

The outCreateCallback is designed to provide necessary information about new archive items and to receive information about the progress of the operation.

Note: some archive formats (like Zip) require an implementation of the IOutStream interface (instead of the ISequentialOutStream) to be passed.

Specified by:

createArchive in interface IOutCreateArchive<T extends IOutItemBase>

Parameters:

outStream - output stream to receive the new archive. An implementation of the IOutStream interface is required for some archive formats.

numberOfItems - number of items in the new archive

outCreateCallback - callback object to exchange information about the archive create operation.

Throws:

SevenZipException - 7-Zip or 7-Zip-JBinding error occurs. Use SevenZipException.printStackTraceExtended() to get stack traces of this SevenZipException and of all thrown 'caused by' exceptions.

getConnectedInArchive

public IInArchive getConnectedInArchive()

Get connected IInArchive for update operations.

Specified by:

getConnectedInArchive in interface IOutUpdateArchive<T extends IOutItemBase>

Returns:

connected IInArchive for update operations

setTracePrintStream

public void setTracePrintStream(PrintStream tracePrintStream)

Set alternative PrintStream for trace output. Default: System.out.

Specified by:

setTracePrintStream in interface IOutArchiveBase

Parameters:

tracePrintStream - instance of the PrintStream.

See Also:

• IOutArchiveBase.setTrace(boolean)

getTracePrintStream

public PrintStream getTracePrintStream()

Alternative PrintStream for trace output. Default: System.out.

Specified by:

getTracePrintStream in interface IOutArchiveBase

Returns:

Alternative PrintStream for trace output

See Also:

• IOutArchiveBase.setTrace(boolean)

setTrace

public void setTrace(boolean trace)

If true, print trace messages during compression and update operations to the System.out or IOutArchiveBase.getTracePrintStream(). Default: false

Specified by:

setTrace in interface IOutArchiveBase

Parameters:

trace - true - output trace messages, false - be quiet.

See Also:

• IOutArchiveBase.setTracePrintStream(PrintStream)

isTrace

public boolean isTrace()

If true, print trace messages during compression and update operations to the System.out or IOutArchiveBase.getTracePrintStream(). Default: false

Specified by:

isTrace in interface IOutArchiveBase

Returns:

true - output trace messages, false - be quiet.

See Also:

• IOutArchiveBase.setTracePrintStream(PrintStream)