Android Jetpack

Jetpack 是一套庫、工具和指南莫绣，可幫助開發(fā)者更輕松地編寫優(yōu)質(zhì)應(yīng)用匪补。這些組件可幫助您遵循最佳做法、讓您擺脫編寫樣板代碼的工作并簡化復(fù)雜任務(wù)溢豆，以便您將精力集中放在所需的代碼上。
Jetpack 包含與平臺 API 解除捆綁的 androidx.* 軟件包庫瘸羡。這意味著漩仙，它可以提供向后兼容性，且比 Android 平臺的更新頻率更高犹赖，以此確保您始終可以獲取最新且最好的 Jetpack 組件版本队他。

Room

Room 持久性庫在 SQLite 的基礎(chǔ)上提供了一個抽象層，讓用戶能夠在充分利用 SQLite 的強(qiáng)大功能的同時峻村，獲享更強(qiáng)健的數(shù)據(jù)庫訪問機(jī)制麸折。

開始使用

1.注入依賴

在app目錄下的build.gradle的dependencies添加如下代碼

 def room_version = "2.2.5"
 implementation "androidx.room:room-runtime:$room_version"
 kapt  "androidx.room:room-compiler:$room_version"

此處需要說明的是使用kapt 需要在該文件的最上方添加

apply plugin: 'kotlin-kapt'

2.創(chuàng)建ORM映射類

    @Entity
    class Person constructor(){
        constructor(name:String,age:Int):this(){
            this.name = name
            this.age = age
        }
        @PrimaryKey(autoGenerate = true)
        var id:Int? = null
        var name:String? = null
        var age:Int? = null
    
        @Ignore
        var sex:Int?=null
        override fun toString(): String {
            return "Person(id=$id, name=$name, age=$age, sex=$sex)"
        }
    }

可以看見類中用到了幾個注解，那就先來了解一下相關(guān)的注解及作用粘昨。

@Entity注解：標(biāo)識數(shù)據(jù)庫映射關(guān)系的類垢啼，可以指定表名等，不指定的話默認(rèn)表=名和類名一致张肾，索引等信息
@PrimaryKey注解：指定主鍵芭析，可設(shè)置自動增長等屬性
@ColumnInfo注解：指定列信息，如列名等信息
@Ignore注解：標(biāo)識忽略此屬性吞瞪，不對應(yīng)生成數(shù)據(jù)庫字段
@Dao注解：標(biāo)識Dao層注解馁启，編譯時候會生成該接口或抽象類的實現(xiàn)
@Insert注解：標(biāo)識該抽象方法為插入數(shù)據(jù)庫，入?yún)镋ntity注解標(biāo)注的類對象
@Query注解：標(biāo)識該抽象方法為查詢的方法（表面）芍秆，需傳入sql語句惯疙，其實sql語句可以實現(xiàn)增刪改查的操作，也就是說可以實現(xiàn)常用全部操作
@Delete注解：標(biāo)注該方法為刪除的方法妖啥，入?yún)镋ntity注解標(biāo)注的類對象
@Update注解：標(biāo)注該方法為更新的方法霉颠，入?yún)镋ntity注解標(biāo)注的類對象
@Database注解：標(biāo)注該類為數(shù)據(jù)庫操作類，一般為單例對象迹栓，入?yún)ntities為對應(yīng)映射的kclass對象集合掉分，verson處理數(shù)據(jù)庫升級相關(guān)俭缓，通過此類可以拿到相關(guān)數(shù)據(jù)庫操作的dao對象克伊，進(jìn)行相關(guān)的數(shù)據(jù)庫操作

3.創(chuàng)建Dao(常用增刪改查四個方法)

    @Dao
    abstract class PersonDao {
        @Insert
        abstract fun insert(person: Person)
        @Delete
        abstract fun delete(person: Person)
        @Update
        abstract fun update(person: Person)
        @Query("SELECT * FROM Person")
        abstract fun getPersonList():MutableList<Person>
    }

直接通過對象來操作增刪改查

4.創(chuàng)建RoomDatabase子類，持有dao的引用

    @Database(entities = [Person::class], version = 1)
    abstract class PersonRoomDatabase : RoomDatabase() {
        abstract fun personDao(): PersonDao
        companion object {
            @Volatile
            private var instance: PersonRoomDatabase? = null
            fun getPersonRoomDatabase(context:Context):PersonRoomDatabase{
                if (null == instance){
                    synchronized(PersonRoomDatabase::class){
                        if (null == instance){
                            instance = Room.databaseBuilder(context.applicationContext,PersonRoomDatabase::class.java,"db_person").allowMainThreadQueries().build()
                        }
                    }
                }
                return instance!!
            }
        }
    }

5.調(diào)用(增刪改查)

增

val personDao = PersonRoomDatabase.getPersonRoomDatabase(this).personDao()
val person = Person("張三",18)
personDao.insert(person)

刪

val person = Person()
person.id = 1
personDao.delete(person)

改

val person = Person("李四",20)
person.id = 2
personDao.update(person)

查

var personList: MutableList<Person> = personDao.getPersonList()
Log.d(Common.TAG,"共有${personList.size}個人")
personList.forEach {
    Log.d(Cst.TAG,it.toString())
}

以上就是常用增刪改查的基本操作华坦，想要高端操作愿吹，我們繼續(xù)看

6.拓展操作

用@Query注解也可以實現(xiàn)增刪改，讓你繼續(xù)感受自己寫sql的快感


@Query("insert into Person values (:id,:name,:age)")
    fun insertQuery(id:Int?,name:String?,age:Int?)
@Query("delete from Person where id = :id")
    fun deleteQuery(id:Int?)
@Query("update Person set name = :name , age = :age where id= :id")
    fun updateQuery(id:Int?,name:String?,age:Int?)
@Query("select * from Person where id= :id")
    fun findById(id:Int?): MutableList<Person>
 @Query("select * from Person where age > :age")
    fun findByAge(age:Int?): MutableList<PersonBean>
@Query("select * from Person where name like :name")
    fun findByNameRule(name: String?): MutableList<Person>

調(diào)用方法和上面一樣

7.Room升級

當(dāng)我們增刪表惜姐，修改表結(jié)構(gòu)犁跪，增刪字段的時候就需要升級
升級步驟如下
1.修改版本號椿息，在RoomDatabase的子類中，改變version的值(我上一個版本是1)

@Database(entities = [PersonBean::class,Teacher::class], version = 2)

2.如果是增加表坷衍，則相應(yīng)的增加寝优、減少entities數(shù)組的內(nèi)容，如果是增刪字段枫耳，在對應(yīng)的ORM映射類中增刪即可
3.增加Migration

Room.databaseBuilder(context.applicationContext,PersonRoomDatabase::class.java,"db_test")
                            .addMigrations(object: Migration(1,2){
                                override fun migrate(database: SupportSQLiteDatabase) {
                                    //此處為增刪表乏矾、增刪字段的sql書寫處
                                    database.execSQL("CREATE TABLE IF NOT EXISTS `Teacher` (" +
                                            "`id` INTEGER PRIMARY KEY AUTOINCREMENT," +
                                            "`name` TEXT," +
                                            "`classes` TEXT," +
                                            "`age` INTEGER " +
                                            ");")
                                }
                            })
                            .allowMainThreadQueries().build()

源碼地址

https://github.com/DalesDawson/JetPackStudy

這是本人在學(xué)習(xí)過程中產(chǎn)生的總結(jié)，記錄一下迁杨，如有錯誤請各位大佬及時指出

JetPack學(xué)習(xí)之路一：Room庫的使用(Kotlin)