[Android] アプリ内にファイルを保存する FileOutputStream, FileInputStream

ファイルをアプリのローカルストレージに保存したり読み出したい場合は、FileOutputStream、 FileInputStreamを使うと簡単です。

Android Studio 3.5.3
API 29

FileOutputStream , FileInputStream

　
ストレージオプション | Android Developers に説明がありますが、ストレージには「内部」ストレージと「外部」ストレージがあります。ここではこの内部ストレージにデータを保存させることが目的です。

内部ストレージ: Internal Storage
- 常に使用できる
- ここに保存されたファイルは、自分のアプリからのみアクセスできる
- ユーザーがアプリをアンインストールすると、システムは内部ストレージから当該アプリのファイルをすべて削除
- ユーザーからも他のアプリからも、自分のファイルにアクセスできないようにしたい場合の適する
外部ストレージ：External Storage
- 使用可能状態か確認が必要
- 誰でも読み取り可能なため、ここに保存されたファイルは自分のコントロールの及ばない所で読み取られる可能性がある

Ref:ファイルを保存する | Android Developers
　
　

目次
1. FileOutputStream
2. FileInputStream
3. サンプルコード

FileOutputStream

　
ファイル保存では FileOutputStream のインスタンスを openFileOutput()メソッドで取得します。

FileOutputStream fileOutputstream  = openFileOutput("test.txt", Context.MODE_PRIVATE);

1	FileOutputStream fileOutputstream = openFileOutput("test.txt", Context.MODE_PRIVATE);

第一引数はファイル名のみの指定です。
実際の保存場所は /data/data/package_name/files/ 以下にあります。adb shell コマンドではセキュリティーでブロックされて見えませんが、run-as を使えば見ることはできます
　
第二引数のモードは

MODE_APPEND
- 追加で書き込み
MODE_PRIVATE
- このアプリのみアクセス許可

書き込みは write()メソッドを使います。

fileOutputstream.write(str.getBytes());

1	fileOutputstream.write(str.getBytes());

strは書き込む文字列です。

FileInputStream

　
読み出しでは
FileInputStream のインスタンスを openFileInput()メソッドで取得します。

FileInputStream fileInputStream = openFileInput("test.txt");

1	FileInputStream fileInputStream = openFileInput("test.txt");

　
InputStreamReaderでバイトを読み込み、指定された文字にデコードし、それをBufferedReaderに入れて、行毎に読み出します。変換効率を上げるため、BufferedReaderの内部にInputStreamReaderをラップするのがいいようです。

BufferedReader reader= new BufferedReader(
new InputStreamReader(fileInputStream, StandardCharsets.UTF_8));

String lineBuffer;
while( (lineBuffer = reader.readLine()) != null ) {
    text = lineBuffer ;
}

BufferedReader reader= new BufferedReader(

new InputStreamReader(fileInputStream, StandardCharsets.UTF_8));

String lineBuffer;

while( (lineBuffer = reader.readLine()) != null ) {

text = lineBuffer ;

}

サンプルコード

　
下の例は、 EditText で入力した文字列を test.txt というファイルに入れて保存し、そのファイルから読み出す例です。

またtry〜catchをつかう場合にtry-with-resources 文を使いました。
　
MainActivity.java

import androidx.appcompat.app.AppCompatActivity;
import android.os.Bundle;
import android.content.Context;
import android.view.View;
import android.widget.Button;
import android.widget.EditText;
import android.widget.TextView;
import java.io.BufferedReader;
import java.io.FileInputStream;
import java.io.FileOutputStream;
import java.io.IOException;
import java.io.InputStreamReader;
import java.nio.charset.StandardCharsets;

public class MainActivity extends AppCompatActivity {

    private TextView textView;
    private EditText editText;
    private String fileName = "test.txt";

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        textView = findViewById(R.id.text_view);

        editText = findViewById(R.id.edit_text);

        Button buttonSave = findViewById(R.id.button_save);
        buttonSave.setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View v) {
                // エディットテキストのテキストを取得
                String text = editText.getText().toString();

                saveFile(fileName, text);
                if(text.length() == 0){
                    textView.setText(R.string.no_text);
                }
                else{
                    textView.setText(R.string.saved);
                }
            }
        });

        Button buttonRead = findViewById(R.id.button_read);
        buttonRead.setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View v) {
                String str = readFile(fileName);
                if (str != null) {
                    textView.setText(str);
                } else {
                    textView.setText(R.string.read_error);
                }
            }
        });

    }

    // ファイルを保存
    public void saveFile(String file, String str) {

        // try-with-resources
        try (FileOutputStream  fileOutputstream = openFileOutput(file,
                Context.MODE_PRIVATE);){

            fileOutputstream.write(str.getBytes());

        } catch (IOException e) {
            e.printStackTrace();
        }
    }

    // ファイルを読み出し
    public String readFile(String file) {
        String text = null;

        // try-with-resources
        try (FileInputStream fileInputStream = openFileInput(file);
             BufferedReader reader= new BufferedReader(
                     new InputStreamReader(fileInputStream, StandardCharsets.UTF_8))) {

            String lineBuffer;
            while( (lineBuffer = reader.readLine()) != null ) {
                text = lineBuffer ;
            }

        } catch (IOException e) {
            e.printStackTrace();
        }

        return text;
    }
}

import androidx.appcompat.app.AppCompatActivity;

import android.os.Bundle;

import android.content.Context;

import android.view.View;

import android.widget.Button;

import android.widget.EditText;

import android.widget.TextView;

import java.io.BufferedReader;

import java.io.FileInputStream;

import java.io.FileOutputStream;

import java.io.IOException;

import java.io.InputStreamReader;

import java.nio.charset.StandardCharsets;

public class MainActivity extends AppCompatActivity {

private TextView textView;

private EditText editText;

private String fileName = "test.txt";

@Override

protected void onCreate(Bundle savedInstanceState) {

super.onCreate(savedInstanceState);

setContentView(R.layout.activity_main);

textView = findViewById(R.id.text_view);

editText = findViewById(R.id.edit_text);

Button buttonSave = findViewById(R.id.button_save);

buttonSave.setOnClickListener(new View.OnClickListener() {

@Override

public void onClick(View v) {

// エディットテキストのテキストを取得

String text = editText.getText().toString();

saveFile(fileName, text);

if(text.length() == 0){

textView.setText(R.string.no_text);

}

else{

textView.setText(R.string.saved);

}

});

Button buttonRead = findViewById(R.id.button_read);

buttonRead.setOnClickListener(new View.OnClickListener() {

@Override

public void onClick(View v) {

String str = readFile(fileName);

if (str != null) {

textView.setText(str);

} else {

textView.setText(R.string.read_error);

}

});

}

// ファイルを保存

public void saveFile(String file, String str) {

// try-with-resources

try (FileOutputStream fileOutputstream = openFileOutput(file,

Context.MODE_PRIVATE);){

fileOutputstream.write(str.getBytes());

} catch (IOException e) {

e.printStackTrace();

}

// ファイルを読み出し

public String readFile(String file) {

String text = null;

// try-with-resources

try (FileInputStream fileInputStream = openFileInput(file);

BufferedReader reader= new BufferedReader(

new InputStreamReader(fileInputStream, StandardCharsets.UTF_8))) {

String lineBuffer;

while( (lineBuffer = reader.readLine()) != null ) {

text = lineBuffer ;

}

} catch (IOException e) {

e.printStackTrace();

}

return text;

}

　
レイアウト
activity_main.xml

<?xml version="1.0" encoding="utf-8"?>
<androidx.constraintlayout.widget.ConstraintLayout
    xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    tools:context=".MainActivity">

    <EditText
        android:id="@+id/edit_text"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_margin="50dp"
        android:autofillHints="@string/hint"
        android:background="#fff"
        android:hint="@string/hint"
        android:inputType="text"
        android:textSize="30sp"
        app:layout_constraintBottom_toBottomOf="parent"
        app:layout_constraintLeft_toLeftOf="parent"
        app:layout_constraintRight_toRightOf="parent"
        app:layout_constraintTop_toTopOf="parent"
        app:layout_constraintVertical_bias="0.05" />

    <Button
        android:id="@+id/button_save"
        android:layout_width="0dp"
        android:layout_height="wrap_content"
        android:text="@string/save_file"
        android:textSize="20sp"
        android:layout_marginStart="20dp"
        android:layout_marginTop="20dp"
        app:layout_constraintBottom_toBottomOf="parent"
        app:layout_constraintLeft_toLeftOf="parent"
        app:layout_constraintRight_toLeftOf="@+id/button_read"
        app:layout_constraintTop_toBottomOf="@+id/edit_text"
        app:layout_constraintVertical_bias="0.0" />

    <Button
        android:id="@+id/button_read"
        android:layout_width="0dp"
        android:layout_height="wrap_content"
        android:text="@string/read_file"
        android:textSize="20sp"
        android:layout_marginEnd="20dp"
        android:layout_marginTop="20dp"
        app:layout_constraintLeft_toRightOf="@+id/button_save"
        app:layout_constraintRight_toRightOf="parent"
        app:layout_constraintTop_toBottomOf="@+id/edit_text" />

    <TextView
        android:id="@+id/text_view"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="@string/app_name"
        android:textColor="#000"
        android:textSize="30sp"
        app:layout_constraintBottom_toBottomOf="parent"
        app:layout_constraintLeft_toLeftOf="parent"
        app:layout_constraintRight_toRightOf="parent"
        app:layout_constraintTop_toTopOf="parent"
        app:layout_constraintVertical_bias="0.4" />

</androidx.constraintlayout.widget.ConstraintLayout>

<?xml version="1.0" encoding="utf-8"?>

<androidx.constraintlayout.widget.ConstraintLayout

xmlns:android="http://schemas.android.com/apk/res/android"

xmlns:app="http://schemas.android.com/apk/res-auto"

xmlns:tools="http://schemas.android.com/tools"

android:layout_width="match_parent"

android:layout_height="match_parent"

tools:context=".MainActivity">

<EditText

android:id="@+id/edit_text"

android:layout_width="wrap_content"

android:layout_height="wrap_content"

android:layout_margin="50dp"

android:autofillHints="@string/hint"

android:background="#fff"

android:hint="@string/hint"

android:inputType="text"

android:textSize="30sp"

app:layout_constraintBottom_toBottomOf="parent"

app:layout_constraintLeft_toLeftOf="parent"

app:layout_constraintRight_toRightOf="parent"

app:layout_constraintTop_toTopOf="parent"

app:layout_constraintVertical_bias="0.05" />

<Button

android:id="@+id/button_save"

android:layout_width="0dp"

android:layout_height="wrap_content"

android:text="@string/save_file"

android:textSize="20sp"

android:layout_marginStart="20dp"

android:layout_marginTop="20dp"

app:layout_constraintBottom_toBottomOf="parent"

app:layout_constraintLeft_toLeftOf="parent"

app:layout_constraintRight_toLeftOf="@+id/button_read"

app:layout_constraintTop_toBottomOf="@+id/edit_text"

app:layout_constraintVertical_bias="0.0" />

<Button

android:id="@+id/button_read"

android:layout_width="0dp"

android:layout_height="wrap_content"

android:text="@string/read_file"

android:textSize="20sp"

android:layout_marginEnd="20dp"

android:layout_marginTop="20dp"

app:layout_constraintLeft_toRightOf="@+id/button_save"

app:layout_constraintRight_toRightOf="parent"

app:layout_constraintTop_toBottomOf="@+id/edit_text" />

<TextView

android:id="@+id/text_view"

android:layout_width="wrap_content"

android:layout_height="wrap_content"

android:text="@string/app_name"

android:textColor="#000"

android:textSize="30sp"

app:layout_constraintBottom_toBottomOf="parent"

app:layout_constraintLeft_toLeftOf="parent"

app:layout_constraintRight_toRightOf="parent"

app:layout_constraintTop_toTopOf="parent"

app:layout_constraintVertical_bias="0.4" />

</androidx.constraintlayout.widget.ConstraintLayout>

　
リソースファイル
strings.xml

<resources>
    <string name="app_name">TestFileInputOutput</string>
    <string name="no_text">"No text !"</string>
    <string name="saved">Saved</string>
    <string name="read_error">Read file error !</string>
    <string name="hint">文字を入力</string>
    <string name="save_file">Save file</string>
    <string name="read_file">Read file</string>
</resources>

<string name="app_name">TestFileInputOutput</string>

<string name="saved">Saved</string>

<string name="read_error">Read file error !</string>

<string name="hint">文字を入力</string>

</resources>

これで実行します。

一連の動作を確認してみます。

　
実際に保存したファイルを確認するときは
Android Studio 3.0から
Device File Explorer
を使うと確認できます。昔はADMと呼ばれていました、もっと昔にはDDMSと呼ばれていましたね…
Android Device Monitor, DDMS で確認

/data/data/[package_name]/files/以下に test.txt を作るようにコーディングしたつもりですが、ありました。クリックすると中身も見えて保存した内容が確認できました。

　
実機では
run-as [package name] をコマンドで打ち込んで確認できます
adb, run-as でローカルストレージ内をのぞく
　
　
関連記事：

SharedPreferences：データ保存
アプリ内にファイルを保存、読み出し
外部ストレージにファイルを保存する WRITE_EXTERNAL_STORAGE
外部ストレージに画像を保存・読出しをする
データベース SQLite の簡単作成
SQLiteのデータを確認する方法

　
References:
Context | Android Developers
View On-Device Files with Device File Explorer | Android Studio
ストレージオプション | Android Developers
ファイルを保存する | Android Developers