Android Architecture Component Room持久化数据库 （二）使用Room实体定义数据

最新推荐文章于 2024-09-04 09:59:55 发布
最新推荐文章于 2024-09-04 09:59:55 发布
阅读量1.6k 收藏 3
点赞数
分类专栏： Android Architecture Component Android开发相关 软件架构与设计 Android Architecture Component

版权声明：本文为博主原创文章，欢迎大家转载！

但是转载请标明出处： https://blog.csdn.net/t000818/article/details/84258618 ，本文出自:【唐宏宇的博客】

使用Room持久性库时，可以将相关字段集定义为实体。对于每个实体，在关联的Database对象中创建一个表来保存项目。必须通过Database类中的entities数组引用实体类。

注意:  要在应用程序中使用实体，请将  Architecture Components artifacts 添加到应用程序的build.gradle文件中。

以下代码段显示了如何定义实体：

Kotlin写法：

@Entity
data class User(
    @PrimaryKey var id: Int,
    var firstName: String?,
    var lastName: String?
)

Java写法：

@Entity
public class User {
    @PrimaryKey
    public int id;

    public String firstName;
    public String lastName;
}

如果要持久化一个字段，Room必须能够访问它。您可以将字段设为public，也可以为其提供getter和setter。如果使用getter和setter方法，请记住它们基于Room中的JavaBeans约定。

注意:实体可以有一个空构造函数 (如果相应的 DAO 类可以访问每个持久化字段), 也可以有一个构造函数, 其参数包含与实体中的字段的类型和名称相匹配的类型和名称。Room 还可以使用完整或部分构造函数, 例如只接收某些字段的构造函数

 

定义主键

每个实体必须至少定义一个字段作为主键。即使只有一个字段，您仍然需要使用@PrimaryKey注释来注释该字段。此外，如果您希望Room为实体分配自动ID，您可以设置@ PrimaryKey的autoGenerate属性。如果实体具有复合主键，则可以使用@Entity批注的primaryKeys属性，如以下代码段所示：

Kotlin写法：

@Entity(primaryKeys = arrayOf("firstName", "lastName"))
data class User(
    @PrimaryKey var id,
    var firstName: String?,
    var lastName: String?
)

Java写法：

@Entity(primaryKeys = {"firstName", "lastName"})
public class User {
    public String firstName;
    public String lastName;
}

默认情况下，Room使用类名作为数据库表名。如果希望表具有不同的名称，请设置@Entity批注的tableName属性，如以下代码段所示：

Kotlin写法：

@Entity(tableName = "users")
data class User (
    // ...
)

Java写法：

@Entity(tableName = "users")
public class User {
    // ...
}

警告：SQLite中的表名称不区分大小写。

 

与tableName属性类似，Room使用字段名称作为数据库中的列名称。如果希望列具有不同的名称，请将@ColumnInfo注释添加到字段中，如以下代码段所示：

Kotlin写法：

@Entity(tableName = "users")
data class User (
    @PrimaryKey var id: Int,
    @ColumnInfo(name = "first_name") var firstName: String?,
    @ColumnInfo(name = "last_name") var lastName: String?
)

Java  写法：

@Entity(tableName = "users")
public class User {
    @PrimaryKey
    public int id;

    @ColumnInfo(name = "first_name")
    public String firstName;

    @ColumnInfo(name = "last_name")
    public String lastName;
}

 

忽略字段

默认情况下，Room会为实体中定义的每个字段创建一列。如果实体有想忽略的字段，则可以使用@Ignore对它们进行注释
忽略，如下面的代码片段所示：

Kotlin写法：

@Entity
data class User(
    @PrimaryKey var id: Int,
    var firstName: String?,
    var lastName: String?,
    @Ignore var picture: Bitmap?
)

Java写法：

@Entity
public class User {
    @PrimaryKey
    public int id;

    public String firstName;
    public String lastName;

    @Ignore
    Bitmap picture;
}

如果实体从父实体继承字段，则通常使用@Entity属性的ignoredColumns属性：

Kotlin写法：

open class User {
    var picture: Bitmap? = null
}

@Entity(ignoredColumns = arrayOf("picture"))
data class RemoteUser(
    @PrimaryKey var id: Int,
    var hasVpn: Boolean
) : User()

Java写法：

@Entity(ignoredColumns = "picture")
public class RemoteUser extends User {
    @PrimaryKey
    public int id;

    public boolean hasVpn;
}

 

提供表搜索支持

Room支持多种类型的注释，使你可以更轻松地搜索数据库表中的详细信息。除非您的应用的minSdkVersion小于16，否则请使用全文搜索。

 

支持全文搜索

如果您的应用程序需要通过全文搜索（FTS）快速访问数据库信息，请让您的实体由使用FTS3或FTS4 SQLite extension module.的虚拟表支持。要使用Room 2.1.0及更高版本中提供的此功能，请将@Fts3 或@Fts4 注释添加到给定实体，如以下代码段所示：

Kotlin写法：

// 仅当你的应用程序具有严格的磁盘空间要求或者您需要与较旧的SQLite版本兼容时，才使用`@ Fts3`。
@Fts4
@Entity(tableName = "users")
data class User(
    /* 为FTS表支持的实体指定主键是可选的，但是
       如果包含一个，则必须使用此类型和列名称 */
    @PrimaryKey @ColumnInfo(name = "rowid") var id: Int,
    @ColumnInfo(name = "first_name") var firstName: String?
)

Java写法：

// 仅当你的应用程序具有严格的磁盘空间要求或者您需要与较旧的SQLite版本兼容时，才使用`@ Fts3`
@Fts4
@Entity(tableName = "users")
public class User {
    // 为FTS表支持的实体指定主键是可选的，但是如果包含一个，则必须使用此类型和列名称
    @ColumnInfo(name = "rowid")
    public int id;

    @ColumnInfo(name = "first_name")
    public String firstName;
}

注意: 启用FTS的表始终使用INTEGER类型的主键和列名“rowid”。如果您的FTS表支持的实体定义主键，则它必须使用该类型和列名称.

如果表支持多种语言的内容，请使用languageId选项指定存储每行语言信息的列：

Kotlin写法：

@Fts4(languageId = "lid")
@Entity(tableName = "users")
data class User(
    // ...
    @ColumnInfo(name = "lid") var languageId: Int
)

Java写法：

@Fts4(languageId = "lid")
@Entity(tableName = "users")
public class User {
    // ...

    @ColumnInfo(name = "lid")
    int languageId;
}

Room提供了其他几个用于定义FTS支持的实体的选项，包括结果排序，tokenizer类型和作为外部内容管理的表。有关这些选项的更多详细信息，请参阅FtsOptions参考。

 

索引表中特定的列

如果你的应用必须支持的SDK版本不允许使用FTS3或FTS4表支持的实体，仍然可以索引数据库中的某些列以加快查询速度。要向实体添加索引，请在@Entity注解中添加indices属性，列出要包含的索引或复合索引中的列的名称。以下代码片段演示了此注截过程：

Kotlin写法：

@Entity(indices = arrayOf(Index(value = ["last_name", "address"])))
data class User(
    @PrimaryKey var id: Int,
    var firstName: String?,
    var address: String?,
    @ColumnInfo(name = "last_name") var lastName: String?,
    @Ignore var picture: Bitmap?
)

Java写法：

@Entity(indices = {@Index("name"),
        @Index(value = {"last_name", "address"})})
public class User {
    @PrimaryKey
    public int id;

    public String firstName;
    public String address;

    @ColumnInfo(name = "last_name")
    public String lastName;

    @Ignore
    Bitmap picture;
}

有时，数据库中的某些字段或字段组必须是唯一的。您可以通过在@Index 注解中设置unique属性索引注解为true，来强制使这些属性保持唯一性。以下代码示例可防止表具有两行，这些行包含firstName和lastName列的相同值集：

Kotlin写法：

@Entity(indices = arrayOf(Index(value = ["first_name", "last_name"],
        unique = true)))
data class User(
    @PrimaryKey var id: Int,
    @ColumnInfo(name = "first_name") var firstName: String?,
    @ColumnInfo(name = "last_name") var lastName: String?,
    @Ignore var picture: Bitmap?
)

Java写法：

@Entity(indices = {@Index(value = {"first_name", "last_name"},
        unique = true)})
public class User {
    @PrimaryKey
    public int id;

    @ColumnInfo(name = "first_name")
    public String firstName;

    @ColumnInfo(name = "last_name")
    public String lastName;

    @Ignore
    Bitmap picture;
}

 

包括基于AutoValue的对象

注意：此功能仅适用于基于Java的实体。要在基于Kotlin的实体中实现相同的功能，最好使用data classes数据类。

在2.1.0及更高版本的Room中，您可以使用基于Java的 immutable value classes不可变值类（使用@AutoValue进行注解）作为应用程序数据库中的实体。如果实体的两个实例的列包含相同的值，则此支持特别有用

使用带@AutoValue注释的类作为实体时，可以使用@PrimaryKey，@ ColumnInfo，@ Embedded和@Relation注解类的抽象方法。但是，在使用这些注释时，每次都必须包含@CopyAnnotations注释，以便Room可以正确解释方法的自动生成实现。

以下代码段显示了一个使用@AutoValue注释的类的示例，Room将其识别为实体

User.java

@AutoValue
@Entity
public abstract class User {
    // Supported annotations must include `@CopyAnnotations`.
    @CopyAnnotations
    @PrimaryKey
    public abstract long getId();

    public abstract String getFirstName();
    public abstract String getLastName();

    // Room uses this factory method to create User objects.
    public static User create(long id, String firstName, String lastName) {
        return new AutoValue_User(id, firstName, lastName);
    }
}

 

定义对象间的关系

由于SQLite是关系数据库，因此您可以指定对象之间的关系。尽管大多数对象关系映射库允许实体对象相互引用，但Room明确禁止这样做。要了解此决策背后的技术推理，请参阅了解Room为何不允许对象引用Understand why Room doesn't allow object references。

即使您不能使用直接关系，Room仍允许您在实体之间定义外键约束。

例如，如果存在另一个名为Book的实体，则可以使用该实体定义其与User实体的关系@ForeignKey注解，如下面的代码片段所示：

Kotlin写法：

@Entity(foreignKeys = arrayOf(ForeignKey(
            entity = User::class,
            parentColumns = arrayOf("id"),
            childColumns = arrayOf("user_id"))
       )
)
data class Book(
    @PrimaryKey var bookId: Int,
    var title: String?,
    @ColumnInfo(name = "user_id") var userId: Int
)

Java写法：

@Entity(foreignKeys = @ForeignKey(entity = User.class,
                                  parentColumns = "id",
                                  childColumns = "user_id"))
public class Book {
    @PrimaryKey
    public int bookId;

    public String title;

    @ColumnInfo(name = "user_id")
    public int userId;
}

外键非常强大，因为它们允许您指定更新引用实体时发生的情况。例如，如果通过在@ForeignKey 注解中包含onDelete = CASCADE ，当相应的User实例被删除是，则可以通知SQLite删除该用户的所有书籍。

注意：SQLite将 @Insert(onConflict = REPLACE)作为一组REMOVE和REPLACE操作处理，而不是单个UPDATE操作。这种替换冲突值的方法可能会影响您的外键约束。有关更多详细信息，请参阅ON_CONFLICT子句的 SQLite documentation文档。

 

创建嵌套对象

有时，您希望在数据库逻辑中将实体或普通旧Java对象（PO​​JO）表达为一个整体，即使该对象包含多个字段。在这些情况下，您可以使用@Embedded 注解来表示对象你想“分解成表格中的子字段”。然后，您可以像查找其他单个列一样查询嵌入字段。

例如，我们的User类可以包含Address类型的字段，它表示名为street，city，state和postCode的字段的组合。若要在表中单独存储组合列，请在User类中包含一个带@Embedded注解的Address字段，如下面的代码片段所示

Kotlin写法：

data class Address(
    var street: String?,
    var state: String?,
    var city: String?,
    @ColumnInfo(name = "post_code") var postCode: Int
)

@Entity
data class User(
    @PrimaryKey var id: Int,
    var firstName: String?,
    @Embedded var address: Address?
)

Java写法：

public class Address {
    public String street;
    public String state;
    public String city;

    @ColumnInfo(name = "post_code")
    public int postCode;
}

@Entity
public class User {
    @PrimaryKey
    public int id;

    public String firstName;

    @Embedded
    public Address address;
}

上面表示User对象的表包含具有以下名称的列：id，firstName，street，state，city和post_code。

注意：嵌入字段还可以包含其他嵌入字段

如果实体具有多个相同类型的嵌入字段，则可以通过设置prefix属性使每个列保持唯一。然后，Room将提供的值添加到嵌入对象中每个列名称的开头。

 

 

 

t000818
关注
专栏目录
Android architecture component架构
philos3的博客
10-21 1222
简介引言谷歌在今年的I/O大会上发布了新的架构库Android architecture component，为了解决开发者遇到的一些常见问题，推荐遵从以下两个原则构建应用： 1. 关注点分离 尽量避免在Activity或Fragment中编写所有的代码，任何不是处理 UI 或操作系统交互的代码都不应该在这些类中。保持它们尽可能的精简可以避免许多与生命周期有关的问题。 2. model驱动UI
浅谈Android Architecture Components
热门推荐
流水不腐小夏
06-24 1万+
浅谈Android Architecture Components浅谈Android Architecture Components 简介 Android Architecture Components Gradle 集成 LifeCycles LiveData Transformations ViewModel Room Entities Entity的参数 primaryKeys Entity的
room-model-generator:直接从Java模型生成Android Room实体
04-28
房间模型生成器 从位于java-library模块中的普通java / kotlin模型生成实体。 问题 如果您倾向于将简单的java / kotlin模块用于逻辑，则可能已经创建了数据库的接口，该接口将通过android代码实现并提供，并且在这样做时，您可能正在考虑如何解决实体问题，因此您可以在非android模块，您需要android批注才能在数据库中使用它。 这将需要在具有适当注释的android模块中编写相同的模型，以电子方式可以使用PrimaryKey创建模型并使用Embedded注释添加所有模型逻辑，在kotlin中，这将缩短为 data class KotlinModel ( val id : String , val name : String ) @RoomEntity data class RoomEntity ( val kotlinModel : KotlinMo
Android Room Entity使用
BlueLzy的个人博客
07-08 3955
说明： Android Room 第二篇 - Entity使用 主要介绍entity的作用 原文地址：https://developer.android.com/training/data-storage/room/defining-data 第一篇：Android Room概述 使用Room entities 来定义数据 当你在使用Room的时候，定义了一组相关的字段作为一个实体。对...
Android中room的使用
m0_73571766的博客
09-04 737
Android中操作数据是用SQLiteOpenHelper，用起来很繁琐 room是简化SQLiteOpenHelper操作方式
Room Entity使用
chuyouyinghe的专栏
02-22 529
说明： Android Room 第二篇 - Entity使用 主要介绍entity的作用 原文地址：https://developer.android.com/training/data-storage/room/defining-data 第一篇：Android Room概述 使用Room entities 来定义数据 当你在使用Room的时候，定义了一组相关的字段作为一个实体。对于每个实体，都会通过在数据库里面创建一张表的方式来处理这些数据。 通常来说，Room 会为实体类中定义的每个字
Android数据库Room之二实体之间的关系
XBlithe的博客
05-25 2126
一.定义对象之间的关系 由于 SQLite 是关系型数据库，因此您可以定义各个实体之间的关系。尽管大多数对象关系映射库都允许实体对象互相引用，但 Room 明确禁止这样做。如需了解此决策背后的技术原因，请参阅了解 Room 为何不允许对象引用。Room 的数据实体类跟数据库表是对应的，所以，有些表关系可以直接通过定义数据实体类之间的关系来实现，这样就可以无需编写 SQL 语句实现插入和查询过操作。 🐼两种可能的方法 在 Room 中，您可以通过两种方式定义和查询实体之间的关系：使用具有嵌入式对象的中间数据类
Room库
li6472的博客
09-13 342
一 引言 Room是Jetpack组件中一个对象关系映射（ORM）库。可以很容易将 SQLite 表数据转换为 Java 对象。 Room 在 SQLite 上提供了一个抽象层，以便在充分利用 SQLite 的强大功能的同时，能够流畅地访问数据库。 支持与LiveData、RxJava、Kotlin协成组合使用。 Google 官方强烈推荐使用Room。 二 优点 编译期检查，Room会在编译的时候验证每个@Query和@Entity等，它不仅检查语法问题，还会检查是否有该表,这就意味着几乎没有任
kotlin-architecture-components：这是一个示例应用程序，将Android Architecture Components与Kotlin和Dagger 2结合使用
02-04
**Android架构组件（Architecture Components）**是一套由Google推出的库，旨在帮助开发者构建健壮、持久、测试友好的Android应用。这些组件包括LiveData、ViewModel、Room、Repository模式等，它们鼓励遵循MVI...
Weatherapp：5天天气预报应用程序，可在Android上运行并使用最新工具（Kotlin，导航，房间，LiveData，数据绑定，Dagger 2）
02-04
- **Room**: 它是Android的一个持久化库，用于处理SQLite数据库。Room提供了抽象层，使得与数据库交互更加简单，同时保持编译时的错误检查。 - **LiveData**: LiveData是一个观察者模式的实现，它允许组件（如...
BLTaxi：:taxi:BL Taxi是一个简单的应用程序，用于使用现代Android开发工具在城市Banja Luka叫出租车
02-04
这些组件帮助开发者实现数据持久化、UI状态管理，以及分离关注点，提高代码的可测试性和可维护性。 4. **MVVM架构模式**: MVVM（Model-View-ViewModel）是BLTaxi的架构设计模式，它将业务逻辑与视图分离开来，...
Android NDK开发详解应用数据和文件之使用 Room 实体定义数据
hnjzfwy的博客
11-09 76
原生开发套件 (NDK) 是一套工具，使您能够在 Android 应用中使用 C 和 C++ 代码，并提供众多平台库，您可使用这些平台库管理原生 activity 和访问实体设备组件，例如传感器和触控输入。NDK 可能不适合大多数 Android 编程初学者，这些初学者只需使用 Java 代码和框架 API 开发应用
Android Room 数据实体类详解
yingaizhu的博客
06-06 5503
在使用 Room 库的过程中，定义数据实体类来表示需要存储的数据对象，每一个数据实体类与关联的数据库中的表相对应，数据实体类的每一个字段对应表中的列，每一个数据实体类对象都对应表中的一行数据。 在Room中，数据实体类的关系也会折射成数据库表关系。
Room 数据库快速入门
m0_60396106的博客
07-22 747
被无穷无尽的 SQLite 样板代码折磨后，发现 Google 的 Room 封装似乎是个不错的选择，不过大量运用注释，使得不熟悉 SQLite 的开发者如果一开始就直接上手 Room，会不知其所以然，这里记录下我的学习笔记。 1. 回顾直接操作 SQLite 我本人在操作数据库数据库时有个习惯，就是不使用封装的api直接写SQL。因为大多数操作数据库的api实在是过于繁琐。如果直接写SQL来写入数据库，只需要使用到 SQLiteOpenHelper， SQLiteDatabase，Cursor 三个类和
Android架构师必学——Jetpack Room数据库应用与源码解析(转载)
foshengtang的博客
10-27 997
当前Room注解大全是基于Room2.4版本代码逻辑得来，如果有问题欢迎给予指正。必须！！！是必须理解sql数据库相关操作！！！如果想全面理解当前Room，那么不但对数据库基本操作熟悉
Android官方ORM数据库Room技术解决方案：@Embedded内嵌对象（二）
Zhang Phil
11-24 9878
Android官方ORM数据库Room技术解决方案：@Embedded内嵌对象（二）（一）附录1简介了Android Room的基本使用。在附录1例子中，User对象元素均为普通的Java基本数据类型，但是实际的开发中，通常建立的持久化存储对象复杂，且通常是结构化的Java对象，互相之间存在引用或者内嵌关系。Android Room支持数据库表Java对象通过注解符@Embedded内嵌一个Jav
Android官方ORM Room介绍
木讷的理科生的专栏
12-09 1007
Android官方ORM Room介绍 基本使用 通过实体类和注解定义表数据： Entity public class User { @PrimaryKey public int uid; @ColumnInfo(name = "first_name") public String firstName; @ColumnInfo(nam...
SQLite FTS3 和 FTS4 插件
stevewong的专栏
08-08 1505
总览 FTS3和FTS4是SQLite虚表模块，允许用户在一堆文档中实现全文搜索。用户输入一个短语（term），或者一些列term，然后这个系统找到一些列文档，最佳地匹配了哪些terms。这篇文章介绍了FTS3和FTS4的部署和使用 FTS1和FTS2是过时的全文搜索模块。有一些已知的问题。FTS3的部分恭喜到了SQLite的项目中。现在作为SQLite的一部分被开发和维护。 1、FTS3和FTS4的介绍 FTS3和FTS4扩展模块允许用户创建特殊的表，内置了全文索引（FTS表）全文索引允许用户有效地查询数
Android：Room动态拼写原生sql语句
Crystal_xing的专栏
04-18 2355
如果不用Room提供的注解方式去查询sql，根据需求要写冗长复杂的查询语句（比如查询的条件数量不是固定的，语句不定长），注解的方式去写实现不了需求，那么就要用Room动态拼写原生sql语句去查询： 使用SimpleSQLiteQuery，将原生的sql字符串传进去就行： /** * home_条件検索 * @return 検索結果 */ public Single<List<RidingLogRoomEntity>> searchCon
Kotlin中如何使用Room数据库进行数据持久化？
最新发布
09-07
Room 是一个数据库持久化库，它是 Android Architecture Components 的一部分，提供了更加便捷的方式来访问 SQLite 数据库。在 Kotlin 中使用 Room 数据库进行数据持久化，通常包括以下几个步骤： 1. 定义实体...
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值