compact1, compact2, compact3

java.io

Class PipedReader

java.lang.Object

java.io.Reader

java.io.PipedReader

All Implemented Interfaces:

Closeable ， AutoCloseable ， Readable

public class PipedReader
extends Reader

流水字符输入流。

从以下版本开始：

JDK1.1

Field Summary

Fields inherited from class java.io.Reader

lock

构造方法摘要

构造方法

Constructor and Description
PipedReader() 创建一个 PipedReader ，所以它还不是 connected 。
PipedReader(int pipeSize) 创建一个 PipedReader ，使其尚未 connected并使用指定的管道大小作为管道的缓冲区。
PipedReader(PipedWriter src) 创建一个 PipedReader ，使其连接到管道写入器 src 。
PipedReader(PipedWriter src, int pipeSize) 创建一个 PipedReader ，使其连接到管道写入器 src ，并使用指定的管道大小作为管道的缓冲区。

方法摘要

Modifier and Type	Method and Description
void	close() 关闭此管道流，并释放与流相关联的任何系统资源。
void	connect(PipedWriter src) 使这个管道读取器连接到管道写入器 src 。
int	read() 从这个管道流读取下一个数据字符。
int	read(char[] cbuf, int off, int len) 从这个管道数据流读取最多 len字符数组。
boolean	ready() 告诉这个流是否准备好阅读。

Methods inherited from class java.io.Reader

mark, markSupported, read, read, reset, skip

Methods inherited from class java.lang.Object

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

构造方法详细信息

PipedReader

public PipedReader(PipedWriter src)
            throws IOException

创建一个PipedReader ，使其连接到管道写入器src 。 写入src数据将作为此流的输入。

参数

src - 要连接的流。

异常

IOException - 如果发生I / O错误。

PipedReader

public PipedReader(PipedWriter src,
                   int pipeSize)
            throws IOException

创建一个PipedReader ，使其连接到管道写入器src ，并为管道缓冲区使用指定的管道大小。 写入src数据将作为此流的输入。

参数

src - 要连接的流。

pipeSize - 管道缓冲区的大小。

异常

IOException - 如果发生I / O错误。

IllegalArgumentException - 如果 pipeSize <= 0 。

从以下版本开始：

1.6

PipedReader

public PipedReader()

创建一个PipedReader ，所以它还不是connected 。 使用前一定是connected到PipedWriter 。

PipedReader

public PipedReader(int pipeSize)

创建一个PipedReader ，使其尚未connected并且使用指定的管道大小作为管道的缓冲区。 在使用前必须是connected到PipedWriter 。

参数

pipeSize - 管道缓冲区的大小。

异常

IllegalArgumentException - 如果 pipeSize <= 0 。

从以下版本开始：

1.6

方法详细信息

connect

public void connect(PipedWriter src)
             throws IOException

使这个管道读取器连接到管道写入器src 。 如果此对象已连接到其他管道写入器，则抛出IOException 。

如果src是未连接的管道写入器，并且snk是未连接的管道读取器，则可以通过以下任一方式连接它们：

  snk.connect(src) 

或电话：

  src.connect(snk) 

两个电话有相同的效果。

参数

src - 连接到管道写入器。

异常

IOException - 如果发生I / O错误。

read

public int read()
         throws IOException

从这个管道流读取下一个数据字符。 如果没有字符可用，因为流已经到达，则返回值-1 。 该方法阻塞直到输入数据可用，检测到流的结尾，或抛出异常。

重写：

read在类别 Reader

结果

数据的下一个字符，如果达到流的末尾， -1 。

异常

IOException -如果管道是 broken ， unconnected ，关闭，或发生I / O错误。

read

public int read(char[] cbuf,
                int off,
                int len)
         throws IOException

从这个管道数据流读取最多len字符数组。 如果达到数据流的结尾，或者如果len超过管道的缓冲区大小，则读取少于len字符。 该方法阻塞，直到输入的至少一个字符可用。

Specified by:

read在 Reader

参数

cbuf - 读取数据的缓冲区。

off - 数据的起始偏移量。

len - 读取的最大字符数。

结果

读入缓冲区的字符总数，或 -1如果没有更多的数据，因为流已经到达。

异常

IOException -如果管道是 broken ， unconnected ，关闭，或发生I / O错误。

ready

public boolean ready()
              throws IOException

告诉这个流是否准备好阅读。 如果循环缓冲区不为空，则管道字符流就绪。

重写：

ready在类别 Reader

结果

如果下一个read（）保证不阻止输入，则为True，否则为false。 请注意，返回false并不能保证下一次读取将被阻止。

异常

IOException -如果管道是 broken ， unconnected ，或关闭。

close

public void close()
           throws IOException

关闭此管道流，并释放与流相关联的任何系统资源。

Specified by:

close在界面 Closeable

Specified by:

close在界面 AutoCloseable

Specified by:

close在类别 Reader

异常

IOException - if an I/O error occurs.