@Immutable public final class TFileOutputStream extends DecoratingOutputStream
FileOutputStream
for writing plain old
files or entries in an archive file.
Mind that applications cannot write archive files directly - just their
entries!
To prevent exceptions to be thrown subsequently, applications should always close their streams using the following idiom:
TFileOutputStream out = new TFileOutputStream(file);
try {
// Do I/O here...
} finally {
out.close(); // ALWAYS close the stream!
}
Note that the DecoratingOutputStream.close()
method may throw an IOException
, too.
Applications need to deal with this appropriately, for example by enclosing
the entire block with another try-catch
-block:
try {
TFileOutputStream out = new TFileOutputStream(file);
try {
// Do I/O here...
} finally {
out.close(); // ALWAYS close the stream!
}
} catch (IOException ex) {
ex.printStackTrace();
}
Applications cannot write to an entry in an archive file if an implicit
unmount
is required but cannot get performed because
another TFileInputStream
or TFileOutputStream
object hasn't
been closed or garbage collected yet.
A FileNotFoundException
is thrown by the constructors of this class
in this case.
If you would like to use this class in order to cp files,
please consider using one of the
cp methods of the class TFile
instead.
These methods provide ease of use, enhanced features, superior performance
and require less space in the temp file folder.
TFile.cat(InputStream, OutputStream)
,
TConfig.setLenient(boolean)
,
TFileInputStream
delegate
Constructor and Description |
---|
TFileOutputStream(File file)
Constructs a new output stream for writing plain old files or entries
in an archive file.
|
TFileOutputStream(File file,
boolean append)
Constructs a new output stream for writing plain old files or entries
in an archive file.
|
TFileOutputStream(String path)
Constructs a new output stream for writing plain old files or entries
in an archive file.
|
TFileOutputStream(String path,
boolean append)
Constructs a new output stream for writing plain old files or entries
in an archive file.
|
@CreatesObligation public TFileOutputStream(File file) throws FileNotFoundException
file
- the plain old file or entry in an archive file to write.FileNotFoundException
- on any I/O failure.@CreatesObligation public TFileOutputStream(File file, boolean append) throws FileNotFoundException
file
- the plain old file or entry in an archive file to write.append
- if the data shall get appended to the file rather than
replacing it.FileNotFoundException
- on any I/O failure.@CreatesObligation public TFileOutputStream(String path) throws FileNotFoundException
new TFile(path)
for
the given path.path
- the path of the plain old file or entry in an archive file
to write.FileNotFoundException
- on any I/O failure.@CreatesObligation public TFileOutputStream(String path, boolean append) throws FileNotFoundException
new TFile(path)
for
the given path.path
- the path of the plain old file or entry in an archive file
to write.append
- if the data shall get appended to the file rather than
replacing it.FileNotFoundException
- on any I/O failure.Copyright © 2005–2018 Schlichtherle IT Services. All rights reserved.