Java에서 json-simple 라이브러리로 JSON 문자열을 Java 객체로 변환하는 방법

JSON(JavaScript Object Notation)은 가장 널리 사용되는 데이터 교환(data-interchange) 형식 중 하나로, 가볍고(lightweight) 언어에 독립적(language independent)이라는 특징을 가지고 있습니다.

json-simple은 JSON 텍스트를 인코딩(encoding)하거나 디코딩(decoding)하는 데 사용할 수 있는 경량 JSON 처리 라이브러리입니다. 별도의 복잡한 설정 없이 간단한 API만으로 JSON 데이터를 손쉽게 다룰 수 있어 많은 Java 프로젝트에서 활용되고 있습니다.

Maven 의존성 추가

프로젝트에서 json-simple을 사용하려면 먼저 아래와 같이 Maven 의존성을 추가해야 합니다.

<dependency>
    <groupId>com.googlecode.json-simple</groupId>
    <artifactId>json-simple</artifactId>
    <version>1.1.1</version>
</dependency>

JSON 문자열을 Java 객체로 변환하기

다음 예제에서는 JSONParser 클래스의 parse() 메서드를 사용하여 JSON 문자열을 JSONObject 객체로 변환합니다. 이후 get() 메서드에 키(key)를 전달하면 해당 값(value)을 쉽게 조회할 수 있습니다.

예제

import org.json.simple.*;
import org.json.simple.parser.*;

public class ConvertJSONStringToObjectTest {
    public static void main(String[] args) {
        String jsonString = "{\"Name\":\"Raja\",\"EmployeeId\":\"115\",\"Age\":\"30\"}";
        JSONParser parser = new JSONParser();
        JSONObject obj;
        try {
            obj = (JSONObject) parser.parse(jsonString);
            System.out.println(obj.get("Name"));
            System.out.println(obj.get("EmployeeId"));
            System.out.println(obj.get("Age"));
        } catch (ParseException e) {
            e.printStackTrace();
        }
    }
}

실행 결과

Raja
115
30

코드 설명

• JSONParser.parse(): JSON 형식의 문자열을 파싱하여 JSONObject 타입의 객체로 반환합니다.
• JSONObject.get(): 지정한 키에 해당하는 값을 반환합니다. 반환 타입은 Object이므로 필요에 따라 적절한 타입으로 형 변환(casting)하여 사용할 수 있습니다.
• ParseException 처리: 전달된 문자열이 올바른 JSON 형식이 아닐 경우 발생하는 예외이므로, 반드시 try-catch 블록으로 처리해야 합니다.

이처럼 json-simple 라이브러리를 활용하면 단 몇 줄의 코드만으로도 JSON 문자열을 Java 객체로 손쉽게 변환하고 데이터를 추출할 수 있습니다.