共享与循环引用

Swift 中的引用跟踪由 ForyConfig.trackRef 控制。

启用引用跟踪

let fory = Fory(xlang: true, trackRef: true, compatible: false)

启用后，可跟踪引用的类型会保留对象身份和循环关系。

共享引用示例

import Fory

@ForyObject
final class Animal {
    var name: String = ""

    required init() {}

    init(name: String) {
        self.name = name
    }
}

@ForyObject
final class AnimalPair {
    var first: Animal? = nil
    var second: Animal? = nil

    required init() {}

    init(first: Animal? = nil, second: Animal? = nil) {
        self.first = first
        self.second = second
    }
}

let fory = Fory(xlang: true, trackRef: true)
fory.register(Animal.self, id: 200)
fory.register(AnimalPair.self, id: 201)

let shared = Animal(name: "cat")
let input = AnimalPair(first: shared, second: shared)

let data = try fory.serialize(input)
let decoded: AnimalPair = try fory.deserialize(data)

assert(decoded.first === decoded.second)

循环引用示例（使用 weak）

trackRef 会保留引用图，但不会改变 ARC 的所有权语义。 在循环中的至少一条边上使用 weak，才能避免内存泄漏。

import Fory

@ForyObject
final class Node {
    var value: Int32 = 0
    weak var next: Node? = nil

    required init() {}

    init(value: Int32, next: Node? = nil) {
        self.value = value
        self.next = next
    }
}

let fory = Fory(xlang: true, trackRef: true)
fory.register(Node.self, id: 300)

let node = Node(value: 7)
node.next = node

let data = try fory.serialize(node)
let decoded: Node = try fory.deserialize(data)

assert(decoded.next === decoded)

说明

• 值类型（struct、基础值）不携带对象身份语义
• trackRef 控制的是序列化图中的引用身份，而不是 ARC 内存所有权
• 对纯值型载荷使用 trackRef=false 可以降低开销