interface Map<K,V> - merge 메서드 (동작 및 활용)

1. 메서드 시그니처 분석

public V merge(
        K key,                    // 맵에서 사용할 키
        V value,                  // 새로운 값 (null이 아니어야 함)
        BiFunction<? super V,     // 두 개의 값을 받아서
                ? super V,     // 하나의 값을 반환하는 함수
                ? extends V> remappingFunction
)

2. 동작 시나리오

A. 키가 없거나 값이 null인 경우: 

Map<String, Integer> map = new HashMap<>();
// 키 "A"가 없을 때
map.merge("A", 1, Integer::sum); // 그냥 {"A"=1} 저장

 

B. 키가 이미 존재하는 경우:

Map<String, Integer> map = new HashMap<>();
map.put("A",5);
// 키 "A"가 이미 있을 때
map.merge("A",1,Integer::sum); // {"A"=6}
// remappingFunction(5, 1)이 실행되어 6이 저장됨

 

C. remappingFunction이 null을 반환하는 경우:

Map<String, Integer> map = new HashMap<>();
map.put("A", 5);
map.merge("A", 1, (old, new) -> null); // "A" 키가 제거됨

 

3. 주의사항

Map<String, Integer> map = new HashMap<>();

// 잘못된 사용: remappingFunction 내에서 map 수정
map.merge("A", 1, (old, new) -> {
    map.put("B", 2);  // ConcurrentModificationException 발생 가능
    return old + new;
});

// 올바른 사용
map.merge("A", 1, (old, new) -> old + new);

 

 

4. 활용 예시

// 1. 문자열 연결
Map<String, String> stringMap = new HashMap<>();
stringMap.merge("greeting", "Hello", (old, new) -> old + " " + new);

// 2. 카운터 증가
Map<String, Integer> countMap = new HashMap<>();
countMap.merge("count", 1, Integer::sum);

// 3. 최대값 유지
Map<String, Integer> maxMap = new HashMap<>();
maxMap.merge("max", 10, Integer::max);

// 4. 리스트 합치기
Map<String, List<String>> listMap = new HashMap<>();
listMap.merge("items",
        Arrays.asList("item1"),
        (oldList, newList) -> {
        List<String> merged = new ArrayList<>(oldList);
        merged.addAll(newList);
        return merged;
    }
);

 

5. 내부 동작 의사코드(Pseudo-code)

V oldValue = map.get(key);
V newValue;

if (oldValue == null) {
    newValue = value;
} else {
    newValue = remappingFunction.apply(oldValue, value);
    if (newValue == null) {
        map.remove(key);
        return null;
    }
}
map.put(key, newValue);
return newValue;

 

 

merge 메서드 주요 장점

 

• Thread-safe한 방식으로 "확인 후 수정" 작업을 수행
• null 처리가 자동으로 이루어짐
• 조건문 없이 간결한 코드 작성 가능
• 맵 수정 작업을 원자적으로 처리

 

 

 

 

출처 :

https://docs.oracle.com/en/java/javase/20/docs/api/java.base/java/util/HashMap.html#merge(K,V,java.util.function.BiFunction)