본문으로 건너뛰기

onDataMessage

onDataMessage

소켓 타입 Provider Instance로 일반 요청(requestData/requestNextData)을 보냈을 때, 서버가 응답 완료 전에 보내는 중간 상태 메시지를 수신하면 호출됩니다. 요청을 종료시키지 않는 부가 알림 채널입니다.

파라미터

  • provInstName (string): 요청을 보낸 Provider Instance의 이름
  • code (string): 메시지 상태 코드
  • message (string): 메시지 내용

반환: 반환값 없음 — 콜백 함수이므로 리턴값을 사용하지 않습니다.

설명

이 이벤트는 실시간 구독(subscribeData)과는 무관합니다. 소켓 타입 Provider Instance에 requestData/requestNextData로 일반 요청을 보낸 뒤, 서버가 응답을 완전히 마치기 전에 보내는 중간 상태·알림 메시지를 수신했을 때 호출됩니다. HTTP(OpenAPI) 방식 Provider Instance에서는 호출되지 않습니다. 요청을 실패로 종료시키는 onReceiveError와 달리, 이 이벤트가 호출되어도 요청은 계속 진행 중이며 이후 onReceiveDone으로 이어집니다.

Example

function onDataMessage(provInstName, code, message) {
$log.i(provInstName + " notice " + code + ": " + message);
}

관련

  • 소켓 타입이 아닌 일반 HTTP(OpenAPI) Provider Instance에서는 호출되지 않습니다.
  • 요청을 종료시키지 않으므로, 한 번의 요청 사이클 동안 여러 번 호출될 수 있습니다.
  • 특정 앱의 거래(TR) 처리 흐름에서 유래한 이벤트이지만, 엔진 자체는 범용적이므로 다른 소켓 기반 Provider에서도 동일한 방식으로 쓸 수 있습니다.