Node.js

node.js에서는 @hackler/javascript-sdk를 이용해서 sdk를 연동할 수 있습니다.

@hackler/hackle-sdk를 사용하고 계시다면, @hackler/javascript-sdk로 마이그레이션 해야합니다.

SDK 의존성 추가

npm

npm install --save @hackler/javascript-sdk

yarn

yarn add @hackler/javascript-sdk

SDK 초기화

hackleClient는 SDK 기능을 사용하기 위한 메소드들을 제공하는 클래스입니다.

SDK 를 사용하기 위해서는 hackleClient 초기화가 필요합니다.

인스턴스화

SDK 키를 전달하여 hackleClient를 인스턴스화 합니다. hackleClient는 필요한 정보들을 얻기 위해 백그라운드 작업으로 핵클 서버와 주기적으로 동기화합니다.

• SDK 키는 핵클 서비스의 대시보드 안에 위치한 SDK 연동 정보에서 확인하실 수 있습니다.

const Hackle = require("@hackler/javascript-sdk");

// YOUR_SERVER_SDK_KEY 자리에 SDK 키를 넣습니다.
const hackleClient = Hackle.createInstance("YOUR_SERVER_SDK_KEY");

초기화 완료

SDK 초기화 시 핵클 서버로부터 필요한 정보들을 가져옵니다.

초기화는 비동기로 진행되며 onReady로 초기화 완료 콜백을 받을 수 있습니다.

SDK가 준비되기 전 사용자 요청이 들어오면 데이터가 누락될 수 있습니다.

hackleClient.onReady(() => {
  // SDK ready to use
  http.createServer((req, res) => {
  	
  }).listen(3000)
});

종료

어플리케이션이 종료될 때 close() 메소드를 호출해야 합니다. 이 과정을 통해 사용 중인 리소스를 반납하고 남아있는 이벤트를 전송합니다.

close() 호출 없이 어플리케이션이 종료되면 이벤트가 누락될 수 있습니다.

process.on('SIGINT', function() {
  // kill signal
  hackleClient.close();
});