Java-AndroidStudioでFirebaseCloudFirestoreからデータを取得し、returnで返す関数で変数の扱いが上手くいきません。

Question

前提・実現したいこと

Firebaseを使ったAndroidアプリの開発において、CloudFirestoreからデータを取得し、そのデータをreturnで返す関数を作成したいです。

発生している問題・エラーメッセージ

発生している問題は、returnで返す変数にCloudFirestoreから取得した値が上手く格納されないことです。
具体的な状況は「試したこと」の欄に記入してあります。

エラーメッセージは出ていません。

該当のソースコード

//指定のドキュメントリファレンスの指定のフィールドのデータを返す関数 (本題)
    public Object getFirestoreData (DocumentReference docRef, final String field) {
        final Object[] data = new Object[1];
        docRef.get().addOnCompleteListener(new OnCompleteListener<DocumentSnapshot>() {
            @Override
            public void onComplete(@NonNull Task<DocumentSnapshot> task) {
                if (task.isSuccessful()) {
                    DocumentSnapshot document = task.getResult();
                    if (document.exists()) {
                        data[0] = document.get(field);
                    } else {
                        data[0] = "no_data";
                    }
                } else {
                    data[0] = "failure";
                }
            }
        });
        return data[0];
    }


//取得したデータが正常にdata[0]に格納されていることが確認できた関数 (試したこと1)
    public void setFirestoreData (DocumentReference docRef, final String field, final TextView text_view) {
        final Object[] data = new Object[1];
        final String[] str = new String[1];
        docRef.get().addOnCompleteListener(new OnCompleteListener<DocumentSnapshot>() {
            @Override
            public void onComplete(@NonNull Task<DocumentSnapshot> task) {
                if (task.isSuccessful()) {
                    DocumentSnapshot document = task.getResult();
                    if (document.exists()) {
                        data[0] = document.get(field);
                    } else {
                        data[0] = "no_data";
                    }
                } else {
                    data[0] = "failure";
                }
                str[0] = data[0].toString();
                text_view.setText(str[0]);
            }
        });
    }


//onComplete外ではdata[0]==nullが確認できた関数 (試したこと2)
    public void setFirestoreData (DocumentReference docRef, final String field, final TextView text_view) {
        final Object[] data = new Object[1];
        final String[] str = new String[1];
        docRef.get().addOnCompleteListener(new OnCompleteListener<DocumentSnapshot>() {
            @Override
            public void onComplete(@NonNull Task<DocumentSnapshot> task) {
                if (task.isSuccessful()) {
                    DocumentSnapshot document = task.getResult();
                    if (document.exists()) {
                        data[0] = document.get(field);
                    } else {
                        data[0] = "no_data";
                    }
                } else {
                    data[0] = "failure";
                }
            }
        });
        if (data[0] != null) {
            str[0] = data[0].toString();
        } else {
            str[0] = "NULL";
        }
        text_view.setText(str[0]);
    }

試したこと

一度、関数を戻り値の無い形にし、複数の場所でdata[0]をString型に変換、TextViewにsetして確認してみたところ、「public void onComplete」の中では取得したデータが正常にdata[0]に格納されていましたが、「public void onComplete」の外ではdata[0]がnullになっていました。

補足情報（FW/ツールのバージョンなど）

Android Studio 4.0.1,
API 29,
Android 10.0

Answer 1

docRef.get().addOnCompleteListener(new OnCompleteListener<DocumentSnapshot>() {
            @Override
            public void onComplete(@NonNull Task<DocumentSnapshot> task) {
                if (task.isSuccessful()) {
                }
            }
});

の部分は別スレッド(非同期)での処理となり、docRef.get().addOnCompleteListenerが実行されてから、OnCompleteListenerがトリガーされたに関わらずdocRef.get()以降の処理が実行されているため、onComplete内で記述しないと取得した値を使えない、ということでした。

Answer 2

docRef.get().addOnCompleteListener(new OnCompleteListener<DocumentSnapshot>() {
            @Override
            public void onComplete(@NonNull Task<DocumentSnapshot> task) {
                if (task.isSuccessful()) {
                }
            }
});

の部分は別スレッド(非同期)での処理となり、docRef.get()が実行されてから、OnCompleteListenerがトリガーされたに関わらずdocRef.get()以降の処理が実行されているため、onComplete内で記述しないと取得した値を使えない、ということでした。