net.java.truevfs.comp.tardriver

Class TarOutputService

java.lang.Object

net.java.truevfs.comp.tardriver.TarOutputService

All Implemented Interfaces:

java.io.Closeable, java.lang.AutoCloseable, java.lang.Iterable<TarDriverEntry>, net.java.truecommons.cio.Container<TarDriverEntry>, net.java.truecommons.cio.OutputService<TarDriverEntry>, net.java.truecommons.shed.Stream<TarDriverEntry>

@NotThreadSafe
public final class TarOutputService
extends java.lang.Object
implements net.java.truecommons.cio.OutputService<TarDriverEntry>

An output service for writing TAR files. This output service can only write one entry concurrently.

Because the TAR file format needs to know each entry's length in advance, entries from an unknown source are actually written to temp files and copied to the underlying TarArchiveOutputStream upon a call to their OutputStream.close() method. Note that this implies that the close() method may fail with an IOException.

If the size of an entry is known in advance it's directly written to the underlying TarArchiveOutputStream instead.

See Also:

TarInputService

Constructor Summary

Constructors

Constructor and Description
TarOutputService(net.java.truevfs.kernel.spec.FsModel model, net.java.truecommons.io.Sink sink, TarDriver driver)

Method Summary

Modifier and Type	Method and Description
void	close()
TarDriverEntry	entry(java.lang.String name)
java.util.Iterator<TarDriverEntry>	iterator()
net.java.truecommons.cio.OutputSocket<TarDriverEntry>	output(TarDriverEntry local)
int	size()

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

TarOutputService

@CreatesObligation
public TarOutputService(net.java.truevfs.kernel.spec.FsModel model,
                                           net.java.truecommons.io.Sink sink,
                                           TarDriver driver)
                                    throws java.io.IOException

Throws:

java.io.IOException

Method Detail

size

public int size()

Specified by:

size in interface net.java.truecommons.cio.Container<TarDriverEntry>

iterator

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

Specified by:

iterator in interface java.lang.Iterable<TarDriverEntry>

Specified by:

iterator in interface net.java.truecommons.cio.Container<TarDriverEntry>

entry

@CheckForNull
public TarDriverEntry entry(java.lang.String name)

Specified by:

entry in interface net.java.truecommons.cio.Container<TarDriverEntry>

output

public net.java.truecommons.cio.OutputSocket<TarDriverEntry> output(TarDriverEntry local)

Specified by:

output in interface net.java.truecommons.cio.OutputService<TarDriverEntry>

close

public void close()
           throws java.io.IOException

Specified by:

close in interface java.io.Closeable

Specified by:

close in interface java.lang.AutoCloseable

Specified by:

close in interface net.java.truecommons.shed.Stream<TarDriverEntry>

Throws:

java.io.IOException