YapDatabase关系管理完全指南：从基础关系到级联删除规则

YapDatabase关系管理是Swift和Objective-C开发者在构建iOS、macOS、tvOS和watchOS应用时管理数据关联的强大功能。这个嵌入式数据库的关系扩展让开发者能够轻松建立对象之间的连接，并配置自动删除规则，确保数据完整性和一致性。## 🔗 YapDatabase关系管理核心概念YapDatabase关系扩展位于`YapDatabase/Extensions/R

诸余煦

618人浏览 · 2026-03-23 03:21:38

诸余煦 · 2026-03-23 03:21:38 发布

YapDatabase关系管理完全指南：从基础关系到级联删除规则

【免费下载链接】YapDatabase yapstudios/YapDatabase: 是一个基于 Swift 的嵌入式数据库，它支持 SQLite 数据库。适合用于 Swift 应用程序的嵌入式数据库操作，特别是对于需要轻量级、高性能的嵌入式数据库的场景。特点是 Swift 嵌入式数据库、支持 SQLite、轻量级、高性能。项目地址: https://gitcode.com/gh_mirrors/ya/YapDatabase

YapDatabase关系管理是Swift和Objective-C开发者在构建iOS、macOS、tvOS和watchOS应用时管理数据关联的强大功能。这个嵌入式数据库的关系扩展让开发者能够轻松建立对象之间的连接，并配置自动删除规则，确保数据完整性和一致性。

🔗 YapDatabase关系管理核心概念

YapDatabase关系扩展位于YapDatabase/Extensions/Relationships/目录中，提供了一套完整的API来管理对象间的关系。关系管理基于边（Edges） 的概念，每条边连接一个源节点和一个目标节点，并定义了删除行为规则。

关系边的基本结构

每个关系边包含以下关键属性：

名称（name）：标识关系类型的字符串
源节点（source）：关系的起始对象
目标节点（destination）：关系的目标对象或文件
删除规则（nodeDeleteRules）：定义删除行为的规则集

🎯 五种删除规则详解

YapDatabase提供了五种删除规则，覆盖了各种数据关联场景：

1. 通知规则

YDB_NotifyIfSourceDeleted      // 源节点删除时通知目标
YDB_NotifyIfDestinationDeleted // 目标节点删除时通知源

通知规则允许对象在关联对象被删除时执行自定义逻辑，非常适合实现"弱引用"模式。

2. 一对一删除规则

YDB_DeleteSourceIfDestinationDeleted      // 目标删除时删除源
YDB_DeleteDestinationIfSourceDeleted      // 源删除时删除目标

这些规则适用于一对一关系，如用户头像与用户记录的关系。

3. 一对多/多对多删除规则

YDB_DeleteSourceIfAllDestinationsDeleted   // 所有目标删除时删除源
YDB_DeleteDestinationIfAllSourcesDeleted   // 所有源删除时删除目标

这些规则适用于复杂的多对多关系，如共享资源的引用计数管理。

🚀 实现关系管理的两种方式

方式一：协议驱动的关系（推荐）

通过实现YapDatabaseRelationshipNode协议，对象可以声明自己的关系：

@interface User : NSObject <YapDatabaseRelationshipNode>
@property (nonatomic, copy) NSString *userId;
@property (nonatomic, copy) NSArray<NSString *> *avatarKeys;
@end

@implementation User
- (NSArray<YapDatabaseRelationshipEdge *> *)yapDatabaseRelationshipEdges {
    NSMutableArray *edges = [NSMutableArray array];
    
    // 用户删除时删除所有头像
    for (NSString *avatarKey in self.avatarKeys) {
        YapDatabaseRelationshipEdge *edge = 
            [YapDatabaseRelationshipEdge edgeWithName:@"avatar"
                                       destinationKey:avatarKey
                                           collection:@"avatars"
                                      nodeDeleteRules:YDB_DeleteDestinationIfSourceDeleted];
        [edges addObject:edge];
    }
    
    return edges;
}
@end

方式二：手动管理关系

对于更复杂的场景，可以直接操作关系图：

YapDatabaseRelationshipEdge *edge = 
    [YapDatabaseRelationshipEdge edgeWithName:@"parent-child"
                                    sourceKey:parentKey
                                   collection:@"users"
                               destinationKey:childKey
                                   collection:@"users"
                              nodeDeleteRules:YDB_DeleteDestinationIfSourceDeleted];

[transaction setObject:parent forKey:parentKey inCollection:@"users"];
[transaction setObject:child forKey:childKey inCollection:@"users"];

[[transaction ext:@"relationship"] addEdge:edge];

📁 文件系统关系管理

YapDatabase关系扩展还支持数据库对象与文件系统文件的关联：

// 关联用户头像文件
NSURL *avatarFileURL = [NSURL fileURLWithPath:@"/path/to/avatar.jpg"];
YapDatabaseRelationshipEdge *fileEdge = 
    [YapDatabaseRelationshipEdge edgeWithName:@"user-avatar"
                          destinationFileURL:avatarFileURL
                             nodeDeleteRules:YDB_DeleteDestinationIfSourceDeleted];

当用户记录被删除时，关联的头像文件也会自动删除，确保不会留下孤立的文件。

⚙️ 关系扩展配置选项

通过YapDatabaseRelationshipOptions可以自定义关系扩展的行为：

YapDatabaseRelationshipOptions *options = [[YapDatabaseRelationshipOptions alloc] init];
options.disableYapDatabaseRelationshipNodeProtocol = NO; // 启用协议支持
options.allowedCollections = [YapWhitelistBlacklist whitelist:@[@"users", @"avatars"]]; // 限制集合

YapDatabaseRelationship *relationship = 
    [[YapDatabaseRelationship alloc] initWithVersionTag:@"1.0" options:options];
[database registerExtension:relationship withName:@"relationship"];

🛠️ 实际应用场景示例

场景1：社交应用用户关系

// 用户删除时删除所有帖子
- (NSArray<YapDatabaseRelationshipEdge *> *)yapDatabaseRelationshipEdges {
    return @[
        [YapDatabaseRelationshipEdge edgeWithName:@"user-posts"
                                   destinationKey:self.userId
                                       collection:@"posts"
                                  nodeDeleteRules:YDB_DeleteDestinationIfSourceDeleted]
    ];
}

场景2：购物车与商品关系

// 商品删除时从所有购物车中移除
- (NSArray<YapDatabaseRelationshipEdge *> *)yapDatabaseRelationshipEdges {
    return @[
        [YapDatabaseRelationshipEdge edgeWithName:@"product-carts"
                                   destinationKey:self.productId
                                       collection:@"carts"
                                  nodeDeleteRules:YDB_NotifyIfDestinationDeleted]
    ];
}

// 通知处理
- (id)yapDatabaseRelationshipEdgeDeleted:(YapDatabaseRelationshipEdge *)edge 
                             withReason:(YDB_NotifyReason)reason {
    if ([edge.name isEqualToString:@"product-carts"]) {
        ShoppingCart *updatedCart = [self copy];
        [updatedCart removeProductWithId:edge.destinationKey];
        return updatedCart;
    }
    return nil;
}

🔍 关系查询与监控

关系扩展提供了丰富的查询API：

// 查询特定关系的边
NSUInteger edgeCount = [[transaction ext:@"relationship"] edgeCountWithName:@"parent-child"];

// 查询特定源节点的所有边
NSArray *edges = [[transaction ext:@"relationship"] edgesWithName:@"parent-child" 
                                                         sourceKey:parentKey 
                                                        collection:@"users"];

// 查询特定目标节点的所有边
NSArray *edges = [[transaction ext:@"relationship"] edgesWithName:@"parent-child" 
                                                   destinationKey:childKey 
                                                       collection:@"users"];