Swift: Swift 闭包进阶：逃逸闭包、自动闭包与循环引用

func postComment(text: String, onComplete: () -> Void) {
    // 模拟网络请求
    DispatchQueue.main.asyncAfter(deadline: .now() + 1) {
        // 编译错误！非逃逸闭包不能在异步回调中使用
        onComplete()
    }
}

// 标记为逃逸闭包，允许异步执行
func postComment(text: String, onComplete: @escaping () -> Void) {
    DispatchQueue.main.asyncAfter(deadline: .now() + 1) { [weak self] in
        guard let self = self else { return }
        self.showSuccess()
        onComplete()
    }
}

// ============================================
// 逃逸闭包与非逃逸闭包的对比
// ============================================
import Foundation
var completionHandlers: [() -> Void] = []
// 非逃逸闭包——函数内同步执行
func syncOperation(task: () -> Void) {
    print("开始同步任务")
    task()
    print("同步任务结束")
}
syncOperation {
    print("  执行中...")
}
// 逃逸闭包——存储到外部数组
func asyncOperation(task: @escaping () -> Void) {
    print("添加异步任务")
    completionHandlers.append(task)  // 如果不加 @escaping 会报错
}
asyncOperation {
    print("  异步任务执行")
}
print("函数已返回，闭包尚未执行")
// 稍后执行存储的闭包
completionHandlers.first?()

// ============================================
// @autoclosure 实现延迟日志输出
// ============================================
var debugEnabled = false
func log(_ message: @autoclosure () -> String) {
    if debugEnabled {
        print("[DEBUG] \(message())")
    } else {
        print("日志未开启，跳过（消息未求值）")
    }
}
// 即使拼接字符串开销很大，不开启时也不会执行
debugEnabled = false
log("expensive " + "string " + "operation " + "skipped")
debugEnabled = true
log("this " + "will " + "be " + "logged")

// ============================================
// 闭包循环引用：weak vs unowned
// ============================================
import Foundation
class NetworkManager {
    var onComplete: (() -> Void)?
    func fetchData() {
        // 模拟异步请求——逃逸闭包
        DispatchQueue.main.asyncAfter(deadline: .now() + 0.5) { [weak self] in
            guard let self = self else { return }
            print("数据已获取")
            self.onComplete?()
        }
    }
    deinit {
        print("NetworkManager deinit")
    }
}
class ViewController {
    let manager = NetworkManager()
    var data: String?
    func loadData() {
        // 使用捕获列表避免循环引用
        manager.onComplete = { [weak self] in
            guard let self = self else { return }
            self.data = "New data"
            print("UI 已更新")
        }
        manager.fetchData()
    }
    deinit {
        print("ViewController deinit")
    }
}
// 模拟使用和销毁
var vc: ViewController? = ViewController()
vc?.loadData()
// 释放视图控制器
DispatchQueue.main.asyncAfter(deadline: .now() + 0.2) {
    print("释放 ViewController")
    vc = nil  // 不会被泄漏
}

// ============================================
// 闭包属性中的循环引用
// ============================================
class Counter {
    var value = 0
    var incrementHandler: (() -> Void)?
    func setup() {
        // 错误：闭包持有 self，self 持有 incrementHandler → 循环引用
        incrementHandler = { [weak self] in
            self?.value += 1
        }
    }
    deinit {
        print("Counter deinit")
    }
}
var counter: Counter? = Counter()
counter?.setup()
print("释放前 value = \(counter?.value ?? 0)")
counter = nil  // 正确释放
print("已释放")

// ============================================
// 完整示例：异步图片加载器
// 功能：@escaping + 捕获列表 + 内存安全
// ============================================
import Foundation
// 1. 图片缓存
class ImageCache {
    private var cache: [String: Data] = [:]
    func get(_ key: String) -> Data? { return cache[key] }
    func set(_ key: String, data: Data) { cache[key] = data }
    deinit { print("ImageCache deinit") }
}
// 2. 图片加载器（使用逃逸闭包）
class ImageLoader {
    let cache = ImageCache()
    func loadImage(from url: String, completion: @escaping (Data?) -> Void) {
        // 检查缓存
        if let cached = cache.get(url) {
            completion(cached)
            return
        }
        // 模拟网络请求——逃逸闭包异步执行
        DispatchQueue.global().asyncAfter(deadline: .now() + 1) { [weak self] in
            guard let self = self else {
                // self 已释放，安全返回
                completion(nil)
                return
            }
            // 模拟下载数据
            let mockData = Data([0x01, 0x02, 0x03])
            self.cache.set(url, data: mockData)
            DispatchQueue.main.async {
                completion(mockData)
            }
        }
    }
    deinit { print("ImageLoader deinit") }
}
// 3. 使用（安全释放测试）
var loader: ImageLoader? = ImageLoader()
loader?.loadImage(from: "https://example.com/photo.jpg") { data in
    if let _ = data {
        print("图片加载成功")
    }
}
// 立即释放——闭包中的 weak self 保证不崩溃
loader = nil
print("Loader 已释放，异步回调不会崩溃")
// 保持运行等待异步完成
RunLoop.main.run(until: Date(timeIntervalSinceNow: 2))