RLM Sync 서브스크립션 세트

Objective-C

@interface RLMSyncSubscriptionSet : NSObject <NSFastEnumeration>

Swift

@_nonSendable(_assumed) class RLMSyncSubscriptionSet : NSObject, NSFastEnumeration

RLMSyncSubscriptionSet RLMSyncSubscription의 collection입니다. 이는 RLMSyncSubscription를 추가하고 제거하기 위한 진입점입니다.

  • 구독 세트의 구독 수입니다.

    선언

    Objective-C

    @property (readonly) NSUInteger count;

    Swift

    var count: UInt { get }
  • 구독 세트와 관련된 오류를 가져옵니다. 구독 세트의 현재 상태가 RLMSyncSubscriptionStateError 인 경우 nil이 아닙니다.

    선언

    Objective-C

    @property (nonatomic, readonly, nullable) NSError *error;

    Swift

    var error: (any Error)? { get }
  • 구독 설정하다 에 연결된 상태 를 가져옵니다.

    선언

    Objective-C

    @property (nonatomic, readonly) RLMSyncSubscriptionState state;

    Swift

    var state: RLMSyncSubscriptionState { get }

배치 업데이트 구독

  • 차단 내의 구독 설정하다 에 대해 모든 트랜잭션(추가/ 제거/ 업데이트 )을 동기식으로 수행하며, 이는 서버 가 이 구독 컬렉션 과 관련된 모든 데이터를 확인하고 볼 때까지 기다리지 않고, 구독 트랜잭션을 커밋한 후 반환됩니다.

    선언

    Objective-C

    - (void)update:(nonnull void (^)(void))block;

    Swift

    func update(_ block: () -> Void)

    매개변수

    block

    구독 설정하다 에 수행할 작업이 포함된 차단 입니다.

  • 차단 내의 구독 설정하다 에 대한 모든 트랜잭션(추가/ 제거/ 업데이트 )을 동기식으로 수행합니다. The onComplete block is executed after waiting for associated data to be downloaded from the server.

    선언

    Objective-C

    - (void)update:(nonnull void (^)(void))block
        onComplete:(nullable void (^)(NSError *_Nullable))onComplete;

    Swift

    @_unsafeInheritExecutor func update(_ block: () -> Void) async throws

    매개변수

    block

    구독 설정하다 에 수행할 작업이 포함된 차단 입니다.

    onComplete

    서버 에서 데이터가 동기화될 때 호출되는 차단 입니다. 업데이트 가 성공하면 차단 에 nil 가 전달되고, 그렇지 않으면 문제를 설명하는 오류가 전달됩니다.

  • 차단 내의 구독 설정하다 에 대한 모든 트랜잭션(추가/ 제거/ 업데이트 )을 동기식으로 수행합니다. The onComplete block is executed after waiting for associated data to be downloaded from the server.

    선언

    Objective-C

    - (void)update:(nonnull void (^)(void))block
             queue:(nullable dispatch_queue_t)queue
        onComplete:(nonnull void (^)(NSError *_Nonnull))onComplete;

    Swift

    @_unsafeInheritExecutor func update(_ block: () -> Void, queue: dispatch_queue_t?, onComplete: @escaping (any Error) -> Void)

    매개변수

    block

    구독 설정하다 에 수행할 작업이 포함된 차단 입니다.

    queue

    알림을 전달할 직렬 대기열입니다.

    onComplete

    서버 에서 데이터가 동기화될 때 호출되는 차단 입니다. 업데이트 가 성공하면 차단 에 nil 가 전달되고, 그렇지 않으면 문제를 설명하는 오류가 전달됩니다.

구독 찾기

  • 지정된 이름으로 구독 을 찾습니다.

    선언

    Objective-C

    - (nullable RLMSyncSubscription *)subscriptionWithName:(nonnull NSString *)name;

    Swift

    func subscription(withName name: String) -> RLMSyncSubscription?

    매개변수

    name

    구독을 식별하는 데 사용되는 이름입니다.

    반환 값

    지정된 이름에 대한 구독입니다.

  • 지정된 객체 클래스 이름에 대한 쿼리 로 구독 을 찾습니다.

    선언

    Objective-C

    - (nullable RLMSyncSubscription *)
        subscriptionWithClassName:(nonnull NSString *)objectClassName
                            where:(nonnull NSString *)predicateFormat, ...;

    매개변수

    objectClassName

    쿼리할 모델 클래스의 클래스 이름입니다.

    predicateFormat

    조건자 형식 문자열이며, 선택적으로 그 뒤에 다양한 수의 인수가 옵니다.

    반환 값

    지정된 쿼리 에 대한 구독 입니다.

  • 지정된 객체 클래스 이름에 대한 쿼리 로 구독 을 찾습니다.

    선언

    Objective-C

    - (nullable RLMSyncSubscription *)
        subscriptionWithClassName:(nonnull NSString *)objectClassName
                        predicate:(nonnull NSPredicate *)predicate;

    Swift

    func subscription(withClassName objectClassName: String, predicate: NSPredicate) -> RLMSyncSubscription?

    매개변수

    objectClassName

    쿼리할 모델 클래스의 클래스 이름입니다.

    predicate

    서버 의 객체를 필터하다 하는 데 사용되는 조건자입니다.

    반환 값

    지정된 쿼리 에 대한 구독 입니다.

구독 추가

  • 쓰기 (write) 구독 차단 이 끝날 때 커밋될 때 서버 로 전송될 구독 설정하다 에 새 구독 을 추가합니다.

    경고

    이 메서드는 쓰기 구독 차단 중에만 호출할 수 있습니다.

    선언

    Objective-C

    - (void)addSubscriptionWithClassName:(nonnull NSString *)objectClassName
                                   where:(nonnull NSString *)predicateFormat, ...;

    매개변수

    objectClassName

    쿼리할 모델 클래스의 클래스 이름입니다.

    predicateFormat

    조건자 형식 문자열이며, 선택적으로 그 뒤에 다양한 수의 인수가 옵니다.

  • 쓰기 (write) 구독 차단 이 끝날 때 커밋될 때 서버 로 전송될 구독 설정하다 에 새 구독 을 추가합니다.

    경고

    이 메서드는 쓰기 구독 차단 중에만 호출할 수 있습니다.

    선언

    Objective-C

    - (void)addSubscriptionWithClassName:(nonnull NSString *)objectClassName
                        subscriptionName:(nonnull NSString *)name
                                   where:(nonnull NSString *)predicateFormat, ...;

    매개변수

    objectClassName

    쿼리할 모델 클래스의 클래스 이름입니다.

    name

    구독을 식별하는 데 사용된 이름입니다.

    predicateFormat

    조건자 형식 문자열이며, 선택적으로 그 뒤에 다양한 수의 인수가 옵니다.

  • 쓰기 (write) 구독 차단 이 끝날 때 커밋될 때 서버 로 전송될 구독 설정하다 에 새 구독 을 추가합니다.

    경고

    이 메서드는 쓰기 구독 차단 중에만 호출할 수 있습니다.

    선언

    Objective-C

    - (void)addSubscriptionWithClassName:(nonnull NSString *)objectClassName
                               predicate:(nonnull NSPredicate *)predicate;

    Swift

    func addSubscription(withClassName objectClassName: String, predicate: NSPredicate)

    매개변수

    objectClassName

    쿼리할 모델 클래스의 클래스 이름입니다.

    predicate

    구독 에 대한 쿼리 를 정의 하는 조건자 입니다.

  • 쓰기 (write) 구독 차단 이 끝날 때 커밋될 때 서버 로 전송될 구독 설정하다 에 새 구독 을 추가합니다.

    경고

    이 메서드는 쓰기 구독 차단 중에만 호출할 수 있습니다.

    선언

    Objective-C

    - (void)addSubscriptionWithClassName:(nonnull NSString *)objectClassName
                        subscriptionName:(nullable NSString *)name
                               predicate:(nonnull NSPredicate *)predicate;

    Swift

    func addSubscription(withClassName objectClassName: String, subscriptionName name: String?, predicate: NSPredicate)

    매개변수

    objectClassName

    쿼리할 모델 클래스의 클래스 이름입니다.

    name

    구독을 식별하는 데 사용되는 이름입니다.

    predicate

    구독 에 대한 쿼리 를 정의 하는 조건자 입니다.

구독 제거

  • 구독 세트에서 지정된 이름의 구독을 제거합니다.

    경고

    이 메서드는 쓰기 구독 차단 중에만 호출할 수 있습니다.

    선언

    Objective-C

    - (void)removeSubscriptionWithName:(nonnull NSString *)name;

    Swift

    func removeSubscription(withName name: String)

    매개변수

    name

    구독을 식별하는 데 사용된 이름입니다.

  • 구독 세트에서 객체 클래스에 대해 지정된 쿼리를 사용하여 구독을 제거합니다.

    경고

    이 메서드는 쓰기 구독 차단 중에만 호출할 수 있습니다.

    선언

    Objective-C

    - (void)removeSubscriptionWithClassName:(nonnull NSString *)objectClassName
                                      where:(nonnull NSString *)predicateFormat,
                                            ...;

    매개변수

    objectClassName

    쿼리할 모델 클래스의 클래스 이름입니다.

    predicateFormat

    조건자 형식 문자열이며, 선택적으로 그 뒤에 다양한 수의 인수가 옵니다.

  • 구독 세트에서 객체 클래스에 대해 지정된 쿼리를 사용하여 구독을 제거합니다.

    경고

    이 메서드는 쓰기 구독 차단 중에만 호출할 수 있습니다.

    선언

    Objective-C

    - (void)removeSubscriptionWithClassName:(nonnull NSString *)objectClassName
                                  predicate:(nonnull NSPredicate *)predicate;

    Swift

    func removeSubscription(withClassName objectClassName: String, predicate: NSPredicate)

    매개변수

    objectClassName

    쿼리할 모델 클래스의 클래스 이름입니다.

    predicate

    제거할 구독을 식별하는 데 사용할 조건자입니다.

  • 구독 설정하다 에서 구독 을 제거합니다.

    경고

    이 메서드는 쓰기 구독 차단 중에만 호출할 수 있습니다.

    선언

    Objective-C

    - (void)removeSubscription:(nonnull RLMSyncSubscription *)subscription;

    Swift

    func remove(_ subscription: RLMSyncSubscription)

    매개변수

    subscription

    제거할 구독 의 인스턴스 입니다.

구독 제거

  • 구독 세트에서 모든 구독을 제거합니다.

    경고

    이 메서드는 쓰기 구독 차단 중에만 호출할 수 있습니다.

    경고

    새 구독이 추가되지 않으면 모든 구독을 제거하면 오류가 발생합니다. 서버는 하나 이상의 구독을 확인해야 합니다.

    선언

    Objective-C

    - (void)removeAllSubscriptions;

    Swift

    func removeAllSubscriptions()
  • 구독 설정하다 에서 이름이 없는 모든 구독을 제거합니다.

    경고

    이 메서드는 쓰기 구독 차단 중에만 호출할 수 있습니다.

    경고

    새 구독이 추가되지 않으면 모든 구독을 제거하면 오류가 발생합니다. 서버는 하나 이상의 구독을 확인해야 합니다.

    선언

    Objective-C

    - (void)removeAllUnnamedSubscriptions;

    Swift

    func removeAllUnnamedSubscriptions()
  • 지정된 클래스 이름을 가진 모든 구독 을 제거합니다.

    경고

    이 메서드는 쓰기 구독 차단 중에만 호출할 수 있습니다.

    선언

    Objective-C

    - (void)removeAllSubscriptionsWithClassName:(nonnull NSString *)className;

    Swift

    func removeAllSubscriptions(withClassName className: String)

    매개변수

    className

    쿼리할 모델 클래스의 클래스 이름입니다.

SubscriptionSet 컬렉션

첨자

  • 지정된 index 에서 구독을 반환합니다.

    선언

    Objective-C

    - (nonnull id)objectAtIndexedSubscript:(NSUInteger)index;

    Swift

    subscript(index: UInt) -> Any { get }

    매개변수

    index

    인덱스입니다.

    반환 값

    구독 세트에서 지정된 인덱스에 대한 구독입니다.