GS2-JobQueue API 레퍼런스

잡 큐 기능을 제공하는 서비스입니다.

잡 큐는 FIFO를 보장하는 큐이며, 결과 정합 처리에 사용할 수 있습니다.
결과 정합 처리란 API가 응답한 시점에는 처리 완료가 보장되지 않고, 일정 시간이 경과한 후 “결과적으로 의도한 상태가 되는” 방식입니다.

GS2에서는 보상 지급의 많은 부분을 결과 정합으로 처리합니다.
이는 보상을 지급할 때 보상을 관리하는 서버가 다운되어 있으면, 연쇄적으로 여러 서비스를 이용할 수 없게 되는 상황을 피하기 위함입니다.
보상 지급 처리를 잡 큐에 등록해 두면, 잡을 실행할 때 대상 서버를 이용할 수 없는 상태였더라도 잡의 재시도를 통해 결과 정합을 실현합니다.
재시도 횟수에는 최댓값을 지정할 수 있으며, 최댓값에 도달해도 성공하지 못한 경우 데드레터 잡이라는 실패한 잡이 쌓이는 모델에 저장됩니다.
데드레터 잡을 사용하면 처리에 실패한 잡에 대해 개별적으로 대응할 수 있습니다.

네임스페이스의 enableAutoRun이 비활성화된 경우(기본값), 잡은 자동으로 실행되지 않으며 명시적으로 실행 API를 호출해야 합니다.
enableAutoRun이 활성화된 경우 등록된 잡은 서버에서 자동으로 실행됩니다. 다음 클라이언트 실행 방법은 수동 실행 모드에 대한 설명입니다.
이는 잡의 반환값을 클라이언트 측에서 파악할 수 있도록 하기 위한 목적입니다.
예를 들어 GS2-Quest에서 퀘스트를 클리어한 후, 잡 큐에 보상을 지급하는 잡이 등록되며,
클라이언트는 잡 큐를 끝까지 실행함으로써 퀘스트를 통해 얻은 보상 지급 처리를 명시적으로 실행할 수 있습니다.
(결과 정합의 지연 처리가 완료되기를 기다릴 수 있습니다) 또한 해당 잡의 반환값을 참조함으로써 얻은 보상을 UI에 반영할 수 있습니다.

잡의 등록·실행은 1초에 3회까지만 가능합니다.