EmbeddedObject is a base class used to define embedded Realm model objects.
Embedded objects work similarly to normal objects, but are owned by a single parent Object (which itself may be embedded). Unlike normal top-level objects, embedded objects cannot be directly created in or added to a Realm. Instead, they can only be created as part of a parent object, or by assigning an unmanaged object to a parent object’s property. Embedded objects are automatically deleted when the parent object is deleted or when the parent is modified to no longer point at the embedded object, either by reassigning an Object property or by removing the embedded object from the List containing it.
Embedded objects can only ever have a single parent object which links to them, and attempting to link to an existing managed embedded object will throw an exception.
The property types supported on EmbeddedObject are the same as for Object, except for that embedded objects cannot link to top-level objects, so Object and List<Object> properties are not supported (EmbeddedObject and List<EmbeddedObject> are).
Embedded objects cannot have primary keys or indexed properties.
class Owner: Object {
@objc dynamic var name: String = ""
let dogs = List<Dog>()
}
class Dog: EmbeddedObject {
@objc dynamic var name: String = ""
@objc dynamic var adopted: Bool = false
let owner = LinkingObjects(fromType: Owner.self, property: "dogs")
}
Creates an unmanaged instance of a Realm object.
An unmanaged embedded object can be added to a Realm by assigning it to a property of a managed object or by adding it to a managed List.
DeclarationSwift
public override required init()Creates an unmanaged instance of a Realm object.
The value argument is used to populate the object. It can be a key-value coding compliant object, an array or dictionary returned from the methods in NSJSONSerialization, or an Array containing one element for each managed property. An exception will be thrown if any required properties are not present and those properties were not defined with default values.
When passing in an Array as the value argument, all properties must be present, valid and in the same order as the properties defined in the model.
An unmanaged embedded object can be added to a Realm by assigning it to a property of a managed object or by adding it to a managed List.
DeclarationSwift
public convenience init(value: Any) value
The value used to populate the object.
The Realm which manages the object, or nil if the object is unmanaged.
Swift
public var realm: Realm? { get }The object schema which lists the managed properties for the object.
Indicates if the object can no longer be accessed because it is now invalid.
An object can no longer be accessed if the object has been deleted from the Realm that manages it, or if invalidate() is called on that Realm.
Swift
public override final var isInvalidated: Bool { get }A human-readable description of the object.
DeclarationSwift
open override var description: String { get }Override this method to specify the names of properties to ignore. These properties will not be managed by the Realm that manages the object.
DeclarationSwift
@objc
open class func ignoredProperties() -> [String]An array of property names to ignore.
Key-Value Coding & Subscripting
Returns or sets the value of the property with the given name.
DeclarationSwift
@objc
open subscript(key: String) -> Any? { get set }Registers a block to be called each time the object changes.
The block will be asynchronously called after each write transaction which deletes the object or modifies any of the managed properties of the object, including self-assignments that set a property to its existing value.
For write transactions performed on different threads or in different processes, the block will be called when the managing Realm is (auto)refreshed to a version including the changes, while for local write transactions it will be called at some point in the future after the write transaction is committed.
Notifications are delivered via the standard run loop, and so can’t be delivered while the run loop is blocked by other activity. When notifications can’t be delivered instantly, multiple notifications may be coalesced into a single notification.
Unlike with List and Results, there is no “initial” callback made after you add a new notification block.
Only objects which are managed by a Realm can be observed in this way. You must retain the returned token for as long as you want updates to be sent to the block. To stop receiving updates, call invalidate() on the token.
It is safe to capture a strong reference to the observed object within the callback block. There is no retain cycle due to that the callback is retained by the returned token and not by the object itself.
Warning
Parameters queue
The serial dispatch queue to receive notification on. If nil, notifications are delivered to the current thread.
block
The block to call with information about changes to the object.
Return ValueA token which must be held for as long as you want updates to be delivered.
Returns whether two Realm objects are the same.
Objects are considered the same if and only if they are both managed by the same Realm and point to the same underlying object in the database.
Note
Equality comparison is implemented by isEqual(_:). If the object type is defined with a primary key, isEqual(_:) behaves identically to this method. If the object type is not defined with a primary key, isEqual(_:) uses the NSObject behavior of comparing object identity. This method can be used to compare two objects for database equality whether or not their object type defines a primary key.
Swift
public func isSameObject(as object: EmbeddedObject?) -> Bool object
The object to compare the receiver to.
Indicates if this object is frozen.
DeclarationSwift
public var isFrozen: Bool { get }Returns a frozen (immutable) snapshot of this object.
The frozen copy is an immutable object which contains the same data as this object currently contains, but will not update when writes are made to the containing Realm. Unlike live objects, frozen objects can be accessed from any thread.
Warning
DeclarationSwift
public func freeze() -> SelfRetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4