RLMAsyncOpenTask

Objective-C


@interface RLMAsyncOpenTask : NSObject

Swift

@_nonSendable(_assumed) class RLMAsyncOpenTask : NSObject, @unchecked Sendable

Um objeto de tarefa que pode ser usado para observar ou cancelar uma abertura assíncrona.

Quando um Realm sincronizado é aberto de forma assíncrona, o estado mais recente do Realm é baixado do servidor antes que a chamada de resposta de conclusão seja invocada. Este objeto de tarefa pode ser usado para observar o estado do download ou cancelá-lo. Isso deve ser usado em vez de tentar observar o download por meio da sessão de sincronização, pois a sessão de sincronização em si é criada de forma assíncrona e pode ainda não existir quando -[RLLMRealm asyncOpenWithConfiguration:completion:] retornar.

  • Obsoleto(a)

    Em vez disso, usar addSyncProgressNotificationBlock

    Registre um bloqueio de notificação de progresso.

    Cada bloco de notificação de progresso registrado é chamado sempre que o subsistema de sincronização tiver novos dados de progresso para relatar até que a tarefa seja cancelada ou o retorno de chamada de conclusão seja chamado. As notificações de progresso são entregues na fila principal.

    Declaração

    Objective-C

    - (void)addProgressNotificationBlock:
        (nonnull RLMProgressNotificationBlock)block;

    Swift

    func addProgressNotificationBlock(_ block: @escaping RLMProgressNotificationBlock)
  • Registre um bloqueio de notificação de progresso.

    Cada bloco de notificação de progresso registrado é chamado sempre que o subsistema de sincronização tiver novos dados de progresso para relatar até que a tarefa seja cancelada ou o retorno de chamada de conclusão seja chamado. As notificações de progresso são entregues na fila principal.

    Declaração

    Objective-C

    - (void)addSyncProgressNotificationBlock:
        (nonnull RLMSyncProgressNotificationBlock)block;

    Swift

    func addSyncProgressNotificationBlock(_ block: @escaping RLMSyncProgressNotificationBlock)
  • Obsoleto(a)

    Em vez disso, usar addSyncProgressNotificationOnQueue

    Registre um bloco de notificação de progresso que é chamado na fila fornecida.

    Cada bloco de notificação de progresso registrado é chamado sempre que o subsistema de sincronização tiver novos dados de progresso para relatar até que a tarefa seja cancelada ou o retorno de chamada de conclusão seja chamado. As notificações de progresso são entregues na fila fornecida.

    Declaração

    Objective-C

    - (void)addProgressNotificationOnQueue:(nonnull dispatch_queue_t)queue
                                     block:(nonnull RLMProgressNotificationBlock)
                                               block;

    Swift

    func addProgressNotification(on queue: dispatch_queue_t, block: @escaping RLMProgressNotificationBlock)
  • Registre um bloco de notificação de progresso que é chamado na fila fornecida.

    Cada bloco de notificação de progresso registrado é chamado sempre que o subsistema de sincronização tiver novos dados de progresso para relatar até que a tarefa seja cancelada ou o retorno de chamada de conclusão seja chamado. As notificações de progresso são entregues na fila fornecida.

    Declaração

    Objective-C

    - (void)
        addSyncProgressNotificationOnQueue:(nonnull dispatch_queue_t)queue
                                     block:
                                         (nonnull RLMSyncProgressNotificationBlock)
                                             block;

    Swift

    func addSyncProgressNotification(on queue: dispatch_queue_t, block: @escaping RLMSyncProgressNotificationBlock)
  • Cancele a abertura assíncrona.

    Qualquer download em andamento será cancelado e o bloco de conclusão para esta abertura assíncrona nunca será chamado. Se várias aberturas assíncronas no mesmo Realm estiverem ocorrendo simultaneamente, todas as outras aberturas falharão com o erro "operação cancelada".

    Declaração

    Objective-C

    - (void)cancel;

    Swift

    func cancel()