Jetpack下的Room簡(jiǎn)單使用

概述

Room持久性庫(kù)在SQLite的基礎(chǔ)上提供了一個(gè)抽象層炼列，讓用戶能夠在充分利用SQLite的強(qiáng)大功能的同時(shí)眠蚂，獲享更強(qiáng)健的數(shù)據(jù)庫(kù)訪問(wèn)機(jī)制辐董。

添加依賴

在app的build.gradle中添加如下依賴：


def room_version ="2.2.6"

implementation"androidx.room:room-runtime:$room_version"

annotationProcessor"androidx.room:room-compiler:$room_version" // For Kotlin use kapt instead of annotationProcessor

// Test helpers

testImplementation"androidx.room:room-testing:$room_version"

在app的build.gradle文件中甚亭，配置schemaLocation選項(xiàng)為app/schemas伐坏，方便我們查看數(shù)據(jù)庫(kù)架構(gòu)信息怔匣。


defaultConfig{

...

    //指定room.schemaLocation生成的文件路徑

    javaCompileOptions{

        annotationProcessorOptions{

            arguments =["room.schemaLocation":"$projectDir/schemas".toString()]

}

}

}

等我們創(chuàng)建好表和數(shù)據(jù)庫(kù)等信息的時(shí)候，編譯一下桦沉，會(huì)在app/schemas目錄下生成這樣的Json文件每瞒。

QQ20210715-103958@2x.png

創(chuàng)建一個(gè)實(shí)體類(lèi)，對(duì)應(yīng)數(shù)據(jù)庫(kù)中的一張表


@Entity(tableName ="User" ,indices ={@Index(value ={"user_name"}, unique =true)})//數(shù)據(jù)庫(kù)實(shí)體

public class User {

    @PrimaryKey(autoGenerate =true)

    private long id;

@ColumnInfo(name ="user_name")

    private String name;

@ColumnInfo(name ="user_gender")

    private String gender;

private int age;

private int type;

public User() {

}

    public User(long id,String name,String gender,int age,int type) {

        this.id = id;

this.name = name;

this.gender = gender;

this.age = age;

this.type = type;

}

    public User(String name,String gender,int age,int type) {

        this.name = name;

this.gender = gender;

this.age = age;

this.type = type;

}

@Entity：注解的類(lèi)對(duì)應(yīng)數(shù)據(jù)庫(kù)中的一張表纯露，我們可以指定表名剿骨，如果不指定的話，默認(rèn)是類(lèi)的名字埠褪。
@PrimaryKey：每一個(gè)表都需要一個(gè)主鍵浓利，這點(diǎn)需要注意，Room就是根據(jù)主鍵是否相同來(lái)判斷是否是同一個(gè)對(duì)象钞速。
@ColumnInfo：指定類(lèi)的屬性在表中列的名字贷掖，如果不指定，默認(rèn)就是屬性名渴语。
注意苹威，存儲(chǔ)在數(shù)據(jù)庫(kù)中的類(lèi)屬性可見(jiàn)性必須是public的。

創(chuàng)建DAO（data access object）

DAO必須是接口或者抽象類(lèi)驾凶，Room使用注解幫我們生成訪問(wèn)數(shù)據(jù)庫(kù)的代碼牙甫，感覺(jué)和Retrofit有類(lèi)似之處。接下來(lái)我們創(chuàng)建一個(gè)DAO類(lèi)调违，具有簡(jiǎn)單的增刪改查的功能窟哺。


@Dao //Database access object 數(shù)據(jù)庫(kù)訪問(wèn)接口 所有增刪改查等操作都在此聲明

public interface UserDao {

    // long 表示插入數(shù)據(jù)后返回的id

    @Insert(onConflict =OnConflictStrategy.REPLACE)

    void insertUser(User... user);

// int 影響的行數(shù)

    @Update

    int updateUser(User... user);

@Delete

    int deleteUser(User... user);

@Query("DELETE FROM USER")

    void deleteUser();

@Query("SELECT * FROM USER ORDER BY ID DESC")

    List<User> getAllUser();

@Query("SELECT * FROM USER ORDER BY ID DESC")

    LiveData<List<User>> getAllUserLive();

}

添加Room數(shù)據(jù)庫(kù)


//exportSchema = false 是不會(huì)導(dǎo)出 schemas json 結(jié)構(gòu)

@Database(entities ={User.class}, version =2, exportSchema =true)

public abstract class UserDatabase extends RoomDatabase {

    public abstract UserDao getUserDao();

private static UserDatabase userDatabase;

synchronized public static UserDatabase getUserDatabase(Context context) {

        if (null ==userDatabase) {

            userDatabase =Room.databaseBuilder(context.getApplicationContext(),UserDatabase.class,"android_room_dev.db")

                    .allowMainThreadQueries()

                    .addMigrations(migration) //保留原有數(shù)據(jù)

                    .build();

}

        return userDatabase;

}

    static final Migration migration =new Migration(1,2) {

        @Override

        public void migrate(@NonNull SupportSQLiteDatabase database) {

            database.execSQL("ALTER TABLE user ADD COLUMN type INTEGER NOT NULL DEFAULT 1");

//sqlLet沒(méi)有刪除字段語(yǔ)句，只能創(chuàng)建新的數(shù)據(jù)庫(kù)定義需要的字段翰萨，將原有數(shù)據(jù)庫(kù)數(shù)據(jù)復(fù)制過(guò)去脏答，刪除舊數(shù)據(jù)庫(kù)后再將新數(shù)據(jù)庫(kù)重命名

        }

    };

}

Room數(shù)據(jù)庫(kù)必須是一個(gè)繼承自RoomDatabase的抽象類(lèi)。通常情況下應(yīng)用內(nèi)應(yīng)該只有一個(gè)Room數(shù)據(jù)庫(kù)實(shí)例亩鬼。

在demo中的簡(jiǎn)單使用


public class MainActivity extends AppCompatActivity {

    TextView tvAdd;

TextView tvUpdate;

TextView tvDelete;

TextView tvQuery;

TextView tvQueryAll;

TextView tvContent;

UserDatabase userDatabase;

@Override

    protected void onCreate(Bundle savedInstanceState) {

        super.onCreate(savedInstanceState);

userDatabase =UserDatabase.getUserDatabase(this);

setContentView(R.layout.activity_main);

tvAdd = findViewById(R.id.tv_add);

tvUpdate = findViewById(R.id.tv_update);

tvDelete = findViewById(R.id.tv_delete);

tvQuery = findViewById(R.id.tv_query);

tvQueryAll = findViewById(R.id.tv_queryAll);

tvContent = findViewById(R.id.tv_content);

UserDao userDao =userDatabase.getUserDao();

LiveData<List<User>> listLiveData =userDao.getAllUserLive();

listLiveData.observe(this,new Observer<List<User>>() {

            @Override

            public void onChanged(List<User> users) {

                String s ="";

for (int i =0; i < users.size(); i++) {

                    User user = users.get(i);

s +="姓名：" +user.getName() +"性別：" +user.getGender() +"年齡：" +user.getAge() +"類(lèi)型：" +user.getType() +"\n";

}

                tvContent.setText(s);

}

        });

tvAdd.setOnClickListener(new View.OnClickListener() {

            @Override

            public void onClick(View view) {

                User user =new User();

user.setName("張三" +new Random().nextInt(100));

user.setAge(new Random().nextInt(100));

user.setGender(new Random().nextInt(1) +"");

user.setType(new Random().nextInt(9));

userDao.insertUser(user);

}

        });

tvUpdate.setOnClickListener(new View.OnClickListener() {

            @Override

            public void onClick(View view) {

                List<User> users =userDao.getAllUser();

User user =users.get(0);

user.setName("瑪麗哈利");

userDao.updateUser(user);

}

        });

tvDelete.setOnClickListener(new View.OnClickListener() {

            @Override

            public void onClick(View view) {

                List<User> users =userDao.getAllUser();

if(users!=null &&users.size()>0){

                    User user =users.get(0);

userDao.deleteUser(user);

}

}

        });

tvQuery.setOnClickListener(new View.OnClickListener() {

            @Override

            public void onClick(View view) {

                List<User> users =userDao.getAllUser();

String s ="";

for (int i =0; I

                    User user =users.get(i);

s +="姓名：" +user.getName() +"性別：" +user.getGender() +"年齡：" +user.getAge() +"類(lèi)型：" +user.getType() +"\n";

}

                Toast.makeText(MainActivity.this,s,Toast.LENGTH_LONG).show();

}

        });

tvQueryAll.setOnClickListener(new View.OnClickListener() {

            @Override

            public void onClick(View view) {

}

        });

}

}

```**概述**

Room持久性庫(kù)在SQLite的基礎(chǔ)上提供了一個(gè)抽象層殖告，讓用戶能夠在充分利用SQLite的強(qiáng)大功能的同時(shí)，獲享更強(qiáng)健的數(shù)據(jù)庫(kù)訪問(wèn)機(jī)制雳锋。

**添加依賴**

在app的build.gradle中添加如下依賴：

def room_version ="2.2.6"

implementation"androidx.room:room-runtime:$room_version"

annotationProcessor"androidx.room:room-compiler:$room_version" // For Kotlin use kapt instead of annotationProcessor

// Test helpers

testImplementation"androidx.room:room-testing:$room_version"


**在app的build.gradle文件中黄绩，配置schemaLocation選項(xiàng)為app/schemas，方便我們查看數(shù)據(jù)庫(kù)架構(gòu)信息玷过。**

defaultConfig{

...

//指定room.schemaLocation生成的文件路徑

javaCompileOptions{

    annotationProcessorOptions{

        arguments =["room.schemaLocation":"$projectDir/schemas".toString()]

}


等我們創(chuàng)建好表和數(shù)據(jù)庫(kù)等信息的時(shí)候爽丹，編譯一下，會(huì)在app/schemas目錄下生成這樣的Json文件辛蚊。

【 ! + [圖片名稱] + (https://upload-images.jianshu.io/upload_images/7182690-7cae1e445eb5801c.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1200) 】

**創(chuàng)建一個(gè)實(shí)體類(lèi)粤蝎，對(duì)應(yīng)數(shù)據(jù)庫(kù)中的一張表**

@Entity(tableName ="User" ,indices ={@Index(value ={"user_name"}, unique =true)})//數(shù)據(jù)庫(kù)實(shí)體

public class User {

@PrimaryKey(autoGenerate =true)

private long id;

@ColumnInfo(name ="user_name")

private String name;

@ColumnInfo(name ="user_gender")

private String gender;

private int age;

private int type;

public User() {

}

public User(long id,String name,String gender,int age,int type) {

    this.id = id;

this.name = name;

this.gender = gender;

this.age = age;

this.type = type;

}

public User(String name,String gender,int age,int type) {

    this.name = name;

this.gender = gender;

this.age = age;

this.type = type;

}


+  @Entity：注解的類(lèi)對(duì)應(yīng)數(shù)據(jù)庫(kù)中的一張表，我們可以指定表名袋马，如果不指定的話初澎，默認(rèn)是類(lèi)的名字。

+  @PrimaryKey：每一個(gè)表都需要一個(gè)主鍵虑凛，這點(diǎn)需要注意碑宴，Room就是根據(jù)主鍵是否相同來(lái)判斷是否是同一個(gè)對(duì)象。

+  @ColumnInfo：指定類(lèi)的屬性在表中列的名字桑谍，如果不指定延柠，默認(rèn)就是屬性名。

+  注意锣披，存儲(chǔ)在數(shù)據(jù)庫(kù)中的類(lèi)屬性可見(jiàn)性必須是public的贞间。

**創(chuàng)建DAO（data access object）**

DAO必須是接口或者抽象類(lèi)，Room使用注解幫我們生成訪問(wèn)數(shù)據(jù)庫(kù)的代碼雹仿，感覺(jué)和Retrofit有類(lèi)似之處榜跌。接下來(lái)我們創(chuàng)建一個(gè)DAO類(lèi)，具有簡(jiǎn)單的增刪改查的功能盅粪。

@Dao //Database access object 數(shù)據(jù)庫(kù)訪問(wèn)接口所有增刪改查等操作都在此聲明

public interface UserDao {

// long 表示插入數(shù)據(jù)后返回的id

@Insert(onConflict =OnConflictStrategy.REPLACE)

void insertUser(User... user);

// int 影響的行數(shù)

@Update

int updateUser(User... user);

@Delete

int deleteUser(User... user);

@Query("DELETE FROM USER")

void deleteUser();

@Query("SELECT * FROM USER ORDER BY ID DESC")

List<User> getAllUser();

@Query("SELECT * FROM USER ORDER BY ID DESC")

LiveData<List<User>> getAllUserLive();

}


**添加Room數(shù)據(jù)庫(kù)**

//exportSchema = false 是不會(huì)導(dǎo)出 schemas json 結(jié)構(gòu)

@Database(entities ={User.class}, version =2, exportSchema =true)

public abstract class UserDatabase extends RoomDatabase {

public abstract UserDao getUserDao();

private static UserDatabase userDatabase;

synchronized public static UserDatabase getUserDatabase(Context context) {

    if (null ==userDatabase) {

        userDatabase =Room.databaseBuilder(context.getApplicationContext(),UserDatabase.class,"android_room_dev.db")

                .allowMainThreadQueries()

                .addMigrations(migration) //保留原有數(shù)據(jù)

                .build();

}

    return userDatabase;

}

static final Migration migration =new Migration(1,2) {

    @Override

    public void migrate(@NonNull SupportSQLiteDatabase database) {

        database.execSQL("ALTER TABLE user ADD COLUMN type INTEGER NOT NULL DEFAULT 1");

//sqlLet沒(méi)有刪除字段語(yǔ)句钓葫，只能創(chuàng)建新的數(shù)據(jù)庫(kù)定義需要的字段，將原有數(shù)據(jù)庫(kù)數(shù)據(jù)復(fù)制過(guò)去票顾，刪除舊數(shù)據(jù)庫(kù)后再將新數(shù)據(jù)庫(kù)重命名

    }

};

}


Room數(shù)據(jù)庫(kù)必須是一個(gè)繼承自RoomDatabase的抽象類(lèi)础浮。通常情況下應(yīng)用內(nèi)應(yīng)該只有一個(gè)Room數(shù)據(jù)庫(kù)實(shí)例。

**在demo中的簡(jiǎn)單使用**

public class MainActivity extends AppCompatActivity {

TextView tvAdd;

TextView tvUpdate;

TextView tvDelete;

TextView tvQuery;

TextView tvQueryAll;

TextView tvContent;

UserDatabase userDatabase;

@Override

protected void onCreate(Bundle savedInstanceState) {

    super.onCreate(savedInstanceState);

userDatabase =UserDatabase.getUserDatabase(this);

setContentView(R.layout.activity_main);

tvAdd = findViewById(R.id.tv_add);

tvUpdate = findViewById(R.id.tv_update);

tvDelete = findViewById(R.id.tv_delete);

tvQuery = findViewById(R.id.tv_query);

tvQueryAll = findViewById(R.id.tv_queryAll);

tvContent = findViewById(R.id.tv_content);

UserDao userDao =userDatabase.getUserDao();

LiveData<List<User>> listLiveData =userDao.getAllUserLive();

listLiveData.observe(this,new Observer<List<User>>() {

        @Override

        public void onChanged(List<User> users) {

            String s ="";

for (int i =0; i < users.size(); i++) {

                User user = users.get(i);

s +="姓名：" +user.getName() +"性別：" +user.getGender() +"年齡：" +user.getAge() +"類(lèi)型：" +user.getType() +"\n";

}

            tvContent.setText(s);

}

});

tvAdd.setOnClickListener(new View.OnClickListener() {

        @Override

        public void onClick(View view) {

            User user =new User();

user.setName("張三" +new Random().nextInt(100));

user.setAge(new Random().nextInt(100));

user.setGender(new Random().nextInt(1) +"");

user.setType(new Random().nextInt(9));

userDao.insertUser(user);

}

});

tvUpdate.setOnClickListener(new View.OnClickListener() {

        @Override

        public void onClick(View view) {

            List<User> users =userDao.getAllUser();

User user =users.get(0);

user.setName("瑪麗哈利");

userDao.updateUser(user);

}

});

tvDelete.setOnClickListener(new View.OnClickListener() {

        @Override

        public void onClick(View view) {

            List<User> users =userDao.getAllUser();

if(users!=null &&users.size()>0){

                User user =users.get(0);

userDao.deleteUser(user);

}

});

tvQuery.setOnClickListener(new View.OnClickListener() {

        @Override

        public void onClick(View view) {

            List<User> users =userDao.getAllUser();

String s ="";

for (int i =0; I

                User user =users.get(i);

s +="姓名：" +user.getName() +"性別：" +user.getGender() +"年齡：" +user.getAge() +"類(lèi)型：" +user.getType() +"\n";

}

            Toast.makeText(MainActivity.this,s,Toast.LENGTH_LONG).show();

}

});

tvQueryAll.setOnClickListener(new View.OnClickListener() {

        @Override

        public void onClick(View view) {

}

});

}

最后編輯于：2021.07.15 10:56:12

?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者

人面猴
序言：七十年代末奠骄，一起剝皮案震驚了整個(gè)濱河市豆同，隨后出現(xiàn)的幾起案子，更是在濱河造成了極大的恐慌含鳞，老刑警劉巖影锈，帶你破解...
沈念sama閱讀 217,734評(píng)論 6贊 505
死咒
序言：濱河連續(xù)發(fā)生了三起死亡事件，死亡現(xiàn)場(chǎng)離奇詭異，居然都是意外死亡鸭廷，警方通過(guò)查閱死者的電腦和手機(jī)枣抱，發(fā)現(xiàn)死者居然都...
沈念sama閱讀 92,931評(píng)論 3贊 394
救了他兩次的神仙讓他今天三更去死
文/潘曉璐我一進(jìn)店門(mén)，熙熙樓的掌柜王于貴愁眉苦臉地迎上來(lái)辆床，“玉大人佳晶，你說(shuō)我怎么就攤上這事∷显兀” “怎么了轿秧？”我有些...
開(kāi)封第一講書(shū)人閱讀 164,133評(píng)論 0贊 354
道士緝兇錄：失蹤的賣(mài)姜人
文/不壞的土叔我叫張陵，是天一觀的道長(zhǎng)咨堤。經(jīng)常有香客問(wèn)我菇篡，道長(zhǎng)，這世上最難降的妖魔是什么一喘？我笑而不...
開(kāi)封第一講書(shū)人閱讀 58,532評(píng)論 1贊 293
?港島之戀（遺憾婚禮）
正文為了忘掉前任驱还，我火速辦了婚禮，結(jié)果婚禮上津滞，老公的妹妹穿的比我還像新娘铝侵。我一直安慰自己，他們只是感情好触徐，可當(dāng)我...
茶點(diǎn)故事閱讀 67,585評(píng)論 6贊 392
惡毒庶女頂嫁案：這布局不是一般人想出來(lái)的
文/花漫我一把揭開(kāi)白布咪鲜。她就那樣靜靜地躺著，像睡著了一般撞鹉。火紅的嫁衣襯著肌膚如雪疟丙。梳的紋絲不亂的頭發(fā)上，一...
開(kāi)封第一講書(shū)人閱讀 51,462評(píng)論 1贊 302
城市分裂傳說(shuō)
那天鸟雏，我揣著相機(jī)與錄音享郊，去河邊找鬼。笑死孝鹊，一個(gè)胖子當(dāng)著我的面吹牛炊琉，可吹牛的內(nèi)容都是我干的。我是一名探鬼主播又活，決...
沈念sama閱讀 40,262評(píng)論 3贊 418
雙鴛鴦連環(huán)套：你想象不到人心有多黑
文/蒼蘭香墨我猛地睜開(kāi)眼苔咪，長(zhǎng)吁一口氣：“原來(lái)是場(chǎng)噩夢(mèng)啊……” “哼！你這毒婦竟也來(lái)了柳骄？” 一聲冷哼從身側(cè)響起团赏，我...
開(kāi)封第一講書(shū)人閱讀 39,153評(píng)論 0贊 276
萬(wàn)榮殺人案實(shí)錄
序言：老撾萬(wàn)榮一對(duì)情侶失蹤，失蹤者是張志新（化名）和其女友劉穎耐薯，沒(méi)想到半個(gè)月后哮塞，有當(dāng)?shù)厝嗽跇?shù)林里發(fā)現(xiàn)了一具尸體，經(jīng)...
沈念sama閱讀 45,587評(píng)論 1贊 314
?護(hù)林員之死
正文獨(dú)居荒郊野嶺守林人離奇死亡替裆，尸身上長(zhǎng)有42處帶血的膿包…… 初始之章·張勛以下內(nèi)容為張勛視角年9月15日...
茶點(diǎn)故事閱讀 37,792評(píng)論 3贊 336
?白月光啟示錄
正文我和宋清朗相戀三年，在試婚紗的時(shí)候發(fā)現(xiàn)自己被綠了杯聚。大學(xué)時(shí)的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片。...
茶點(diǎn)故事閱讀 39,919評(píng)論 1贊 348
活死人
序言：一個(gè)原本活蹦亂跳的男人離奇死亡营密，死狀恐怖械媒，靈堂內(nèi)的尸體忽然破棺而出目锭，到底是詐尸還是另有隱情评汰，我是刑警寧澤，帶...
沈念sama閱讀 35,635評(píng)論 5贊 345
?日本核電站爆炸內(nèi)幕
正文年R本政府宣布痢虹，位于F島的核電站被去，受9級(jí)特大地震影響，放射性物質(zhì)發(fā)生泄漏奖唯。R本人自食惡果不足惜惨缆，卻給世界環(huán)境...
茶點(diǎn)故事閱讀 41,237評(píng)論 3贊 329
男人毒藥：我在死后第九天來(lái)索命
文/蒙蒙一、第九天我趴在偏房一處隱蔽的房頂上張望丰捷。院中可真熱鬧坯墨，春花似錦、人聲如沸病往。這莊子的主人今日做“春日...
開(kāi)封第一講書(shū)人閱讀 31,855評(píng)論 0贊 22
一樁弒父案，背后竟有這般陰謀
文/蒼蘭香墨我抬頭看了看天上的太陽(yáng)停巷。三九已至耍攘，卻和暖如春，著一層夾襖步出監(jiān)牢的瞬間畔勤，已是汗流浹背蕾各。一陣腳步聲響...
開(kāi)封第一講書(shū)人閱讀 32,983評(píng)論 1贊 269
情欲美人皮
我被黑心中介騙來(lái)泰國(guó)打工，沒(méi)想到剛下飛機(jī)就差點(diǎn)兒被人妖公主榨干…… 1. 我叫王不留庆揪，地道東北人式曲。一個(gè)月前我還...
沈念sama閱讀 48,048評(píng)論 3贊 370
代替公主和親
正文我出身青樓，卻偏偏與公主長(zhǎng)得像缸榛，于是被迫代替她去往敵國(guó)和親吝羞。傳聞我的和親對(duì)象是個(gè)殘疾皇子，可洞房花燭夜當(dāng)晚...
茶點(diǎn)故事閱讀 44,864評(píng)論 2贊 354

Jetpack下的Room簡(jiǎn)單使用

推薦閱讀更多精彩內(nèi)容