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

ファイルをアプリのローカルストレージに保存したり読み出したい場合は、FileOutputStream、 FileInputStreamを使うと簡単です。
　
下の例は、 EditText で入力した文字列を testfile.txt というファイルに入れて保存し、そのファイルから読み出す例です。その後run-asを使ってアプリ内にあるファイルと文字列を確認しました。
　

Android Studio 3.0.1
Android 8.0

FileOutputStream , FileInputStream

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

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

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

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
- このアプリのみアクセス許可

~~MODE_WORLD_READABLE / MODE_WORLD_WRITABLE~~
というモードもありましたが
API level 17 で Deprecated （非推奨）となりました

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

FileInputStream

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

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

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

　
読み出しは read() を使います
またtry〜catchをつかう場合にtry-with-resources 文を使いました。
　
MainActivity.java

import android.support.v7.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;

public class MainActivity extends AppCompatActivity {

    private TextView textView;
    private EditText editText;
    private String fileName = "testfile.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,"UTF-8"));
            ) {

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

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

        return text;
    }

}

100

import android.support.v7.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;

public class MainActivity extends AppCompatActivity {

private TextView textView;

private EditText editText;

private String fileName = "testfile.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,"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"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:orientation="vertical"
    android:gravity="center_horizontal"
    android:background="#dfe"
    tools:context=".MainActivity">

    <EditText
        android:id="@+id/edit_text"
        android:hint="@string/hint"
        android:layout_margin="50dp"
        android:textSize="30sp"
        android:background="#fff"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content" />

    <LinearLayout
        android:orientation="horizontal"
        android:gravity="center"
        android:layout_width="match_parent"
        android:layout_height="wrap_content">

        <Button
            android:id="@+id/button_save"
            android:text="@string/save_file"
            android:layout_margin="20dp"
            android:textSize="20sp"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content" />

        <Button
            android:id="@+id/button_read"
            android:text="@string/read_file"
            android:textSize="20sp"
            android:layout_margin="20dp"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content" />
    </LinearLayout>

    <TextView
        android:id="@+id/text_view"
        android:textSize="30sp"
        android:textColor="#000"
        android:layout_margin="20sp"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content" />

</LinearLayout>

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

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

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

android:layout_width="match_parent"

android:layout_height="match_parent"

android:orientation="vertical"

android:gravity="center_horizontal"

android:background="#dfe"

tools:context=".MainActivity">

<EditText

android:id="@+id/edit_text"

android:hint="@string/hint"

android:layout_margin="50dp"

android:textSize="30sp"

android:background="#fff"

android:layout_width="wrap_content"

android:layout_height="wrap_content" />

<LinearLayout

android:orientation="horizontal"

android:gravity="center"

android:layout_width="match_parent"

android:layout_height="wrap_content">

<Button

android:id="@+id/button_save"

android:text="@string/save_file"

android:layout_margin="20dp"

android:textSize="20sp"

android:layout_width="wrap_content"

android:layout_height="wrap_content" />

<Button

android:id="@+id/button_read"

android:text="@string/read_file"

android:textSize="20sp"

android:layout_margin="20dp"

android:layout_width="wrap_content"

android:layout_height="wrap_content" />

</LinearLayout>

<TextView

android:id="@+id/text_view"

android:textSize="30sp"

android:textColor="#000"

android:layout_margin="20sp"

android:layout_width="wrap_content"

android:layout_height="wrap_content" />

</LinearLayout>

　
リソースファイル
strings.xml

<?xml version="1.0"?>
    <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>

<?xml version="1.0"?>

<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/以下に testfile.txt を作るようにコーディングしたつもりですが、ありました。クリックすると中身も見えて保存した内容が確認できました。

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

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