onCheckUpdateValid

응답(또는 구독 데이터)이 성공적으로 도착한 뒤, 연결된 Data Set에 실제로 반영해도 될지 결정하는 시점에 호출됩니다.

파라미터

provInstName (string): Provider Instance의 이름

반환: 반환값은 사용되지 않습니다. 대신 이 함수 안에서 $vm.setCancelData(provInstName, true)를 호출하면 이어지는 Data Set 반영이 취소됩니다.

설명

일반 요청이 성공했거나 구독으로 새 데이터가 도착했을 때, Data Set에 실제로 반영하기 직전 딱 한 번 호출됩니다. 반영을 막고 싶다면 이 함수 안에서 $vm.setCancelData(provInstName, true)를 호출하면 됩니다 — 반환값이 아니라 이 API 호출이 반영 여부를 결정합니다. 일반 요청 응답 갱신(onResponseUpdateBefore)과 실시간 구독 데이터 갱신(onPushUpdateBefore) 모두에서 공통으로 호출되며, "이 값을 화면에 반영해도 되는지"를 마지막으로 확인하는 역할을 합니다.

Example

function onCheckUpdateValid(provInstName) {
  if (shouldSkipUpdate(provInstName)) {
    $vm.setCancelData(provInstName, true);
  }
}

관련 및 주의사항

일반 요청 성공 시에는 onResponseUpdateBefore/onResponseUpdateAfter 앞에, 구독 데이터 수신 시에는 onPushUpdateBefore/onPushUpdateAfter 앞에 공통으로 호출됩니다.
실패(에러) 응답 경로에서는 호출되지 않습니다 — 성공 경로 전용입니다.
$vm.setCancelData(provInstName, true)를 호출하면 이후 onResponseUpdateBefore/onPushUpdateBefore 자체가 아예 호출되지 않고 반영이 통째로 취소됩니다.

onCheckUpdateValid​

onCheckUpdateValid