Java Map을 보기 좋게 출력하는 방법
Java Map.toString()은 디버깅에 편리하지만 Map과 List가 중첩되면 읽기 어려워집니다. 작은 레코드도 한 줄을 가득 채울 수 있습니다.
{name=kim, age=30, address={city=seoul, zip=12345}, skills=[Java, Spring]}이 가이드에서는 기본 Map 출력, 엔트리 직접 정리, Jackson과 Gson 사용, 로그에서 복사한 Map 문자열의 포맷팅을 다룹니다. Java 객체가 남아 있는지, Map 형식의 텍스트와 JSON 중 무엇이 필요한지에 따라 적합한 방법을 선택하세요.
Java Map 출력이 읽기 어려워지는 이유
일반적인 Map 구현은 중괄호 안에 엔트리를 표시하고, 키와 값은 등호로, 엔트리 사이는 쉼표로 구분합니다. Map을 출력하면 toString() 메서드가 호출됩니다.
// map is an existing Map<String, Object>.
System.out.println(map);{name=kim, age=30}Map이 중첩되면 중괄호가, List가 들어가면 대괄호가 추가됩니다. 들여쓰기가 없으면 각 구조가 끝나는 지점을 찾기 어렵고, 컬렉션이 커질수록 한 줄 출력을 읽기 힘들어집니다.
Map.toString() 사용하기
간단히 확인할 때는 기본 출력으로 충분합니다. 다음 예제는 삽입 순서대로 표시되도록 LinkedHashMap을 사용합니다.
import java.util.LinkedHashMap;
import java.util.Map;
public class MapOutput {
public static void main(String[] args) {
Map<String, Object> map = new LinkedHashMap<>();
map.put("name", "kim");
map.put("age", 30);
System.out.println(map.toString());
// {name=kim, age=30}
}
}표준 구현에는 보기 좋게 출력하는 옵션이 없습니다. HashMap은 엔트리 순서를 보장하지 않으므로 출력 순서에 의존하지 마세요. 사용자 정의 Map 클래스는 문자열 표현을 재정의할 수도 있습니다. 표준 형식은 Java AbstractMap.toString() 문서를 참고하세요.
엔트리를 순회하며 출력하기
한 줄에 엔트리 하나씩 표시하려면 entrySet()를 순회하세요. 앞 예제의 출력문을 다음과 같이 바꿉니다.
System.out.println("{");
for (Map.Entry<String, Object> entry : map.entrySet()) {
System.out.println(" " + entry.getKey() + " = " + entry.getValue());
}
System.out.println("}");{
name = kim
age = 30
}외부 의존성이 필요 없고 구분자를 직접 선택할 수 있습니다. 다만 최상위 수준만 정리하며 중첩된 Map과 List는 각자의 문자열 표현을 그대로 사용합니다. 간단한 표시 형식이며 JSON은 아닙니다.
Jackson으로 Map을 보기 좋게 출력하기
Map 객체를 JSON으로 만들려면 Jackson으로 들여쓰기를 적용해 직렬화할 수 있습니다. 이 예제는 Jackson 2.x를 사용하며, JDK에 포함되지 않은 com.fasterxml.jackson.core:jackson-databind 의존성을 Java 프로젝트에 추가해야 합니다.
import com.fasterxml.jackson.core.JsonProcessingException;
import com.fasterxml.jackson.databind.ObjectMapper;
import java.util.Map;
public class JacksonMapOutput {
public static void printMap(Map<String, Object> map)
throws JsonProcessingException {
ObjectMapper mapper = new ObjectMapper();
String json = mapper
.writerWithDefaultPrettyPrinter()
.writeValueAsString(map);
System.out.println(json);
}
}Map으로 JacksonMapOutput.printMap(map)를 호출하고 호출하는 쪽에서 검사 예외를 처리하거나 선언하세요. 지원되는 일반 값을 담은 문자열 키 Map에서는 중첩 Map이 JSON 객체로, List가 배열로 변환됩니다. 결과는 Java Map 문법이 아닌 JSON입니다. pretty-print writer는 ObjectMapper API 문서에서 확인할 수 있습니다.
Gson으로 Map을 보기 좋게 출력하기
Gson도 GsonBuilder로 비슷한 기능을 제공합니다. 예제를 사용하기 전에 Java 프로젝트에 com.google.code.gson:gson 의존성을 추가하세요.
import com.google.gson.Gson;
import com.google.gson.GsonBuilder;
import java.util.Map;
public class GsonMapOutput {
public static void printMap(Map<String, Object> map) {
Gson gson = new GsonBuilder()
.setPrettyPrinting()
.create();
System.out.println(gson.toJson(map));
}
}원본 객체로 GsonMapOutput.printMap(map)를 호출하세요. 출력은 문자열 키와 값을 큰따옴표로 감싼 JSON입니다. Gson은 기본적으로 null 객체 필드를 생략합니다. 유지하려면 빌더에서 serializeNulls()을 사용하세요. 설정에 관한 자세한 내용은 Gson 사용 가이드를 참고하세요.
Map.toString() 출력만 있다면?
{name=kim, age=30, address={city=seoul}}처럼 로그나 콘솔에서 복사한 한 줄만 남아 있을 수 있습니다. Java 코드를 다시 실행하거나 원본 Map에 접근하지 못할 수도 있습니다. 이 텍스트를 JSON 직렬화기에 전달하면 Map 구조를 복원하는 대신 문자열 자체를 직렬화합니다.
지원되는 Map 형식의 문자열에는 Java Map Pretty Formatter를 사용하세요. 출력을 붙여넣고 공백 2칸 또는 4칸을 선택한 뒤 포맷을 누릅니다. 브라우저에서 처리하며, Map 문법을 유지하고 스칼라 값은 텍스트로 다룹니다.
정리 전
{name=kim, age=30, address={city=seoul, zip=12345}, skills=[Java, Spring]}정리 후 (공백 4칸)
{
name=kim,
age=30,
address={
city=seoul,
zip=12345
},
skills=[
Java,
Spring
]
}Java Map 출력과 JSON의 차이
Java Map 형식의 텍스트
{name=kim, active=true}JSON
{
"name": "kim",
"active": true
}Java Map.toString()은 등호를, JSON은 콜론을 사용합니다. JSON 객체의 키와 문자열 값에는 큰따옴표가 필요합니다. 따라서 Map 출력이 반드시 유효한 JSON인 것은 아니며, 등호를 콜론으로 바꾸기만 해서는 정확하게 변환할 수 없습니다.
지원되는 Map 형식의 텍스트에서 JSON이 필요하면 Java Map to JSON Converter를 사용하세요. 문서에 명시된 규칙으로 숫자, 불리언과 null을 추론합니다. 출력된 Map에서는 타입 정보가 사라질 수 있습니다. 예를 들어 문자열 "true"와 불리언 true가 똑같이 보일 수 있습니다. 이 차이를 보존해야 한다면 원본 객체를 직렬화하세요.
어떤 방법을 선택할까요?
| 상황 | 권장 방법 |
|---|---|
| 실제 Map 객체가 있는 경우 | JSON은 Jackson이나 Gson으로, 그 밖의 표시 형식은 Java 코드로 직접 구성합니다. |
| 외부 의존성 없이 간단히 출력하려는 경우 | 엔트리를 순회하며 각 줄의 형식을 직접 지정합니다. |
| Map.toString() 출력만 있는 경우 | 지원되는 문자열에는 Java Map Pretty Formatter를 사용합니다. |
| 올바른 JSON이 필요한 경우 | 객체는 Jackson이나 Gson으로, 지원되는 텍스트는 Java Map to JSON Converter로 변환합니다. |
온라인 포맷터의 제한 사항
온라인 포맷터는 List 안의 Map, Map 안의 List를 포함한 중첩 구조를 지원합니다. 모든 Java 객체를 문자열에서 복원할 수 있는 것은 아닙니다.
- 큰따옴표로 감싼 스칼라 값은 쉼표와 구조 문자를 포함할 수 있습니다. 이스케이프된 큰따옴표와 역슬래시만 해석하고, 다른 이스케이프 시퀀스는 그대로 유지합니다.
- 전체 Java 이스케이프 문법, 작은따옴표 값, 따옴표로 감싼 키는 지원하지 않습니다.
User(name=kim)같은 DTO toString 형식은 지원하지 않습니다.