JavaTM Platform
Standard Ed. 6

类 java.io.Reader
的使用

使用 Reader 的软件包
java.awt.datatransfer 提供在应用程序之间和在应用程序内部传输数据的接口和类。 
java.io 通过数据流、序列化和文件系统提供系统输入和输出。 
java.nio.channels 定义了各种通道,这些通道表示到能够执行 I/O 操作的实体(如文件和套接字)的连接;定义了用于多路复用的、非阻塞 I/O 操作的选择器。 
java.sql 提供使用 JavaTM 编程语言访问并处理存储在数据源(通常是一个关系数据库)中的数据的 API。 
java.util 包含 collection 框架、遗留的 collection 类、事件模型、日期和时间设施、国际化和各种实用工具类(字符串标记生成器、随机数生成器和位数组)。 
javax.print 为 JavaTM Print Service API 提供了主要类和接口。 
javax.script 脚本 API 由定义 Java TM Scripting Engines 的接口和类组成,并为它们在 Java 应用程序中的使用提供框架。 
javax.sql 为通过 JavaTM 编程语言进行服务器端数据源访问和处理提供 API。 
javax.sql.rowset JDBC RowSet 实现的标准接口和基类。 
javax.sql.rowset.serial 提供实用工具类,允许 SQL 类型与 Java 编程语言数据类型之间的可序列化映射关系。 
javax.sql.rowset.spi 第三方供应商在其同步提供者的实现中必须使用的标准类和接口。 
javax.swing.text 提供类 HTMLEditorKit 和创建 HTML 文本编辑器的支持类。 
javax.swing.text.html 提供类 HTMLEditorKit 和创建 HTML 文本编辑器的支持类。 
javax.swing.text.html.parser 提供默认的 HTML 解析器以及支持类。 
javax.swing.text.rtf 提供一个类 (RTFEditorKit),用于创建富文本格式(Rich-Text-Format)的文本编辑器。 
javax.tools 为能够从程序(例如,编译器)中调用的工具提供接口。 
javax.xml.bind 为包含解组、编组和验证功能的客户端应用程序提供运行时绑定框架。 
javax.xml.bind.helpers 仅由 JAXB 提供者用于: 提供某些 javax.xml.bind 接口的部分默认实现。 
javax.xml.stream   
javax.xml.transform.stream 此包实现特定于流和 URI 的转换 API。 
org.w3c.dom.ls   
org.xml.sax 此包提供了核心 SAX API。 
 

java.awt.datatransferReader 的使用
 

返回 Readerjava.awt.datatransfer 中的方法
 Reader DataFlavor.getReaderForText(Transferable transferable)
          获取文本 flavor 的 Reader,如果需要,则为期望的 charset(编码的)解码。
 

java.ioReader 的使用
 

java.ioReader 的子类
 class BufferedReader
          从字符输入流中读取文本,缓冲各个字符,从而实现字符、数组和行的高效读取。
 class CharArrayReader
          此类实现一个可用作字符输入流的字符缓冲区。
 class FileReader
          用来读取字符文件的便捷类。
 class FilterReader
          用于读取已过滤的字符流的抽象类。
 class InputStreamReader
          InputStreamReader 是字节流通向字符流的桥梁:它使用指定的 charset 读取字节并将其解码为字符。
 class LineNumberReader
          跟踪行号的缓冲字符输入流。
 class PipedReader
          传送的字符输入流。
 class PushbackReader
          允许将字符推回到流的字符流 reader。
 class StringReader
          其源为一个字符串的字符流。
 

声明为 Readerjava.io 中的字段
protected  Reader FilterReader.in
          底层字符输入流。
 

返回 Readerjava.io 中的方法
 Reader Console.reader()
          获取与此控制台关联的唯一 Reader 对象。
 

参数类型为 Readerjava.io 中的构造方法
BufferedReader(Reader in)
          创建一个使用默认大小输入缓冲区的缓冲字符输入流。
BufferedReader(Reader in, int sz)
          创建一个使用指定大小输入缓冲区的缓冲字符输入流。
FilterReader(Reader in)
          创建一个新的 filtered reader。
LineNumberReader(Reader in)
          使用默认输入缓冲区的大小创建新的行编号 reader。
LineNumberReader(Reader in, int sz)
          创建新的行编号 reader,将字符读入给定大小的缓冲区。
PushbackReader(Reader in)
          创建具有单字符推回缓冲区的新推回 reader。
PushbackReader(Reader in, int size)
          创建具有给定大小推回缓冲区的新推回 reader。
StreamTokenizer(Reader r)
          创建解析给定字符流的标记生成器。
 

java.nio.channelsReader 的使用
 

返回 Readerjava.nio.channels 中的方法
static Reader Channels.newReader(ReadableByteChannel ch, CharsetDecoder dec, int minBufferCap)
          构造一个 reader,它用给定的解码器对取自给定信道的字节进行解码。
static Reader Channels.newReader(ReadableByteChannel ch, String csName)
          构造一个 reader,它根据命名的 charset 对取自给定信道的字节进行解码。
 

java.sqlReader 的使用
 

返回 Readerjava.sql 中的方法
 Reader Clob.getCharacterStream()
          以 java.io.Reader 对象形式(或字符流形式)获取此 Clob 对象指定的 CLOB 值。
 Reader SQLXML.getCharacterStream()
          以 java.io.Reader 对象的形式获取此 SQLXML 实例指定的 XML 值。
 Reader CallableStatement.getCharacterStream(int parameterIndex)
          以 Java 编程语言中 java.io.Reader 对象的形式获取指定参数的值。
 Reader ResultSet.getCharacterStream(int columnIndex)
          以 java.io.Reader 对象的形式获取此 ResultSet 对象的当前行中指定列的值。
 Reader Clob.getCharacterStream(long pos, long length)
          返回包含部分 Clob 值的 Reader 对象,该值从 pos 指定的字符开始,长度为 length 个字符。
 Reader CallableStatement.getCharacterStream(String parameterName)
          以 Java 编程语言中 java.io.Reader 对象的形式获取指定参数的值。
 Reader ResultSet.getCharacterStream(String columnLabel)
          以 java.io.Reader 对象的形式获取此 ResultSet 对象的当前行中指定列的值。
 Reader CallableStatement.getNCharacterStream(int parameterIndex)
          以 Java 编程语言中 java.io.Reader 对象的形式获取指定参数的值。
 Reader ResultSet.getNCharacterStream(int columnIndex)
          以 java.io.Reader 对象的形式获取此 ResultSet 对象的当前行中指定列的值。
 Reader CallableStatement.getNCharacterStream(String parameterName)
          以 Java 编程语言中 java.io.Reader 对象的形式获取指定参数的值。
 Reader ResultSet.getNCharacterStream(String columnLabel)
          以 java.io.Reader 对象的形式获取此 ResultSet 对象的当前行中指定列的值。
 Reader SQLInput.readCharacterStream()
          读取流中的下一个属性并将其作为 Unicode 字符流返回。
 

参数类型为 Readerjava.sql 中的方法
 void PreparedStatement.setCharacterStream(int parameterIndex, Reader reader)
          将指定参数设置为给定 Reader 对象。
 void PreparedStatement.setCharacterStream(int parameterIndex, Reader reader, int length)
          将给定参数设置为给定 Reader 对象,该对象具有给定字符数长度。
 void PreparedStatement.setCharacterStream(int parameterIndex, Reader reader, long length)
          将指定参数设置为给定 Reader 对象,该对象具有给定字符数长度。
 void CallableStatement.setCharacterStream(String parameterName, Reader reader)
          将指定参数设置为给定 Reader 对象。
 void CallableStatement.setCharacterStream(String parameterName, Reader reader, int length)
          将指定参数设置为给定 Reader 对象,该对象是给定的字符长度数。
 void CallableStatement.setCharacterStream(String parameterName, Reader reader, long length)
          将指定参数设置为给定 Reader 对象,该对象具有给定字符数长度。
 void PreparedStatement.setClob(int parameterIndex, Reader reader)
          将指定参数设置为 Reader 对象。
 void PreparedStatement.setClob(int parameterIndex, Reader reader, long length)
          将指定参数设置为 Reader 对象。
 void CallableStatement.setClob(String parameterName, Reader reader)
          将指定参数设置为 Reader 对象。
 void CallableStatement.setClob(String parameterName, Reader reader, long length)
          将指定参数设置为 Reader 对象。
 void PreparedStatement.setNCharacterStream(int parameterIndex, Reader value)
          将指定参数设置为 Reader 对象。
 void PreparedStatement.setNCharacterStream(int parameterIndex, Reader value, long length)
          将指定参数设置为 Reader 对象。
 void CallableStatement.setNCharacterStream(String parameterName, Reader value)
          将指定参数设置为 Reader 对象。
 void CallableStatement.setNCharacterStream(String parameterName, Reader value, long length)
          将指定参数设置为 Reader 对象。
 void PreparedStatement.setNClob(int parameterIndex, Reader reader)
          将指定参数设置为 Reader 对象。
 void PreparedStatement.setNClob(int parameterIndex, Reader reader, long length)
          将指定参数设置为 Reader 对象。
 void CallableStatement.setNClob(String parameterName, Reader reader)
          将指定参数设置为 Reader 对象。
 void CallableStatement.setNClob(String parameterName, Reader reader, long length)
          将指定参数设置为 Reader 对象。
 void ResultSet.updateCharacterStream(int columnIndex, Reader x)
          用字符流值更新指定的列。
 void ResultSet.updateCharacterStream(int columnIndex, Reader x, int length)
          用字符流值更新指定列,该列将具有指定字节数。
 void ResultSet.updateCharacterStream(int columnIndex, Reader x, long length)
          用字符流值更新指定的列,该值将具有指定的字节数。
 void ResultSet.updateCharacterStream(String columnLabel, Reader reader)
          用字符流值更新指定列。
 void ResultSet.updateCharacterStream(String columnLabel, Reader reader, int length)
          用字符流值更新指定列,该列具有指定的字节数。
 void ResultSet.updateCharacterStream(String columnLabel, Reader reader, long length)
          用字符流值更新指定的列,该值将具有指定的字节数。
 void ResultSet.updateClob(int columnIndex, Reader reader)
          使用给定的 Reader 对象更新指定列。
 void ResultSet.updateClob(int columnIndex, Reader reader, long length)
          使用给定的 Reader 对象更新指定列,该对象是给定的字符长度数目。
 void ResultSet.updateClob(String columnLabel, Reader reader)
          使用给定的 Reader 对象更新指定列。
 void ResultSet.updateClob(String columnLabel, Reader reader, long length)
          使用给定的 Reader 对象更新指定列,该对象是给定的字符长度数目。
 void ResultSet.updateNCharacterStream(int columnIndex, Reader x)
          用字符流值更新指定的列。
 void ResultSet.updateNCharacterStream(int columnIndex, Reader x, long length)
          用字符流值更新指定的列,该值将具有指定的字节数。
 void ResultSet.updateNCharacterStream(String columnLabel, Reader reader)
          用字符流值更新指定的列。
 void ResultSet.updateNCharacterStream(String columnLabel, Reader reader, long length)
          用字符流值更新指定的列,该值将具有指定的字节数。
 void ResultSet.updateNClob(int columnIndex, Reader reader)
          使用给定的 Reader 对象更新指定列。
 void ResultSet.updateNClob(int columnIndex, Reader reader, long length)
          使用给定的 Reader 对象更新指定的列,该对象是给定的字符长度数目。
 void ResultSet.updateNClob(String columnLabel, Reader reader)
          使用给定的 Reader 对象更新指定列。
 void ResultSet.updateNClob(String columnLabel, Reader reader, long length)
          使用给定的 Reader 对象更新指定的列,该对象是给定的字符长度数目。
 void SQLOutput.writeCharacterStream(Reader x)
          将下一个属性作为 Unicode 字符的流写入流中。
 

java.utilReader 的使用
 

参数类型为 Readerjava.util 中的方法
 void Properties.load(Reader reader)
          按简单的面向行的格式从输入字符流中读取属性列表(键和元素对)。
 

参数类型为 Readerjava.util 中的构造方法
PropertyResourceBundle(Reader reader)
          根据 Reader 创建属性资源包。
 

javax.printReader 的使用
 

返回 Readerjavax.print 中的方法
 Reader Doc.getReaderForText()
          获得一个从此 doc 中提取字符打印数据的 reader。
 Reader SimpleDoc.getReaderForText()
          获得一个从此 doc 中提取字符打印数据的 reader。
 

javax.scriptReader 的使用
 

声明为 Readerjavax.script 中的字段
protected  Reader SimpleScriptContext.reader
          此字段是用于脚本输入的 reader。
 

返回 Readerjavax.script 中的方法
 Reader ScriptContext.getReader()
          返回脚本用来读取输入的 Reader
 Reader SimpleScriptContext.getReader()
          返回脚本用来读取输入的 Reader
 

参数类型为 Readerjavax.script 中的方法
 CompiledScript Compilable.compile(Reader script)
          编译脚本(从 Reader 读取的源),以便以后执行。
 Object AbstractScriptEngine.eval(Reader reader)
          eval(Reader) 调用抽象 eval(Reader, ScriptContext),并传递 context 字段的值给它。
 Object ScriptEngine.eval(Reader reader)
          除了脚本的源是以 Reader 形式提供的外,与 eval(String) 相同。
 Object AbstractScriptEngine.eval(Reader reader, Bindings bindings)
          eval(Reader, Bindings) 调用抽象 eval(Reader, ScriptContext) 方法,并传递一个 ScriptContext 给它,对于 ENGINE_SCOPE 以外的范围,该 ScriptContext 的 Reader、Writer 和 Bindings 等同于受保护 context 字段的 Reader、Writer 和 Bindings。
 Object ScriptEngine.eval(Reader reader, Bindings n)
          除了脚本的源是以 Reader 形式提供的外,与 eval(String, Bindings) 相同。
 Object ScriptEngine.eval(Reader reader, ScriptContext context)
          与 eval(String, ScriptContext) 相同,其中脚本的源是从 Reader 读取的。
 void ScriptContext.setReader(Reader reader)
          设置脚本的 Reader,以读取输入。
 void SimpleScriptContext.setReader(Reader reader)
          设置脚本的 Reader,以读取输入。
 

javax.sqlReader 的使用
 

参数类型为 Readerjavax.sql 中的方法
 void RowSet.setCharacterStream(int parameterIndex, Reader reader)
          将此 RowSet 对象命令中的指定参数设置为给定 Reader 对象。
 void RowSet.setCharacterStream(int parameterIndex, Reader reader, int length)
          将此 RowSet 对象命令中的指定参数设置为给定的 java.io.Reader 值。
 void RowSet.setCharacterStream(String parameterName, Reader reader)
          将指定参数设置为给定 Reader 对象。
 void RowSet.setCharacterStream(String parameterName, Reader reader, int length)
          将指定参数设置为给定 Reader 对象,该对象是给定的字符长度数目。
 void RowSet.setClob(int parameterIndex, Reader reader)
          将指定参数设置为 Reader 对象。
 void RowSet.setClob(int parameterIndex, Reader reader, long length)
          将指定参数设置为 Reader 对象。
 void RowSet.setClob(String parameterName, Reader reader)
          将指定参数设置为 Reader 对象。
 void RowSet.setClob(String parameterName, Reader reader, long length)
          将指定参数设置为 Reader 对象。
 void RowSet.setNCharacterStream(int parameterIndex, Reader value)
          将此 RowSet 对象命令中的指定参数设置为 Reader 对象。
 void RowSet.setNCharacterStream(int parameterIndex, Reader value, long length)
          将指定参数设置为 Reader 对象。
 void RowSet.setNCharacterStream(String parameterName, Reader value)
          将指定参数设置为 Reader 对象。
 void RowSet.setNCharacterStream(String parameterName, Reader value, long length)
          将指定参数设置为 Reader 对象。
 void RowSet.setNClob(int parameterIndex, Reader reader)
          将指定参数设置为 Reader 对象。
 void RowSet.setNClob(int parameterIndex, Reader reader, long length)
          将指定参数设置为 Reader 对象。
 void RowSet.setNClob(String parameterName, Reader reader)
          将指定参数设置为 Reader 对象。
 void RowSet.setNClob(String parameterName, Reader reader, long length)
          将指定参数设置为 Reader 对象。
 

javax.sql.rowsetReader 的使用
 

声明为 Readerjavax.sql.rowset 中的字段
protected  Reader BaseRowSet.charStream
          将由方法 getCharacterStream 返回的 Reader 对象,该方法在 ResultSet 接口中指定。
 

参数类型为 Readerjavax.sql.rowset 中的方法
 void WebRowSet.readXml(Reader reader)
          从给定的 Reader 对象以其 XML 格式读取 WebRowSet 对象。
 void BaseRowSet.setCharacterStream(int parameterIndex, Reader reader)
          将此 RowSet 对象命令中的指定参数设置为给定的 Reader 对象。
 void BaseRowSet.setCharacterStream(int parameterIndex, Reader reader, int length)
          将指定参数设置为给定的 java.io.Reader 对象,该对象具有指定的字符数。
 void BaseRowSet.setCharacterStream(String parameterName, Reader reader)
          将指定参数设置为给定 Reader 对象。
 void BaseRowSet.setCharacterStream(String parameterName, Reader reader, int length)
          将指定参数设置为给定的 Reader 对象,该对象是给定的字符长度数目。
 void BaseRowSet.setClob(int parameterIndex, Reader reader)
          将指定参数设置为 Reader 对象。
 void BaseRowSet.setClob(int parameterIndex, Reader reader, long length)
          将指定参数设置为 Reader 对象。
 void BaseRowSet.setClob(String parameterName, Reader reader)
          将指定参数设置为 Reader 对象。
 void BaseRowSet.setClob(String parameterName, Reader reader, long length)
          将指定参数设置为 Reader 对象。
 void BaseRowSet.setNCharacterStream(int parameterIndex, Reader value)
          将此 RowSet 对象命令中的指定参数设置为 Reader 对象。
 void BaseRowSet.setNCharacterStream(int parameterIndex, Reader value, long length)
          将指定参数设置为 Reader 对象。
 void BaseRowSet.setNCharacterStream(String parameterName, Reader value)
          将指定参数设置为 Reader 对象。
 void BaseRowSet.setNCharacterStream(String parameterName, Reader value, long length)
          将指定参数设置为 Reader 对象。
 void BaseRowSet.setNClob(int parameterIndex, Reader reader)
          将指定参数设置为 Reader 对象。
 void BaseRowSet.setNClob(int parameterIndex, Reader reader, long length)
          将指定参数设置为 Reader 对象。
 void BaseRowSet.setNClob(String parameterName, Reader reader)
          将指定参数设置为 Reader 对象。
 void BaseRowSet.setNClob(String parameterName, Reader reader, long length)
          将指定参数设置为 Reader 对象。
 

javax.sql.rowset.serialReader 的使用
 

返回 Readerjavax.sql.rowset.serial 中的方法
 Reader SerialClob.getCharacterStream()
          以 Unicode 字符流的形式返回此 SerialClob 对象的数据。
 Reader SerialClob.getCharacterStream(long pos, long length)
           
 Reader SQLInputImpl.readCharacterStream()
          以 Unicode 字符流的形式获取此 SQLInputImpl 对象中的下一个属性。
 

参数类型为 Readerjavax.sql.rowset.serial 中的方法
 void SQLOutputImpl.writeCharacterStream(Reader x)
          将 Unicode 字符流写入此 SQLOutputImpl 对象。
 

javax.sql.rowset.spiReader 的使用
 

参数类型为 Readerjavax.sql.rowset.spi 中的方法
 void XmlReader.readXML(WebRowSet caller, Reader reader)
          从给定的 XML 格式的输入流读取并解析给定的 WebRowSet 对象。
 

javax.swing.textReader 的使用
 

参数类型为 Readerjavax.swing.text 中的方法
 void DefaultEditorKit.read(Reader in, Document doc, int pos)
          插入取自给定流的内容,它将被视为纯文本。
abstract  void EditorKit.read(Reader in, Document doc, int pos)
          插入来自给定流的内容,其格式需要适合此类型的内容处理程序。
 void JTextComponent.read(Reader in, Object desc)
          根据流进行初始化。
 

javax.swing.text.htmlReader 的使用
 

参数类型为 Readerjavax.swing.text.html 中的方法
 void StyleSheet.loadRules(Reader in, URL ref)
          加载 CSS1 语法中指定的规则集合。
abstract  void HTMLEditorKit.Parser.parse(Reader r, HTMLEditorKit.ParserCallback cb, boolean ignoreCharSet)
          解析给定的流并通过解析的结果驱动给定的回调。
 void HTMLEditorKit.read(Reader in, Document doc, int pos)
          插入来自给定流的内容。
 

javax.swing.text.html.parserReader 的使用
 

参数类型为 Readerjavax.swing.text.html.parser 中的方法
 void Parser.parse(Reader in)
          在给定 DTD 的情况下,解析 HTML 流。
 void DocumentParser.parse(Reader in, HTMLEditorKit.ParserCallback callback, boolean ignoreCharSet)
           
 void ParserDelegator.parse(Reader r, HTMLEditorKit.ParserCallback cb, boolean ignoreCharSet)
           
 

javax.swing.text.rtfReader 的使用
 

参数类型为 Readerjavax.swing.text.rtf 中的方法
 void RTFEditorKit.read(Reader in, Document doc, int pos)
          插入来自给定流的内容,该内容将被视为纯文本。
 

javax.toolsReader 的使用
 

返回 Readerjavax.tools 中的方法
 Reader FileObject.openReader(boolean ignoreEncodingErrors)
          获取此对象的 reader。
 Reader ForwardingFileObject.openReader(boolean ignoreEncodingErrors)
           
 Reader SimpleJavaFileObject.openReader(boolean ignoreEncodingErrors)
          在 Reader 中包装 SimpleJavaFileObject.getCharContent(boolean) 的结果。
 

javax.xml.bindReader 的使用
 

参数类型为 Readerjavax.xml.bind 中的方法
 Object Unmarshaller.unmarshal(Reader reader)
          从指定的 Reader 解组 XML 数据并返回得到的内容树。
 

javax.xml.bind.helpersReader 的使用
 

参数类型为 Readerjavax.xml.bind.helpers 中的方法
 Object AbstractUnmarshallerImpl.unmarshal(Reader reader)
           
 

javax.xml.streamReader 的使用
 

参数类型为 Readerjavax.xml.stream 中的方法
abstract  XMLEventReader XMLInputFactory.createXMLEventReader(Reader reader)
          根据 reader 创建一个新 XMLEventReader。
abstract  XMLEventReader XMLInputFactory.createXMLEventReader(String systemId, Reader reader)
          根据 reader 创建一个新 XMLEventReader。
abstract  XMLStreamReader XMLInputFactory.createXMLStreamReader(Reader reader)
          根据 reader 创建一个新 XMLStreamReader。
abstract  XMLStreamReader XMLInputFactory.createXMLStreamReader(String systemId, Reader reader)
          根据 java.io.InputStream 创建一个新 XMLStreamReader。
 

javax.xml.transform.streamReader 的使用
 

返回 Readerjavax.xml.transform.stream 中的方法
 Reader StreamSource.getReader()
          获取通过 setReader 设置的字符流。
 

参数类型为 Readerjavax.xml.transform.stream 中的方法
 void StreamSource.setReader(Reader reader)
          调用要作为字符 reader 的输入。
 

参数类型为 Readerjavax.xml.transform.stream 中的构造方法
StreamSource(Reader reader)
          从字符 reader 构造 StreamSource。
StreamSource(Reader reader, String systemId)
          从字符 reader 构造 StreamSource。
 

org.w3c.dom.lsReader 的使用
 

返回 Readerorg.w3c.dom.ls 中的方法
 Reader LSInput.getCharacterStream()
          依赖于语言和绑定类型的属性,表示 16 位单元流。
 

参数类型为 Readerorg.w3c.dom.ls 中的方法
 void LSInput.setCharacterStream(Reader characterStream)
          依赖于语言和绑定类型的属性,表示 16 位单元的流。
 

org.xml.saxReader 的使用
 

返回 Readerorg.xml.sax 中的方法
 Reader InputSource.getCharacterStream()
          获取此输入源的字符流。
 

参数类型为 Readerorg.xml.sax 中的方法
 void InputSource.setCharacterStream(Reader characterStream)
          设置此输入源的字符流。
 

参数类型为 Readerorg.xml.sax 中的构造方法
InputSource(Reader characterStream)
          使用字符流创建新的输入源。
 


JavaTM Platform
Standard Ed. 6

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

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