java io OutputStreamWriter源码分析

简介

package java.io;

import java.nio.charset.Charset;
import java.nio.charset.CharsetEncoder;
import sun.nio.cs.StreamEncoder;


/**
 * OutputStreamWriter是一个从字符流到字节流的桥梁:
 * 写入到它的字符使用指定的Charset成为字节。
 * 它使用的字符集可以通过名称指定或明确给出，也可以接受平台的默认字符集。
 *
 * <p> 对write()方法的每次调用都会导致在给定字符上调用编码转换器。
 * 在写入底层输出流之前，生成的字节在缓存中累积。
 * 可以指定此缓冲区的大小，但默认情况下，它对于大多数用途来说已经足够大了。
 * 注意，传递给write()方法的字符没有缓冲。
 *
 * <p> 为了提高效率，可以考虑在BufferedWriter中
 * 封装一个OutputStreamWriter，以避免频繁的转换器调用。例如:
 *
 * <pre>
 * Writer out
 *   = new BufferedWriter(new OutputStreamWriter(System.out));
 * </pre>
 *
 * <p> surrogate pair对是由两个字符值序列表示的字符:
 * '\uD800'到'\uDBFF'范围内的高代理项，然后是'\uDC00'到'\uDFFF'范围内的低代理项。
 *
 * <p> 畸形代理项元素是后面没有低代理项的高代理项，或前面没有高代理项的低代理项。
 *
 * <p> 这个类总是用字符集的默认替换序列替换不规范的代理项元素和不可映射的字符序列。
 * 当需要对编码过程进行更多控制时，应该使用CharsetEncoder类。
 *
 * @see Buf