org.apache.hadoop.fs

Class FSDataOutputStream

java.lang.Object

java.io.OutputStream

java.io.FilterOutputStream

java.io.DataOutputStream

org.apache.hadoop.fs.FSDataOutputStream

All Implemented Interfaces:

Closeable, DataOutput, Flushable, AutoCloseable, CanSetDropBehind, StreamCapabilities, Syncable

Direct Known Subclasses:

CryptoFSDataOutputStream

@InterfaceAudience.Public
@InterfaceStability.Stable
public class FSDataOutputStream
extends DataOutputStream
implements Syncable, CanSetDropBehind, StreamCapabilities

Utility that wraps a OutputStream in a DataOutputStream.

Nested Class Summary

Nested classes/interfaces inherited from interface org.apache.hadoop.fs.StreamCapabilities

StreamCapabilities.StreamCapability

Field Summary

Fields inherited from class java.io.DataOutputStream

written

Fields inherited from class java.io.FilterOutputStream

out

Fields inherited from interface org.apache.hadoop.fs.StreamCapabilities

DROPBEHIND, HFLUSH, HSYNC, PREADBYTEBUFFER, READAHEAD, READBYTEBUFFER, UNBUFFER

Constructor Summary

Constructors

Constructor and Description
FSDataOutputStream(OutputStream out) Deprecated.
FSDataOutputStream(OutputStream out, FileSystem.Statistics stats)
FSDataOutputStream(OutputStream out, FileSystem.Statistics stats, long startPosition)

Method Summary

Methods

Modifier and Type	Method and Description
void	close() Close the underlying output stream.
long	getPos() Get the current position in the output stream.
boolean	hasCapability(String capability) Query the stream for a specific capability.
void	hflush() Flush out the data in client's user buffer.
void	hsync() Similar to posix fsync, flush out the data in client's user buffer all the way to the disk device (but the disk may have it in its cache).
void	setDropBehind(Boolean dropBehind) Configure whether the stream should drop the cache.
void	sync() Deprecated.

Methods inherited from class java.io.DataOutputStream

flush, size, write, write, writeBoolean, writeByte, writeBytes, writeChar, writeChars, writeDouble, writeFloat, writeInt, writeLong, writeShort, writeUTF

Methods inherited from class java.io.FilterOutputStream

write

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.io.DataOutput

write

Constructor Detail

FSDataOutputStream

@Deprecated
public FSDataOutputStream(OutputStream out)
                   throws IOException

Deprecated.

Throws:

IOException

FSDataOutputStream

public FSDataOutputStream(OutputStream out,
                  FileSystem.Statistics stats)
                   throws IOException

Throws:

IOException

FSDataOutputStream

public FSDataOutputStream(OutputStream out,
                  FileSystem.Statistics stats,
                  long startPosition)
                   throws IOException

Throws:

IOException

Method Detail

getPos

public long getPos()
            throws IOException

Get the current position in the output stream.

Returns:

the current position in the output stream

Throws:

IOException

close

public void close()
           throws IOException

Close the underlying output stream.

Specified by:

close in interface Closeable

Specified by:

close in interface AutoCloseable

Overrides:

close in class FilterOutputStream

Throws:

IOException

hasCapability

public boolean hasCapability(String capability)

Description copied from interface: StreamCapabilities

Query the stream for a specific capability.

Specified by:

hasCapability in interface StreamCapabilities

Parameters:

capability - string to query the stream support for.

Returns:

True if the stream supports capability.

sync

@Deprecated
public void sync()
          throws IOException

Deprecated.

Specified by:

sync in interface Syncable

Throws:

IOException

See Also:

Syncable.hflush()

hflush

public void hflush()
            throws IOException

Description copied from interface: Syncable

Flush out the data in client's user buffer. After the return of this call, new readers will see the data.

Specified by:

hflush in interface Syncable

Throws:

IOException - if any error occurs

hsync

public void hsync()
           throws IOException

Description copied from interface: Syncable

Similar to posix fsync, flush out the data in client's user buffer all the way to the disk device (but the disk may have it in its cache).

Specified by:

hsync in interface Syncable

Throws:

IOException - if error occurs

setDropBehind

public void setDropBehind(Boolean dropBehind)
                   throws IOException

Description copied from interface: CanSetDropBehind

Configure whether the stream should drop the cache.

Specified by:

setDropBehind in interface CanSetDropBehind

Parameters:

dropBehind - Whether to drop the cache. null means to use the default value.

Throws:

IOException - If there was an error changing the dropBehind setting. UnsupportedOperationException If this stream doesn't support setting the drop-behind.