Class CpioArchiveOutputStream
java.lang.Object
java.io.OutputStream
org.apache.commons.compress.archivers.ArchiveOutputStream
org.apache.commons.compress.archivers.cpio.CpioArchiveOutputStream
- All Implemented Interfaces:
Closeable
,Flushable
,AutoCloseable
,CpioConstants
CpioArchiveOutputStream is a stream for writing CPIO streams. All formats of
CPIO are supported (old ASCII, old binary, new portable format and the new
portable format with CRC).
An entry can be written by creating an instance of CpioArchiveEntry and fill it with the necessary values and put it into the CPIO stream. Afterwards write the contents of the file into the CPIO stream. Either close the stream by calling finish() or put a next entry into the cpio stream.
CpioArchiveOutputStream out = new CpioArchiveOutputStream( new FileOutputStream(new File("test.cpio"))); CpioArchiveEntry entry = new CpioArchiveEntry(); entry.setName("testfile"); String contents = "12345"; entry.setFileSize(contents.length()); entry.setMode(CpioConstants.C_ISREG); // regular file ... set other attributes, e.g. time, number of links out.putArchiveEntry(entry); out.write(testContents.getBytes()); out.close();
Note: This implementation should be compatible to cpio 2.5
This class uses mutable fields and is not considered threadsafe.
based on code from the jRPM project (jrpm.sourceforge.net)
-
Field Summary
FieldsModifier and TypeFieldDescriptionprivate final int
private boolean
private long
(package private) final String
private CpioArchiveEntry
private final short
SeeCpioArchiveEntry(short)
for possible values.private boolean
indicates if this archive is finishedprivate final HashMap<String,
CpioArchiveEntry> private long
private final OutputStream
private long
private final ZipEncoding
The encoding to use for file names and labels.Fields inherited from interface org.apache.commons.compress.archivers.cpio.CpioConstants
BLOCK_SIZE, C_IRGRP, C_IROTH, C_IRUSR, C_ISBLK, C_ISCHR, C_ISDIR, C_ISFIFO, C_ISGID, C_ISLNK, C_ISNWK, C_ISREG, C_ISSOCK, C_ISUID, C_ISVTX, C_IWGRP, C_IWOTH, C_IWUSR, C_IXGRP, C_IXOTH, C_IXUSR, CPIO_TRAILER, FORMAT_NEW, FORMAT_NEW_CRC, FORMAT_NEW_MASK, FORMAT_OLD_ASCII, FORMAT_OLD_BINARY, FORMAT_OLD_MASK, MAGIC_NEW, MAGIC_NEW_CRC, MAGIC_OLD_ASCII, MAGIC_OLD_BINARY, S_IFMT
-
Constructor Summary
ConstructorsConstructorDescriptionConstruct the cpio output stream.CpioArchiveOutputStream
(OutputStream out, short format) Construct the cpio output stream with a specified format, a blocksize ofBLOCK_SIZE
and using ASCII as the file name encoding.CpioArchiveOutputStream
(OutputStream out, short format, int blockSize) Construct the cpio output stream with a specified format using ASCII as the file name encoding.CpioArchiveOutputStream
(OutputStream out, short format, int blockSize, String encoding) Construct the cpio output stream with a specified format using ASCII as the file name encoding.CpioArchiveOutputStream
(OutputStream out, String encoding) Construct the cpio output stream. -
Method Summary
Modifier and TypeMethodDescriptionvoid
close()
Closes the CPIO output stream as well as the stream being filtered.void
Closes the archive entry, writing any trailer information that may be required.createArchiveEntry
(File inputFile, String entryName) Creates a new ArchiveEntry.createArchiveEntry
(Path inputPath, String entryName, LinkOption... options) Creates a new ArchiveEntry.private byte[]
Encodes the given string using the configured encoding.private void
Check to make sure that this stream has not been closedvoid
finish()
Finishes writing the contents of the CPIO output stream without closing the underlying stream.private void
pad
(int count) void
putArchiveEntry
(ArchiveEntry entry) Begins writing a new CPIO file entry and positions the stream to the start of the entry data.void
write
(byte[] b, int off, int len) Writes an array of bytes to the current CPIO entry data.private void
writeAsciiLong
(long number, int length, int radix) private void
writeBinaryLong
(long number, int length, boolean swapHalfWord) private void
writeCString
(byte[] str) Writes an encoded string to the stream followed by \0private void
private void
writeNewEntry
(CpioArchiveEntry entry) private void
private void
writeOldBinaryEntry
(CpioArchiveEntry entry, boolean swapHalfWord) Methods inherited from class org.apache.commons.compress.archivers.ArchiveOutputStream
canWriteEntryData, count, count, getBytesWritten, getCount, write
Methods inherited from class java.io.OutputStream
flush, write
-
Field Details
-
entry
-
closed
private boolean closed -
finished
private boolean finishedindicates if this archive is finished -
entryFormat
private final short entryFormatSeeCpioArchiveEntry(short)
for possible values. -
names
-
crc
private long crc -
written
private long written -
out
-
blockSize
private final int blockSize -
nextArtificalDeviceAndInode
private long nextArtificalDeviceAndInode -
zipEncoding
The encoding to use for file names and labels. -
encoding
-
-
Constructor Details
-
CpioArchiveOutputStream
Construct the cpio output stream with a specified format, a blocksize ofBLOCK_SIZE
and using ASCII as the file name encoding.- Parameters:
out
- The cpio streamformat
- The format of the stream
-
CpioArchiveOutputStream
Construct the cpio output stream with a specified format using ASCII as the file name encoding.- Parameters:
out
- The cpio streamformat
- The format of the streamblockSize
- The block size of the archive.- Since:
- 1.1
-
CpioArchiveOutputStream
Construct the cpio output stream with a specified format using ASCII as the file name encoding.- Parameters:
out
- The cpio streamformat
- The format of the streamblockSize
- The block size of the archive.encoding
- The encoding of file names to write - use null for the platform's default.- Since:
- 1.6
-
CpioArchiveOutputStream
Construct the cpio output stream. The format for this CPIO stream is the "new" format using ASCII encoding for file names- Parameters:
out
- The cpio stream
-
CpioArchiveOutputStream
Construct the cpio output stream. The format for this CPIO stream is the "new" format.- Parameters:
out
- The cpio streamencoding
- The encoding of file names to write - use null for the platform's default.- Since:
- 1.6
-
-
Method Details
-
ensureOpen
Check to make sure that this stream has not been closed- Throws:
IOException
- if the stream is already closed
-
putArchiveEntry
Begins writing a new CPIO file entry and positions the stream to the start of the entry data. Closes the current entry if still active. The current time will be used if the entry has no set modification time and the default header format will be used if no other format is specified in the entry.- Specified by:
putArchiveEntry
in classArchiveOutputStream
- Parameters:
entry
- the CPIO cpioEntry to be written- Throws:
IOException
- if an I/O error has occurred or if a CPIO file error has occurredClassCastException
- if entry is not an instance of CpioArchiveEntry
-
writeHeader
- Throws:
IOException
-
writeNewEntry
- Throws:
IOException
-
writeOldAsciiEntry
- Throws:
IOException
-
writeOldBinaryEntry
- Throws:
IOException
-
closeArchiveEntry
Description copied from class:ArchiveOutputStream
Closes the archive entry, writing any trailer information that may be required.- Specified by:
closeArchiveEntry
in classArchiveOutputStream
- Throws:
IOException
- if an I/O error occurs
-
write
Writes an array of bytes to the current CPIO entry data. This method will block until all the bytes are written.- Overrides:
write
in classOutputStream
- Parameters:
b
- the data to be writtenoff
- the start offset in the datalen
- the number of bytes that are written- Throws:
IOException
- if an I/O error has occurred or if a CPIO file error has occurred
-
finish
Finishes writing the contents of the CPIO output stream without closing the underlying stream. Use this method when applying multiple filters in succession to the same output stream.- Specified by:
finish
in classArchiveOutputStream
- Throws:
IOException
- if an I/O exception has occurred or if a CPIO file error has occurred
-
close
Closes the CPIO output stream as well as the stream being filtered.- Specified by:
close
in interfaceAutoCloseable
- Specified by:
close
in interfaceCloseable
- Overrides:
close
in classOutputStream
- Throws:
IOException
- if an I/O error has occurred or if a CPIO file error has occurred
-
pad
- Throws:
IOException
-
writeBinaryLong
- Throws:
IOException
-
writeAsciiLong
- Throws:
IOException
-
encode
Encodes the given string using the configured encoding.- Parameters:
str
- the String to write- Returns:
- result of encoding the string
- Throws:
IOException
- if the string couldn't be written
-
writeCString
Writes an encoded string to the stream followed by \0- Parameters:
str
- the String to write- Throws:
IOException
- if the string couldn't be written
-
createArchiveEntry
Creates a new ArchiveEntry. The entryName must be an ASCII encoded string.- Specified by:
createArchiveEntry
in classArchiveOutputStream
- Parameters:
inputFile
- the file to create the entry fromentryName
- name to use for the entry- Returns:
- the ArchiveEntry set up with details from the file
- Throws:
IOException
- if an I/O error occurs- See Also:
-
createArchiveEntry
public ArchiveEntry createArchiveEntry(Path inputPath, String entryName, LinkOption... options) throws IOException Creates a new ArchiveEntry. The entryName must be an ASCII encoded string.- Overrides:
createArchiveEntry
in classArchiveOutputStream
- Parameters:
inputPath
- the file to create the entry fromentryName
- name to use for the entryoptions
- options indicating how symbolic links are handled.- Returns:
- the ArchiveEntry set up with details from the file
- Throws:
IOException
- if an I/O error occurs- See Also:
-