인터페이스 SubscriptionSet

이 페이지의 내용

io.realm.mongodb.sync
중첩된 클래스 요약
메서드 요약
상속된 메서드
메서드 세부 정보
찾기
getErrorMessage
getState
size
update
updateAsync
waitForSynchronization
waitForSynchronizationAsync

Atlas Device SDK는 더 이상 사용되지 않습니다. 자세한 내용은 지원 중단 페이지 를 참조하세요.

io.realm.mongodb.sync

구현된 인터페이스:

java.lang.Iterable

구독 설정하다 는 Flexible 동기화 를 위해 구성된 특정 Realm 에 대한 모든 현재 구독 에 대한 변경할 수 없는 보기입니다.

Flexible Sync는 RealmQuery 를 사용하여 장치와 동기화되는 데이터를 정의하는 방법입니다. 쿼리 와 쿼리의 메타데이터 는 구독 으로 표시됩니다.

따라서 구독 세트는 장치에서 사용할 수 있고 서버와 동기화되는 모든 데이터를 정의합니다. 유효하지 않은 쿼리를 포함하는 등 구독 세트에 오류가 발생하면 전체 구독 세트가 SubscriptionSet.State.ERROR 상태가 되며 오류가 수정될 때까지 동기화가 발생하지 않습니다.

구독이 제거되면 해당 데이터도 제거되지만 장치에서만 제거됩니다. 서버에서 삭제되지 않습니다.

오프라인 상태에서도 구독 설정하다 를 수정할 수 있지만 getState() 가 SubscriptionSet.State.COMPLETE 를 반환하기 전에 서버 에서 수정을 수락하지 않습니다.

waitForSynchronization() 및 그 변형을 사용하여 구독 설정하다 를 서버 와 동기화하도록 강제할 수 있습니다.

중첩된 클래스 요약

수정자 및 유형	클래스 및 설명
`public static final`	SubscriptionSet.State
`public static interface`	SubscriptionSet.UpdateCallback
`public static interface`	SubscriptionSet.UpdateAsyncCallback
`public static interface`	SubscriptionSet.StateChangeCallback

메서드 요약

수정자 및 유형	메서드 및 설명
public 서브스크립션	find ( String name ) 지정된 이름의 구독을 찾습니다.
public 서브스크립션	find ( io.realm.RealmQuery query ) 지정된 쿼리가 포함된 첫 번째 구독을 찾습니다.
public 문자열	getErrorMessage () getState()가 State.ERROR를 반환하면 이 메서드는 이유를 반환합니다.
public SubscriptionSet.State	getState () SubscriptionSet의 현재 상태를 반환합니다.
public int	size () 현재 이 구독 세트에 있는 구독 수를 반환합니다.
공개 SubscriptionSet	update ( SubscriptionSet.UpdateCallback action ) 구독 세트를 수정합니다.
public RealmAsyncTask	updateAsync ( SubscriptionSet.UpdateAsyncCallback callback ) 구독 세트를 비동기적으로 수정합니다.
공개 부울	waitForSynchronization ( Long timeOut, TimeUnit unit ) 구독 세트가 서버와 동기화될 때까지 기다립니다.
공개 부울	waitForSynchronization () 구독 세트가 서버와 동기화될 때까지 기다립니다.
public RealmAsyncTask	waitForSynchronizationAsync ( Long timeOut, TimeUnit unit, SubscriptionSet.StateChangeCallback callback ) 구독 세트가 서버와 동기화될 때까지 비동기적으로 기다립니다.
public RealmAsyncTask	waitForSynchronizationAsync ( SubscriptionSet.StateChangeCallback callback ) 구독 세트가 서버와 동기화될 때까지 비동기적으로 기다립니다.

상속된 메서드

메서드 세부 정보

찾기

public Subscription find ( String name )
지정된 이름의 구독을 찾습니다. 매개변수 `name` - 검색 할 구독 의 이름입니다. 반환 일치하는 구독 또는 해당 이름의 구독을 찾을 수 없는 경우 `null` 입니다.

public Subscription find ( io.realm.RealmQuery query )
지정된 쿼리가 포함된 첫 번째 구독을 찾습니다. 여러 개의 명명된 구독에 동일한 쿼리가 포함될 수 있습니다. 매개변수 `query` - 검색 할 쿼리 입니다. 반환 쿼리 가 포함된 첫 번째 구독 이거나 일치하는 항목이 없는 경우 `null` 입니다.

getErrorMessage

public String getErrorMessage ()
getState()가 State.ERROR를 반환하면 이 메서드는 이유를 반환합니다. 이에 따라 구독 수정한 다음 waitForSynchronization()을 호출하여 오류를 수정할 수 있습니다. 반환 구독 설정하다 가 State.ERROR 상태 인 경우 기본 오류입니다. 다른 모든 상태의 경우 `null` 가 반환됩니다.

getState

public SubscriptionSet.State getState ()
SubscriptionSet의 현재 상태 를 반환합니다. 각 상태 에 대한 자세한 내용은 SubscriptionSet.State 를 참조하세요. 반환 SubscriptionSet의 현재 상태입니다.

size

public int size ()
현재 이 구독 세트에 있는 구독 수를 반환합니다. 반환 구독 세트의 구독 수입니다.

update

public SubscriptionSet update (

SubscriptionSet.UpdateCallback action

)

구독 세트를 수정합니다. 업데이트 중에 예외가 발생하면 변경 사항이 적용되지 않습니다. 업데이트가 성공하면 이 구독 세트가 수정된 상태로 업데이트됩니다.

매개변수

action - 구독 설정하다 를 수정하는 차단 입니다. 호출자 스레드에서 실행 됩니다.

반환

이제 업데이트된 이 구독 세트입니다.

스로우

예외 - 업데이트 중에 발생한 예외는 다시 전파됩니다.

updateAsync

public RealmAsyncTask updateAsync ( SubscriptionSet.UpdateAsyncCallback callback )
구독 세트를 비동기적으로 수정합니다. 업데이트 중에 예외가 발생하면 변경 사항이 적용되지 않습니다. * 매개변수 `callback` - 비동기 요청을 제어하는 콜백 입니다. 성공 또는 실패가 여기에 보고됩니다. 반환 비동기 실행을 제어하는 작업.

waitForSynchronization

public boolean waitForSynchronization (

Long timeOut,

TimeUnit unit

)

구독 설정하다 서버 와 동기화될 때까지 기다립니다. 서버 가 쿼리 설정하다 를 수락하고 쿼리에 대한 데이터를 다운로드했거나 오류가 발생한 경우 반환됩니다. 다운로드한 데이터를 보려면 Realm.refresh()를 수동으로 호출하거나 변경 리스너가 트리거하다 때까지 기다려야 합니다. 오류가 발생한 경우 getErrorMessage()를 통해 기본 이유를 찾을 수 있습니다.

매개변수

timeOut - 동기화가 성공하거나 실패할 때까지 기다리는 시간입니다.
unit - 시간 제한에 사용되는 시간 단위입니다.

반환

서버에서 현재 구독을 모두 수락하고 데이터를 다운로드한 경우 true , 오류가 발생한 경우 false 를 반환합니다.

스로우

RuntimeException - 시간 초과가 초과된 경우.

public boolean waitForSynchronization ()

반환

서버에서 현재 구독을 모두 수락하고 데이터를 다운로드한 경우 true , 오류가 발생한 경우 false 를 반환합니다.

waitForSynchronizationAsync

public RealmAsyncTask waitForSynchronizationAsync (

Long  timeOut,
TimeUnit  unit,
SubscriptionSet.StateChangeCallback  callback

)

구독 설정하다 서버 와 동기화될 때까지 비동기적으로 기다립니다. 콜백 서버 가 쿼리 설정하다 를 수락하고 쿼리에 대한 데이터를 다운로드했거나 오류가 발생한 경우 호출됩니다. 다운로드한 데이터를 보려면 Realm.refresh()를 수동으로 호출하거나 변경 리스너가 트리거하다 때까지 기다려야 합니다. 오류가 발생한 경우 getErrorMessage()를 통해 기본 이유를 찾을 수 있습니다.

매개변수

timeOut - 동기화가 성공하거나 실패할 때까지 기다리는 시간입니다.
unit - 시간 제한에 사용되는 시간 단위입니다.
callback - 동기화가 성공하거나 실패할 때 trigger 하는 콜백 입니다. 결과는 UI 스레드에서 보고됩니다.

반환

서버에서 현재 구독을 모두 수락하고 데이터를 다운로드한 경우 true , 오류가 발생한 경우 false 를 반환합니다.

public RealmAsyncTask waitForSynchronizationAsync (

SubscriptionSet.StateChangeCallback callback

)

구독 설정하다 서버 와 동기화될 때까지 비동기적으로 기다립니다. 서버 쿼리 설정하다 를 수락하고 쿼리에 대한 데이터를 다운로드했거나 오류가 발생한 경우 콜백 호출합니다. 다운로드한 데이터를 보려면 Realm.refresh()를 수동으로 호출하거나 변경 리스너가 트리거하다 때까지 기다려야 합니다. 오류가 발생한 경우 getErrorMessage()를 통해 기본 이유를 찾을 수 있습니다.

매개변수

callback - 동기화가 성공하거나 실패할 때 trigger 하는 콜백 입니다. 결과는 UI 스레드에서 보고됩니다.

반환

서버에서 현재 구독을 모두 수락하고 데이터를 다운로드한 경우 true , 오류가 발생한 경우 false 를 반환합니다.

돌아가기

서브스크립션

SubscriptionSet.State