시간과 타이머¶
아이펀 엔진은 내부적으로 monotonic clock 을 사용하며, 개발자의 편의를 위해 참고용으로 wall clock 역시 제공합니다. 그리고 주기적으로 event 를 발생시킬 수 있는 timer 역시 제공합니다. 각각에 대한 설명은 다음과 같습니다.
Monotonic clock¶
Wall clock 은 현실 세계와 시간 단위가 똑같다는 장점이 있지만, 서버의 시간을 동기화할 때 시간 값이 튈 수 있다는 단점이 있습니다. 이때 서버 내부에서 특정 시간에 처리되어야 하는 일이 실행되지 않거나, 두 번 실행되는 일이 발생할 수 있습니다. 이 때문에 아이펀 엔진은 모든 시간 단위를 Monotonic clock 을 이용하며 게임 서버 개발자 역시 monotonic clock 을 사용할 것을 권장합니다.
Monotonic clock 은 이름에서 알 수 있듯이 시간 값이 단조 증가하는 시간입니다. 즉 서버의 시간을 동기화 해서 1초가 뒤로 돌아가더라도 안정적으로 증가하는 시간 값을 반환합니다. monotonic clock 은 최신 OS 들에서는 모두 제공하는 기능이며, 아이펀 엔진의 monotomic clock 은 system 에서 제공하는 monotonic clock 을 이용합니다. 아이펀 엔진의 Monotonic clock 는 마이크로세컨드까지의 정밀도를 제공합니다.
Monotonic clock 활용법¶
#include <funapi.h>
void test_function(MonotonicClock::Value old) {
// 현재 시간은 다음처럼 얻습니다.
MonotonicClock::Value t = MonotonicClock::Now();
// 시간 비교는 일반 integer 와 같습니다.
if (old < t) {
// old 는 t 보다는 작네요.
}
// struct timespec 으로의 변경은 다음처럼 합니다.
struc timesepc ts;
MonotonicClock::ToTimespec(t, &ts);
}
using funapi;
void TestFunction(Int64 old)
{
// 현재 시간은 다음처럼 얻습니다.
Int64 t = MonotonicClock.Now;
// 시간 비교는 일반 integer 와 같습니다.
if (old < t) {
// old 는 t 보다는 작네요.
}
}
Wall clock¶
Monotonic clock 은 서버 시간을 보정하는 상황에서도 안정적으로 쓸 수 있다는 장점이 있지만, 사람이 읽을 수 있는 형태가 아니기 때문에 디버깅할 때 곤란합니다. 이 때문에 아이펀 엔진은 Wall clock 도 제공합니다.
아이펀 엔진에서의 Wall clock 은 게임 서버가 뜨는 순간의 현실 시계와 Monotonic clock 값의 차이를 기억했다가 이후에 Wall clock 이 필요한 경우 해당 차이를 반영한 값을 반영하는 것입니다. 이 때문에 아이펀 엔진의 Wall clock 역시 단조 증가합니다.
그 때문에 OS 시간이 보정될 때 아이펀 엔진의 Wall clock 값과 OS의 시간 값이 다를 수 있습니다. 그 때문에 아이펀 엔진에서는 Wall clock 을 참고용으로 쓰시는 것을 권장합니다.
Wall clock 활용법¶
#include <funapi.h>
void test_function(WallClock::Value old) {
// 현재 시간은 다음처럼 얻습니다.
WallClock::Value t = WallClock::Now();
// 시간 비교는 일반 integer 와 같습니다.
if (old < t) {
// old 는 t 보다는 작네요.
}
// 로그로 쉽게 출력할 수 있습니다.
LOG(INFO) << t;
// Monotonic clock 값으로 변환할 수도 있습니다.
MonotonicClock::Value m = WallClock::ToMonotonicClock(t);
}
using funapi;
public void TestFunction(System.DateTime old)
{
// 현재 시간은 다음처럼 얻습니다.
System.DateTime dt = WallClock.Now;
// 시간 비교는 일반 DateTime 과 같습니다.
if (old < t) {
// old 는 t 보다는 작네요.
}
// Monotonic clock 값으로 변환할 수도 있습니다.
Int64 m = WallClock.ToMonotonicClock (dt);
}
Note
WallClock 의 Now 는 UTC 값을 리턴합니다.
Timestamp 로의 전환¶
아래처럼 Wall clock 을 정수값의 timestamp 로 변환할 수 있습니다.
// 현재 시간에 대한 timestamp 를 얻거나
int64_t ts = WallClock::GetTimestampInSec();
// WallClock::Value 값을 timestamp 로 변환할 수 있습니다.
WallClock::Value t = WallClock::Now();
ts = WallClock::GetTimestampInSec(t);
// 반대로 timestamp 값을 WallClock::Value 로도 변환할 수 있습니다.
t = WallClock::FromTimestampInSec(ts);
// 밀리초 단위로도 가능합니다.
ts = WallClock::GetTimestampInMsec();
ts = WallClock::GetTimestampInMsec(t);
t = WallClock::FromTimestampInMsec(ts);
// 현재 시간에 대한 timestamp 를 얻거나
Int64 ts = WallClock.GetTimestampInSec ();
// System.DateTime 값을 timestamp 로 변환할 수 있습니다.
System.DateTime dateTime = WallClock.Now;
ts = WallClock.GetTimestampInSec (dateTime);
// 반대로 timestamp 값을 System.DateTime 로도 변환할 수 있습니다.
dateTime = WallClock.FromTimestampInSec (ts);
// 밀리초 단위로도 가능합니다.
ts = WallClock.GetTimestampInMsec ();
ts = WallClock.GetTimestampInMsec (dateTime);
dateTime = WallClock.FromTimestampInMsec (ts);
시간의 문자열 표현¶
아래처럼 Wall clock 을 문자열 형태로 변환할 수 있습니다.
Note
시간에 대한 문자열 표현은 ISO-extended 형식으로 표현됩니다. 예) 2016-09-21T03:30:16.787663
// 현재 시간에 대한 문자열을 얻거나
string ts = WallClock::GetTimestring();
// WallClock::Value 값을 문자열로 변환할 수 있습니다.
WallClock::Value t = WallClock::Now();
ts = WallClock::GetTimestring(t);
// 반대로 문자열을 WallClock::Value 로도 변환할 수 있습니다.
if (not WallClock::FromTimestring(ts, &t)) {
// ts 가 올바른 iso-extended time string 이 아니면 실패합니다.
}
// 현재 시간에 대한 문자열을 얻거나
string timestr = WallClock.GetTimestring ();
// System.DateTime 값을 문자열로 변환할 수 있습니다.
System.DateTime t = WallClock.Now;
timestr = t.ToTimestring ();
Log.Info (timestr);
// 반대로 문자열을 System.DateTime 로도 변환할 수 있습니다.
if (!WallClock.FromTimestring (timestr, out t)) {
// timestr 가 올바른 iso-extended time string 이 아니면 실패합니다.
}
시스템 설정의 지역을 반영해서 시간 문자열을 얻을 수도 있습니다.
// 현재 시간에 대한 로컬 시간 문자열을 얻거나
string ts = WallClock::GetLocalTimestring();
// WallClock::Value 값을 로컬 시간 문자열로 변환할 수 있습니다.
WallClock::Value t = WallClock::Now();
ts = WallClock::GetLocalTimestring(t);
// 현재 시간에 대한 로컬 시간 문자열을 얻거나
string timestr = WallClock.GetLocalTimestring ();
// System.DateTime 값을 로컬 시간 문자열로 변환할 수 있습니다.
System.DateTime t = WallClock.Now;
timestr = t.ToLocalTimestring ();
타이머¶
게임 서버들은 대개 주기적으로 처리하는 일들이 있고, 이를 위해 ‘Tick’ 이라고 불리는 반복되는 timer 가 필요합니다. 아이펀 엔진은 반복되는 타이머와 일회성 타이머를 지원합니다. 아이펀 엔진 타이머는 타이머가 expire 될 때 호출될 핸들러를 등록하는 방식으로 사용합니다. 아래는 그 예제입니다.
타이머 활용법¶
#include <funapi.h>
extern void handler1(Timer::Id tid, const WallClock::Value &at);
extern void handler2(Timer::Id tid, const WallClock::Value &at);
extern void handler3(Timer::Id tid, const WallClock::Value &at);
void test_function() {
// 특정 시간에 expire 되게 하려면 ExpireAt 을 이용합니다.
// 아래 예는 지금으로부터 500msec 뒤에 expire 하도록 설정합니다
Timer::ExpireAt(WallClock::Now() + boost::posix_time::millisec(500), handler1);
// 상대 시간 뒤에 expire 되게 하려면 ExpireAfter 를 이용합니다.
Timer::ExpireAfter(boost::posix_time::millisec(500), handler2);
// 반복해서 expire 되는 timer 는 interval 과 핸들러를 지정합니다.
// 아래는 500msec 단위로 expire 되는 timer 입니다.
Timer::ExpireRepeatedly(boost::posix_time::millisec(500), handler3);
}
Important
Timer::ExpireAt(), Timer::ExpireAfter(), Timer::ExpireRepeatedly(), Timer::Cancel() 함수들은 의도하지 않은 중복 호출을 방지하기 위하여 오브젝트 롤백을 감지하는 기능이 내장되어 있습니다. 오브젝트 서브시스템의 기능을 이용하신다면 트랜잭션 을 참고하세요.
using funapi;
public void TestFunction()
{
// 특정 시간에 expire 되게 하려면 ExpireAt 을 이용합니다.
// 아래 예는 지금으로부터 500msec 뒤에 expire 하도록 설정합니다
Timer.ExpireAt (
WallClock.Now + WallClock.FromMsec(1500), TimerHandler1);
// delegate를 이용해 타이머를 호출 할수도 있습니다.
Timer.Handler timer_handler2 = (
/*UInt64 tid*/ tid,
/*System.DateTime*/ value) => {
Log.Info ("timer_handler_2");
};
// 반복해서 expire 되는 timer 는 interval 과 핸들러를 지정합니다.
// 아래는 500msec 단위로 expire 되는 timer 입니다.
// delegate를 이용해 호출하겠습니다.
Timer.ExpireRepeatedly (WallClock.FromSec (1), timer_handler2);
// 반복해서 expire 되는 timer 는 interval 과 핸들러를 지정합니다.
// 아래는 500msec 단위로 expire 되는 timer 입니다.
Timer.ExpireAfter (WallClock.FromMsec(500), TimerHandler3);
}
public void TimerHandler1(UInt64 tid, DateTime value)
{
Log.Info ("TimerHandler_1");
}
public void TimerHandler3(UInt64 tid, DateTime value)
{
Log.Info ("TimerHandler_3");
}
Important
Timer.ExpireAt(), Timer.ExpireAfter(), Timer.ExpireRepeatedly(), Timer::Cancel() 함수들은 의도하지 않은 중복 호출을 방지하기 위하여 오브젝트 롤백을 감지하는 기능이 내장되어 있습니다. 오브젝트 서브시스템의 기능을 이용하신다면 트랜잭션 을 참고하세요.