객체

객체가 변경될 때마다 Void를 방출하는 출판사입니다.

이름과 달리 실제로 객체가 변경된 후에 방출합니다.

Realm 객체의 관리되지 않는 인스턴스를 만듭니다.

value 인수는 객체를 채우는 데 사용됩니다. 키-값 코딩을 준수하는 객체, NSJSONSerialization 의 메서드에서 반환된 배열 또는 사전 또는 각 managed 속성에 대해 하나의 요소를 포함하는 Array 일 수 있습니다. 필수 속성이 없고 해당 속성이 기본값으로 정의되지 않은 경우 예외가 발생합니다.

Array 를 value 인수로 전달할 때 모든 속성이 존재하고 유효해야 하며 모델에 정의된 속성과 동일한 순서여야 합니다.

Realm 인스턴스에서 add(_:) 를 호출하여 관리되지 않는 객체를 해당 Realm에 추가합니다.

객체를 managed하는 Realm이거나 객체가 관리되지 않는 경우 nil 입니다.

managed 객체의 속성을 나열하는 객체 스키마입니다.

객체가 유효하지 않아 더 이상 액세스할 수 없는지 여부를 나타냅니다.

객체를 managed Realm에서 객체가 삭제되었거나 해당 Realm에서 invalidate() 이(가) 호출된 경우 객체에 더 이상 액세스할 수 없습니다. 이 속성은 키-값으로 관찰 가능합니다.

사람이 읽을 수 있는 객체에 대한 설명입니다.

기본 키로 사용할 속성의 이름을 지정하려면 이 메서드를 재정의합니다.

String, Int, ObjectId , UUID 유형의 속성만 기본 키로 지정할 수 있습니다. 기본 키 속성은 속성이 설정될 때마다 각 값에 고유성을 적용하므로 약간의 오버헤드가 발생합니다. 인덱스는 기본 키 속성에 대해 자동으로 생성됩니다.

무시할 속성의 이름을 지정하려면 이 메서드를 재정의합니다. 이러한 속성은 객체를 managed하는 Realm에서 managed하지 않습니다.

인덱스화해야 하는 속성의 속성 이름 배열을 반환합니다.

문자열, 정수, 부울, Date 및 NSDate 속성만 지원됩니다.

공개-비공개 속성 이름 맵을 지정하려면 이 메서드를 재정의합니다. 이렇게 하면 Realm에 다른 영구 속성 이름이 설정되고 속성을 다루는 모든 작업에 공개 이름을 사용할 수 있습니다. (예: 쿼리, 정렬 등). 이는 Device Sync JSON 스키마의 속성 이름을 로컬 속성 이름에 매핑해야 하는 경우 매우 유용합니다.

class Person: Object {
    @Persisted var firstName: String
    @Persisted var birthDate: Date
    @Persisted var age: Int

    override class public func propertiesMapping() -> [String : String] {
        ["firstName": "first_name",
         "birthDate": "birth_date"]
    }
}

let migrationBlock = { migration, oldSchemaVersion in
    migration.enumerateObjects(ofType: "Person", { oldObj, newObj in
       let oldPropertyValue = oldObj!["first_name"] as! String
       // Use this value in migration
    })
}

속성 이름을 바꿀 때도 이 작업을 수행해야 합니다.

let migrationBlock = { migration, oldSchemaVersion in
    migration.renameProperty(onType: "Person", from: "first_name", to: "complete_name")
}

지정된 이름을 가진 속성의 값을 반환하거나 설정합니다.

객체가 변경될 때마다 호출될 블록을 등록합니다.

이 블록은 객체를 삭제하거나 속성을 기존 값으로 설정하는 자체 할당을 포함하여 객체의 managed 속성을 수정하는 각 쓰기 트랜잭션(write transaction) 후에 비동기적으로 호출됩니다.

다른 스레드 또는 다른 프로세스에서 수행되는 쓰기 트랜잭션 (write transaction)의 경우 관리 Realm이 변경 사항이 포함된 버전으로 (자동)새로 고침될 때 블록이 호출되는 반면, 로컬 쓰기 트랜잭션 (write transaction)의 경우 다음과 같은 미래의 어느 점에 블록이 호출됩니다. 쓰기 트랜잭션 (write transaction)이 커밋됩니다.

키 경로가 제공되지 않으면 객체의 모든 첫 번째 수준 속성에 대해 삽입, 수정 또는 삭제할 때 차단이 실행됩니다. Object 알림은 기본적으로 단순 알림이므로 해당 속성의 키 경로가 지정되지 않는 한 중첩된 속성을 수정해도 알림이 trigger되지 않습니다. 하나 이상의 키 경로가 제공되면 제공된 키 경로에서만 발생하는 변경에 대해 차단이 호출됩니다. 예를 들어 다음과 같은 경우입니다.

class Dog: Object {
    @Persisted var name: String
    @Persisted var adopted: Bool
    @Persisted var siblings: List<Dog>
}

// ... where `dog` is a managed Dog object.
dog.observe(keyPaths: ["adopted"], { changes in
   // ...
})

• 위의 알림 차단은 adopted 속성이 변경될 경우 실행되지만 name 에 대한 변경 사항에 대해서는 실행되지 않습니다.
• 관찰된 키 경로가 ["siblings"] 인 경우 siblings 목록을 삽입, 삭제 또는 수정하면 차단이 trigger됩니다. someSibling.name 을(를) 변경해도 차단이 trigger 되지 않습니다(여기서 someSibling 은 siblings 에 포함된 요소입니다).

• 관찰된 키 경로가 ["siblings.name"] 인 경우 siblings 목록을 삽입하거나 삭제하면 차단이 trigger됩니다. siblings 목록에 포함된 객체의 경우, 해당 name 속성을 수정해야만 차단이 trigger됩니다.

대기열이 제공되지 않으면 표준 이벤트 루프를 통해 알림이 전달되므로 이벤트 루프가 다른 활동에 의해 차단되는 동안에는 알림을 전달할 수 없습니다. 대기열이 제공되면 대신 해당 대기열로 알림이 전달됩니다. 알림을 즉시 전달할 수 없는 경우 여러 알림이 단일 알림으로 병합될 수 있습니다.

List 및 Results 과 달리 새 알림 차단을 추가한 후에는 '초기' 콜백이 이루어지지 않습니다.

Realm에서 managed 객체만 이러한 방식으로 관찰할 수 있습니다. 블록에 업데이트를 전송하려는 한 반환된 토큰을 보관해야 합니다. 업데이트 수신을 중지하려면 토큰에서 invalidate() 을 호출합니다.

콜백 블록 내에서 관찰된 객체에 대한 강력한 참고를 캡처하는 것이 안전합니다. 콜백이 객체 자체가 아닌 반환된 토큰에 의해 유지되므로 유지 주기가 없습니다.

객체가 변경될 때마다 호출될 블록을 등록합니다.

이 블록은 객체를 삭제하거나 속성을 기존 값으로 설정하는 자체 할당을 포함하여 객체의 managed 속성을 수정하는 각 쓰기 트랜잭션(write transaction) 후에 비동기적으로 호출됩니다.

다른 스레드 또는 다른 프로세스에서 수행되는 쓰기 트랜잭션 (write transaction)의 경우 관리 Realm이 변경 사항이 포함된 버전으로 (자동)새로 고침될 때 블록이 호출되는 반면, 로컬 쓰기 트랜잭션 (write transaction)의 경우 다음과 같은 미래의 어느 점에 블록이 호출됩니다. 쓰기 트랜잭션 (write transaction)이 커밋됩니다.

키 경로가 제공되지 않으면 객체의 모든 첫 번째 수준 속성에 대해 삽입, 수정 또는 삭제할 때 차단이 실행됩니다. Object 알림은 기본적으로 단순 알림이므로 해당 속성의 키 경로가 지정되지 않는 한 중첩된 속성을 수정해도 알림이 trigger되지 않습니다. 하나 이상의 키 경로가 제공되면 제공된 키 경로에서만 발생하는 변경에 대해 차단이 호출됩니다. 예를 들어,

class Dog: Object {
    @Persisted var name: String
    @Persisted var adopted: Bool
    @Persisted var siblings: List<Dog>
}

// ... where `dog` is a managed Dog object.
dog.observe(keyPaths: [\Dog.adopted], { changes in
   // ...
})

• 위의 알림 차단은 adopted 속성이 변경될 경우 실행되지만 name 에 대한 변경 사항에 대해서는 실행되지 않습니다.
• 관찰된 키 경로가 [\Dog.siblings] 인 경우 siblings 목록을 삽입, 삭제 또는 수정하면 차단이 trigger됩니다. someSibling.name 을(를) 변경해도 차단이 trigger 되지 않습니다(여기서 someSibling 은 siblings 에 포함된 요소입니다).

• 관찰된 키 경로가 [\Dog.siblings.name] 인 경우 siblings 목록을 삽입하거나 삭제하면 차단이 trigger됩니다. siblings 목록에 포함된 객체의 경우, 해당 name 속성을 수정해야만 차단이 trigger됩니다.

대기열이 제공되지 않으면 표준 이벤트 루프를 통해 알림이 전달되므로 이벤트 루프가 다른 활동에 의해 차단되는 동안에는 알림을 전달할 수 없습니다. 대기열이 제공되면 대신 해당 대기열로 알림이 전달됩니다. 알림을 즉시 전달할 수 없는 경우 여러 알림이 단일 알림으로 병합될 수 있습니다.

List 및 Results 과 달리 새 알림 차단을 추가한 후에는 '초기' 콜백이 이루어지지 않습니다.

Realm에서 managed 객체만 이러한 방식으로 관찰할 수 있습니다. 블록에 업데이트를 전송하려는 한 반환된 토큰을 보관해야 합니다. 업데이트 수신을 중지하려면 토큰에서 invalidate() 을 호출합니다.

콜백 블록 내에서 관찰된 객체에 대한 강력한 참고를 캡처하는 것이 안전합니다. 콜백이 객체 자체가 아닌 반환된 토큰에 의해 유지되므로 유지 주기가 없습니다.

객체가 변경될 때마다 호출될 블록을 등록합니다.

managed 객체를 삭제하거나 속성을 기존 값으로 설정하는 자체 할당을 포함하여 객체의 managed 속성을 수정하는 각 쓰기 트랜잭션 (write transaction) 후에는 지정된 행위자의 실행기에서 차단이 비동기적으로 호출됩니다. 요청된 행위자에게 격리된 객체의 복사본이 해당 행위자에서 안전하게 사용할 수 있는 객체의 사본과 변경된 내용에 대한 정보가 블록에 전달됩니다.

다른 스레드 또는 다른 프로세스에서 수행되는 쓰기 트랜잭션 (write transaction)의 경우 관리 Realm이 변경 사항이 포함된 버전으로 (자동)새로 고침될 때 블록이 호출되는 반면, 로컬 쓰기 트랜잭션 (write transaction)의 경우 다음과 같은 미래의 어느 점에 블록이 호출됩니다. 쓰기 트랜잭션 (write transaction)이 커밋됩니다.

Realm에서 managed 객체만 이러한 방식으로 관찰할 수 있습니다. 블록에 업데이트를 전송하려는 한 반환된 토큰을 보관해야 합니다. 업데이트 수신을 중지하려면 토큰에서 invalidate() 을 호출합니다.

기본적으로 객체의 속성을 직접 변경하는 경우에만 알림이 생성되고 연결된 객체에 대한 변경 사항은 생성되지 않습니다. 이는 collection 변경 알림과는 다릅니다. nil이 아니고 비어 있지 않은 키 경로 배열이 전달되는 경우 해당 키 경로로 식별되는 속성의 변경 사항만 변경 알림을 생성합니다. 키 경로는 링크 속성을 순회하여 연결된 객체의 변경 사항에 대한 정보를 받을 수 있습니다.

객체가 변경될 때마다 호출될 블록을 등록합니다.

managed 객체를 삭제하거나 속성을 기존 값으로 설정하는 자체 할당을 포함하여 객체의 managed 속성을 수정하는 각 쓰기 트랜잭션 (write transaction) 후에는 지정된 행위자의 실행기에서 차단이 비동기적으로 호출됩니다. 요청된 행위자에게 격리된 객체의 복사본이 해당 행위자에서 안전하게 사용할 수 있는 객체의 사본과 변경된 내용에 대한 정보가 블록에 전달됩니다.

다른 스레드 또는 다른 프로세스에서 수행되는 쓰기 트랜잭션 (write transaction)의 경우 관리 Realm이 변경 사항이 포함된 버전으로 (자동)새로 고침될 때 블록이 호출되는 반면, 로컬 쓰기 트랜잭션 (write transaction)의 경우 다음과 같은 미래의 어느 점에 블록이 호출됩니다. 쓰기 트랜잭션 (write transaction)이 커밋됩니다.

Realm에서 managed 객체만 이러한 방식으로 관찰할 수 있습니다. 블록에 업데이트를 전송하려는 한 반환된 토큰을 보관해야 합니다. 업데이트 수신을 중지하려면 토큰에서 invalidate() 을 호출합니다.

기본적으로 객체의 속성을 직접 변경하는 경우에만 알림이 생성되고 연결된 객체에 대한 변경 사항은 생성되지 않습니다. 이는 collection 변경 알림과는 다릅니다. nil이 아니고 비어 있지 않은 키 경로 배열이 전달되는 경우 해당 키 경로로 식별되는 속성의 변경 사항만 변경 알림을 생성합니다. 키 경로는 링크 속성을 순회하여 연결된 객체의 변경 사항에 대한 정보를 받을 수 있습니다.

두 Realm 객체가 동일한지 여부를 반환합니다.

객체는 동일한 Realm에서 managed되고 데이터베이스에서 동일한 기본 객체를 점하는 경우에만 동일한 것으로 간주됩니다.

이 객체가 동결되었는지 여부를 나타냅니다.

이 객체의 동결(불변) 스냅샷을 반환합니다.

동결 복사본은 변경이 불가능한 객체로 이 객체가 현재 포함하고 있는 것과 동일한 데이터를 포함하지만 포함된 Realm에 기록할 때 업데이트되지 않습니다. 라이브 객체와 달리 동결 객체는 모든 스레드에서 액세스할 수 있습니다.

이 객체의 라이브(변경 가능) 참고를 반환합니다.

이 메서드는 동일한 동결된 객체의 라이브 복사본에 대한 managed 접근자를 만듭니다. 이미 라이브 객체에 대해 호출되면 자체를 반환합니다.