mirror of
https://github.com/JohnEstropia/CoreStore.git
synced 2026-01-14 13:13:33 +01:00
508 lines
18 KiB
Swift
508 lines
18 KiB
Swift
//
|
|
// CoreStoreObject+Observing.swift
|
|
// CoreStore
|
|
//
|
|
// Created by John Estropia on 2018/12/12.
|
|
// Copyright © 2018 John Rommel Estropia. All rights reserved.
|
|
//
|
|
|
|
import Foundation
|
|
import CoreData
|
|
|
|
|
|
// MARK: CoreStoreObjectKeyValueObservation
|
|
|
|
/**
|
|
Observation token for `CoreStoreObject` properties. Make sure to retain this instance to keep observing notifications.
|
|
|
|
`invalidate()` will be called automatically when an `CoreStoreObjectKeyValueObservation` is deinited.
|
|
*/
|
|
public protocol CoreStoreObjectKeyValueObservation: class {
|
|
|
|
/**
|
|
`invalidate()` will be called automatically when an `CoreStoreObjectKeyValueObservation` is deinited.
|
|
*/
|
|
func invalidate()
|
|
}
|
|
|
|
|
|
// MARK: - ValueContainer.Required
|
|
|
|
extension ValueContainer.Required {
|
|
|
|
public func observe(options: NSKeyValueObservingOptions = [], changeHandler: @escaping (O, CoreStoreObjectValueDiff<V>) -> Void) -> CoreStoreObjectKeyValueObservation {
|
|
|
|
return self.observe(with: options, changeHandler: changeHandler)
|
|
}
|
|
}
|
|
|
|
|
|
// MARK: - ValueContainer.Optional
|
|
|
|
extension ValueContainer.Optional {
|
|
|
|
public func observe(options: NSKeyValueObservingOptions = [], changeHandler: @escaping (O, CoreStoreObjectValueDiff<V>) -> Void) -> CoreStoreObjectKeyValueObservation {
|
|
|
|
return self.observe(with: options, changeHandler: changeHandler)
|
|
}
|
|
}
|
|
|
|
|
|
// MARK: - TransformableContainer.Required
|
|
|
|
extension TransformableContainer.Required {
|
|
|
|
public func observe(options: NSKeyValueObservingOptions = [], changeHandler: @escaping (O, CoreStoreObjectTransformableDiff<V>) -> Void) -> CoreStoreObjectKeyValueObservation {
|
|
|
|
return self.observe(with: options, changeHandler: changeHandler)
|
|
}
|
|
}
|
|
|
|
|
|
// MARK: - TransformableContainer.Optional
|
|
|
|
extension TransformableContainer.Optional {
|
|
|
|
public func observe(options: NSKeyValueObservingOptions = [], changeHandler: @escaping (O, CoreStoreObjectTransformableDiff<V>) -> Void) -> CoreStoreObjectKeyValueObservation {
|
|
|
|
return self.observe(with: options, changeHandler: changeHandler)
|
|
}
|
|
}
|
|
|
|
|
|
// MARK: - RelationshipContainer.ToOne
|
|
|
|
extension RelationshipContainer.ToOne {
|
|
|
|
public func observe(options: NSKeyValueObservingOptions = [], changeHandler: @escaping (O, CoreStoreObjectObjectDiff<D>) -> Void) -> CoreStoreObjectKeyValueObservation {
|
|
|
|
let result = _CoreStoreObjectKeyValueObservation(
|
|
object: self.rawObject!,
|
|
keyPath: self.keyPath,
|
|
callback: { (object, kind, newValue, oldValue, _, isPrior) in
|
|
|
|
let notification = CoreStoreObjectObjectDiff<D>(
|
|
kind: kind,
|
|
newNativeValue: newValue as! CoreStoreManagedObject?,
|
|
oldNativeValue: oldValue as! CoreStoreManagedObject?,
|
|
isPrior: isPrior
|
|
)
|
|
changeHandler(
|
|
O.cs_fromRaw(object: object),
|
|
notification
|
|
)
|
|
}
|
|
)
|
|
result.start(options)
|
|
return result
|
|
}
|
|
}
|
|
|
|
|
|
// MARK: - RelationshipContainer.ToManyUnordered
|
|
|
|
extension RelationshipContainer.ToManyUnordered {
|
|
|
|
public func observe(options: NSKeyValueObservingOptions = [], changeHandler: @escaping (O, CoreStoreObjectUnorderedDiff<D>) -> Void) -> CoreStoreObjectKeyValueObservation {
|
|
|
|
let result = _CoreStoreObjectKeyValueObservation(
|
|
object: self.rawObject!,
|
|
keyPath: self.keyPath,
|
|
callback: { (object, kind, newValue, oldValue, _, isPrior) in
|
|
|
|
let notification = CoreStoreObjectUnorderedDiff<D>(
|
|
kind: kind,
|
|
newNativeValue: newValue as! NSOrderedSet?,
|
|
oldNativeValue: oldValue as! NSOrderedSet?,
|
|
isPrior: isPrior
|
|
)
|
|
changeHandler(
|
|
O.cs_fromRaw(object: object),
|
|
notification
|
|
)
|
|
}
|
|
)
|
|
result.start(options)
|
|
return result
|
|
}
|
|
}
|
|
|
|
|
|
// MARK: - RelationshipContainer.ToManyOrdered
|
|
|
|
extension RelationshipContainer.ToManyOrdered {
|
|
|
|
public func observe(options: NSKeyValueObservingOptions = [], changeHandler: @escaping (O, CoreStoreObjectOrderedDiff<D>) -> Void) -> CoreStoreObjectKeyValueObservation {
|
|
|
|
let result = _CoreStoreObjectKeyValueObservation(
|
|
object: self.rawObject!,
|
|
keyPath: self.keyPath,
|
|
callback: { (object, kind, newValue, oldValue, indexes, isPrior) in
|
|
|
|
let notification = CoreStoreObjectOrderedDiff<D>(
|
|
kind: kind,
|
|
newNativeValue: newValue as! NSArray?,
|
|
oldNativeValue: oldValue as! NSArray?,
|
|
indexes: indexes ?? IndexSet(),
|
|
isPrior: isPrior
|
|
)
|
|
changeHandler(
|
|
O.cs_fromRaw(object: object),
|
|
notification
|
|
)
|
|
}
|
|
)
|
|
result.start(options)
|
|
return result
|
|
}
|
|
}
|
|
|
|
|
|
// MARK: - CoreStoreObjectValueDiff
|
|
|
|
public final class CoreStoreObjectValueDiff<V: ImportableAttributeType> {
|
|
|
|
/**
|
|
Indicates the kind of change. See the comments for `NSObject.observeValue(forKeyPath:of:change:context:)` for more information.
|
|
*/
|
|
public let kind: NSKeyValueChange
|
|
|
|
/**
|
|
`newValue` and `oldValue` will only be non-nil if `.new`/`.old` is passed to `observe()`. In general, get the most up to date value by accessing it directly on the observed object instead.
|
|
*/
|
|
public private(set) lazy var newValue: V? = self.newNativeValue.flatMap(V.cs_fromQueryableNativeType)
|
|
|
|
/**
|
|
`newValue` and `oldValue` will only be non-nil if `.new`/`.old` is passed to `observe()`. In general, get the most up to date value by accessing it directly on the observed object instead.
|
|
*/
|
|
public private(set) lazy var oldValue: V? = self.oldNativeValue.flatMap(V.cs_fromQueryableNativeType)
|
|
|
|
/**
|
|
'isPrior' will be `true` if this change observation is being sent before the change happens, due to `.prior` being passed to `observe()`
|
|
*/
|
|
public let isPrior: Bool
|
|
|
|
|
|
// MARK: FilePrivate
|
|
|
|
fileprivate init(kind: NSKeyValueChange, newNativeValue: V.QueryableNativeType?, oldNativeValue: V.QueryableNativeType?, isPrior: Bool) {
|
|
|
|
self.kind = kind
|
|
self.newNativeValue = newNativeValue
|
|
self.oldNativeValue = oldNativeValue
|
|
self.isPrior = isPrior
|
|
}
|
|
|
|
|
|
// MARK: Private
|
|
|
|
private let newNativeValue: V.QueryableNativeType?
|
|
private let oldNativeValue: V.QueryableNativeType?
|
|
}
|
|
|
|
|
|
// MARK: - CoreStoreObjectValueDiff
|
|
|
|
public final class CoreStoreObjectTransformableDiff<V: NSCoding & NSCopying> {
|
|
|
|
/**
|
|
Indicates the kind of change. See the comments for `NSObject.observeValue(forKeyPath:of:change:context:)` for more information.
|
|
*/
|
|
public let kind: NSKeyValueChange
|
|
|
|
/**
|
|
`newValue` and `oldValue` will only be non-nil if `.new`/`.old` is passed to `observe()`. In general, get the most up to date value by accessing it directly on the observed object instead.
|
|
*/
|
|
public let newValue: V?
|
|
|
|
/**
|
|
`newValue` and `oldValue` will only be non-nil if `.new`/`.old` is passed to `observe()`. In general, get the most up to date value by accessing it directly on the observed object instead.
|
|
*/
|
|
public let oldValue: V?
|
|
|
|
/**
|
|
'isPrior' will be `true` if this change observation is being sent before the change happens, due to `.prior` being passed to `observe()`
|
|
*/
|
|
public let isPrior: Bool
|
|
|
|
|
|
// MARK: FilePrivate
|
|
|
|
fileprivate init(kind: NSKeyValueChange, newValue: V?, oldValue: V?, isPrior: Bool) {
|
|
|
|
self.kind = kind
|
|
self.newValue = newValue
|
|
self.oldValue = oldValue
|
|
self.isPrior = isPrior
|
|
}
|
|
}
|
|
|
|
|
|
// MARK: - CoreStoreObjectObjectDiff
|
|
|
|
public final class CoreStoreObjectObjectDiff<D: CoreStoreObject> {
|
|
|
|
/**
|
|
Indicates the kind of change. See the comments for `NSObject.observeValue(forKeyPath:of:change:context:)` for more information.
|
|
*/
|
|
public let kind: NSKeyValueChange
|
|
|
|
/**
|
|
`newValue` and `oldValue` will only be non-nil if `.new`/`.old` is passed to `observe()`. In general, get the most up to date value by accessing it directly on the observed object instead.
|
|
*/
|
|
public private(set) lazy var newValue: D? = self.newNativeValue.flatMap(D.cs_fromRaw(object:))
|
|
|
|
/**
|
|
`newValue` and `oldValue` will only be non-nil if `.new`/`.old` is passed to `observe()`. In general, get the most up to date value by accessing it directly on the observed object instead.
|
|
*/
|
|
public private(set) lazy var oldValue: D? = self.oldNativeValue.flatMap(D.cs_fromRaw(object:))
|
|
|
|
/**
|
|
'isPrior' will be `true` if this change observation is being sent before the change happens, due to `.prior` being passed to `observe()`
|
|
*/
|
|
public let isPrior: Bool
|
|
|
|
|
|
// MARK: FilePrivate
|
|
|
|
fileprivate init(kind: NSKeyValueChange, newNativeValue: CoreStoreManagedObject?, oldNativeValue: CoreStoreManagedObject?, isPrior: Bool) {
|
|
|
|
self.kind = kind
|
|
self.newNativeValue = newNativeValue
|
|
self.oldNativeValue = oldNativeValue
|
|
self.isPrior = isPrior
|
|
}
|
|
|
|
|
|
// MARK: Private
|
|
|
|
private let newNativeValue: CoreStoreManagedObject?
|
|
private let oldNativeValue: CoreStoreManagedObject?
|
|
}
|
|
|
|
|
|
// MARK: - CoreStoreObjectUnorderedDiff
|
|
|
|
public final class CoreStoreObjectUnorderedDiff<D: CoreStoreObject> {
|
|
|
|
/**
|
|
Indicates the kind of change. See the comments for `NSObject.observeValue(forKeyPath:of:change:context:)` for more information.
|
|
*/
|
|
public let kind: NSKeyValueChange
|
|
|
|
/**
|
|
`newValue` and `oldValue` will only be non-nil if `.new`/`.old` is passed to `observe()`. In general, get the most up to date value by accessing it directly on the observed object instead.
|
|
*/
|
|
public private(set) lazy var newValue: Set<D> = Set(self.newNativeValue.map({ D.cs_fromRaw(object: $0 as! NSManagedObject) }))
|
|
|
|
/**
|
|
`newValue` and `oldValue` will only be non-nil if `.new`/`.old` is passed to `observe()`. In general, get the most up to date value by accessing it directly on the observed object instead.
|
|
*/
|
|
public private(set) lazy var oldValue: Set<D> = Set(self.oldNativeValue.map({ D.cs_fromRaw(object: $0 as! NSManagedObject) }))
|
|
|
|
/**
|
|
'isPrior' will be `true` if this change observation is being sent before the change happens, due to `.prior` being passed to `observe()`
|
|
*/
|
|
public let isPrior: Bool
|
|
|
|
|
|
// MARK: FilePrivate
|
|
|
|
fileprivate init(kind: NSKeyValueChange, newNativeValue: NSOrderedSet?, oldNativeValue: NSOrderedSet?, isPrior: Bool) {
|
|
|
|
self.kind = kind
|
|
self.newNativeValue = newNativeValue ?? []
|
|
self.oldNativeValue = oldNativeValue ?? []
|
|
self.isPrior = isPrior
|
|
}
|
|
|
|
|
|
// MARK: Private
|
|
|
|
private let newNativeValue: NSOrderedSet
|
|
private let oldNativeValue: NSOrderedSet
|
|
}
|
|
|
|
|
|
// MARK: - CoreStoreObjectOrderedDiff
|
|
|
|
public final class CoreStoreObjectOrderedDiff<D: CoreStoreObject> {
|
|
|
|
/**
|
|
Indicates the kind of change. See the comments for `NSObject.observeValue(forKeyPath:of:change:context:)` for more information.
|
|
*/
|
|
public let kind: NSKeyValueChange
|
|
|
|
/**
|
|
`newValue` and `oldValue` will only be non-nil if `.new`/`.old` is passed to `observe()`. In general, get the most up to date value by accessing it directly on the observed object instead.
|
|
*/
|
|
public private(set) lazy var newValue: [D] = self.newNativeValue.map({ D.cs_fromRaw(object: $0 as! NSManagedObject) })
|
|
|
|
/**
|
|
`newValue` and `oldValue` will only be non-nil if `.new`/`.old` is passed to `observe()`. In general, get the most up to date value by accessing it directly on the observed object instead.
|
|
*/
|
|
public private(set) lazy var oldValue: [D] = self.oldNativeValue.map({ D.cs_fromRaw(object: $0 as! NSManagedObject) })
|
|
|
|
/**
|
|
`indexes` will be `nil` unless the observed KeyPath refers to an ordered to-many property
|
|
*/
|
|
public let indexes: IndexSet
|
|
|
|
/**
|
|
'isPrior' will be `true` if this change observation is being sent before the change happens, due to `.prior` being passed to `observe()`
|
|
*/
|
|
public let isPrior: Bool
|
|
|
|
|
|
// MARK: FilePrivate
|
|
|
|
fileprivate init(kind: NSKeyValueChange, newNativeValue: NSArray?, oldNativeValue: NSArray?, indexes: IndexSet, isPrior: Bool) {
|
|
|
|
self.kind = kind
|
|
self.newNativeValue = newNativeValue ?? []
|
|
self.oldNativeValue = oldNativeValue ?? []
|
|
self.indexes = indexes
|
|
self.isPrior = isPrior
|
|
}
|
|
|
|
|
|
// MARK: Private
|
|
|
|
private let newNativeValue: NSArray
|
|
private let oldNativeValue: NSArray
|
|
}
|
|
|
|
|
|
// MARK: - AttributeProtocol
|
|
|
|
extension AttributeProtocol {
|
|
|
|
// MARK: FilePrivate
|
|
|
|
fileprivate func observe<O: CoreStoreObject, V: ImportableAttributeType>(with options: NSKeyValueObservingOptions = [], changeHandler: @escaping (O, CoreStoreObjectValueDiff<V>) -> Void) -> CoreStoreObjectKeyValueObservation {
|
|
|
|
let result = _CoreStoreObjectKeyValueObservation(
|
|
object: self.rawObject!,
|
|
keyPath: self.keyPath,
|
|
callback: { (object, kind, newValue, oldValue, _, isPrior) in
|
|
|
|
let notification = CoreStoreObjectValueDiff<V>(
|
|
kind: kind,
|
|
newNativeValue: newValue as! V.QueryableNativeType?,
|
|
oldNativeValue: oldValue as! V.QueryableNativeType?,
|
|
isPrior: isPrior
|
|
)
|
|
changeHandler(
|
|
O.cs_fromRaw(object: object),
|
|
notification
|
|
)
|
|
}
|
|
)
|
|
result.start(options)
|
|
return result
|
|
}
|
|
|
|
fileprivate func observe<O: CoreStoreObject, V: NSCoding & NSCopying>(with options: NSKeyValueObservingOptions = [], changeHandler: @escaping (O, CoreStoreObjectTransformableDiff<V>) -> Void) -> CoreStoreObjectKeyValueObservation {
|
|
|
|
let result = _CoreStoreObjectKeyValueObservation(
|
|
object: self.rawObject!,
|
|
keyPath: self.keyPath,
|
|
callback: { (object, kind, newValue, oldValue, _, isPrior) in
|
|
|
|
let notification = CoreStoreObjectTransformableDiff<V>(
|
|
kind: kind,
|
|
newValue: newValue as! V?,
|
|
oldValue: oldValue as! V?,
|
|
isPrior: isPrior
|
|
)
|
|
changeHandler(
|
|
O.cs_fromRaw(object: object),
|
|
notification
|
|
)
|
|
}
|
|
)
|
|
result.start(options)
|
|
return result
|
|
}
|
|
}
|
|
|
|
|
|
// MARK: - _CoreStoreObjectKeyValueObservation
|
|
|
|
// Mirrored implementation from https://github.com/apple/swift/blob/6e7051eb1e38e743a514555d09256d12d3fec750/stdlib/public/Darwin/Foundation/NSObject.swift#L141
|
|
fileprivate final class _CoreStoreObjectKeyValueObservation: NSObject, CoreStoreObjectKeyValueObservation {
|
|
|
|
// MARK: FilePrivate
|
|
|
|
fileprivate init(object: CoreStoreManagedObject, keyPath: KeyPathString, callback: @escaping (_ object: CoreStoreManagedObject, _ kind: NSKeyValueChange, _ newValue: Any?, _ oldValue: Any?, _ indexes: IndexSet?, _ isPrior: Bool) -> Void) {
|
|
|
|
let _ = _CoreStoreObjectKeyValueObservation.swizzler
|
|
self.keyPath = keyPath
|
|
self.object = object
|
|
self.callback = callback
|
|
}
|
|
|
|
fileprivate func start(_ options: NSKeyValueObservingOptions) {
|
|
|
|
self.object?.addObserver(self, forKeyPath: self.keyPath, options: options, context: nil)
|
|
}
|
|
|
|
deinit {
|
|
|
|
self.object?.removeObserver(self, forKeyPath: self.keyPath, context: nil)
|
|
}
|
|
|
|
|
|
// MARK: DynamicObjectKeyValueObservation
|
|
|
|
public func invalidate() {
|
|
|
|
self.object?.removeObserver(self, forKeyPath: self.keyPath, context: nil)
|
|
self.object = nil
|
|
}
|
|
|
|
|
|
// MARK: Private
|
|
|
|
// workaround for <rdar://problem/31640524> Erroneous (?) error when using bridging in the Foundation overlay
|
|
@nonobjc static var swizzler: Any? = cs_lazy {
|
|
|
|
let bridgeClass: AnyClass = _CoreStoreObjectKeyValueObservation.self
|
|
let rootObserveImpl = class_getInstanceMethod(
|
|
bridgeClass,
|
|
#selector(_CoreStoreObjectKeyValueObservation.observeValue(forKeyPath:of:change:context:))
|
|
)!
|
|
let swapObserveImpl = class_getInstanceMethod(
|
|
bridgeClass,
|
|
#selector(_CoreStoreObjectKeyValueObservation._cs_swizzle_me_observeValue(forKeyPath:of:change:context:))
|
|
)!
|
|
method_exchangeImplementations(rootObserveImpl, swapObserveImpl)
|
|
return nil
|
|
}
|
|
|
|
@nonobjc private weak var object: CoreStoreManagedObject?
|
|
@nonobjc private let callback: (_ object: CoreStoreManagedObject, _ kind: NSKeyValueChange, _ newValue: Any?, _ oldValue: Any?, _ indexes: IndexSet?, _ isPrior: Bool) -> Void
|
|
@nonobjc private let keyPath: KeyPathString
|
|
|
|
@objc private dynamic func _cs_swizzle_me_observeValue(forKeyPath keyPath: String?, of object: Any?, change: [NSString: Any]?, context: UnsafeMutableRawPointer?) {
|
|
|
|
guard
|
|
let object = object as? CoreStoreManagedObject,
|
|
object == self.object,
|
|
let change = change
|
|
else {
|
|
|
|
return
|
|
}
|
|
let rawKind: UInt = change[NSKeyValueChangeKey.kindKey.rawValue as NSString] as! UInt
|
|
self.callback(
|
|
object,
|
|
NSKeyValueChange(rawValue: rawKind)!,
|
|
change[NSKeyValueChangeKey.newKey.rawValue as NSString],
|
|
change[NSKeyValueChangeKey.oldKey.rawValue as NSString],
|
|
change[NSKeyValueChangeKey.indexesKey.rawValue as NSString] as! IndexSet?,
|
|
change[NSKeyValueChangeKey.notificationIsPriorKey.rawValue as NSString] as! Bool? ?? false
|
|
)
|
|
}
|
|
}
|