データベース ビュー Room for Android

注: このチュートリアルでは、Kotlin による Android 用開発経験および Room での作業経験があることを前提としています。 Room に慣れていない場合は、「Room によるデータ永続化」チュートリアルをご覧ください。

このチュートリアルでは、Room でコルーチンを使用します。 詳細は、「Coroutines With Room Persistence Library」チュートリアルを参照してください。

@DatabaseView("SELECT user.id, user.name " + "AS departmentName FROM user " + "WHERE user.departmentId = department.id")class User { var id: Long = 0 var name: String? = null}

// 1val email = editEmail.text.toString()// 2if (validateEmail(email)) { // 3 val meal = when (radioGroupMeals.checkedRadioButtonId) { R.id.radioBreakfast -> "Breakfast" R.id.radioLunch -> "Lunch" R.id.radioDinner -> "Dinner" else -> "No Meal" } // 4 val customerSurvey = SurveyListItem .CustomerSurvey(0, email, meal, questionOneAnswer, questionTwoAnswer, questionThreeAnswer) customerSurveyViewModel.insertCustomerSurvey(customerSurvey) // 5 findNavController() .navigate(R.id.action_surveyFragment_to_surveyCompletedFragment)}

private val customerSurveyViewModel: CustomerSurveyViewModel by viewModels()

data class HappyBreakFastView( override val email: String) : SurveyListItem()

@DatabaseView("SELECT CustomerSurvey.email FROM CustomerSurvey WHERE CustomerSurvey.meal = 'Breakfast'")

注意: このチュートリアルでは、繰り返しを避け、コードを読みやすくするために、ビューとエンティティを SurveyListItem 内に置いています。 ビューは常にシールされたクラスでサブクラス化する必要はなく、独自の別のファイルまたはクラスにすることもできます。

Using Room Database Views in DAO Queries

最初に、アプリの @Database 内の views に HappyBreakFastView を含めます。

database/AppDatabase.kt に移動して、views 内で、SurveyListItem.HappyBreakFastView::class を追加します。 更新された @Database アノテーションは、次のようになります：

@Database(entities = , version = 2, exportSchema = false, views = )

Notice that the version = 2. AppDatabase に view を追加するたびに、データベースのバージョンを更新する必要があります – そうしないと、アプリがクラッシュします。 この場合、バージョンを 2 に更新しました。 これらの変更をすべて適用するために gradle を同期します。

次に、customers/CustomerSurveysDao.kt に移動して、getQuestionOneSadView() 直下に、次のコードを追加してください。

@Query("SELECT * FROM HappyBreakFastView")fun getHappyBreakFastCustomers():LiveData<List<SurveyListItem.HappyBreakFastView>>

このメソッドは、レストランからアンケートのいずれかの側面に満足したすべての顧客を取得します。

• 最初に、通常のクエリと同様に HappyBreakFastView を使用します。
• このメソッドを CustomerSurveyRepo で呼び出し、いずれかの質問に「良い」と回答したすべての顧客のリストを取得します。 このメソッドの戻り値の型は、観測可能な変数ホルダーである SurveyListItem.HappyBreakFastView 型のリスト LiveData であることに注意してください。

さて、あなたは view と CustomerSurveysDao で肯定的に回答した顧客のリストを照会するメソッドを作成しました。 次のセクションでは、リポジトリ クラスからこのメソッドを呼び出す方法を学びます。

DatabaseViewを使用してデータを取得する

customersurveys/CustomerSurveyRepo.ktに移動して、getQuestionOneSadView()のすぐ下に次のメソッドを追加します：

fun getHappyBreakFastCustomers() : LiveData<List<SurveyListItem.HappyBreakFastView>> { return customerSurveysDao.getHappyBreakFastCustomers()}

このメソッドはCustomerSurveysDaoからgetHappyBreakFastCustomers()を呼び出して、Roomからデータを取得します。 その戻り値はLiveDataで、このメソッドの呼び出し元はデータの変化を観察することができます。

次に、CustomerSurveyViewModelにgetHappyBreakFastCustomers()への呼び出しを追加します。 これは、ビューにデータを表示する役割を果たします。この場合、ビューはDatabaseViewではなく、AllSurveysFragmentです。

「customersurveys/CustomerSurveyViewModel.kt」に移動し、次のコードを追加します。

val happyBreakfastCustomers : LiveData<List<SurveyListItem.HappyBreakFastView>> by lazy { customerSurveyRepo.getHappyBreakFastCustomers()}

この変数は CustomerSurveyRepo から getHappyBreakFastCustomers() を呼び出してその値を取得します。

次に、データを表示できるように UI を更新します。

データを UI に表示する

allsurveys/AllSurveysFragment に移動します。

private fun getHappyBreakfastCustomers() { customerSurveyViewModel.happyBreakfastCustomers.observe(viewLifecycleOwner, Observer { customerSurveyList -> if (customerSurveyList.isEmpty()) { layoutEmptyView.visibility = View.VISIBLE rvReviews.visibility = View.GONE } else { layoutEmptyView.visibility = View.GONE rvReviews.visibility = View.VISIBLE initView(customerSurveyList) } })}private fun initView(customerSurveySurveyList: List<SurveyListItem.HappyBreakFastView>) { val customerSurveysAdapter = CustomerSurveysAdapter(customerSurveySurveyList) rvReviews.adapter = customerSurveysAdapter}

このコードが何を行うかを説明します。

• 最初に、happyBreakfastCustomers を呼び出してその値を観察します。
• 観察ラムダの内部では、customerSurveyList が null かどうかを確認します。 リストがnullの場合、TextViewのNo surveys found! メッセージをvisibleに設定し、RecyclerViewを非表示にします。 null でない場合は、TextView の可視性を GONE に設定し、RecyclerView を表示します。
• initView(customerSurveySurveyList: List) は CustomerSurveysAdapter を customerSurveyList で初期化し、RecyclerView のアダプタを CustomerSurveysAdapter に設定して、アンケートのリストを UI に表示します。

IDE は SurveyListItem インポートを追加するように促します。

import com.raywenderlich.android.customersurveys.customersurveys.SurveyListItem

これで UI にデータが表示されましたが、すべてが完璧に動作するまでには、あと数ステップしかありません。

次に、ユーザー インターフェイス (スピナー ウィジェット) のドロップダウンで選択されたオプションに応じて Room からデータをフェッチするコードを追加します。

異なるビューのデータをフェッチする

以下のコード部分を AllSurveysFragment.kt::

private fun spinnerListener() { filterSpinner.onItemSelectedListener = object : AdapterView.OnItemSelectedListener { override fun onNothingSelected(parent: AdapterView<*>?) {} override fun onItemSelected(parent: AdapterView<*>?, view: View?, position: Int, id: Long) { when (position) { 0 -> resetState() 1 -> getAllCustomerSurveys() 2 -> getHappyBreakfastCustomers() 3 -> getSadDinnerCustomers() 4 -> getAverageLunchCustomers() 5 -> getQuestionOneSadCustomers() } } }}

上のコード部分は onItemSelectedListener を filterSpinner に設定し、2 つのメソッドをオーバーライドします。 onNothingSelected と onItemSelected です。 何も選択されていないときは何もしたくないので、onNothingSelectedは空のままです。

onItemSelected には when 式があり、filterSpinner で選択されたオプションに応じて異なるメソッドを呼び出します。 これらのメソッドは getHappyBreakfastCustomers() と似ていますが、別の DatabaseView を使用してデータをフェッチします。

最後に、次のように setupSpinner() のすぐ後に、onViewCreated 内で spinnerListener() への呼び出しを追加します。

Navigating to All Surveys

これは、ビューの動作を確認するために必要な最後のステップです。

completedsurvey/SurveyCompletedFragment.kt に移動して、btnViewSurveys 内のコードをアンコメントしてください。 最終結果は次のようになります。

override fun onViewCreated(view: View, savedInstanceState: Bundle?) { super.onViewCreated(view, savedInstanceState) btnViewSurveys.setOnClickListener { findNavController() .navigate(R.id.action_surveyCompletedFragment_to_allSurveysFragment) }}

ここでは、VIEW SURVEYS ボタンのクリック リスナーを設定し、AllSurveysFragment に移動しています。

コードのコメントを解除すると、IDE は findNavController() をインポートするように要求します。 必要な.

をインポートするだけで、アンケートを構築、実行、開始し、質問に回答して送信することができます。 最後に、すべてのアンケートを表示し、スピナーで選択したオプションに応じてすべてのデータを取得することができます。

Congratulations ! あなたはビューレストランでの体験を終了しました。 素晴らしい食事をし、素晴らしい景色を眺め、DatabaseViews が何であるかを学ぶ機会があったことを願っています。

ここからどこへ行くのでしょうか。

チュートリアルの上部または下部にある [Download Materials] ボタンを使用して、最終プロジェクトをダウンロードします。

Room の機能についての詳細情報は、Android からの公式ドキュメントをチェックしてください。