SqliteRepositoryBase<T>

Defined in: packages/rxdb-adapter-sqlite-core/src/repository/SqliteRepositoryBase.ts:18

操作实体仓库

Extends

• RepositoryBase<T>

Extended by

• SqliteRepository
• SqliteRepository
• SqliteRepository
• SqliteRepository
• SqliteRepository

Type Parameters

Type Parameter
T extends EntityType

Constructors

Constructor

new SqliteRepositoryBase<T>(adapter, EntityType): SqliteRepositoryBase<T>;

Defined in: packages/rxdb-adapter-sqlite-core/src/repository/SqliteRepositoryBase.ts:21

Parameters

Parameter	Type
adapter	RxDBAdapterSqliteBase
EntityType	T

Returns

SqliteRepositoryBase<T>

Overrides

RepositoryBase.constructor

Properties

adapter

protected adapter: RxDBAdapterSqliteBase;

Defined in: packages/rxdb-adapter-sqlite-core/src/repository/SqliteRepositoryBase.ts:22

---

EntityType

readonly EntityType: T;

Defined in: packages/rxdb/dist/repository/RepositoryBase.d.ts:20

Inherited from

RepositoryBase.EntityType

---

metadata

readonly metadata: EntityMetadata;

Defined in: packages/rxdb-adapter-sqlite-core/src/repository/SqliteRepositoryBase.ts:19

---

rxdb

protected readonly rxdb: RxDB;

Defined in: packages/rxdb/dist/repository/RepositoryBase.d.ts:19

Inherited from

SqliteTreeRepository.rxdb

---

_STATIC_METHODS

protected static _STATIC_METHODS: string[];

Defined in: packages/rxdb/dist/repository/RepositoryBase.d.ts:29

子类声明的"静态方法名"清单，用于把 User.findOne(...) 这样的方法 注入到实体类上（EntityManager.init 时挂）。

Remarks

用类字段 static 而非构造器里赋值 —— 字段初始化在 extends 链上是自底向上 合并的，所以子类定义的 _STATIC_METHODS 不会丢；运行时反射取的是当前类的字段。

Inherited from

RepositoryBase._STATIC_METHODS

Accessors

staticMethods

Get Signature

get static staticMethods(): string[];

Defined in: packages/rxdb/dist/repository/RepositoryBase.d.ts:37

当前类（含继承链上各层）声明的全部静态方法名

Remarks

没有沿原型链累加：每个子类自己写一份 _STATIC_METHODS，避免运行时 反射出祖先的 get / findOne 这类名字后，再被后代意外覆盖一次。

Returns

string[]

Inherited from

RepositoryBase.staticMethods

Methods

addQueryCache()

addQueryCache(sqliteSuccessResult, forcedUpdate?): Promise<InstanceType<T>[]>;

Defined in: packages/rxdb-adapter-sqlite-core/src/repository/SqliteRepositoryBase.ts:69

添加缓存

Parameters

Parameter	Type	Default value	Description
sqliteSuccessResult	SqliteSuccessResult	undefined	-
forcedUpdate	boolean	false	强制刷新，在数据有的情况下也会更新数据，在修改数据的情况下需要

Returns

Promise<InstanceType<T>[]>

---

createEntityRef()

createEntityRef(data): EntityInstanceType<T>;

Defined in: packages/rxdb/dist/repository/RepositoryBase.d.ts:50

创建（或复用）一个实体引用

Parameters

Parameter	Type	Description
data	EntityUpdateData<T>	字段初始值；其中 id 缺省时会自动生成

Returns

EntityInstanceType<T>

已挂到 EntityManager 缓存里的实体实例

Remarks

不管入参 id 是否已存在于缓存，都会优先返回缓存里的实例（覆盖式刷新）； 走 rxdb.entityManager.createEntityRef 是为了复用同一份引用语义，避免 不同调用栈里拿到的是两个状态不同步的克隆。

Inherited from

RepositoryBase.createEntityRef

---

findByRowIds()

findByRowIds(rowIds, forceRefresh?): Promise<InstanceType<T>[]>;

Defined in: packages/rxdb-adapter-sqlite-core/src/repository/SqliteRepositoryBase.ts:29

Parameters

Parameter	Type	Default value
rowIds	bigint[]	undefined
forceRefresh	boolean	false

Returns

Promise<InstanceType<T>[]>

---

getEntityRef()

getEntityRef(id): 
  | EntityInstanceType<T>
  | undefined;

Defined in: packages/rxdb/dist/repository/RepositoryBase.d.ts:57

按 ID 在当前进程的实体缓存中查找实体

Parameters

Parameter	Type	Description
id	EntityStaticType<T, "idType">	实体主键

Returns

| EntityInstanceType<T> | undefined

缓存命中则返回实例，未命中返回 undefined（不触发数据库查询）

Inherited from

RepositoryBase.getEntityRef

---

hasEntityRef()

hasEntityRef(id): boolean;

Defined in: packages/rxdb/dist/repository/RepositoryBase.d.ts:68

判定当前进程的实体缓存里是否有指定 ID

Parameters

Parameter	Type	Description
id	EntityStaticType<T, "idType">	实体主键

Returns

boolean

缓存命中返回 true，否则 false

Remarks

等价于 getEntityRef(id) !== undefined，单独提供是为了让"批量预热"和 "差异同步"等热点路径省掉一次引用创建 / 取状态的开销。

Inherited from

RepositoryBase.hasEntityRef

---

mergeQueryCache()

protected mergeQueryCache(sqliteSuccessResult): Promise<InstanceType<T>[]>;

Defined in: packages/rxdb-adapter-sqlite-core/src/repository/SqliteRepositoryBase.ts:86

把结果行合进身份映射：干净实体整行刷新，脏实体逐字段避让未保存的编辑。

Parameters

Parameter	Type	Description
sqliteSuccessResult	SqliteSuccessResult	一次 SELECT 的结果集

Returns

Promise<InstanceType<T>[]>

结果行对应的实体（命中缓存的返回同一引用）

Remarks

与 addQueryCache 的分工是「读」与「写」：写路径（create / update）知道自己 刚刚写了什么，用 forcedUpdate 整行盖回去是对的；读路径拿到的是别人写的行，可能 落在一个用户正在编辑的实体上，只能用 state.modified ? mergeExternal : replace 这一对策略——这正是 entity-status.ts#applyExternal 的语义，它把「查询结果回填」 明确列为必须分流的三条路径之一。

---

updateEntity()

updateEntity(entity, update): void;

Defined in: packages/rxdb/dist/repository/RepositoryBase.d.ts:80

用 update 覆盖实体字段

Parameters

Parameter	Type	Description
entity	InstanceType<T>	目标实体
update	InstanceType<T>	待写入的字段；主键 id 也会被赋值（用于 hydrate 场景）

Returns

void

Remarks

走 EntityStatus.applyExternal，保证 dirty tracking 与 patch 生成走的是同一条路径， 且实体有未保存编辑时逐字段避让而不是整行覆盖 —— 活查询整批回填会命中已被用户改过的实体， 无条件 replace 会静默吃掉那些编辑。

Inherited from

RepositoryBase.updateEntity