Java Map을 JSON으로 변환하는 방법
Java Map 출력과 JSON은 비슷해 보여도 서로 다른 형식입니다. 콘솔에 출력한 Map은 다음과 같을 수 있습니다.
{name=kim, age=30, active=true}이에 대응하는 JSON은 키를 따옴표로 감싸고 콜론을 사용합니다.
{
"name": "kim",
"age": 30,
"active": true
}먼저 가지고 있는 데이터가 무엇인지 확인하세요. 실제 Java Map 객체가 남아 있다면 Jackson이나 Gson으로 직렬화합니다. 로그나 콘솔에서 복사한 Map.toString() 출력만 있다면 텍스트를 해석한 뒤 JSON 객체를 만들어야 합니다. 두 작업은 서로 다릅니다.
Java Map과 JSON의 차이
Java Map은 키와 값을 담는 객체이며 toString() 출력은 그 객체의 텍스트 표현입니다. JSON은 객체, 배열, 문자열, 숫자, 불리언과 null의 문법이 정의된 데이터 교환 형식입니다.
Map.toString() 출력
{name=kim, age=30}JSON
{
"name": "kim",
"age": 30
}Map 출력은 보통 등호를, JSON은 콜론을 사용합니다. JSON 객체의 키와 문자열 값에는 큰따옴표가 필요합니다. = 를 : 로 단순 치환해도 키에는 따옴표가 붙지 않고 이스케이프와 값의 타입도 처리하지 못하므로 안전한 변환 방법이 아닙니다.
Jackson으로 Java Map을 JSON으로 변환하기
Map 객체를 ObjectMapper에 전달하세요. 다음 예제는 Jackson 2.x를 대상으로 하며 Java 프로젝트에 com.fasterxml.jackson.core:jackson-databind 의존성이 필요합니다.
import com.fasterxml.jackson.core.JsonProcessingException;
import com.fasterxml.jackson.databind.ObjectMapper;
import java.util.LinkedHashMap;
import java.util.Map;
public class MapToJson {
public static void main(String[] args) throws JsonProcessingException {
Map<String, Object> map = new LinkedHashMap<>();
map.put("name", "kim");
map.put("age", 30);
map.put("active", true);
ObjectMapper mapper = new ObjectMapper();
String json = mapper.writeValueAsString(map);
System.out.println(json);
}
}출력
{"name":"kim","age":30,"active":true}들여쓰기를 적용하려면 직렬화 구문을 다음과 같이 바꾸세요.
String json = mapper.writerWithDefaultPrettyPrinter()
.writeValueAsString(map);예제는 검사 예외를 선언합니다. 애플리케이션 코드에서는 직렬화 실패를 처리할 위치에서 예외를 잡을 수 있습니다. 메서드에 관한 내용은 ObjectMapper API 문서를 참고하세요.
Spring Boot 프로젝트는 이미 Jackson을 사용하는 경우가 많지만 실제 의존성과 메이저 버전을 확인하세요. 모든 프로젝트에 포함된다고 가정하면 안 됩니다. Spring Boot 4는 기본적으로 Jackson 3을 사용하며, import가 이 Jackson 2 예제와 다릅니다. 해당 버전의 Spring Boot JSON 문서를 참고하세요.
Gson으로 Java Map을 JSON으로 변환하기
원본 객체가 있다면 Gson도 사용할 수 있습니다. com.google.code.gson:gson 의존성이 필요합니다. 앞 예제의 Map 구성은 유지하고 import com.google.gson.Gson;를 추가한 뒤 Jackson 직렬화 구문을 다음과 같이 바꾸세요.
Gson gson = new Gson();
String json = gson.toJson(map);
System.out.println(json);보기 좋게 출력하려면 com.google.gson.GsonBuilder도 import하고 다음 코드를 사용하세요.
Gson gson = new GsonBuilder()
.setPrettyPrinting()
.create();
String json = gson.toJson(map);
System.out.println(json);예제를 전부 Gson으로 바꾼다면 Jackson import와 예외 선언을 제거하세요. 두 방식 모두 Map에서 JSON을 생성하며, pretty printing은 표시 형식만 바꿉니다. Gson은 보통 null 객체 필드를 생략하므로 필요하면 빌더에 serializeNulls()을 설정하세요. 직렬화 옵션은 Gson 사용 가이드를 참고하세요.
중첩된 Map과 List
지원되는 일반 값을 담은 문자열 키 Map에서는 중첩 Map이 JSON 객체로, List가 JSON 배열로 변환됩니다. Jackson 예제의 Map 구성 부분을 다음 코드로 바꾸고 import java.util.Arrays;를 추가하세요. Arrays.asList()는 Java 8에서도 동작합니다.
Map<String, Object> address = new LinkedHashMap<>();
address.put("city", "Seoul");
address.put("zip", "12345");
Map<String, Object> map = new LinkedHashMap<>();
map.put("name", "kim");
map.put("address", address);
map.put("skills", Arrays.asList("Java", "Spring"));Jackson이나 Gson으로 이 구조를 직렬화할 수 있습니다. 들여쓰기를 적용하면 다음과 같은 JSON이 됩니다.
{
"name": "kim",
"address": {
"city": "Seoul",
"zip": "12345"
},
"skills": [
"Java",
"Spring"
]
}우편번호는 Java 값이 String이므로 문자열로 유지됩니다. 직렬화기는 출력된 텍스트에서 타입을 추측하지 않고 객체의 값을 바탕으로 동작합니다.
Map.toString() 출력만 있다면?
로그에 다음 텍스트만 남아 있을 수 있습니다.
{name=kim, age=30, active=true, address={city=Seoul}}이것은 Map 객체가 아닌 String입니다. 직렬화기에 전달해도 엔트리가 파싱되지 않습니다. 위의 ObjectMapper를 예로 들면 다음과 같습니다.
String text = "{name=kim, age=30}";
System.out.println(mapper.writeValueAsString(text));결과는 바깥쪽 따옴표를 포함한 하나의 JSON 문자열입니다.
"{name=kim, age=30}"name과 age 속성을 가진 JSON 객체가 되는 것은 아닙니다. 원본 Map이 없고 텍스트가 지원되는 Map 문법을 따른다면 Java Map to JSON Converter로 구조를 복원할 수 있습니다.
Map.toString() 출력 온라인 변환
Java Map to JSON Converter를 열고 입력란에 텍스트를 붙여넣은 뒤 공백 2칸 또는 4칸을 선택하고 변환을 누르세요. 입력을 업로드하지 않고 브라우저에서 처리합니다.
변환기는 중첩 Map, 중첩 List, List 안의 Map, Map 안의 List를 지원합니다. 큰따옴표 값은 항상 문자열로 유지합니다. 따옴표가 없는 소문자 true, false, null은 해당 JSON 값이 됩니다. 지원되는 정수와 소수는 숫자로, 나머지 스칼라 값은 문자열로 변환합니다.
입력
{name=kim, age=30, active=true, skills=[Java, Spring]}출력
{
"name": "kim",
"age": 30,
"active": true,
"skills": [
"Java",
"Spring"
]
}타입 처리 시 주의할 점
Map.toString()에서는 타입 정보가 사라질 수 있습니다. "true"를 담은 Java String과 불리언 true은 모두 Map 출력에서 active=true로 보일 수 있습니다. 온라인 변환기는 이 텍스트를 불리언으로 추론하지만, 원래 Java 타입이 무엇인지는 알 수 없습니다.
원본 Map 객체가 있다면 Jackson이나 Gson을 우선 사용하세요. 로그 문자열에서 복원하는 방법은 원본이 없을 때 유용하지만, 추론된 타입이 원래 타입과 같다고 보장할 수는 없습니다.
흔히 하는 실수
등호(=)를 콜론(:)으로 치환하기
일괄 치환만으로는 키와 문자열에 따옴표나 이스케이프를 적용하거나, 중첩 구조를 파싱하거나, 텍스트를 숫자·불리언과 구분할 수 없습니다. 값 안의 등호까지 바뀔 수도 있습니다. JSON으로 변환하려면 구조와 값을 이해해야 합니다.
Map.toString()을 JSON.parse에 직접 전달하기
JavaScript의 JSON.parse()는 유효한 JSON을 기대합니다. {name=kim, age=30} 같은 텍스트는 키에 따옴표가 없고 등호를 사용하므로 파싱 시 문법 오류가 발생합니다.
Map 객체 대신 Map 문자열 직렬화하기
JSON 객체가 필요하면 ObjectMapper에 map.toString()이 아닌 map을 전달하세요. String 인수는 내용이 키·값 쌍처럼 보여도 JSON 문자열로 변환됩니다.
어떤 접근 방법을 선택할까요?
| 상황 | 권장 방법 |
|---|---|
| 실제 Java Map 객체가 있는 경우 | Jackson 또는 Gson |
| 이미 Spring/Jackson을 사용하는 경우 | 설정된 ObjectMapper |
| 이미 Gson을 사용하는 경우 | Gson.toJson() |
| Map.toString() 출력만 있는 경우 | 지원되는 텍스트에는 Java Map to JSON Converter 사용 |
| 읽기 쉬운 Map 문법만 필요한 경우 | Java Map Pretty Formatter |
온라인 변환기의 현재 제한 사항
- 큰따옴표로 감싼 스칼라 값은 쉼표와 구조 문자를 포함할 수 있습니다. 이스케이프된 큰따옴표와 역슬래시만 해석하고, 다른 이스케이프 시퀀스는 그대로 유지합니다.
- 전체 Java 이스케이프 문법, 작은따옴표 값, 따옴표로 감싼 키는 지원하지 않습니다.
User(name=kim)같은 DTO toString 형식은 지원하지 않습니다.- 중복된 Map 키는 마지막 JSON 값을 유지합니다.
- 숫자는 JavaScript 정밀도 제한을 따르므로 매우 큰 정수는 정밀도를 잃을 수 있습니다.
- 큰따옴표 값은 항상 JSON 문자열이 됩니다. 따옴표가 없는 정수와 소수는 선택적으로 음수 부호를 포함할 수 있으며, 불필요한 선행 0이 없고 유한한 JavaScript 숫자가 되는 경우에만 숫자로 추론합니다.
00123,1e3,+10와 대문자TRUE,NULL는 문자열로 유지합니다.