com.aliyun.odps.io

Class DataOutputBuffer

java.lang.Object

java.io.OutputStream

java.io.FilterOutputStream

java.io.DataOutputStream

com.aliyun.odps.io.DataOutputBuffer

All Implemented Interfaces:

Closeable, DataOutput, Flushable, AutoCloseable

public class DataOutputBuffer
extends DataOutputStream

DataOutputBuffer 提供一个可复用的 DataOutput 实现.

DataOutputBuffer 继承自 DataOutputStream，提供了 DataOutput 的实现，DataOutputBuffer 使用内存作为数据输出的缓冲区，并提供 reset() 方法支持对象复用。

代码示例：

 DataOutputBuffer buffer = new DataOutputBuffer();
 while (... loop condition ...) {
   buffer.reset();
   ... write buffer using DataOutput methods ...
   byte[] data = buffer.getData();
   int dataLength = buffer.getLength();
   ... write data to its ultimate destination ...
 }
 

See Also:

Writable.write(DataOutput), DataInputBuffer

Constructor Summary

Constructors

Constructor and Description
DataOutputBuffer() 构造一个空数据输出缓冲区
DataOutputBuffer(int size) 构造一个给定大小的数据输出缓冲区

Method Summary

Modifier and Type	Method and Description
byte[]	getData() 返回输出缓冲区中的数据.
int	getLength() 返回数据缓冲区中的有效数据长度
DataOutputBuffer	reset() 重置缓冲区内容为空并返回
void	write(DataInput in, int length) 从给定 DataInput 中读出数据然后输出到缓冲区.
void	writeTo(OutputStream out) 将输出缓冲区中的内容输出到给定的 OutputStream.

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

close, write

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.io.DataOutput

write

Constructor Detail

DataOutputBuffer

public DataOutputBuffer()

构造一个空数据输出缓冲区

DataOutputBuffer

public DataOutputBuffer(int size)

构造一个给定大小的数据输出缓冲区

Parameters:

size -

Method Detail

getData

public byte[] getData()

返回输出缓冲区中的数据.

注意：返回字节数组中[0, getLength()-1] 中的数据才是有效的。

Returns:

输出缓冲区中的数据

getLength

public int getLength()

返回数据缓冲区中的有效数据长度

Returns:

数据缓冲区中的有效数据长度，单位：字节

reset

public DataOutputBuffer reset()

重置缓冲区内容为空并返回

Returns:

write

public void write(DataInput in,
                  int length)
           throws IOException

从给定 DataInput 中读出数据然后输出到缓冲区.

Parameters:

in - 数据输入 DataInput

length - 读取长度

Throws:

IOException

writeTo

public void writeTo(OutputStream out)
             throws IOException

将输出缓冲区中的内容输出到给定的 OutputStream.

Parameters:

out -

Throws:

IOException