/*
* Licensed to the Apache Software Foundation (ASF) under one
* or more contributor license agreements. See the NOTICE file
* distributed with this work for additional information
* regarding copyright ownership. The ASF licenses this file
* to you under the Apache License, Version 2.0 (the
* "License"); you may not use this file except in compliance
* with the License. You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing,
* software distributed under the License is distributed on an
* "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
* KIND, either express or implied. See the License for the
* specific language governing permissions and limitations
* under the License.
*/
package org.apache.commons.compress.compressors.pack200;
import java.io.File;
import java.io.IOException;
import java.io.InputStream;
import java.util.Map;
import java.util.jar.JarOutputStream;
import java.util.jar.Pack200;
import org.apache.commons.compress.compressors.CompressorInputStream;
import org.apache.commons.compress.utils.CloseShieldFilterInputStream;
import org.apache.commons.compress.utils.IOUtils;
An input stream that decompresses from the Pack200 format to be read
as any other stream.
The getCount
and getBytesRead
methods always return 0.
@NotThreadSafe Since: 1.3
/**
* An input stream that decompresses from the Pack200 format to be read
* as any other stream.
*
* <p>The {@link CompressorInputStream#getCount getCount} and {@link
* CompressorInputStream#getBytesRead getBytesRead} methods always
* return 0.</p>
*
* @NotThreadSafe
* @since 1.3
*/
public class Pack200CompressorInputStream extends CompressorInputStream {
private final InputStream originalInput;
private final StreamBridge streamBridge;
Decompresses the given stream, caching the decompressed data in
memory.
When reading from a file the File-arg constructor may
provide better performance.
Params: - in – the InputStream from which this object should be created
Throws: - IOException – if reading fails
/**
* Decompresses the given stream, caching the decompressed data in
* memory.
*
* <p>When reading from a file the File-arg constructor may
* provide better performance.</p>
*
* @param in the InputStream from which this object should be created
* @throws IOException if reading fails
*/
public Pack200CompressorInputStream(final InputStream in)
throws IOException {
this(in, Pack200Strategy.IN_MEMORY);
}
Decompresses the given stream using the given strategy to cache
the results.
When reading from a file the File-arg constructor may
provide better performance.
Params: - in – the InputStream from which this object should be created
- mode – the strategy to use
Throws: - IOException – if reading fails
/**
* Decompresses the given stream using the given strategy to cache
* the results.
*
* <p>When reading from a file the File-arg constructor may
* provide better performance.</p>
*
* @param in the InputStream from which this object should be created
* @param mode the strategy to use
* @throws IOException if reading fails
*/
public Pack200CompressorInputStream(final InputStream in,
final Pack200Strategy mode)
throws IOException {
this(in, null, mode, null);
}
Decompresses the given stream, caching the decompressed data in
memory and using the given properties.
When reading from a file the File-arg constructor may
provide better performance.
Params: - in – the InputStream from which this object should be created
- props – Pack200 properties to use
Throws: - IOException – if reading fails
/**
* Decompresses the given stream, caching the decompressed data in
* memory and using the given properties.
*
* <p>When reading from a file the File-arg constructor may
* provide better performance.</p>
*
* @param in the InputStream from which this object should be created
* @param props Pack200 properties to use
* @throws IOException if reading fails
*/
public Pack200CompressorInputStream(final InputStream in,
final Map<String, String> props)
throws IOException {
this(in, Pack200Strategy.IN_MEMORY, props);
}
Decompresses the given stream using the given strategy to cache
the results and the given properties.
When reading from a file the File-arg constructor may
provide better performance.
Params: - in – the InputStream from which this object should be created
- mode – the strategy to use
- props – Pack200 properties to use
Throws: - IOException – if reading fails
/**
* Decompresses the given stream using the given strategy to cache
* the results and the given properties.
*
* <p>When reading from a file the File-arg constructor may
* provide better performance.</p>
*
* @param in the InputStream from which this object should be created
* @param mode the strategy to use
* @param props Pack200 properties to use
* @throws IOException if reading fails
*/
public Pack200CompressorInputStream(final InputStream in,
final Pack200Strategy mode,
final Map<String, String> props)
throws IOException {
this(in, null, mode, props);
}
Decompresses the given file, caching the decompressed data in
memory.
Params: - f – the file to decompress
Throws: - IOException – if reading fails
/**
* Decompresses the given file, caching the decompressed data in
* memory.
*
* @param f the file to decompress
* @throws IOException if reading fails
*/
public Pack200CompressorInputStream(final File f) throws IOException {
this(f, Pack200Strategy.IN_MEMORY);
}
Decompresses the given file using the given strategy to cache
the results.
Params: - f – the file to decompress
- mode – the strategy to use
Throws: - IOException – if reading fails
/**
* Decompresses the given file using the given strategy to cache
* the results.
*
* @param f the file to decompress
* @param mode the strategy to use
* @throws IOException if reading fails
*/
public Pack200CompressorInputStream(final File f, final Pack200Strategy mode)
throws IOException {
this(null, f, mode, null);
}
Decompresses the given file, caching the decompressed data in
memory and using the given properties.
Params: - f – the file to decompress
- props – Pack200 properties to use
Throws: - IOException – if reading fails
/**
* Decompresses the given file, caching the decompressed data in
* memory and using the given properties.
*
* @param f the file to decompress
* @param props Pack200 properties to use
* @throws IOException if reading fails
*/
public Pack200CompressorInputStream(final File f,
final Map<String, String> props)
throws IOException {
this(f, Pack200Strategy.IN_MEMORY, props);
}
Decompresses the given file using the given strategy to cache
the results and the given properties.
Params: - f – the file to decompress
- mode – the strategy to use
- props – Pack200 properties to use
Throws: - IOException – if reading fails
/**
* Decompresses the given file using the given strategy to cache
* the results and the given properties.
*
* @param f the file to decompress
* @param mode the strategy to use
* @param props Pack200 properties to use
* @throws IOException if reading fails
*/
public Pack200CompressorInputStream(final File f, final Pack200Strategy mode,
final Map<String, String> props)
throws IOException {
this(null, f, mode, props);
}
private Pack200CompressorInputStream(final InputStream in, final File f,
final Pack200Strategy mode,
final Map<String, String> props)
throws IOException {
originalInput = in;
streamBridge = mode.newStreamBridge();
try (final JarOutputStream jarOut = new JarOutputStream(streamBridge)) {
final Pack200.Unpacker u = Pack200.newUnpacker();
if (props != null) {
u.properties().putAll(props);
}
if (f == null) {
// unpack would close this stream but we
// want to give the user code more control
u.unpack(new CloseShieldFilterInputStream(in), jarOut);
} else {
u.unpack(f, jarOut);
}
}
}
@Override
public int read() throws IOException {
return streamBridge.getInput().read();
}
@Override
public int read(final byte[] b) throws IOException {
return streamBridge.getInput().read(b);
}
@Override
public int read(final byte[] b, final int off, final int count) throws IOException {
return streamBridge.getInput().read(b, off, count);
}
@Override
public int available() throws IOException {
return streamBridge.getInput().available();
}
@Override
public boolean markSupported() {
try {
return streamBridge.getInput().markSupported();
} catch (final IOException ex) { // NOSONAR
return false;
}
}
@Override
public synchronized void mark(final int limit) {
try {
streamBridge.getInput().mark(limit);
} catch (final IOException ex) {
throw new RuntimeException(ex); //NOSONAR
}
}
@Override
public synchronized void reset() throws IOException {
streamBridge.getInput().reset();
}
@Override
public long skip(final long count) throws IOException {
return IOUtils.skip(streamBridge.getInput(), count);
}
@Override
public void close() throws IOException {
try {
streamBridge.stop();
} finally {
if (originalInput != null) {
originalInput.close();
}
}
}
private static final byte[] CAFE_DOOD = new byte[] {
(byte) 0xCA, (byte) 0xFE, (byte) 0xD0, (byte) 0x0D
};
private static final int SIG_LENGTH = CAFE_DOOD.length;
Checks if the signature matches what is expected for a pack200
file (0xCAFED00D).
Params: - signature –
the bytes to check
- length –
the number of bytes to check
Returns: true, if this stream is a pack200 compressed stream,
false otherwise
/**
* Checks if the signature matches what is expected for a pack200
* file (0xCAFED00D).
*
* @param signature
* the bytes to check
* @param length
* the number of bytes to check
* @return true, if this stream is a pack200 compressed stream,
* false otherwise
*/
public static boolean matches(final byte[] signature, final int length) {
if (length < SIG_LENGTH) {
return false;
}
for (int i = 0; i < SIG_LENGTH; i++) {
if (signature[i] != CAFE_DOOD[i]) {
return false;
}
}
return true;
}
}