Java_io体系之OutputStreamWriter、InputStreamReader简介、走进源码及示例――17

一：OutputStreamWriter

1、类功能简介：

输入字符转换流、是输入字节流转向输入字符流的桥梁、用于将输入字节流转换成输入字符流、通过指定的或者默认的编码将从底层读取的字节转换成字符返回到程序中、与OutputStreamWriter一样、本质也是使用其内部的一个类来完成所有工作：StreamDecoder、使用默认或者指定的编码将字节转换成字符、InputStreamReader只是对StreamDecoder进行了封装、isr内部所有方法核心都是调用StreamDecoder来完成的、InputStreamReader只是对StreamDecoder进行了封装、使得我们可以直接使用读取方法、而不用关心内部实现。

2、OutputStreamWriter API简介：

A：关键字

	private final StreamEncoder se;		核心类、用于将字符编码成字节

B：构造方法

	OutputStreamWriter(OutputStream out, String charsetName)	创建使用指定字符集的 OutputStreamWriter。
	
	OutputStreamWriter(OutputStream out, Charset cs)	 创建使用给定字符集的 OutputStreamWriter。	
	
	OutputStreamWriter(OutputStream out)	 创建使用默认字符编码的 OutputStreamWriter。
	
	OutputStreamWriter(OutputStream out, CharsetEncoder enc)	创建使用给定字符集编码器的 OutputStreamWriter。

C：一般方法

	String getEncoding()	 返回此流使用的字符编码的名称。	
	
	void write(int c)	写入单个字符。
	
	void write(char cbuf[], int off, int len)	 写入字符数组的某一部分。
	
	void write(String str, int off, int len)	  写入字符串的某一部分。
	
	void flush()	刷新该流的缓冲。
	
	void close()	关闭此流，但要先刷新它。

3、源码分析

package com.chy.io.original.code;

import java.io.IOException;
import java.io.UnsupportedEncodingException;
import java.nio.charset.Charset;
import java.nio.charset.CharsetEncoder;


/**
 * 字符输出流、是使用指定的编码或者时系统默认的编码将字节转换成字符。
 * 是OutputStream转换成Writer的桥梁、也是PrintStream、能够在构造的时候指定编码的关键。
 * 实际上是将OutputStream传递给了StreamEncoder来操作out
 */

public class OutputStreamWriter extends Writer {

	//通过StreamEncoder se进行字节与字符的转码。
    private final StreamEncoder se;

    /**
     * 用指定的编码将OutputStream out转换成OutputStreamWriter。
     */
    public OutputStreamWriter(OutputStream out, String charsetName)
	throws UnsupportedEncodingException
    {
    	// 调用父类Writer的构造方法创建一个新的字符流 writer，其关键部分将同步给自身。
		super(out);
		if (charsetName == null)
		    throw new NullPointerException("charsetName");
		//初始化StreamEncoder se.
		se = StreamEncoder.forOutputStreamWriter(out, this, charsetName);
	}

    /**
     * 使用默认编码创建osw。
     */
    public OutputStreamWriter(OutputStream out) {
	super(out);
	try {
	    se = StreamEncoder.forOutputStreamWriter(out, this, (String)null);
	} catch (UnsupportedEncodingException e) {
	    throw new Error(e);
        }
    }

    /**
     * 使用指定的字符集创建osw
     */
    public OutputStreamWriter(OutputStream out, Charset cs) {
	super(out);
	if (cs == null)
	    throw new NullPointerException("charset");
	se = StreamEncoder.forOutputStreamWriter(out, this, cs);
    }

    /**
     * 使用指定的字符编码创建osw
     */
    public OutputStreamWriter(OutputStream out, CharsetEncoder enc) {
	super(out);
	if (enc == null)
	    throw new NullPointerException("charset encoder");
	se = StreamEncoder.forOutputStreamWriter(out, this, enc);
    }

    /**
     * 获取字符流使用的字符集、或者编码
     */
    public String getEncoding() {
    	return se.getEncoding();
    }

    /**
     * 将osw中的字符flush到底层OutputStream中、此方法不包含flush底层out中的字节
     */
    void flushBuffer() throws IOException {
    	se.flushBuffer();
    }

    /**
     * 将字节转换成字符后、向out中写入一个字符（字符的编码在构造OutputStreamWriter时指定或者使用默认编码
     */
    public void write(int c) throws IOException {
    	se.write(c);
    }

    /**
     * 将cbuf中的一部分写入到out中
     */
    public void write(char cbuf[], int off, int len) throws IOException {
    	se.write(cbuf, off, len);
    }

    /**
     * 将str一部分写入到out中
     */
    public void write(String str, int off, int len) throws IOException {
    	se.write