managed 동기화 세션 - C++ SDK

전제 조건

동기화 세션 상태를 managed하려면 먼저 다음을 수행해야 합니다.

1. Atlas App Services 백엔드에서 Flexible Sync 구성

2. 동기화된 Realm 열기

동기화 세션 가져오기

멤버 함수 get_sync_session() 을 사용하여 동기화된 모든 영역 에 대한 sync_session 객체 를 가져올 수 있습니다. SDK는 이 객체 를 선택 사항으로 반환합니다. 값으로 전달할 수 있는 경량 처리하다 입니다.

auto syncSession = realm.get_sync_session();

네트워크 연결 확인

연결 상태를 확인하려면 동기화 세션 인스턴스의 connection_state() 속성을 직접 읽으면 됩니다.

syncSession->connection_state();

관찰_연결 _변경() 함수를 사용하여 연결 상태를 관찰할 수도 있습니다. 이 함수는 기본 동기화 세션이 연결 상태를 변경할 때 SDK가 호출하는 콜백을 등록합니다.

auto connectionToken = syncSession->observe_connection_change(
    [&](enum realm::sync_session::connection_state,
        enum realm::sync_session::connection_state new_state) {
      // Register a block to execute when connection state changes.
    });

연결 변경 리스너를 등록한 경우 변경 사항 수신이 완료되면 등록을 취소할 수 있습니다. 동기화 세션 인스턴스의 unregister_connection_change_observer() 메서드를 호출하여 관찰 토큰 등록을 취소합니다.

syncSession->unregister_connection_change_observer(connectionToken);

네트워크 연결 상태는 state() 메서드로 확인할 수 있는 Realm Mobile Sync 연결 상태와 다릅니다. 동기화 연결 상태에 대한 자세한 내용은 이 페이지의 동기화 상태 확인 문서를 참조하세요.

동기화 세션 일시 중지 또는 재개

Realm에서 동기화 세션을 일시 중지했다가 다시 시작할 수 있습니다. 동기화 세션을 일시 중지하면 해당 Realm의 동기화 세션만 일시 중단됩니다. 열려 있는 Realm이 두 개 이상 있는 경우 일시 중단해도 다른 Realm의 동기화 세션에는 영향을 주지 않습니다.

동기화 세션을 일시 중지하려면 동기화 세션의 pause() 메서드를 호출합니다.

syncSession->pause();

동기화 세션을 재개하려면 동기화 세션의 resume() 메서드를 호출합니다.

syncSession->resume();

변경 사항이 업로드 및 다운로드될 때까지 기다립니다.

sync_session 의 wait_for_upload_completion() 및 wait_for_download_completion() 메서드를 사용하여 변경 사항이 Atlas에 업로드되거나 Atlas 에서 다운로드 될 때까지 기다릴 수 있습니다. 이 두 메서드 모두 업로드 또는 다운로드 가 완료되면 선택적으로 콜백 을 받아 실행할 수 있습니다.

모든 변경 사항이 동기화된 영역에서 Atlas로 업로드될 때까지 기다리려면 wait_for_upload_completion() 멤버 함수를 사용합니다.

syncSession->wait_for_upload_completion().get();

모든 변경 사항이 Atlas에서 동기화된 영역으로 다운로드될 때까지 기다리려면 wait_for_download_completion() 멤버 함수를 사용합니다. 변경 사항을 다운로드한 후 영역을 새로 고쳐 가장 최근 데이터가 반영되는지 확인합니다.

syncSession->wait_for_download_completion().get();
realm.refresh();

동기화 상태 확인

sync_session 의 공개 멤버 함수 state() 를 사용하여 동기화 세션이 활성 상태인지 확인할 수 있습니다. 가능한 Device Sync 상태를 반영하는 값의 열거형을 반환합니다.

syncSession->state();

동기화 연결 상태는 connection_state() 메서드로 확인할 수 있는 네트워크 연결 상태와 다릅니다. 네트워크 연결 상태에 대한 자세한 내용은 이 페이지의 네트워크 연결 확인 문서를 참조하세요.

모든 동기화 세션에 수동으로 다시 연결

Realm은 장치가 오프라인 상태였다가 다시 연결되면 자동으로 감지하고 증분 백오프 전략을 사용하여 다시 연결을 시도합니다.

증분 백오프 기간 trigger 동안 기다리는 대신 동기화 세션의 reconnect() 메서드를 사용하여 재연결 시도를 수동으로 하도록 선택할 수 있습니다. 이는 네트워크 상태를 더 정확하게 이해하고 있고 Realm의 자동 재연결 감지에 의존하고 싶지 않은 경우에 유용합니다.

syncSession->reconnect();

이 메서드를 호출하면 SDK는 모든 동기화 세션이 즉시 재연결을 시도 하도록 강제합니다. 이렇게 하면 증분 백오프에 사용되는 모든 타이머가 재설정됩니다.

이 메서드를 호출한다고 해서 기기의 재연결이 보장되는 것은 아닙니다. SDK에 치명적인 오류가 발생하거나 장치가 이미 연결되었거나 연결을 시도하는 경우 이 메서드를 호출해도 아무런 효과가 없습니다.