Class BoundaryByteSupplier

java.lang.Object

cool.scx.io.supplier.BoundaryByteSupplier

All Implemented Interfaces:

ByteSupplier, AutoCloseable

public final class BoundaryByteSupplier
extends Object
implements ByteSupplier

BoundaryByteSupplier

Version:

0.0.1

Author:

scx567888

Constructor Summary

Constructors

Constructor	Description
BoundaryByteSupplier(ByteInput byteInput, ByteIndexer byteIndexer, boolean keepBoundaryInSource)

Method Summary

Modifier and Type	Method	Description
ByteInput	byteInput()
void	close()	如果持有底层资源, 在此方法释放资源
ByteChunk	get()	获取下一个数据块

Methods inherited from class Object

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

Constructor Details

BoundaryByteSupplier

public BoundaryByteSupplier(ByteInput byteInput,
 ByteIndexer byteIndexer,
 boolean keepBoundaryInSource)

Method Details

get

public ByteChunk get()
              throws AlreadyClosedException,
ScxIOException,
NoMoreDataException

Description copied from interface: ByteSupplier

获取下一个数据块

• 必须是推进式的阻塞拉取
• 如果当前已经读取到有效数据 -> 返回 ByteChunk(len > 0)
• 如果暂时无法输出数据, 但 I/O 状态确实推进了 -> 返回 EMPTY_BYTE_CHUNK
• 如果 EOF 且不会再产生数据 -> 返回 null
• 不允许无状态的空循环: 供应者不得无意义地连续返回 EMPTY_BYTE_CHUNK
• 连续多次调用 get() 必须使底层数据源或解码状态单调推进

Specified by:

get in interface ByteSupplier

Returns:

ByteChunk.

Throws:

AlreadyClosedException

ScxIOException

NoMoreDataException

close

public void close()
           throws ScxIOException,
AlreadyClosedException

Description copied from interface: ByteSupplier

如果持有底层资源, 在此方法释放资源

Specified by:

close in interface AutoCloseable

Specified by:

close in interface ByteSupplier

Throws:

ScxIOException

AlreadyClosedException

byteInput

public ByteInput byteInput()