alluxio.underfs

Class AtomicFileOutputStream

java.lang.Object

java.io.OutputStream

alluxio.underfs.AtomicFileOutputStream

All Implemented Interfaces:

ContentHashable, Closeable, Flushable, AutoCloseable

@NotThreadSafe
public class AtomicFileOutputStream
extends OutputStream
implements ContentHashable

A AtomicFileOutputStream writes to a temporary file and renames on close. This ensures that writing to the stream is atomic, i.e., all writes become readable only after a close.

Constructor Summary

Constructors

Constructor and Description
AtomicFileOutputStream(String path, AtomicFileOutputStreamCallback ufs, CreateOptions options) Constructs a new AtomicFileOutputStream.

Method Summary

Modifier and Type	Method and Description
void	close()
Optional<String>	getContentHash()
void	write(byte[] b)
void	write(byte[] b, int off, int len)
void	write(int b)

Methods inherited from class java.io.OutputStream

flush

Methods inherited from class java.lang.Object

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

Constructor Detail

AtomicFileOutputStream

public AtomicFileOutputStream(String path,
                              AtomicFileOutputStreamCallback ufs,
                              CreateOptions options)
                       throws IOException

Constructs a new AtomicFileOutputStream.

Parameters:

path - path being written to

ufs - the calling UnderFileSystem

options - create options for destination file

Throws:

IOException

Method Detail

write

public void write(int b)
           throws IOException

Specified by:

write in class OutputStream

Throws:

IOException

write

public void write(byte[] b)
           throws IOException

Overrides:

write in class OutputStream

Throws:

IOException

write

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

Overrides:

write in class OutputStream

Throws:

IOException

close

public void close()
           throws IOException

Specified by:

close in interface Closeable

Specified by:

close in interface AutoCloseable

Overrides:

close in class OutputStream

Throws:

IOException

getContentHash

public Optional<String> getContentHash()
                                throws IOException

Specified by:

getContentHash in interface ContentHashable

Returns:

the content hash of the file written to the UFS if available after the stream has been closed

Throws:

IOException