WatermelonDB高级字段使用指南：JSON字段与自定义可观察属性

WatermelonDB高级字段使用指南：JSON字段与自定义可观察属性

【免费下载链接】WatermelonDB 🍉 Reactive & asynchronous database for powerful React and React Native apps ⚡️ 项目地址: https://gitcode.com/gh_mirrors/wa/WatermelonDB

前言

在Nozbe/WatermelonDB数据库框架中，除了基本字段类型外，还提供了一些高级字段特性，能够帮助开发者处理更复杂的数据场景。本文将深入探讨两种高级特性：JSON字段和自定义可观察字段，帮助开发者更好地利用WatermelonDB的强大功能。

JSON字段的高级应用

什么是JSON字段

JSON字段允许开发者将复杂的数据结构（如对象或多值数组）以JSON字符串的形式存储在单个数据库列中，而不是创建多个列或关联表。

使用场景

JSON字段特别适合以下情况：

• 存储元数据或配置信息
• 处理动态结构的数据
• 需要快速访问而不需要频繁查询的数据

实现步骤

1. 定义表结构：

tableSchema({
  name: 'comments',
  columns: [
    { name: 'reactions', type: 'string' }, // 可添加isOptional: true
  ],
})

2. 模型定义：

import { json } from '@nozbe/watermelondb/decorators'

class Comment extends Model {
  @json('reactions', sanitizeReactions) reactions
}

3. 数据操作：

comment.update(() => {
  comment.reactions = ['up', 'down', 'down']
})

数据净化函数

JSON字段需要一个净化函数(sanitizer)，用于确保数据格式正确：

const sanitizeReactions = rawReactions => {
  return Array.isArray(rawReactions) ? rawReactions.map(String) : []
}

净化函数可以接收两个参数：

1. 原始JSON数据
2. 模型引用（可选）

使用限制

JSON字段有以下限制：

• 无法对JSON内容进行查询或计数
• 违背了关系型数据库的设计原则
• 仅适用于确定不需要查询的元数据

不可变字段保护

@nochange装饰器

@nochange装饰器可以防止字段在创建后被修改：

import { field, nochange } from '@nozbe/watermelondb/decorators'

class User extends Model {
  @nochange @field('is_owner') isOwner
}

@readonly装饰器

比@nochange更严格，完全禁止字段修改，适用于同步场景或服务器专用字段。

自定义可观察字段

基本概念

自定义可观察字段允许开发者创建基于其他字段计算的响应式属性，这些属性会自动更新并触发UI重绘。

基础示例

判断文章是否"流行"（评论数>10）：

import { distinctUntilChanged, map as map$ } from 'rxjs/operators'
import { lazy } from '@nozbe/watermelondb/decorators'

class Post extends Model {
  @lazy isPopular = this.comments.observeCount().pipe(
    map$(comments => comments > 10),
    distinctUntilChanged()
  )
}

高级示例

结合多个条件判断流行度：

import { of as of$ } from 'rxjs/observable/of'
import { distinctUntilChanged, map as map$ } from 'rxjs/operators'
import { lazy } from '@nozbe/watermelondb/decorators'

class Post extends Model {
  @lazy isPopular = this.observe().pipe(
    distinctUntilKeyChanged('isStarred'),
    switchMap(post =>
      post.isStarred ?
        of$(true) :
        this.comments.observeCount().pipe(map$(comments => comments > 10))
    ),
    distinctUntilChanged(),
  )
}

性能优化技巧

1. 使用distinctUntilChanged避免不必要的更新
2. 使用@lazy装饰器实现单例模式
3. 条件性订阅相关Observable

总结

WatermelonDB的高级字段功能为开发者提供了处理复杂数据场景的强大工具。JSON字段适合存储不需要查询的复杂数据，而自定义可观察字段则实现了响应式的数据派生逻辑。在使用这些高级功能时，开发者应当权衡其便利性与性能影响，选择最适合应用场景的方案。

【免费下载链接】WatermelonDB 🍉 Reactive & asynchronous database for powerful React and React Native apps ⚡️ 项目地址: https://gitcode.com/gh_mirrors/wa/WatermelonDB