com.fr.third.jgroups.util

类 BlockingInputStream

java.lang.Object

java.io.InputStream

com.fr.third.jgroups.util.BlockingInputStream

所有已实现的接口:

java.io.Closeable, java.lang.AutoCloseable

public class BlockingInputStream
extends java.io.InputStream

Bounded input stream. A consumer reads bytes until the end of the stream is reached, or the input stream is closed. The producer writes bytes to the tail and blocks if the capacity has been reached (until the consumer reads more bytes).

This class is for only 1 producer and 1 consumer; multiple producers/consumers will most likely yield incorrect results !

Note that the implementation of this class is optimized for reading and adding a few K at a time; performance will be suboptimal if single bytes are added and read.

从以下版本开始:

2.12.2

作者:

Bela Ban

字段概要

字段

限定符和类型	字段和说明
protected byte[]	buf The transfer buffer
protected boolean	closed Set to true when close() is called
protected java.util.concurrent.locks.Lock	lock
protected java.util.concurrent.locks.Condition	not_empty Signalled when the buf becomes 'readable'; ie. is not empty anymore
protected java.util.concurrent.locks.Condition	not_full Signalled when the buf becomes 'writeable'; ie. is not full anymore
protected int	read_pos Index into buf at which the next bytes will be read.
protected int	write_pos Index into buf at which bytes will be written.

构造器概要

构造器

构造器和说明
BlockingInputStream()
BlockingInputStream(int capacity)

方法概要

方法

限定符和类型	方法和说明
int	available()
int	capacity()
void	close() Closes the stream.
protected void	compact() Moves the bytes between [read_pos and write_pos] read_pos bytes to the left, such that the new read_pos is 0 and the write_pos is write_pos - read_pos.
boolean	isClosed()
int	read()
int	read(byte[] b)
int	read(byte[] b, int off, int len)
protected int	remaining()
protected static void	sanityCheck(byte[] buf, int offset, int length) Verifies that length doesn't exceed a buffer's length
protected int	size()
long	skip(long n)
java.lang.String	toString()
void	write(byte[] buf) Appends bytes to the end of the stream
void	write(byte[] buf, int offset, int length) Appends bytes to the end of the stream.

从类继承的方法 java.io.InputStream

mark, markSupported, reset

从类继承的方法 java.lang.Object

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

字段详细资料

closed

protected boolean closed

Set to true when close() is called

buf

protected final byte[] buf

The transfer buffer

read_pos

protected int read_pos

Index into buf at which the next bytes will be read. Has to be between 0 and buf.length-1

write_pos

protected int write_pos

Index into buf at which bytes will be written. Has to be between 0 and buf.length-1

lock

protected final java.util.concurrent.locks.Lock lock

not_full

protected final java.util.concurrent.locks.Condition not_full

Signalled when the buf becomes 'writeable'; ie. is not full anymore

not_empty

protected final java.util.concurrent.locks.Condition not_empty

Signalled when the buf becomes 'readable'; ie. is not empty anymore

构造器详细资料

BlockingInputStream

public BlockingInputStream()

BlockingInputStream

public BlockingInputStream(int capacity)

方法详细资料

read

public int read()
         throws java.io.IOException

指定者:

read 在类中 java.io.InputStream

抛出:

java.io.IOException

read

public int read(byte[] b)
         throws java.io.IOException

覆盖:

read 在类中 java.io.InputStream

抛出:

java.io.IOException

read

public int read(byte[] b,
       int off,
       int len)
         throws java.io.IOException

覆盖:

read 在类中 java.io.InputStream

抛出:

java.io.IOException

write

public void write(byte[] buf)
           throws java.io.IOException

Appends bytes to the end of the stream

参数:

buf -

抛出:

java.io.IOException

另请参阅:

write(byte[], int, int)

write

public void write(byte[] buf,
         int offset,
         int length)
           throws java.io.IOException

Appends bytes to the end of the stream. If the number of bytes to be written is greater than the remaining capacity, write() will block until the bytes can be added, or the stream is closed.

This method will try to append partial buffers to the stream, e.g. if the remaining capacity is 2K, but the length of the buffer is 5K, 2K will be written and then write() will block until the remaining 3K can be added.

参数:

buf - The buffer to be added to the end of the stream

offset - The offset within buf at which bytes are read

length - The number of bytes to be added

抛出:

java.io.IOException

skip

public long skip(long n)
          throws java.io.IOException

覆盖:

skip 在类中 java.io.InputStream

抛出:

java.io.IOException

available

public int available()
              throws java.io.IOException

覆盖:

available 在类中 java.io.InputStream

抛出:

java.io.IOException

capacity

public int capacity()

close

public void close()
           throws java.io.IOException

Closes the stream. Writes to a closed stream will fail, reads will successfully read the bytes that are already in the buffer and then return -1 (EOF)

指定者:

close 在接口中 java.io.Closeable

指定者:

close 在接口中 java.lang.AutoCloseable

覆盖:

close 在类中 java.io.InputStream

抛出:

java.io.IOException

isClosed

public boolean isClosed()

toString

public java.lang.String toString()

覆盖:

toString 在类中 java.lang.Object

size

protected int size()

remaining

protected int remaining()

compact

protected void compact()

Moves the bytes between [read_pos and write_pos] read_pos bytes to the left, such that the new read_pos is 0 and the write_pos is write_pos - read_pos. Lock must be held.

sanityCheck

protected static void sanityCheck(byte[] buf,
               int offset,
               int length)

Verifies that length doesn't exceed a buffer's length

参数:

buf -

offset -

length -