[Java] World Time API로 세계시간 알아오기

 세계 각지에 있는 창고를 관리하는 자사 시스템 특성 상 TIME-ZONE과 관련된 이슈를 무시할 수는 없었다. 현재는 국내 창고에서만 사용하고 있었지만 해외 창고 셋업 일정을 내년으로 계획하고 있는 만큼 TIME-ZONE 이슈는 필수 해결과제라고 생각했다.

개발 방식 고려

 

 TIME-ZONE을 관리하는 방법에는 여러가지 방법이 있겠지만, 내부 개발자 회의를 통해 나온 방식은 두 가지였다. 하나는 세계 각지의 시간을 담아서 관리하는 테이블을 만들어 사용자가 입력한 나라에 코드에 맞게 시차를 게산해주는 방식이었고, 다른 하나는 따로 시간을 담아두지 않고 사용자가 개인정보에서 나라를 변경할 때 실시간적인 API통신을 통해 해당 도시의 시간을 받아오자는 것이었다.

전자의 방식 : TIME-ZONE은 불변의 데이터이기 때문에 최초 한번만 받아서 테이블에 등록해두면 그 이후로 굳이 리소스를 잡아먹을 일이 없다.
후자의 방식 : 별도의 테이블 없이 관리할 수 있어 관리 포인트가 늘어나지 않고, 개발 난이도 자체도 더 낮다.

 

 둘 다 일리가 있고 가능성 있는 의견이었지만, 내 생각엔 후자가 당장 테스트하기엔 더 적합하다고 생각하여 후자의 방식을 어필했고, 먼저 테스트해보기로 했다. 당장 테스트 하기에도 전자보단 후자가 공수가 훨씬 덜 들었기 때문도 있다.

 

World Time API

 

World Time API: Simple JSON/plain-text API to obtain the current time in, and related data about, a timezone.

 

 간단하게 구글링을 해보니 World Time API라는 Open API가 있었고, 해당 API주소에 명시되어있는 대륙/도시 명을 붙여서 호출하면 해당 지역의 현재 날짜와 시간, 그라니치 표준시(GMT)와의 시차를 json객체로 return해준다.

 프론트 쪽에서 콤보박스 형식으로 사용자에게 도시/대륙 정보를 선택하게 유도했고, 그 값을 통해 Service에서 가변적으로 API를 호출할 수 있도록 구상했다.

combo_nm = Seoul / combo_cd = Asia 같은 형식

function getUserCountryTime() {
    // 사용자가 선택한 comboboxData 추출
    let cboIdx = $NC.getComboSelectedIndex("#cboUser_Country");
    let cboData = $NC.getComboData("#cboUser_Country")[cboIdx];
    // comboboxData의 코드 값과 이름을 합쳐 url에 붙일 country_code 생성
    let userCountry = cboData.COMMON_NM + "/" + cboData.COMMON_CD;
    // callback으로 전달받을 변수 선언
    let utcOffset = '';
    
    // API 송신을 위해 Controller의 callGetUserCountryTime 메소드 호출
    $NC.serviceCall("/CSC01010E0/callGetUserCountryTime.do", {
        P_QUERY_PARAMS: $NC.getParams({
            P_COUNTRY_INFO: userCountry
        })
    }, function(data) {
      // JSON형식으로 받아온 데이터를 실제 JSON으로 파싱해주고 원하는 값 추출
      utcOffset = JSON.parse(data.data).RESULT_DATA.O_UTC_OFFSET
      // 사용자 화면에 세팅
      $NC.setValue("#edtRemark1",utcOffset);
    });
}

 

@Service
public class WorldTimeAPIService {

    public Map<String, Object> getWorldTime(final Map<String, Object> params) throws Exception {

        Map<String, Object> resultMap = new HashMap<String, Object>();        

        final String COUNTRY_KEY = (String)params.get("P_COUNTRY_INFO");
        final String URLPATH = "http://worldtimeapi.org/api/timezone/"+COUNTRY_KEY;
        
        try {
            
            URL url = new URL(URLPATH);
            HttpURLConnection conn = (HttpURLConnection)url.openConnection();

            conn.setRequestMethod("GET"); // http 메서드
            conn.setRequestProperty("Content-Type", "application/json"); // header Content-Type 정보

            // 서버로부터 데이터 읽어오기
            BufferedReader br = new BufferedReader(new InputStreamReader(conn.getInputStream()));
            StringBuilder sb = new StringBuilder();
            String line = null;

            while ((line = br.readLine()) != null) { // 읽을 수 있을 때 까지 반복
                sb.append(line);
            }
           
            br.close();
            conn.disconnect();

            JSONObject jo = new JSONObject(sb.toString());
            resultMap.put("O_UTC_OFFSET", jo.get("utc_offset"));
            resultMap.put("O_MSG", Consts.OK);
        } catch (Exception e) {
            e.printStackTrace();
        }
        
        return resultMap;
   
    }
}

 

 이번 테스트에서는 SYSDATE에 시차로 계산하는 방식을 테스트하기 위해 GMT 시차만 가져왔지만, 그 외에도 유의미한 많은 데이터를 사용할 수 있다.

실제로 받는 데이터