Package 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:

java.io.Closeable, java.io.DataOutput, java.io.Flushable, java.lang.AutoCloseable, Abortable, CanSetDropBehind, IOStatisticsSource, StreamCapabilities, Syncable

Direct Known Subclasses:

CryptoFSDataOutputStream

@Public
@Stable
public class FSDataOutputStream
extends java.io.DataOutputStream
implements Syncable, CanSetDropBehind, StreamCapabilities, IOStatisticsSource, Abortable

Utility that wraps a OutputStream in a DataOutputStream.

Nested Class Summary

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

Abortable.AbortableResult

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

ABORTABLE_STREAM, DROPBEHIND, HFLUSH, HSYNC, IOSTATISTICS, IOSTATISTICS_CONTEXT, PREADBYTEBUFFER, READAHEAD, READBYTEBUFFER, UNBUFFER, VECTOREDIO

Constructor Summary

Constructors

Constructor	Description
FSDataOutputStream(java.io.OutputStream out, FileSystem.Statistics stats)
FSDataOutputStream(java.io.OutputStream out, FileSystem.Statistics stats, long startPosition)

Method Summary

Modifier and Type	Method	Description
Abortable.AbortableResult	abort()	Invoke abort() on the wrapped stream if it is Abortable, otherwise raise an UnsupportedOperationException.
void	close()	Close the underlying output stream.
long[]	getFidServers()
IOStatistics	getIOStatistics()	Get the IO Statistics of the nested stream, falling back to empty statistics if the stream does not implement the interface IOStatisticsSource.
long	getPos()	Get the current position in the output stream.
java.io.OutputStream	getWrappedStream()	Get a reference to the wrapped output stream.
boolean	hasCapability(java.lang.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	seek(long pos)
void	setDropBehind(java.lang.Boolean dropBehind)	Configure whether the stream should drop the cache.
void	sync()	Deprecated.
java.lang.String	toString()

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.io.OutputStream

nullOutputStream

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.io.DataOutput

write

Constructor Detail

FSDataOutputStream

public FSDataOutputStream(java.io.OutputStream out,
                          FileSystem.Statistics stats)

FSDataOutputStream

public FSDataOutputStream(java.io.OutputStream out,
                          FileSystem.Statistics stats,
                          long startPosition)

Method Detail

getPos

public long getPos()

Get the current position in the output stream.

Returns:

the current position in the output stream

close

public void close()
           throws java.io.IOException

Close the underlying output stream.

Specified by:

close in interface java.lang.AutoCloseable

Specified by:

close in interface java.io.Closeable

Overrides:

close in class java.io.FilterOutputStream

Throws:

java.io.IOException

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object

getWrappedStream

@LimitedPrivate("HDFS")
public java.io.OutputStream getWrappedStream()

Get a reference to the wrapped output stream.

Returns:

the underlying output stream

hasCapability

public boolean hasCapability(java.lang.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 java.io.IOException

Deprecated.

Specified by:

sync in interface Syncable

Throws:

java.io.IOException

See Also:

Syncable.hflush()

hflush

public void hflush()
            throws java.io.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:

java.io.IOException - if any error occurs

hsync

public void hsync()
           throws java.io.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:

java.io.IOException - if error occurs

setDropBehind

public void setDropBehind(java.lang.Boolean dropBehind)
                   throws java.io.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:

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

getIOStatistics

public IOStatistics getIOStatistics()

Get the IO Statistics of the nested stream, falling back to empty statistics if the stream does not implement the interface IOStatisticsSource.

Specified by:

getIOStatistics in interface IOStatisticsSource

Returns:

an IOStatistics instance.

abort

public Abortable.AbortableResult abort()

Invoke abort() on the wrapped stream if it is Abortable, otherwise raise an UnsupportedOperationException.

Specified by:

abort in interface Abortable

Returns:

the result.

Throws:

java.lang.UnsupportedOperationException - if not available.

getFidServers

public long[] getFidServers()
                     throws java.io.IOException

Throws:

java.io.IOException

seek

public void seek(long pos)
          throws java.io.IOException

Throws:

java.io.IOException