Java 스니펫 39종

SI 실무에서 자주 쓰는 Java 코드 조각 모음입니다. 컬렉션·Stream·형변환(VO↔Map↔JSON)·날짜 비교·예외 처리·JUnit/Mockito 테스트·HTTP 클라이언트(JDK 11+와 JDK 8+ 레거시)·파일 처리까지, 매번 검색하게 되는 정형 코드를 완성형으로 정리했습니다.

웹 앱에서는 빈칸을 채워 완성된 코드를 바로 복사할 수 있습니다.

반복문 3종 (for · for-each · Stream) + Map 순회

반복문

List<String> items = List.of("a", "b", "c");

// 1) 기본 for (인덱스 필요할 때)
for (int i = 0; i < items.size(); i++) {
    System.out.println(i + ": " + items.get(i));
}

// 2) 향상된 for (for-each) — 값만 필요할 때
for (String item : items) {
    System.out.println(item);
}

// 3) Stream
items.forEach(System.out::println);

// Map 순회 (entrySet)
Map<String, Integer> scores = Map.of("kim", 90, "lee", 80);
for (Map.Entry<String, Integer> e : scores.entrySet()) {
    System.out.println(e.getKey() + " = " + e.getValue());
}

List<Map<String, Object>> 생성 · 데이터 넣기

컬렉션

List<Map<String, Object>> rows = new ArrayList<>();

// 한 건씩 put
Map<String, Object> row = new HashMap<>();
row.put("id", 1);
row.put("name", "홍길동");
row.put("active", true);
rows.add(row);

// 불변 맵으로 바로 추가 (Java 9+)
rows.add(Map.of("id", 2, "name", "김철수", "active", false));

// 읽기
for (Map<String, Object> r : rows) {
    System.out.println(r.get("id") + " / " + r.get("name"));
}

💡 Map.of(...)는 불변(수정·null 불가). 값을 넣었다 뺐다 하려면 new HashMap<>()을 쓴다.

List · Set · Map 초기화 (가변 vs 불변)

컬렉션

// List
List<String> list  = new ArrayList<>();             // 가변(추가·삭제 가능)
List<String> fixed = List.of("a", "b", "c");        // 불변 (Java 9+)
List<String> copy  = new ArrayList<>(List.of("a", "b")); // 불변→가변 복사

// Set (중복 제거)
Set<String> set = new HashSet<>(List.of("a", "b", "a")); // {a, b}

// Map
Map<String, Integer> map = new HashMap<>();
map.put("a", 1);
Map<String, Integer> imap = Map.of("a", 1, "b", 2);  // 불변

문자열 ↔ 숫자 형변환

형변환

// 문자열 → 숫자
int i    = Integer.parseInt("42");
long l   = Long.parseLong("42");
double d = Double.parseDouble("3.14");

// 숫자 → 문자열
String s1 = String.valueOf(42);
String s2 = Integer.toString(42);

// 실패 대비 — 숫자가 아니면 NumberFormatException
try {
    int n = Integer.parseInt(userInput);
} catch (NumberFormatException e) {
    // 기본값·오류 처리
}

💡 parseXxx는 숫자가 아니면 예외를 던진다. 사용자 입력엔 try/catch가 사실상 필수.

VO ↔ Map<String, Object> (리스트 포함)

형변환 · Jackson 2 (ObjectMapper)

import com.fasterxml.jackson.core.type.TypeReference;
import com.fasterxml.jackson.databind.ObjectMapper;

ObjectMapper mapper = new ObjectMapper();
UserVo vo = new UserVo();

// VO → Map
Map<String, Object> map = mapper.convertValue(vo, new TypeReference<Map<String, Object>>() {});

// Map → VO
UserVo back = mapper.convertValue(map, UserVo.class);

// List<VO> → List<Map>  (MyBatis·JDBC 결과와 주고받을 때)
List<UserVo> voList = List.of(vo); // Java 9+ · Java 8이면 Arrays.asList(vo)
List<Map<String, Object>> rows =
        mapper.convertValue(voList, new TypeReference<List<Map<String, Object>>>() {});

// List<Map> → List<VO>
List<UserVo> parsed = mapper.convertValue(rows, new TypeReference<List<UserVo>>() {});

💡 convertValue는 JSON 문자열을 거치지 않고 객체↔Map을 바로 바꾼다(직렬화보다 빠름). VO에 기본 생성자와 getter/setter(또는 record)가 없으면 InvalidDefinitionException.

VO ↔ JSON 문자열 (배열 → List<VO>)

형변환 · Jackson 2 (ObjectMapper)

import com.fasterxml.jackson.core.type.TypeReference;
import com.fasterxml.jackson.databind.ObjectMapper;

ObjectMapper mapper = new ObjectMapper();
UserVo vo = new UserVo();

// VO → JSON 문자열
String json = mapper.writeValueAsString(vo);

// 보기 좋게 들여쓰기해서
String pretty = mapper.writerWithDefaultPrettyPrinter().writeValueAsString(vo);

// JSON 문자열 → VO
UserVo back = mapper.readValue(json, UserVo.class);

// JSON 배열 → List<VO>  (제네릭은 TypeReference로 알려줘야 한다)
String arrayJson = "[{\"id\":1},{\"id\":2}]";
List<UserVo> list = mapper.readValue(arrayJson, new TypeReference<List<UserVo>>() {});

💡 readValue·writeValueAsString은 검사예외(JsonProcessingException)를 던진다. JSON에 VO가 모르는 필드가 하나라도 있으면 기본 설정에선 UnrecognizedPropertyException — 아래 "ObjectMapper 실무 설정" 카드 참고.

Map ↔ JSON 문자열

형변환 · Jackson 2 (ObjectMapper)

import com.fasterxml.jackson.core.type.TypeReference;
import com.fasterxml.jackson.databind.ObjectMapper;

ObjectMapper mapper = new ObjectMapper();

// Map → JSON 문자열
Map<String, Object> map = new HashMap<>();
map.put("id", 1);
map.put("name", "홍길동");
String json = mapper.writeValueAsString(map);

// JSON 문자열 → Map
Map<String, Object> back = mapper.readValue(json, new TypeReference<Map<String, Object>>() {});

// 값은 Object로 들어있어 캐스팅이 필요하다
String name = (String) back.get("name");
Integer id = (Integer) back.get("id");

💡 JSON→Map은 값이 전부 Object라 캐스팅이 필요하고, 숫자는 크기에 따라 Integer·Long·Double로 달라져 ClassCastException이 나기 쉽다. 타입이 중요하면 Map 대신 VO로 받는다.

ObjectMapper 실무 설정 (안 하면 터지는 것들)

형변환 · Jackson 2 (ObjectMapper)

import com.fasterxml.jackson.annotation.JsonInclude;
import com.fasterxml.jackson.databind.DeserializationFeature;
import com.fasterxml.jackson.databind.ObjectMapper;
import com.fasterxml.jackson.databind.PropertyNamingStrategies;
import com.fasterxml.jackson.databind.SerializationFeature;
import com.fasterxml.jackson.datatype.jsr310.JavaTimeModule;

ObjectMapper mapper = new ObjectMapper();

// 1) VO에 없는 필드가 와도 무시 — 서버가 응답 필드를 추가해도 안 터진다
mapper.configure(DeserializationFeature.FAIL_ON_UNKNOWN_PROPERTIES, false);

// 2) 값이 null인 필드는 JSON에서 아예 빼기
mapper.setSerializationInclusion(JsonInclude.Include.NON_NULL);

// 3) LocalDate·LocalDateTime 지원 — 등록 안 하면 직렬화에서 예외
mapper.registerModule(new JavaTimeModule());
mapper.disable(SerializationFeature.WRITE_DATES_AS_TIMESTAMPS); // 1720512000 → "2026-07-09T15:00:00"

// 4) DB 컬럼(user_name) ↔ 자바 필드(userName) 자동 매핑
mapper.setPropertyNamingStrategy(PropertyNamingStrategies.SNAKE_CASE);

💡 1번이 실무 1순위 — 없으면 상대 API가 필드 하나만 추가해도 UnrecognizedPropertyException으로 죽는다. JavaTimeModule은 별도 의존성(jackson-datatype-jsr310), PropertyNamingStrategies는 Jackson 2.12+(이전엔 PropertyNamingStrategy). Spring Boot는 이 대부분을 자동으로 해준다.

돈 계산 BigDecimal (double 함정 · 반올림 · 비교)

형변환

import java.math.BigDecimal;
import java.math.RoundingMode;

// double로 돈 계산 금지 — 이진 오차
System.out.println(0.1 + 0.2); // 0.30000000000000004

// 생성은 "문자열"로 — new BigDecimal(0.1)은 그 오차까지 그대로 담는다
BigDecimal price = new BigDecimal("10000");
BigDecimal rate  = new BigDecimal("0.135");

// 사칙연산 — 불변 객체라 반환값을 받아야 한다
BigDecimal fee   = price.multiply(rate); // 1350.000
BigDecimal total = price.add(fee);

// 나눗셈은 자리수·반올림을 반드시 지정 (무한소수면 예외)
BigDecimal share = total.divide(new BigDecimal("3"), 0, RoundingMode.HALF_UP);

// 반올림 · 버림
BigDecimal rounded = fee.setScale(0, RoundingMode.HALF_UP); // 1350
BigDecimal cut     = fee.setScale(0, RoundingMode.DOWN);    // 1350

// 비교는 equals가 아니라 compareTo — 스케일(1.0 vs 1) 차이를 무시
boolean same = new BigDecimal("1.0").compareTo(new BigDecimal("1")) == 0; // true (equals는 false)

💡 divide는 나누어떨어지지 않으면 ArithmeticException — 스케일·RoundingMode 필수. setScale도 새 객체를 반환한다(원본 불변). 표시용 문자열은 toPlainString()(지수 표기 방지).

문자열 ↔ 날짜 (LocalDate · LocalDateTime)

날짜·시간

import java.time.*;
import java.time.format.DateTimeFormatter;

DateTimeFormatter fmt = DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss");

// 문자열 → 날짜
LocalDateTime dt = LocalDateTime.parse("2026-07-07 21:30:00", fmt);
LocalDate date   = LocalDate.parse("2026-07-07"); // ISO 기본형은 포맷 불필요

// 날짜 → 문자열
String text = dt.format(fmt);

💡 java.util.Date/SimpleDateFormat 대신 java.time(JSR-310) 권장 — 불변·스레드 안전.