JavaTM Platform
Standard Ed. 6

java.io
类 PipedWriter

java.lang.Object
  继承者 java.io.Writer
      继承者 java.io.PipedWriter
所有已实现的接口:
Closeable, Flushable, Appendable

public class PipedWriter
     
extends Writer

传送的字符输出流。

从以下版本开始:
JDK1.1

字段摘要
 
从类 java.io.Writer 继承的字段
lock
 
构造方法摘要
PipedWriter()
          创建一个尚未连接到传送 reader 的传送 writer。
PipedWriter(PipedReader snk)
          创建传送 writer,使其连接到指定的传送 reader。
 
方法摘要
 void close()
          关闭此管道输出流并释放与此流相关的所有系统资源。
 void connect(PipedReader snk)
          将此传送 writer 连接到接收方。
 void flush()
          刷新此输出流并强制写出所有缓冲的输出字符。
 void write(char[] cbuf, int off, int len)
          将 len 字符从指定初始偏移量为 off 的字符数组写入到此管道输出流。
 void write(int c)
          将指定的 char 写入管道输出流。
 
从类 java.io.Writer 继承的方法
append, append, append, write, write, write
 
从类 java.lang.Object 继承的方法
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

构造方法详细信息

PipedWriter

public PipedWriter(PipedReader snk)
            throws IOException
创建传送 writer,使其连接到指定的传送 reader。写入此流的数据字符稍后将用作 snk 的输入。

参数:
snk - 连接的传送 reader。
抛出:
IOException - 如果发生 I/O 错误。

PipedWriter

public PipedWriter()
创建一个尚未连接到传送 reader 的传送 writer。必须在使用之前将其连接到传送 reader(既可由接收方连接,也可由发送方连接)。

另请参见:
PipedReader.connect(java.io.PipedWriter), connect(java.io.PipedReader)
方法详细信息

connect

public void connect(PipedReader snk)
             throws IOException
将此传送 writer 连接到接收方。如果此对象已经连接到其他某个传送 reader,则抛出 IOException

如果 snk 为未连接的传送 reader,而 src 为未连接的传送 writer,则可以通过以下任一调用使其连接:

 src.connect(snk)
或:
 snk.connect(src)
这两个调用的效果相同。

参数:
snk - 连接的传送 reader。
抛出:
IOException - 如果发生 I/O 错误。

write

public void write(int c)
           throws IOException
将指定的 char 写入管道输出流。如果某个线程正从连接的管道输入流读取数据字符,但该线程不再处于活动状态,则抛出 IOException

实现 Writerwrite 方法。

覆盖:
Writer 中的 write
参数:
c - 要写入的 char
抛出:
IOException - 如果管道 损坏未连接、关闭或发生 I/O 错误。

write

public void write(char[] cbuf,
                  int off,
                  int len)
           throws IOException
len 字符从指定初始偏移量为 off 的字符数组写入到此管道输出流。在将所有字符写入输出流之前,此方法将阻塞。如果某个线程正从连接的管道输入流读取数据字符,但该线程不再处于活动状态,则抛出 IOException

指定者:
Writer 中的 write
参数:
cbuf - 数据。
off - 数据中的初始偏移量。
len - 要写入的字符数。
抛出:
IOException - 如果管道 损坏未连接、关闭或发生 I/O 错误。

flush

public void flush()
           throws IOException
刷新此输出流并强制写出所有缓冲的输出字符。这将通知所有 reader,告知它们管道中的字符处于等待中。

指定者:
接口 Flushable 中的 flush
指定者:
Writer 中的 flush
抛出:
IOException - 如果管道关闭,或者发生 I/O 错误。

close

public void close()
           throws IOException
关闭此管道输出流并释放与此流相关的所有系统资源。此流可能无法再用于写入字符。

指定者:
接口 Closeable 中的 close
指定者:
Writer 中的 close
抛出:
IOException - 如果发生 I/O 错误。

JavaTM Platform
Standard Ed. 6

提交错误或意见
有关更多的 API 参考资料和开发人员文档,请参阅 Java SE 开发人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作代码示例。

版权所有 2007 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策