alluxio.client.block.stream

Class BlockOutStream

java.lang.Object

java.io.OutputStream

alluxio.client.block.stream.BlockOutStream

All Implemented Interfaces:

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

Direct Known Subclasses:

UnderFileSystemFileOutStream

@NotThreadSafe
public class BlockOutStream
extends java.io.OutputStream
implements BoundedStream, Cancelable

Provides an OutputStream implementation that is based on DataWriter which streams data chunk by chunk.

Constructor Summary

Constructors

Modifier	Constructor and Description
	BlockOutStream(DataWriter dataWriter, long length, WorkerNetAddress address) Constructs a new BlockOutStream with only one DataWriter.
protected	BlockOutStream(java.util.List<DataWriter> dataWriters, long length, java.util.List<WorkerNetAddress> workerNetAddresses) Constructs a new BlockOutStream with only one DataWriter.

Method Summary

Modifier and Type	Method and Description
void	cancel() Cancels an operation.
void	close()
static BlockOutStream	createReplicatedBlockOutStream(FileSystemContext context, long blockId, long blockSize, java.util.List<WorkerNetAddress> workerNetAddresses, OutStreamOptions options) Creates a new remote block output stream.
void	flush()
WorkerNetAddress	getAddress()
long	remaining()
void	write(byte[] b)
void	write(byte[] b, int off, int len)
void	write(io.netty.buffer.ByteBuf buf) Writes the data in the specified byte buf to this output stream.
void	write(io.netty.buffer.ByteBuf buf, int off, int len) Writes len bytes from the specified byte buf starting at offset off to this output stream.
void	write(int b)

Methods inherited from class java.lang.Object

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

Constructor Detail

BlockOutStream

public BlockOutStream(DataWriter dataWriter,
                      long length,
                      WorkerNetAddress address)

Constructs a new BlockOutStream with only one DataWriter.

Parameters:

dataWriter - the data writer

length - the length of the stream

address - the Alluxio worker address

BlockOutStream

protected BlockOutStream(java.util.List<DataWriter> dataWriters,
                         long length,
                         java.util.List<WorkerNetAddress> workerNetAddresses)

Constructs a new BlockOutStream with only one DataWriter.

Parameters:

dataWriters - the data writer

length - the length of the stream

workerNetAddresses - the worker network addresses

Method Detail

remaining

public long remaining()

Specified by:

remaining in interface BoundedStream

Returns:

the remaining size of the block

createReplicatedBlockOutStream

public static BlockOutStream createReplicatedBlockOutStream(FileSystemContext context,
                                                            long blockId,
                                                            long blockSize,
                                                            java.util.List<WorkerNetAddress> workerNetAddresses,
                                                            OutStreamOptions options)
                                                     throws java.io.IOException

Creates a new remote block output stream.

Parameters:

context - the file system context

blockId - the block id

blockSize - the block size

workerNetAddresses - the worker network addresses

options - the options

Returns:

the BlockOutStream instance created

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

write

public void write(io.netty.buffer.ByteBuf buf)
           throws java.io.IOException

Writes the data in the specified byte buf to this output stream.

Parameters:

buf - the buffer

Throws:

java.io.IOException - exception

write

public void write(io.netty.buffer.ByteBuf buf,
                  int off,
                  int len)
           throws java.io.IOException

Writes len bytes from the specified byte buf starting at offset off to this output stream.

Parameters:

buf - the buffer

off - the offset

len - the length

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

cancel

public void cancel()
            throws java.io.IOException

Description copied from interface: Cancelable

Cancels an operation.

Specified by:

cancel in interface Cancelable

Throws:

java.io.IOException

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

getAddress

public WorkerNetAddress getAddress()

Returns:

the worker address for this stream