org.eclipse.osgi.framework.internal.reliablefile
Class ReliableFileOutputStream

java.lang.Object
  java.io.OutputStream
      java.io.FilterOutputStream
          org.eclipse.osgi.framework.internal.reliablefile.ReliableFileOutputStream

All Implemented Interfaces:

Closeable, Flushable

public class ReliableFileOutputStream
extends FilterOutputStream

A ReliableFile FileOutputStream replacement class. This class can be used just like FileOutputStream. The class is in partnership with ReliableFileInputStream to avoid losing file data by using multiple files.

See Also:

ReliableFileInputStream

Field Summary

Fields inherited from class java.io.FilterOutputStream

out

Constructor Summary

ReliableFileOutputStream(File file)
Constructs a new ReliableFileOutputStream on the File file.

ReliableFileOutputStream(File file, boolean append)
Constructs a new ReliableFileOutputStream on the File file.

ReliableFileOutputStream(String name)
Constructs a new ReliableFileOutputStream on the file named name.

ReliableFileOutputStream(String name, boolean append)
Constructs a new ReliableFileOutputStream on the file named name.

Method Summary

void	abort()
void	close() Closes this output stream and releases any system resources associated with this stream.
File	closeIntermediateFile()
void	write(byte[] b) Override default FilterOutputStream method.
void	write(byte[] b, int off, int len) Override default FilterOutputStream method.
void	write(int b) Override default FilterOutputStream method.

Methods inherited from class java.io.FilterOutputStream

flush

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

ReliableFileOutputStream

public ReliableFileOutputStream(File file)
                         throws IOException

Constructs a new ReliableFileOutputStream on the File file. If the file exists, it is written over. See the constructor which can append to the file if so desired.

Parameters:

file - the File on which to stream reads.

Throws:

IOException - If an error occurs opening the file.

ReliableFileOutputStream

public ReliableFileOutputStream(File file,
                                boolean append)
                         throws IOException

Constructs a new ReliableFileOutputStream on the File file.

Parameters:

file - the File on which to stream reads.

append - a boolean indicating whether or not to append to an existing file.

Throws:

IOException - If an error occurs opening the file.

ReliableFileOutputStream

public ReliableFileOutputStream(String name)
                         throws IOException

Constructs a new ReliableFileOutputStream on the file named name. If the file exists, it is written over. See the constructor which can append to the file if so desired. The name may be absolute or relative to the System property "user.dir".

Parameters:

name - the file on which to stream writes.

Throws:

IOException - If an error occurs opening the file.

ReliableFileOutputStream

public ReliableFileOutputStream(String name,
                                boolean append)
                         throws IOException

Constructs a new ReliableFileOutputStream on the file named name. The name may be absolute or relative to the System property "user.dir".

Parameters:

name - the file on which to stream writes.

append - a boolean indicating whether or not to append to an existing file.

Throws:

IOException - If an error occurs opening the file.

Method Detail

close

public void close()
           throws IOException

Closes this output stream and releases any system resources associated with this stream. The general contract of close is that it closes the output stream. A closed stream cannot perform output operations and cannot be reopened.

Specified by:

close in interface Closeable

Overrides:

close in class FilterOutputStream

Throws:

IOException - If an error occurs closing the file.

closeIntermediateFile

public File closeIntermediateFile()
                           throws IOException

Throws:

IOException

write

public void write(byte[] b)
           throws IOException

Override default FilterOutputStream method.

Overrides:

write in class FilterOutputStream

Throws:

IOException

See Also:

FilterOutputStream.write(byte[])

write

public void write(byte[] b,
                  int off,
                  int len)
           throws IOException

Override default FilterOutputStream method.

Overrides:

write in class FilterOutputStream

Throws:

IOException

See Also:

FilterOutputStream.write(byte[], int, int)

write

public void write(int b)
           throws IOException

Override default FilterOutputStream method.

Overrides:

write in class FilterOutputStream

Throws:

IOException

See Also:

FilterOutputStream.write(int)

abort

public void abort()