de.schlichtherle.truezip.fs.archive.tar.TarDriver Maven / Gradle / Ivy
Show all versions of truezip-driver-tar Show documentation
/*
* Copyright (C) 2005-2013 Schlichtherle IT Services.
* All rights reserved. Use is subject to license terms.
*/
package de.schlichtherle.truezip.fs.archive.tar;
import de.schlichtherle.truezip.entry.Entry;
import static de.schlichtherle.truezip.entry.Entry.Access.WRITE;
import static de.schlichtherle.truezip.entry.Entry.Size.DATA;
import de.schlichtherle.truezip.entry.Entry.Type;
import de.schlichtherle.truezip.fs.*;
import static de.schlichtherle.truezip.fs.FsOutputOption.COMPRESS;
import de.schlichtherle.truezip.socket.*;
import de.schlichtherle.truezip.util.BitField;
import de.schlichtherle.truezip.util.JSE7;
import edu.umd.cs.findbugs.annotations.CreatesObligation;
import java.io.CharConversionException;
import java.io.IOException;
import java.io.InputStream;
import java.io.OutputStream;
import java.nio.charset.Charset;
import javax.annotation.CheckForNull;
import javax.annotation.WillClose;
import javax.annotation.WillCloseWhenClosed;
import javax.annotation.WillNotClose;
import javax.annotation.concurrent.Immutable;
import org.apache.commons.compress.archivers.tar.TarArchiveEntry;
/**
* An archive driver for Tape Archive files (TAR).
* By default, TAR files use the US-ASCII character set for the encoding of
* entry names.
* This configuration pretty much constraints the applicability of this file
* format to North American countries.
*
* Subclasses must be thread-safe and should be immutable!
*
* @author Christian Schlichtherle
*/
@Immutable
public class TarDriver extends FsCharsetArchiveDriver {
/** Default record size */
static final int DEFAULT_RCDSIZE = 512;
/** Default block size */
static final int DEFAULT_BLKSIZE = DEFAULT_RCDSIZE * 20;
/**
* The character set for entry names and comments, which is the default
* character set.
*/
public static final Charset TAR_CHARSET = Charset.defaultCharset();
private final IOPool ioPool;
/**
* Constructs a new TAR driver.
*
* @param provider the provider for the I/O buffer pool.
*/
public TarDriver(final IOPoolProvider provider) {
super(TAR_CHARSET);
if (null == (this.ioPool = provider.get()))
throw new NullPointerException();
}
final String getEncoding() {
return getCharset().name();
}
@Override
protected final IOPool getPool() {
return ioPool;
}
/**
* {@inheritDoc}
*
* @return The implementation in the class {@link TarDriver} returns
* {@code true} because when reading a TAR file sequentially,
* each TAR entry should "override" any previously read
* TAR entry with an equal name.
*/
@Override
public boolean getRedundantContentSupport() {
return true;
}
/**
* Clears {@link FsInputOption#CACHE} in {@code options} before
* forwarding the call to {@code controller}.
*/
@Override
public InputSocket getInputSocket( FsController controller,
FsEntryName name,
BitField options) {
return controller.getInputSocket(
name,
options.clear(FsInputOption.CACHE));
}
/**
* Sets {@link FsOutputOption#COMPRESS} in {@code options} before
* forwarding the call to {@code controller}.
*/
@Override
public OutputSocket getOutputSocket( FsController controller,
FsEntryName name,
BitField options,
@CheckForNull Entry template) {
return controller.getOutputSocket(name, options.set(COMPRESS), template);
}
@Override
public TarDriverEntry newEntry(
String name,
final Type type,
final Entry template,
final BitField mknod)
throws CharConversionException {
name = toZipOrTarEntryName(name, type);
final TarDriverEntry entry;
if (template instanceof TarArchiveEntry) {
entry = newEntry(name, (TarArchiveEntry) template);
} else {
entry = newEntry(name);
if (null != template) {
entry.setModTime(template.getTime(WRITE));
entry.setSize(template.getSize(DATA));
}
}
return entry;
}
public TarDriverEntry newEntry(String name) {
return new TarDriverEntry(name);
}
public TarDriverEntry newEntry(String name, TarArchiveEntry template) {
return new TarDriverEntry(name, template);
}
/**
* {@inheritDoc}
*
* The implementation in the class {@link TarDriver} acquires an input
* stream from the given socket and forwards the call to
* {@link #newTarInputShop}.
*/
@Override
@edu.umd.cs.findbugs.annotations.SuppressWarnings("OBL_UNSATISFIED_OBLIGATION")
public TarInputShop newInputShop(FsModel model, InputSocket input)
throws IOException {
if (null == model)
throw new NullPointerException();
TarInputShop is = null;
final @WillClose InputStream in = input.newInputStream();
try {
return is = newTarInputShop(model, in);
} finally {
try {
in.close();
} catch (final IOException ex) {
if (null != is)
is.close();
throw ex;
}
}
}
@CreatesObligation
protected TarInputShop newTarInputShop(
FsModel model,
@WillCloseWhenClosed InputStream in)
throws IOException {
assert null != model;
return new TarInputShop(this, in);
}
/**
* {@inheritDoc}
*
* The implementation in the class {@link TarDriver} acquires an output
* stream from the given socket, forwards the call to
* {@link #newTarOutputShop} and wraps the result in a new
* {@link MultiplexedOutputShop}.
*/
@Override
public OutputShop newOutputShop(
final FsModel model,
final OutputSocket output,
final InputShop source)
throws IOException {
if (null == model)
throw new NullPointerException();
final OutputStream out = output.newOutputStream();
try {
return new MultiplexedOutputShop(
newTarOutputShop(model, out, (TarInputShop) source),
getPool());
} catch (final IOException ex) {
try {
out.close();
} catch (final IOException ex2) {
if (JSE7.AVAILABLE) ex.addSuppressed(ex2);
}
throw ex;
}
}
@CreatesObligation
protected TarOutputShop newTarOutputShop(
FsModel model,
OutputStream out,
@CheckForNull @WillNotClose TarInputShop source)
throws IOException {
assert null != model;
return new TarOutputShop(this, out);
}
}