ソフトウェアエンジニアリング

レイアウトの確認をするため、実行（Android Device上で実行）したところ次のエラーに。

Installation did not succeed.
The application could not be installed: INSTALL_FAILED_UPDATE_INCOMPATIBLE

アプリケーションのIDが、Java編とかぶっているため、アプリケーションIDは次に定義

• appモジュールのbuild.gradle
  

  android {
    :
    defaultConfig {
      applicationId "com.torutk.temprecorder" 
      :
  

• appモジュールのsrc/main/AndroidManifest.xml
  

  <manifest xmlns:android=..
      package="com.torutk.temprecorder">
  

この2か所を整合をもって変更する。
このパッケージ名は、ソースコードのパッケージ（Activityの配置しているパッケージ）として使われるので、ソースコードのパッケージも合わせて修正。

コントローラのロジック¶

検温日時の保持と表示¶

• 画面が表示されたときに、現在日時を検温日時として表示する
• 10分前／10分後ボタンを押すと、検温日時を変更する

日時（java.time.LocalDateTime）をフィールドに持ち、ボタンをクリックするとフィールドに保持した日時を±10分増減する。
日時を表示のために文字列化するには、java.time.format.DateTimeFormatterを用いる。

internal val DATE_TIME_VIEW_FORMATTER = DateTimeFormatter.ofPattern("MM.dd HH:mm")

class MainActivity : AppCompatActivity() {

    private var measuredAt: LocalDateTime = LocalDateTime.now() // 検温日時
        set(dateTime: LocalDateTime) {
            field = dateTime
            measuredAtTextView.text = field.format(DATE_TIME_VIEW_FORMATTER)
        }
   :

DateTimeFormatterのインスタンスはスレッドセーフなので、Javaでは静的フィールドのfinal定数で保持している。
一方Kotlinには静的フィールド（staticなプロパティ）がない。通常コンパニオンオブジェクトを使うが、今回はクラス定義の外、ファイルスコープに定義する。

LodalDateTimeインスタンスはプロパティとして保持する。LodalDateTimeインスタンスはイミュータブルなので日時の変更はプロパティの値の再代入となる。この再代入時には表示更新を伴うのでカスタムのアクセッサを定義し、表示更新を追加した。
なお、Kotlinでは表示部品のインスタンスを、findViewByIdを利用せずに表示部品のidと同じ名前の変数名で利用可能。

ボタンを押した際の処理は、ボタンのインスタンスにsetOnClickListenerでラムダ式を渡している。

    override fun onCreate(savedInstanceState: Bundle?) {
        :
        dec10MinButton.setOnClickListener { measuredAt = measuredAt.minusMinutes(10) }
        inc10MinButton.setOnClickListener { measuredAt = measuredAt.plusMinutes(10) }
    }

Kotlinのラムダ式は、引数1つの場合、引数を省略可（itで参照できる）。

体温の入力用NumberPicker¶

最小値、最大値、初期値、周回有無の設定は、レイアウトエディタから設定できなかったのでコードで行う。

    override fun onCreate(savedInstanceState: Bundle?) {
        :
        with(integralNumberPicker) {
            minValue = 35
            maxValue = 40
            value = 36
            wrapSelectorWheel = false
        }
        with(fractionNumberPicker) {
            minValue = 0
            maxValue = 9
            value = 5
        }

withスコープを使うと、同じインスタンスに対して複数のメソッド呼び出しをする際、行数は同じだがレシーバーの記述を省略できるので簡潔明瞭になる。

登録ボタン¶

登録ボタンを押すと、画面に表示されている検温日時と体温をコンテントプロバイダに新規登録する。
現時点はコンテントプロバイダが未実装のため、privateメソッドの呼び出しまで実装する。

    override fun onCreate(savedInstanceState: Bundle?) {
        :
        submitButton.setOnClickListener { submitTemp() }
    }

    private fun submitTemp() {
        val temp = integralNumberPicker.value + fractionNumberPicker.value / 10.0
        // TODO: コンテントプロバイダ実装後に記述
    }

RecyclerViewの実装については、次のWikiページに記載

Androidプログラミング-RecyclerView

コンテントプロバイダの作成（続）¶

ContentProviderのサブクラス作成¶

コンテントプロバイダとして次の2種類のリクエストに対応する。

1. すべての検温記録を取得
2. 指定したIDの検温記録1件を取得

利用者は、次のコンテントURIでリクエストを指定する。

1. "content://com.torutk.temprecorder.kt.provider/temperatures"
2. "content://com.torutk.temprecorder.kt.provider/temperatures/987"
   注）987 の部分はIDで、検温記録に対応する任意の数値

URIを判別するUriMatcherクラスのプロパティを定義し、URIとURIに対応する数値を定義する。
トップレベルプロパティに定義。

private const val TEMPERATURES = 1
private const val TEMPERATURES_ID = 2
private val uriMatcher = UriMatcher(UriMatcher.NO_MATCH).apply {
    addURI(TempContract.AUTHORITY, "temperatures", TEMPERATURES)
    addURI(TempContract.AUTHORITY, "temperatures/#", TEMPERATURES_ID)
}

クラス定義、プロパティにSQLiteOpenHelperのサブクラスを保持

class TempProvider : ContentProvider() {

    private lateinit var dbHelper: TempDbHelper

最低限実装するメソッドは、insert、onCreate、query の３つ。

まず onCreate

    override fun onCreate(): Boolean {
        dbHelper = TempDbHelper(context!!)
        return true
    }

insertのエラー処理やcloseなどが怪しい最低限の実装

    override fun insert(uri: Uri, values: ContentValues?): Uri? {
        val database = dbHelper.writableDatabase
        val id = database.insert(TempContract.TempEntry.TABLE_NAME, null, values)
        val insertedUri = Uri.withAppendedPath(uri, id.toString())
        context?.contentResolver?.notifyChange(uri, null)
        return insertedUri
    }

databaseのcloseが必要では、とかinsertに失敗時の処理が必要では、など。

insertの引数 uri の中をチェックしてエラー処理をしている例もネット上に見かけた。

        return when (uriMatcher.match(uri)) {
            TEMPERATURES -> {
                val id = dbHelper.writableDatabase.insert(TempContract.TempEntry.TABLE_NAME, null, values)
                val insertedUri = Uri.withAppendedPath(uri, id.toString())
                context!!.contentResolver.notifyChange(insertedUri, null)
                insertedUri
            }
            TEMPERATURES_ID -> {
                throw IllegalArgumentException("Invalid URI, cannot insert with ID: $uri")
            }
            else -> throw IllegalArgumentException("Unknown URI: $uri")
        }

queryの実装

    override fun query(
        uri: Uri, projection: Array<String>?, selection: String?,
        selectionArgs: Array<String>?, sortOrder: String?
    ): Cursor? {
        val db = dbHelper.readableDatabase
        val cursor: Cursor
        when (uriMatcher.match(uri)) {
            TEMPERATURES -> {
                cursor = db.query(
                    TempContract.TempEntry.TABLE_NAME,
                    projection,
                    selection,
                    selectionArgs,
                    null,
                    null,
                    sortOrder
                )
            }
            TEMPERATURES_ID -> {
                cursor = db.query(
                    TempContract.TempEntry.TABLE_NAME,
                    projection,
                    "_id = ?",
                    arrayOf(uri.lastPathSegment),
                    null,
                    null,
                    sortOrder
                )
            }
            else -> throw IllegalArgumentException("Unknown URI ${uri}")
        }
        cursor.setNotificationUri(context!!.contentResolver, uri)
        return cursor
    }

MainActivity.kt にコンテントプロバイダアクセスを追記

 class MainActivity : AppCompatActivity() {
+    lateinit var tempAdapter: TempAdapter
+    lateinit var tempProviderObserver: ContentObserver

• RecyclerViewのAdapterサブクラスをプロパティに追加
• コンテントプロバイダの変更を観測するオブザーバーをプロパティに追加
• lateinitとしたのはonCreateで初期化するため。

     override fun onCreate(savedInstanceState: Bundle?) {
         :
+        tempAdapter = TempAdapter(null)
+        tempRecyclerView.adapter = tempAdapter
+        tempProviderObserver = object : ContentObserver(Handler()) {
+            override fun onChange(selfChange: Boolean) {
+                super.onChange(selfChange)
+                queryTemp()
+            }
+        } 

• プロパティ tempAdapterとtempProviderObserverの初期化
• tempAdapterは、recyclerViewに登録
• queryTempメソッドはコンテントプロバイダのqueryを呼び出し一覧を取得するメソッドで実装は後述

+    override fun onStart() {
+        super.onStart()
+        queryTemp()
+    }

• onStartでアプリ画面の表示時に一覧を取得

     override fun onResume() {
         super.onResume()
         measuredAt = LocalDateTime.now()
+        contentResolver.registerContentObserver(TempContract.CONTENT_URI, true, tempProviderObserver)
    }

• コンテントプロバイダの変更を観測するオブザーバーを登録

+    override fun onPause() {
+        super.onPause()
+        contentResolver.unregisterContentObserver(tempProviderObserver)
+    }

• オブザーバーの解除

+    private fun queryTemp() {
+        val cursor = contentResolver.query(
+            TempContract.CONTENT_URI, null, null, null, "_id DESC" 
+        )
+        cursor?.let { tempAdapter.swapCursor(cursor) }
+    }

• コンテントプロバイダから一覧取得するメソッド作成

     private fun submitTemp() {
+        val values = ContentValues().apply {
+            put(TempContract.TempEntry.MEASURED_AT, measuredAt.format(DateTimeFormatter.ISO_LOCAL_DATE_TIME))
+            put(TempContract.TempEntry.MEASUREMENT, integralNumberPicker.value + fractionNumberPicker.value / 10.0)
+        }
+        contentResolver.insert(TempContract.CONTENT_URI, values)
     }

• 検温結果を登録する処理を記述したメソッド

アプリを実行するとすぐに落ちてしまう。

2020-09-21 11:20:47.810 19975-19975/com.torutk.temprecorder.kt E/AndroidRuntime: FATAL EXCEPTION: main
    Process: com.torutk.temprecorder.kt, PID: 19975
    java.lang.RuntimeException: Unable to resume activity {com.torutk.temprecorder.kt/com.torutk.temprecorder.kt.MainActivity}: java.lang.SecurityException: Failed to find provider com.tourtk.temprecorder.kt.provider for user 0; expected to find a valid ContentProvider for this authority
        at android.app.ActivityThread.performResumeActivity(ActivityThread.java:4205)
        :
     Caused by: java.lang.SecurityException: Failed to find provider com.tourtk.temprecorder.kt.provider for user 0; expected to find a valid ContentProvider for this authority
        at android.os.Parcel.createException(Parcel.java:2071)
        :
        at com.torutk.temprecorder.kt.MainActivity.onResume(MainActivity.kt:60)
        :

アプリ側の次のコード

        contentResolver.registerContentObserver(TempContract.CONTENT_URI, true, tempProviderObserver)

コンテントURIが一致しないというエラー、原因はどこかAndroidManifestも含めて調べたところ、
TempContract の AUTHORITY の文字列定数定義の誤記と判明

-        const val AUTHORITY = "com.tourtk.temprecorder.kt.provider" 
+        const val AUTHORITY = "com.torutk.temprecorder.kt.provider"