com.emc.ecs.nfsclient.nfs.io

Class NfsFileOutputStream

java.lang.Object

java.io.OutputStream

com.emc.ecs.nfsclient.nfs.io.NfsFileOutputStream

All Implemented Interfaces:

java.io.Closeable, java.io.Flushable, java.lang.AutoCloseable

public class NfsFileOutputStream
extends java.io.OutputStream

The NFS equivalent of java.io.FileOutputStream.

Constructor Summary

Constructors

Constructor and Description
NfsFileOutputStream(NfsFile<?,?> nfsFile) Creates a file output stream to write to the file represented by the specified NfsFile object, starting at offset = 0 and using syncType = FILE_SYNC (commit all data and metadata to stable storage before returning).
NfsFileOutputStream(NfsFile<?,?> nfsFile, int syncType) Creates a file output stream to write to the file represented by the specified NfsFile object, starting at offset = 0 and using syncType behavior.
NfsFileOutputStream(NfsFile<?,?> nfsFile, long offset, int syncType) Creates a file output stream to write to the file represented by the specified NfsFile object, starting at offset and using syncType behavior.

Method Summary

Modifier and Type	Method and Description
void	close()
void	flush()
void	write(byte[] b)
void	write(byte[] b, int off, int len)
void	write(int b)

Methods inherited from class java.lang.Object

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

Constructor Detail

NfsFileOutputStream

public NfsFileOutputStream(NfsFile<?,?> nfsFile)
                    throws java.io.IOException

Creates a file output stream to write to the file represented by the specified NfsFile object, starting at offset = 0 and using syncType = FILE_SYNC (commit all data and metadata to stable storage before returning).

If the file does not exist, it will first be created.

Parameters:

nfsFile - The file to be opened for writing.

Throws:

java.io.IOException - If the file exists but is a directory rather than a regular file, does not exist but cannot be created, or cannot be opened for any other reason

NfsFileOutputStream

public NfsFileOutputStream(NfsFile<?,?> nfsFile,
                           int syncType)
                    throws java.io.IOException

Creates a file output stream to write to the file represented by the specified NfsFile object, starting at offset = 0 and using syncType behavior.

If the file does not exist, it will first be created.

Parameters:

nfsFile - The file to be opened for writing.

syncType - One of the values below.

• UNSTABLE = 0 - Best effort, no promises.
• DATA_SYNC = 1 - Commit all data to stable storage, plus enough metadata for retrieval, before returning.
• FILE_SYNC = 2 - Commit all data and metadata to stable storage before returning.

Throws:

java.io.IOException - If the file exists but is a directory rather than a regular file, does not exist but cannot be created, or cannot be opened for any other reason

NfsFileOutputStream

public NfsFileOutputStream(NfsFile<?,?> nfsFile,
                           long offset,
                           int syncType)
                    throws java.io.IOException

Creates a file output stream to write to the file represented by the specified NfsFile object, starting at offset and using syncType behavior.

If the file does not exist, it will first be created.

Parameters:

nfsFile - The file to be opened for writing.

offset - Where to start writing to the file.

syncType - One of the values below.

• UNSTABLE = 0 - Best effort, no promises.
• DATA_SYNC = 1 - Commit all data to stable storage, plus enough metadata for retrieval, before returning.
• FILE_SYNC = 2 - Commit all data and metadata to stable storage before returning.

Throws:

java.io.IOException - If the file exists but is a directory rather than a regular file, does not exist but cannot be created, or cannot be opened for any other reason

Method Detail

close

public void close()
           throws java.io.IOException

Specified by:

close in interface java.io.Closeable

Specified by:

close in interface java.lang.AutoCloseable

Overrides:

close in class java.io.OutputStream

Throws:

java.io.IOException

flush

public void flush()
           throws java.io.IOException

Specified by:

flush in interface java.io.Flushable

Overrides:

flush in class java.io.OutputStream

Throws:

java.io.IOException

write

public void write(int b)
           throws java.io.IOException

Specified by:

write in class java.io.OutputStream

Throws:

java.io.IOException

write

public void write(byte[] b)
           throws java.io.IOException

Overrides:

write in class java.io.OutputStream

Throws:

java.io.IOException

write

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

Overrides:

write in class java.io.OutputStream

Throws:

java.io.IOException