Reader

(KAB-studioからのおしらせです)

// Sample.java
import java.io.Reader;
import java.io.PushbackReader;
import java.io.IOException;

public class Sample
{
    public static void main( String[] args )
    {
        NormalReader normalReader = null;
        PushbackReader pushbackReader = null;
        try
        {
            // 「入力元」のNormalReaderクラスを用意します。
            normalReader = new NormalReader();

            // このクラスを対象とするPushbackReaderクラスを用意します。
            pushbackReader = new PushbackReader( normalReader );

            // つまり、

            // NormalReader
            // ↓
            // PushbackReader

            // という形で、文字入力ストリームクラスが連結したことになります。

            while( true )
            {
                // 1バイト取得します。
                int i = pushbackReader.read();
                if( i == -1 )
                {
                    // -1が返されてきたら終わりです。
                    break;
                }

                // 入力します。
                System.out.println( (char)i );
            }
            // あ
            // い
            // う
            // え
            // お

            // このように、pushbackReaderのread()メソッドを呼ぶと、
            // normalReaderのread()メソッドを呼び出します。
        }
        catch( IOException e )
        {
            // 読み込みに失敗した際に、read()メソッドが
            // IOException例外を投げます。
            e.printStackTrace();
        }
        finally
        {
            // 処理が終わったら、最後にclose()メソッドを呼んで
            // 後処理をします。また、これは必ず行うため、
            // finally内で行います。
            try
            {
                if( pushbackReader != null )
                {
                    pushbackReader.close();
                    // NormalReader#close()

                    // この結果から分かるとおり、stringReaderのclose()メソッドを
                    // 呼ぶと、「入力元」のnormalReaderのclose()メソッドも呼び
                    // 出されるので、本当は下のclose()メソッドを呼ぶ必要は
                    // ありません。でも必ずしも呼ばれるとは限らない
                    // （Javadocの仕様に書かれていない）ので呼んでおきましょう。
                }
            }
            catch( IOException e )
            {
                // close()メソッドはIOExceptionがthrows指定されているので
                // 一応受け取ります。
                e.printStackTrace();
            }

            // 処理が終わったら、最後にclose()メソッドを呼んで
            // 後処理をします。また、これは必ず行うため、
            // finally内で行います。
            try
            {
                if( normalReader != null )
                {
                    normalReader.close();
                    // NormalReader#close()
                }
            }
            catch( IOException e )
            {
                // close()メソッドはIOExceptionがthrows指定されているので
                // 一応受け取ります。
                e.printStackTrace();
            }
        }
    }
}

/**
*   NormalReaderクラス。
*   Readerクラスのサブクラスです。
*/
class NormalReader extends Reader
{
    // 対象の文字列。
    private String source = "あいうえお";
    // 現在の出力位置。
    private int pos = 0;

    /**
    *   read()メソッド。
    *   このクラスを利用する文字入力ストリームクラスの
    *   read()メソッドから呼び出されます。
    *   これをオーバーライドしておけば、他のオーバーロードされた
    *   read()メソッドが呼ばれても、最終的にこのメソッドが呼ばれるので
    *   適切に処理できます。
    */
    public int read( char[] cbuf, int off, int len) throws IOException
    {
        // 対象の文字数を超えていたら（つまり、文字入力ストリーム
        // の末端に達していたら）-1を返します。
        if( pos >= source.length() )
        {
            return -1;
        }

        // 第2引数から第3引数で指定された範囲まで、
        // 第1引数の配列にコピーして返します。
        // （注：実際には引数の整合性チェックや、最大文字数チェック等が
        // 必要です。でないとgetChars()メソッドがIndexOutOfBoundsException例外
        // を投げる可能性があります）
        source.getChars( pos, pos + len, cbuf, off );

        // 取り出した分だけ「取り出し位置」を増やします。
        pos += len;

        return len;
    }

    /**
    *   close()メソッド。
    *   ストリームを閉じるために呼び出されます。
    */
    public void close() throws IOException
    {
        System.out.println( "NormalReader#close()" );
    }
}