FilterReader

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

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

public class Sample
{
    public static void main( String[] args )
    {
        StringReader stringReader = null;
        NormalFilterReader normalFilterReader = null;
        PushbackReader pushbackReader = null;
        try
        {
            // 対象とする文字列。
            String source = "あいうえお";

            // その文字列を読み込み対象とする
            // StringReaderクラス。
            stringReader = new StringReader( source );

            // このクラスを対象とするNormalFilterReaderクラスを用意します。
            normalFilterReader = new NormalFilterReader( stringReader );

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

            // つまり、

            // StringReader
            // ↓
            // NormalFilterReader
            // ↓
            // PushbackReader

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

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

                // 出力します。
                System.out.println( (char)i );
            }
            // NormalFilterReader#read() : あ ( 0x3042 )
            // あ
            // NormalFilterReader#read() : い ( 0x3044 )
            // い
            // NormalFilterReader#read() : う ( 0x3046 )
            // う
            // NormalFilterReader#read() : え ( 0x3048 )
            // え
            // NormalFilterReader#read() : お ( 0x304a )
            // お
            // NormalFilterReader#read() : ? ( 0xffffffff )

            // このように、pushbackReaderのread()メソッドを呼ぶと、
            // normalFilterReaderのread()メソッドを呼び出します。
            // つまり文字入力ストリームが連結して「チェーン」になった
            // というわけです。
        }
        catch( IOException e )
        {
            // 読み込みに失敗した際に、read()メソッドが
            // IOException例外を投げます。
            e.printStackTrace();
        }
        finally
        {
            // 処理が終わったら、最後にclose()メソッドを呼んで
            // 後処理をします。また、これは必ず行うため、
            // finally内で行います。
            try
            {
                if( pushbackReader != null )
                {
                    pushbackReader.close();
                }
            }
            catch( IOException e )
            {
                // close()メソッドはIOExceptionがthrows指定されているので
                // 一応受け取ります。
                e.printStackTrace();
            }

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

            // 処理が終わったら、最後にclose()メソッドを呼んで
            // 後処理をします。また、これは必ず行うため、
            // finally内で行います。
            if( stringReader != null )
            {
                stringReader.close();
            }
        }
    }
}

/**
*   NormalFilterReaderクラス。
*   FilterReaderクラスのサブクラスです。
*/
class NormalFilterReader extends FilterReader
{
    /**
    *   コンストラクタ。
    *   引数に「入力元」となる文字入力ストリームクラスを受け取ります。
    *   「中継ぎ」に当たるので、Readerクラスを引数に受け取ります。
    */
    public NormalFilterReader( Reader in )
    {
        // 処理はスーパークラスが受け持ってくれるので、
        // スーパークラスに渡します。
        super( in );
    }

    /**
    *   read()メソッド。
    *   このクラスを利用する文字入力ストリームクラスの
    *   read()メソッドから呼び出されます。
    */
    public int read() throws IOException
    {
        // スーパークラスであるFilterReaderクラスの
        // inフィールドに「入力元」のReaderクラスが
        // 入っているので、そのread()メソッドを呼び出します。
        int i = in.read();
        System.out.println( "NormalFilterReader#read() : " + (char)i + " ( 0x" + Integer.toHexString( i ) + " )" );
        return i;
    }
}