Class DefaultByteInput

java.lang.Object

cool.scx.io.DefaultByteInput

All Implemented Interfaces:

ByteInput, AutoCloseable

public class DefaultByteInput
extends Object
implements ByteInput

DefaultByteInput

Version:

0.0.1

Author:

scx567888

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
protected static class	DefaultByteInput.ByteChunkNode
protected static final record	DefaultByteInput.DefaultByteInputMark

Field Summary

Fields

Modifier and Type	Field	Description
protected final ByteSupplier	byteSupplier
protected boolean	closed
protected DefaultByteInput.ByteChunkNode	head
protected DefaultByteInput.ByteChunkNode	tail

Constructor Summary

Constructors

Constructor	Description
DefaultByteInput(ByteSupplier byteSupplier)

Method Summary

Modifier and Type	Method	Description
protected void	appendByteChunk(ByteChunk byteChunk)
void	close()	关闭这个流, 此方法应该是幂等的.
protected long	ensureAvailable()	确保 有数据可用 (至少 1 字节)
protected void	ensureOpen()	确保 open
ByteMatchResult	indexOf(ByteIndexer indexer, long maxLength)	在最多 maxLength 个字节中查找匹配 (或直到 EOF).
protected ByteMatchResult	indexOf0(ByteIndexer indexer, long maxLength, long maxPullCount)
boolean	isClosed()	检测当前流是否关闭
ByteInputMark	mark()	在当前读取位置创建一个标记对象.
byte	peek()	查看字节, 行为参考 ByteInput.read()
<X extends Throwable> void	peek(ByteConsumer<X> byteConsumer, long maxLength)	查看字节, 行为参考 ByteInput.read(ByteConsumer, long)
<X extends Throwable> void	peekFully(ByteConsumer<X> byteConsumer, long length)	查看字节, 行为参考 ByteInput.readFully(ByteConsumer, long)
<X extends Throwable> void	peekUpTo(ByteConsumer<X> byteConsumer, long length)	查看字节, 行为参考 ByteInput.readUpTo(ByteConsumer, long)
protected boolean	pullByteChunk()	从 byteSupplier 中持续拉取直到得到有效数据块
byte	read()	读取单个字节
<X extends Throwable> void	read(ByteConsumer<X> byteConsumer, long maxLength)	最多读取 maxLength 个字节, 可能少于 maxLength (即使尚未遇到 EOF, 如底层缓冲区不足)
protected <X extends Throwable> void	read0(ByteConsumer<X> consumer, long maxLength, boolean movePointer, long maxPullCount, boolean throwOnEOF)	底层 的 read
<X extends Throwable> void	readFully(ByteConsumer<X> byteConsumer, long length)	恰好读取 length 个字节
<X extends Throwable> void	readUpTo(ByteConsumer<X> byteConsumer, long length)	尽量读取 length 个字节, 可能少于 length (仅在 EOF 时发生)

Methods inherited from class Object

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

Methods inherited from interface ByteInput

indexOf, indexOf, indexOf, indexOf, indexOf, peek, peekAll, peekAll, peekFully, peekUntil, peekUntil, peekUntil, peekUntil, peekUntil, peekUntil, peekUpTo, read, readAll, readAll, readFully, readUntil, readUntil, readUntil, readUntil, readUntil, readUntil, readUpTo, skip, skipAll, skipFully, skipUpTo

Field Details

byteSupplier

protected final ByteSupplier byteSupplier

head

protected DefaultByteInput.ByteChunkNode head

tail

protected DefaultByteInput.ByteChunkNode tail

closed

protected volatile boolean closed

Constructor Details

DefaultByteInput

public DefaultByteInput(ByteSupplier byteSupplier)

Method Details

appendByteChunk

protected void appendByteChunk(ByteChunk byteChunk)

pullByteChunk

protected boolean pullByteChunk()
                         throws ScxIOException

从 byteSupplier 中持续拉取直到得到有效数据块

Returns:

EOF

Throws:

ScxIOException

ensureOpen

protected void ensureOpen()
                   throws AlreadyClosedException

确保 open

Throws:

AlreadyClosedException

ensureAvailable

protected long ensureAvailable()
                        throws ScxIOException,
NoMoreDataException

确保 有数据可用 (至少 1 字节)

Returns:

调用了几次底层拉取

Throws:

ScxIOException

NoMoreDataException

read0

protected <X extends Throwable> void read0(ByteConsumer<X> consumer,
 long maxLength,
 boolean movePointer,
 long maxPullCount,
 boolean throwOnEOF)
                                    throws X,
ScxIOException,
NoMoreDataException

底层 的 read

Type Parameters:

X - 用户自定义异常

Parameters:

consumer - 字节消费者

maxLength - 希望读取的字节数

movePointer - 是否移动指针

maxPullCount - 最大允许调用底层 ByteSupplier 的次数

throwOnEOF - 当遇到 EOF (底层数据源结束), 导致实际读取字节数不足时 是否抛异常

Throws:

X - X

ScxIOException

NoMoreDataException

indexOf0

protected ByteMatchResult indexOf0(ByteIndexer indexer,
 long maxLength,
 long maxPullCount)
                            throws NoMatchFoundException,
ScxIOException

Throws:

NoMatchFoundException

ScxIOException

read

public byte read()
          throws ScxIOException,
AlreadyClosedException,
NoMoreDataException

Description copied from interface: ByteInput

读取单个字节

• 如果 当前没有数据可读 (立即遇到 EOF), 则会抛出 NoMoreDataException

Specified by:

read in interface ByteInput

Throws:

ScxIOException

AlreadyClosedException

NoMoreDataException

read

public <X extends Throwable> void read(ByteConsumer<X> byteConsumer,
 long maxLength)
                                throws X,
ScxIOException,
AlreadyClosedException,
NoMoreDataException

Description copied from interface: ByteInput

最多读取 maxLength 个字节, 可能少于 maxLength (即使尚未遇到 EOF, 如底层缓冲区不足)

• 如果 maxLength = 0, 立即返回 (不抛出异常, 即使在 EOF 状态)
• 如果 maxLength > 0, 至少读取 1 个字节.
  • 如果 数据不足 (读取过程中遇到 EOF), 则停止读取
  • 如果 当前没有数据可读 (立即遇到 EOF), 则会抛出 NoMoreDataException

Specified by:

read in interface ByteInput

Throws:

X

ScxIOException

AlreadyClosedException

NoMoreDataException

readUpTo

public <X extends Throwable> void readUpTo(ByteConsumer<X> byteConsumer,
 long length)
                                    throws X,
ScxIOException,
AlreadyClosedException,
NoMoreDataException

Description copied from interface: ByteInput

尽量读取 length 个字节, 可能少于 length (仅在 EOF 时发生)

• 如果 length = 0, 立即返回 (不抛出异常, 即使在 EOF 状态)
• 如果 length > 0, 至少读取 1 个字节.
  • 如果 数据不足 (读取过程中遇到 EOF), 则停止读取
  • 如果 当前没有数据可读 (立即遇到 EOF), 则会抛出 NoMoreDataException

Specified by:

readUpTo in interface ByteInput

Throws:

X

ScxIOException

AlreadyClosedException

NoMoreDataException

readFully

public <X extends Throwable> void readFully(ByteConsumer<X> byteConsumer,
 long length)
                                     throws X,
ScxIOException,
AlreadyClosedException,
NoMoreDataException

Description copied from interface: ByteInput

恰好读取 length 个字节

• 如果 length = 0, 立即返回且不抛出异常 (即使在 EOF 状态)
• 如果 length > 0. 一定读取 length 个字节.
  • 如果 数据不足 (读取过程中遇到 EOF), 则会抛出 NoMoreDataException
  • 如果 当前没有数据可读 (立即遇到 EOF), 则会抛出 NoMoreDataException

Specified by:

readFully in interface ByteInput

Throws:

X

ScxIOException

AlreadyClosedException

NoMoreDataException

peek

public byte peek()
          throws ScxIOException,
AlreadyClosedException,
NoMoreDataException

Description copied from interface: ByteInput

查看字节, 行为参考 ByteInput.read()

Specified by:

peek in interface ByteInput

Throws:

ScxIOException

AlreadyClosedException

NoMoreDataException

peek

public <X extends Throwable> void peek(ByteConsumer<X> byteConsumer,
 long maxLength)
                                throws X,
ScxIOException,
AlreadyClosedException,
NoMoreDataException

Description copied from interface: ByteInput

查看字节, 行为参考 ByteInput.read(ByteConsumer, long)

Specified by:

peek in interface ByteInput

Throws:

X

ScxIOException

AlreadyClosedException

NoMoreDataException

peekUpTo

public <X extends Throwable> void peekUpTo(ByteConsumer<X> byteConsumer,
 long length)
                                    throws X,
ScxIOException,
AlreadyClosedException,
NoMoreDataException

Description copied from interface: ByteInput

查看字节, 行为参考 ByteInput.readUpTo(ByteConsumer, long)

Specified by:

peekUpTo in interface ByteInput

Throws:

X

ScxIOException

AlreadyClosedException

NoMoreDataException

peekFully

public <X extends Throwable> void peekFully(ByteConsumer<X> byteConsumer,
 long length)
                                     throws X,
ScxIOException,
AlreadyClosedException,
NoMoreDataException

Description copied from interface: ByteInput

查看字节, 行为参考 ByteInput.readFully(ByteConsumer, long)

Specified by:

peekFully in interface ByteInput

Throws:

X

ScxIOException

AlreadyClosedException

NoMoreDataException

indexOf

public ByteMatchResult indexOf(ByteIndexer indexer,
 long maxLength)
                        throws NoMatchFoundException,
ScxIOException,
AlreadyClosedException,
NoMoreDataException

Description copied from interface: ByteInput

在最多 maxLength 个字节中查找匹配 (或直到 EOF).

• 如果 indexer 是 空匹配模式. (意味着没有消费数据的能力和意义)
  • 在任意情况下都返回 0. (恒为 0)
• 如果 indexer 不是 空匹配模式.
  • 如果 maxLength = 0, 抛 NoMatchFoundException (恒 NoMatch, 因为这是不可能完成的任务).
  • 如果 maxLength > 0. (正常逻辑)
    • 如果在边界达成条件内仍未匹配到 (如达到 maxLength限制 或 读取过程中遇到 EOF) 抛出 NoMatchFoundException.
    • 如果 当前没有数据可读 (立即遇到 EOF), 则会抛出 NoMoreDataException.

Specified by:

indexOf in interface ByteInput

Throws:

NoMatchFoundException

ScxIOException

AlreadyClosedException

NoMoreDataException

mark

public ByteInputMark mark()
                   throws AlreadyClosedException

Description copied from interface: ByteInput

在当前读取位置创建一个标记对象.

Specified by:

mark in interface ByteInput

Throws:

AlreadyClosedException

isClosed

public boolean isClosed()

Description copied from interface: ByteInput

检测当前流是否关闭

Specified by:

isClosed in interface ByteInput

close

public void close()
           throws ScxIOException

Description copied from interface: ByteInput

关闭这个流, 此方法应该是幂等的.

Specified by:

close in interface AutoCloseable

Specified by:

close in interface ByteInput

Throws:

ScxIOException