Javaでファイルの書き込みをする方法を現役エンジニアが解説【初心者向け】

Javaでファイルの書き込みをする方法をTechAcademyのメンター（現役エンジニア）が実際のコードを使用して初心者向けに解説します。

 

Javaについてそもそもよく分からないという方は、Javaとは何なのか解説した記事を読むとさらに理解が深まるでしょう。

 

なお本記事は、TechAcademyのオンラインブートキャンプJava講座の内容をもとに作成しています。

 

 

Javaでファイルの書き込みをする方法

Javaでファイルを書き込む方法は、FileWriterで書き込むファイルを指定し、PrintWriterで書き込み閉じることで完了します。

Javaでは、文章を作成してファイルに保存したり、保存しておいたファイルを開いたりする場合、 java.io というパッケージを利用します。

 

FileWriter

FileWriterクラスは、ファイルに何かを書き出すクラスです。

java.io パッケージのFileWriterクラスのオブジェクトを生成すると、同時に「ファイルを開く」処理が行われます。（ファイルが存在しない場合でも、新しくファイルが作成されます。）

PrintWriter

PrintWriterクラスは書き込みに特化したクラスで、

• print()メソッド
• println()メソッド
• printf()メソッド
• format()メソッド

も実装しています。

これらのメソッドを今までコンソールへの出力と同じように用いてファイルに出力可能です。

FileWriterと同様の使い方であるものの、出力文字列の整形などテキスト出力に特化した機能です。

 

BufferedWriter

FileWriterクラスはファイルの書き込み操作は、一文字ずつ入行わなくてはならないため、使い勝手は今一つだといえるでしょう。

BufferedWriterクラスでは、ある程度データをまとめてから、一度に出力（書き込み）をおこなうためのクラスです。

これによりある程度まとめて入出力を行うことができるため、処理速度を向上させることができます。

 

Javaでファイルの書き込みのコードの使い方を学ぼう

以下、FileWriterクラスを利用したサンプルコードです。

import java.io.*;

public class FileWriterReaderSample {
    public static void main(String[] args) {
        FileWriter fw = null;
        try {
            File file = new File("c:¥¥src¥¥Test.txt");
            fw = new FileWriter(file);
            fw.write(" こんにちは");
            fw.flush();
        } catch(IOException e) {
            e.printStackTrace();
        } finally {
            try {
                if(fw != null) {
                    fw.close();
                }
            } catch(IOException e) {
                e.printStackTrace();
            }
        }
    }
}

FileクラスやFileWriterクラスは java.io パッケージに含まれています。

そのため、インポート宣言が必要です。

try 〜 catch 文で囲っているのは、ファイルにデータを書き込む場合に必要な設定になります。

これは、ファイルを取り扱うクラスには全て、java.io.IOException クラス例外が発生する可能性があるためです。

 

Fileクラスをインスタンス化してオブジェクトを生成する際に、テキストファイルへのパス（ファイル名を含む）を設定しました。

そして、Fileクラスのオブジェクトを引数に渡して、FileWriterクラスをインスタンス化しオブジェクトを生成しています。

こうすることにより、Fileクラスで管理しているファイルをファイルへの書き出し専用クラスであるFileWriterから使用することが可能です。

 

flush()メソッドは、ファイルに指定した文字列を書き出すという機能を持っています。

write()メソッドは、あくまで書き込む文字列を指定していただけであるため、実際に書き込みたい場合は必ずflush()メソッドを使用しましょう。

そして、finally文を使用して、クローズ処理を行います。

また、ファイルに書き込みを行うためにつなげていたストリームは必ず閉じましょう。

以下、PrintWriterを利用したサンプルコードです。

import java.io.*;

public class PrintWriterSample {
    public static void main(String[] args) {
    	PrintWriter pw = null;
        try {
            File file = new File("c:¥¥src¥¥Test2.txt");
            pw = new PrintWriter(file);
            pw.println(" おはようございます");
            pw.println(" こんにちは");
            pw.println(" こんばんは");
            pw.flush();
        } catch(IOException e) {
            e.printStackTrace();
        } finally {
            if(pw != null){
                pw.close();
            }
        }
    }
}

PrintWriterクラスをインスタンス化してオブジェクトを生成する際には、Fileクラスオブジェクトを引数に指定してインスタンス化しオブジェクトを生成します。

PrintWriterクラスのprintln()メソッドを使用して、文字列をバッファ内に書き込むと同時に改行をしています。

以下、BufferedWriterを利用したサンプルコードです。

import java.io.*;

public class BufferedMain {
    public static void main(String args[]){
        BufferedWriter bw = null;
        try{
            File file = new File("c:¥¥src¥¥Test3.txtt");
            bw = new BufferedWriter(new FileWriter(file));
            bw.write("こんにちは");
            bw.newLine();
            bw.write("お元気ですか？");
            bw.newLine();
            bw.flush();
        } catch(IOException e) {
            e.printStackTrace();
        } finally {
            try {
                if(bw != null) {
                    bw.close();
                }
            } catch(IOException e) {
                e.printStackTrace();
            }
        }
    }
}

BufferdWriterクラスをインスタンス化してオブジェクトを生成する際に、FileWriterクラスオブジェクトを引数に指定してインスタンス化しオブジェクトを生成しています。

BufferdWriterは連結ストリームと呼ばれ、単独では使用できないため、FileWriterのストリームに繋げることで使用可能です。

そのため、FileWriterクラスは改行する際に必ず「¥n」を入れる必要があります。しかし、BufferdWriterクラスはnewLine()メソッドを呼ぶだけで改行することができます。

 

[PR] 未経験からWebエンジニアを目指す方法とは

まとめ

Javaのファイルの書き込み操作について、基本的な書き込み方法について解説しました。

ファイルの書き込み操作は実際に使用する機会が多いため、使いこなしていきましょう。

 

執筆してくれたメンター

松井紀明 メーカー系で17年エンジニアとして勤務後、現在はフリーのエンジニアとしてリモートワークで働いています。 Java、Perl、COBOL、最近ではRuby、PHP等、様々な言語での開発を経験しています。 TechAcademyではJavaコースを担当しています。

 

TechAcademyでは、初心者でもJavaやServletの技術を使ってWebアプリケーション開発を習得できるオンラインブートキャンプを開催しています。

また、現役エンジニアから学べる無料体験も実施しているので、参加してみてください。