[단축URL] 2. Java로 API 호출 모듈 작성 - 2. JSON 파싱하기 (2018-04-19 내용 추가)

탁돌이개발자

추천 수 206

이번 시간에는 저번 포스팅에서 호출하여 응답받은 JSON 결과에서 꼭 필요한 "url" 필드만 파싱하는 방법에 대해 알아보겠다.

json 파싱 라이브러리에는 다양한 것들이 있으나, 그 중에서도 제일 많이 사용되는 Jackson 을 이용하도록 하겠다.

아래의 maven dependency 값을 pom.xml 에 등록하도록 한다.

<!-- https://mvnrepository.com/artifact/com.fasterxml.jackson.core/jackson-databind -->
<dependency>
    <groupId>com.fasterxml.jackson.core</groupId>
    <artifactId>jackson-databind</artifactId>
    <version>2.9.4</version>
</dependency>

그러면 자동으로 jackson 라이브러리를 다운받아서 dependency 에 추가해준다.

이제 잠시 저번에 살펴본 응답 결과를 살펴보자

JSON은 Key: Value 형식으로 구성되어 있다.
간단히 위 응답을 분석해보면 아래와 같이 나타낼 수 있다.

우리가 원하는 url 필드는 LinkedHashMap 형태의 result 필드에 담겨 있으므로, 한번 더 파싱을 해야 하고, 그 결과는 아래와 같다.

이를 파싱하는 메서드를, 이전에 작성한 Short.java에 이어서 작성한다.

    /* 응답받은 json 중 url 필드만 가져오는 메서드 */
    private static String getUrl(String json) throws IOException {
        ObjectMapper mapper = new ObjectMapper();

        HashMap<String, Object> response =
                mapper.readValue(json, HashMap.class); // json을 HashMap으로 매핑한다.

        LinkedHashMap<String, String> result =
                (LinkedHashMap<String, String>) response.get("result");

        return result.get("url"); // url의 value인 단축된 주소만 리턴
    }

그리고 main 메서드 내부에 위에서 작성한 메서드 호출 부분을 넣어준다.

String shortenURL = getUrl(json.toString());
System.out.println(shortenURL);

이 과정들을 통해 최종적으로 완성된 코드 전문은 아래와 같다.

import java.io.BufferedReader;
import java.io.DataOutputStream;
import java.io.IOException;
import java.io.InputStreamReader;
import java.net.HttpURLConnection;
import java.net.URL;
import java.net.URLEncoder;
import java.util.HashMap;
import java.util.LinkedHashMap;

import com.fasterxml.jackson.databind.ObjectMapper;

public class Short {
    /* 단축 URL api 주소 */
    final static String API_URL = "https://openapi.naver.com/v1/util/shorturl";

    public static void main(String[] args) throws Exception {
        /* 단축시킬 URL이 매개변수로 주어지지 않으면 에러 -> 종료 */
        if(args.length != 1) {
            System.err.println("사용법: java -jar short.jar 단축시킬URL");
            System.exit(1);
        }

        String target = args[0]; // 매개변수로 넘어온 단축 대상 주소

        /* POST 요청 부분 작성 */
        HttpURLConnection conn = (HttpURLConnection) new URL(API_URL).openConnection();
        conn.setRequestProperty("X-Naver-Client-Id", "발급받은 Client ID");
        conn.setRequestProperty("X-Naver-Client-Secret", "발급받은 Client Secret");
        conn.setRequestMethod("POST"); // POST
        conn.setDoOutput(true); // POST

        /* 단축시킬 URL을 담는 부분 */
        DataOutputStream dos = new DataOutputStream(conn.getOutputStream());
        dos.writeBytes("url=" + target); // 단축시킬 주소를 UTF-8 로 변환하여 담는다
        dos.close(); // 필수

        /* 응답 코드가 200이 아니면 에러 -> 종료 */
        int responseCode = conn.getResponseCode();
        if(responseCode != 200){
            System.err.println("연결 실패: " + responseCode);
            System.exit(1);
        }

        /* json 형태의 응답값을 받는다. */
        String line;
        StringBuilder json = new StringBuilder();
        BufferedReader br = new BufferedReader(new InputStreamReader(conn.getInputStream()));
        while((line = br.readLine()) != null){
            json.append(line + System.getProperty("line.separator"));
        }
        br.close();

        /* url 부분만 뽑아내서 출력 */
        String shortenURL = getUrl(json.toString());
        System.out.println(shortenURL);
    }

    /* 변환시킬 주소를 UTF-8 형식으로 변환한다. */
    private static String toUTF8(String url){
        try {
            return URLEncoder.encode(url, "UTF-8");
        } catch (UnsupportedEncodingException e) {
            return url; // 변환 실패 시 기존 url 리턴
        }
    }

    /* 응답받은 json 중 url 필드만 가져오는 메서드 */
    private static String getUrl(String json) throws IOException {
        ObjectMapper mapper = new ObjectMapper();

        HashMap<String, Object> response =
                mapper.readValue(json, HashMap.class); // json을 HashMap으로 매핑한다.

        LinkedHashMap<String, String> result =
                (LinkedHashMap<String, String>) response.get("result");

        return result.get("url"); // url의 value인 단축된 주소만 리턴
    }
}

여기까지 하면 단축 url 부분만 추출하는 작업이 완료된 것이다.

그러나 우리는 최종적으로 이 코드들을 jar 파일로 묶어서 명령어로 사용할 것이기 때문에, runnable jar 파일로 export를 한다.

IntelliJ 기준으로 Dependencies 파일(Jackson)들과 함께 빌드하도록 하겠다.

우선 artifacts 설정을 한다.

artifact 설정

artifact 설정 시 주의사항

artifact 설정 완료

artifact 설정이 완료되었으면 빌드를 진행하도록 한다.

build artifact

빌드가 정상적으로 완료되면 out 폴더 내부에 Short.jar 파일이 생성된다.

Short.jar 생성

이후 해당 jar 파일을 커맨드라인에서 실행시킨다.

jar 파일 실행 결과

jar 파일 실행 결과 정상적으로 동작하는 것을 확인할 수 있다.

여기까지 하여 Java 를 이용한 API 호출 및 url 필드 파싱이 모두 완료되었다.
다음 시간에는 이 jar 파일을 리눅스의 명령어로 등록하여 간단하게 사용할 수 있도록 해 보겠다.

< Prev 이너넷 테스트중입니다

[단축URL] 2. Java로 API 호출 모듈 작성 - 1. API 호출하기 (2018-04-19 내용 추가) Next >

♥