우아한테크코스 on 의찬의 개발 블로그

Testcontainers란?

Sat, 06 Jun 2026 00:00:00 +0000

어떤 개념일까?

Testcontainers는

Docker 컨테이너로 실제 서비스 (DB, 메시지 브로커, 브라우저 등)의 일회용 인스턴스를 테스트 코드에서 직접 띄우고, 끝나면 자동으로 정리해주는 라이브러리이다.

동시성 테스트 코드 작성 CountDownLatch vs CyclicBarrier

Sat, 06 Jun 2026 00:00:00 +0000

어떤 개념일까?

CountDownLatch

한번쓰고 버리는 카운터 게이트이다. 하나 이상의 스레드가, 다른 스레드들에서 진행되는 일련의 작업이 끝날 때까지 기다리게 해주는 동기화 도구이다.

네오의 방탈출

Wed, 03 Jun 2026 00:00:00 +0000

큰 그림: 이 코드는 “정답"이 아니라 “다리”

“스프링 환경에서도 객체지향을 지키라"고 했더니 다들 갈피조차 못 잡는 것 같아서, 직접 빌드해 공개한 코드입니다. 그래서 모범 답안이 아니라 갈피만 잡으라고 던진 다리예요. 오늘 보고 다시는 보지 말라는 말이 핵심입니다. 따라 하면 억지로 끼워넣게 되고 부작용이 더 큽니다.

ThemeSlot을 이용한 Aggregate Root 적용

Tue, 02 Jun 2026 00:00:00 +0000

1. 문제 인식 및 배경

대상 클래스: Reservation과 ThemeSlot 도메인 객체와 ReservationService

리뷰어가 말씀하시기를 Reservation과 ThemeSlot 객체를 보았을 때, 서비스가 두 객체를 동시에 직접 조율하고 있다는 말을 하였다.

equals & hashCode 사용 목적과 id null일 수 있을 때, 어떤 정책으로 동등성, 동일성 검사를 할 수 있을까?

Sun, 31 May 2026 00:00:00 +0000

엔티티의 동등성을 무엇으로 정의할 것인가?

equals / hashCode 사용 목적

동일성 (identity, ==): 두 참조가 같은 객체 인스턴스를 가리키는가. JVM 메모리 주소 비교
동등성(equality, equals): 두 객체가 논리적으로 같은 것을 의미하는가.

a.equals(b)가 true 이면, a.hashCode() == b.hashCode()이어야 한다.

ExceptionHandler에서 핸들링하지 못한 예외가 발생 했을 때 어떤 문제가 발생할 수 있을까?

Sun, 31 May 2026 00:00:00 +0000

💥 의도적 파괴 학습 로그

개념 / 대상 코드:

package roomescape.global.exception;

@RestControllerAdvice
public class GlobalExceptionHandler {

 @ExceptionHandler(IllegalArgumentException.class)
 public ResponseEntity<ErrorResponse> handleIllegalArgumentException(
 IllegalArgumentException illegalArgumentException, HttpServletRequest httpServletRequest
 ) {
 ErrorResponse errorResponse = new ErrorResponseBuilder()
 .httpStatus(HttpStatus.BAD_REQUEST)
 .errorMessage(illegalArgumentException.getMessage())
 .apiUrl(httpServletRequest.getRequestURI())
 .timeStamp(LocalDateTime.now())
 .traceId(MDC.get("traceId"))
 .build();

 return ResponseEntity.status(errorResponse.httpStatus()).body(errorResponse);
 }

 @ExceptionHandler(CustomException.class)
 public ResponseEntity<ErrorResponse> handleCustomException(
 CustomException customException, HttpServletRequest httpServletRequest
 ) {
 ErrorResponse errorResponse = new ErrorResponseBuilder()
 .httpStatus(customException.getErrorCode().getHttpStatus())
 .errorMessage(customException.getErrorCode().getMessage())
 .apiUrl(httpServletRequest.getRequestURI())
 .timeStamp(LocalDateTime.now())
 .traceId(MDC.get("traceId"))
 .build();

 return ResponseEntity.status(customException.getHttpStatus()).body(errorResponse);
 }

 @ExceptionHandler(MethodArgumentNotValidException.class)
 public ResponseEntity<ErrorResponse> handleMethodArgumentNotValidException(
 MethodArgumentNotValidException methodArgumentNotValidException, HttpServletRequest httpServletRequest
 ) {
 ErrorResponse errorResponse = new ErrorResponseBuilder()
 .httpStatus(HttpStatus.BAD_REQUEST)
 .errorMessage("요청값이 잘못됐습니다.")
 .apiUrl(httpServletRequest.getRequestURI())
 .timeStamp(LocalDateTime.now())
 .traceId(MDC.get("traceId"))
 .build();

 return ResponseEntity.status(HttpStatus.BAD_REQUEST).body(errorResponse);
 }


 @ExceptionHandler(ConstraintViolationException.class)
 public ResponseEntity<ErrorResponse> handleConstraintViolationException(
 ConstraintViolationException constraintViolationException, HttpServletRequest httpServletRequest
 ) {
 ErrorResponse errorResponse = new ErrorResponseBuilder()
 .httpStatus(HttpStatus.BAD_REQUEST)
 .errorMessage("요청값이 잘못됐습니다.")
 .apiUrl(httpServletRequest.getRequestURI())
 .timeStamp(LocalDateTime.now())
 .traceId(MDC.get("traceId"))
 .build();

 return ResponseEntity.status(HttpStatus.BAD_REQUEST).body(errorResponse);
 }
}

어떤 개념인가요?

@RestControllerAdvice + @ExceptionHandler로 전역 예외를 잡아 일관된 ErrorResponse(traceId · apiUrl · timeStamp 포함)로 변환하는 구조.

import * 와일드 카드 사용시 문제점과 FakeRepository 테스트를 병렬로 수행시 문제 점과 storage와 sequence에 접근했을 때 어떤 방어 로직이나 객체가 필요할까?

Sun, 31 May 2026 00:00:00 +0000

어떤 개념일까?

1. `import java.util.*;` 와일드카드의 문제

이름 충돌

와일드카드를 여러 패키지에 쓰면 같은 단순 이름의 클래스가 부딪힌다. 나중에 와일드 카드 임포트가 추가되거나 JDK버전이 올라가서 새로운 클래스가 생긴다면 멀쩡하던 코드가 문제가 생길 수 있다.

TraceIdFilter의 사용 목적

Sun, 31 May 2026 00:00:00 +0000

어떤 개념일까?

TraceId는 어떤 목적으로 사용할까?

@Component
public class TraceIdFilter implements Filter {
 @Override
 public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain)
 throws IOException, ServletException {
 try {
 MDC.put("traceId", UUID.randomUUID().toString());
 chain.doFilter(request, response);
 } finally {
 MDC.clear();
 }
 }
}

@ExceptionHandler(CustomException.class)
 public ResponseEntity<ErrorResponse> handleCustomException(
 CustomException customException, HttpServletRequest httpServletRequest
 ) {
 ErrorResponse errorResponse = new ErrorResponseBuilder()
 .httpStatus(customException.getErrorCode().getHttpStatus())
 .errorMessage(customException.getErrorCode().getMessage())
 .apiUrl(httpServletRequest.getRequestURI())
 .timeStamp(LocalDateTime.now())
 .traceId(MDC.get("traceId"))
 .build();

 return ResponseEntity.status(customException.getHttpStatus()).body(errorResponse);
 }

이 로그가 어느 요청에서 나온 것인지 추적할 수 있게 해주는 장치의 목적으로 사용한다.

상태 패턴에서 상태 객체들을 싱글톤으로 선언하는 이유는?

Sun, 31 May 2026 00:00:00 +0000

어떤 개념일까?

상태 패턴에서 상태 객체를 왜 싱글톤으로 선언하는가?

1. 상태 객체는 필드가 없고 행위만 있는 `무상태(stateless)` 객체입니다.

상태 객체들은 내부에 인스턴스 필드를 소유하지 않고 있고, 오직 행위 행동만 정의되어 있습니다.

네오 방탈출 테스트코드 피드백

Fri, 29 May 2026 00:00:00 +0000

방탈출 사이클3 공통 피드백 전달합니다!!

해당 내용 읽고 이따 10시 40분에 질문 답변 받을게요~

## 진단

여러분은 답을 모르는 게 아니라, 답을 평가할 기준이 비어 있어요.

방탈출-싸이클1 리팩터링1

Thu, 28 May 2026 00:00:00 +0000

대상: (예: OrderService, 결제 모듈, API 응답 구조 등)

언어 / 프레임워크:

1. 개요

항목	내용
한 줄 요약	(예: 중복된 할인 계산 로직을 전략 패턴으로 분리)
리팩터링 범위	(예: 단일 메서드 / 클래스 / 모듈 / 아키텍처 레이어)
소요 시간
난이도	⭐ / ⭐⭐ / ⭐⭐⭐ / ⭐⭐⭐⭐ / ⭐⭐⭐⭐⭐

2. 문제 인식 — 무엇이 문제였나?

현재 코드 혹은 구조에서 느낀 불편함, 버그, 유지보수 어려움 등을 구체적으로 기록하세요.

방탈출-싸이클1 엔티티는 record → class로 수정

Thu, 28 May 2026 00:00:00 +0000

엔티티는 record → class로 수정

**대상: 방탈출-회원 예약 싸이클1**

## 문제 인식 — 무엇이 문제였나?

> 현재 코드 혹은 구조에서 느낀 불편함, 버그, 유지보수 어려움 등을 구체적으로 기록하세요.

### 문제 상황

- 도메인 엔티티를 record 자료형으로 사용했을 때의 문제점
1. record를 값 그 자체를 식별자로 갖게된다.

엔티티는 id를 가지는 도메인 엔티티인데 id를 생명 주기로 가지게 된다.
하지만 record는 모든 필드값이 같으면 같은 객체로 equals로 동등성을 비교하게 된다.

그러면 record를 도메인 엔티티로 사용하는게 맞을까 ?
아니다 맞지 않다.

엔티티의 동일성은 식별자 기반이어야 한다. 도메인 객체는 값이 바뀌어도 같은 존재이다.
2. 불변성 문제
record는 완전한 불변 객체이기 때문에 
저장 후에 id를 받고 받은 id로 다시 record를 생성하게 되는데 이것은 도메인의 영역이 아니게 된다.

즉, 값 그 자체가 식별자인 객체는 도메인이 아니고, 
`생명주기와 식별자를 갖는 객체는 class로 설계하는게 맞다.`

### 문제가 되는 코드 / 구조


```plain text
// 문제가 있는 코드나 구조를 붙여넣으세요 (코드가 아닌 경우 텍스트로 설명)
```


### 문제 유형 체크

- [ ] 중복 코드 / 로직
- [ ] 불명확한 이름 (변수, 메서드, 클래스 등)
- [ ] 단일 책임 원칙(SRP) 위반 — 너무 많은 역할
- [ ] 높은 결합도 — 변경 시 여러 곳에 영향
- [ ] 낮은 응집도 — 관련 없는 것들이 한곳에
- [ ] 확장하기 어려운 구조 (OCP 위반)
- [ ] 테스트하기 어려운 구조
- [ ] 성능 문제
- [ ] 가독성 / 이해하기 어려움
- [x] 기타: 엔티티 자료형의 문제

## 변경 이유 — 왜 바꿔야 하는가?

> 지금 당장 동작하더라도 왜 바꾸어야 하는지 그 필요성을 설득력 있게 정리하세요.

엔티티를 record로 사용했을 때,


생명주기와 식별자는 갖는 객체를 record로 설계한다면
값 그 자체가 식별자가 되고 불변 객체인 record의 목적과 맞지 않게 된다.


## 변경 방향 — 어떻게 바꿀 것인가?

> 어떤 방식으로 접근할지, 어떤 기법·패턴·원칙을 적용할지 계획을 기록하세요.

### 접근 전략

- 엔티티에 만든 Reservation, Time, Theme 레코드를 class로 바꾼다.
- equals hashCode를 id 기반으로 재정의 한다.

### 적용할 기법 / 패턴 / 원칙

- [ ] 메서드 추출 (Extract Method)
- [ ] 클래스 / 인터페이스 추출
- [ ] 디자인 패턴 적용 (패턴명: )
- [ ] 레이어 / 모듈 분리
- [ ] 의존성 역전 (DIP) 적용
- [ ] 불변 객체 / VO 도입
- [ ] 기타:

## 회고


### 배운 점

- 엔티티를 record로 사용하면 안되는 이유
- 생명주기와 식별자에 대한 개념

방탈출-싸이클1 예약가능한 시간 관리 수정

Thu, 28 May 2026 00:00:00 +0000

대상:

문제 인식 — 무엇이 문제였나?

현재 코드 혹은 구조에서 느낀 불편함, 버그, 유지보수 어려움 등을 구체적으로 기록하세요.

문제 상황

예약 가능한 시간 조회할 때, 모든 시간들을 다 조회하고, reseration 테이블에서 조회 후에 예약이 존재하는 timeId들에 대해서 다시 비교 하는 로직을 거친 후에 예약 가능한 시간에 대한 데이터를 생성 후 반환해주고 있다.

스키마 변경에 따른 변경 전파

Thu, 28 May 2026 00:00:00 +0000

스키마 변경 영향 분석: `reservation.theme_slot_id` FK 도입

변경 개요

reservation 테이블의 date, time_id, theme_id 컬럼을 제거하고,

theme_slot(id)를 참조하는 외래키 theme_slot_id 단일 컬럼으로 대체한다.

-- 변경 전CREATETABLE reservation( id BIGINTNOTNULL AUTO_INCREMENT,nameVARCHAR(255)NOTNULL, statusVARCHAR(255)NOTNULL,dateDATENOTNULL, time_id BIGINTNOTNULL, theme_id BIGINTNOTNULL,PRIMARYKEY(id),FOREIGNKEY(time_id)REFERENCEStime(id),FOREIGNKEY(theme_id)REFERENCES theme(id));-- 변경 후CREATETABLE reservation( id BIGINTNOTNULL AUTO_INCREMENT,nameVARCHAR(255)NOTNULL, statusVARCHAR(255)NOTNULL, theme_slot_id BIGINTNOTNULL,PRIMARYKEY(id),FOREIGNKEY(theme_slot_id)REFERENCES theme_slot(id));

영향 파일 목록

레이어	파일	변경 규모
DB 스키마	`schema.sql`	컬럼 교체
초기 데이터	`data.sql`	전면 재작성
도메인	`Reservation.java`	필드·생성자·검증 전체
리포지토리 인터페이스	`ReservationRepository.java`	메서드 시그니처 변경
리포지토리 구현	`JdbcReservationRepository.java`	SQL 쿼리 전체
리포지토리 인터페이스	`ThemeSlotRepository.java`	신규 메서드 추가
리포지토리 구현	`JdbcThemeSlotRepository.java`	신규 메서드 구현
서비스	`ReservationService.java`	조회·검증·생성 로직
컨트롤러	`ReservationController.java`	`toResponse()` 위임 확인
DTO	`ReservationModifyRequest.java`	검증 로직 이동 고려
테스트 Fake	`FakeReservationDao.java`	인터페이스 변경 동기화
테스트 Fake	`FakeThemeSlotDao.java`	신규 메서드 구현
단위 테스트	`ReservationTest.java`	생성자 호출부 전체
통합 테스트	`JdbcReservationRepositoryTest.java`	테스트 픽스처 전체
서비스 테스트	`ReservationServiceTest.java`	픽스처·어설션 일부

파일별 상세 변경 내용

1. `src/main/resources/schema.sql`

-- reservation 테이블 재정의CREATETABLE IFNOTEXISTS reservation( id BIGINTNOTNULL AUTO_INCREMENT,nameVARCHAR(255)NOTNULL, statusVARCHAR(255)NOTNULL, theme_slot_id BIGINTNOTNULL,-- 신규PRIMARYKEY(id),FOREIGNKEY(theme_slot_id)REFERENCES theme_slot(id)-- 신규-- 제거: date DATE, time_id BIGINT, theme_id BIGINT, 기존 FK 2개);

주의: theme_slot 테이블 CREATE 문이 reservation보다 먼저 위치해야 FK 참조가 성립한다.

예약 상태 패턴

Thu, 28 May 2026 00:00:00 +0000

대상:

문제 인식 — 무엇이 문제였나?

현재 코드 혹은 구조에서 느낀 불편함, 버그, 유지보수 어려움 등을 구체적으로 기록하세요.

문제 상황

예약 도메인은 상태 전이가 중요한 핵심 비즈니스 로직이다.

우아한테크코스 on 의찬의 개발 블로그

Testcontainers란?

어떤 개념일까?

Testcontainers는

동시성 테스트 코드 작성 CountDownLatch vs CyclicBarrier

어떤 개념일까?

CountDownLatch

네오의 방탈출

큰 그림: 이 코드는 “정답"이 아니라 “다리”

ThemeSlot을 이용한 Aggregate Root 적용

1. 문제 인식 및 배경

equals & hashCode 사용 목적과 id null일 수 있을 때, 어떤 정책으로 동등성, 동일성 검사를 할 수 있을까?

equals / hashCode 사용 목적

ExceptionHandler에서 핸들링하지 못한 예외가 발생 했을 때 어떤 문제가 발생할 수 있을까?

💥 의도적 파괴 학습 로그

어떤 개념인가요?

import * 와일드 카드 사용시 문제점과 FakeRepository 테스트를 병렬로 수행시 문제 점과 storage와 sequence에 접근했을 때 어떤 방어 로직이나 객체가 필요할까?

어떤 개념일까?

1. import java.util.*; 와일드카드의 문제

이름 충돌

TraceIdFilter의 사용 목적

어떤 개념일까?

상태 패턴에서 상태 객체들을 싱글톤으로 선언하는 이유는?

어떤 개념일까?

상태 패턴에서 상태 객체를 왜 싱글톤으로 선언하는가?

1. 상태 객체는 필드가 없고 행위만 있는 무상태(stateless) 객체입니다.

네오 방탈출 테스트코드 피드백

방탈출-싸이클1 리팩터링1

1. 개요

2. 문제 인식 — 무엇이 문제였나?

방탈출-싸이클1 엔티티는 record → class로 수정

엔티티는 record → class로 수정

방탈출-싸이클1 예약가능한 시간 관리 수정

문제 인식 — 무엇이 문제였나?

문제 상황

스키마 변경에 따른 변경 전파

스키마 변경 영향 분석: reservation.theme_slot_id FK 도입

변경 개요

영향 파일 목록

파일별 상세 변경 내용

1. src/main/resources/schema.sql

예약 상태 패턴

문제 인식 — 무엇이 문제였나?

문제 상황

1. `import java.util.*;` 와일드카드의 문제

1. 상태 객체는 필드가 없고 행위만 있는 `무상태(stateless)` 객체입니다.

스키마 변경 영향 분석: `reservation.theme_slot_id` FK 도입

1. `src/main/resources/schema.sql`