Writer

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

// Sample.java
import java.io.Writer;
import java.io.PrintWriter;
import java.io.IOException;

public class Sample
{
    public static void main( String[] args )
    {
        NormalWriter normalWriter = null;
        PrintWriter printWriter = null;
        try
        {
            // 「出力先」のNormalWriterクラスを用意します。
            normalWriter = new NormalWriter();

            // このクラスを対象とするPrintWriterクラスを用意します。
            printWriter = new PrintWriter( normalWriter );

            // つまり、

            // PrintWriter
            // ↓
            // NormalWriter

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

            // 出力します。
            printWriter.write( 'あ' );
            printWriter.write( 'い' );
            printWriter.write( 'う' );
            printWriter.write( "えお" );
            // NormalWriter#write( char[], int, int ) : あ
            // NormalWriter#write( char[], int, int ) : い
            // NormalWriter#write( char[], int, int ) : う
            // NormalWriter#write( char[], int, int ) : えお

            // このように、printWriterのwrite()メソッドを呼ぶと、
            // normalWriterのwrite()メソッドを呼び出します。
        }
        finally
        {
            // 処理が終わったら、最後にclose()メソッドを呼んで
            // 後処理をします。また、これは必ず行うため、
            // finally内で行います。
            if( printWriter != null )
            {
                printWriter.close();
                // NormalWriter#close()

                // この結果から分かるとおり、printWriterのclose()メソッドを
                // 呼ぶと、「出力先」のnormalWriterのclose()メソッドも呼び
                // 出されるので、本当は下のclose()メソッドを呼ぶ必要は
                // ありません。でも必ずしも呼ばれるとは限らない
                // （Javadocの仕様に書かれていないので）呼んでおきましょう。
            }

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

/**
*   NormalWriterクラス。
*   Writerクラスのサブクラスです。
*/
class NormalWriter extends Writer
{
    /**
    *   write()メソッド。
    *   このクラスを利用する文字出力ストリームクラスの
    *   write()メソッドから呼び出されます。
    *   これをオーバーライドしておけば、他のオーバーロードされた
    *   write()メソッドが呼ばれても、最終的にこのメソッドが呼ばれるので
    *   適切に処理できます。
    */
    public void write( char[] cbuf, int off, int len) throws IOException
    {
        System.out.println( "NormalWriter#write( char[], int, int ) : " + new String( cbuf, off, len ) );
    }

    /**
    *   flush()メソッド。
    *   ストリームをフラッシュするために呼び出されます。
    */
    public void flush() throws IOException
    {
        System.out.println( "NormalWriter#flush()" );
    }

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