개발자 경험 — Dev Mode, DevServices, Continuous Testing

# Dev Mode 시작
quarkus dev
# 또는
./mvnw quarkus:dev

[Spring Boot DevTools]
코드 수정 → 전체 ApplicationContext 재시작 → 빈 재생성 → 준비 완료
약 2~5초 (프로젝트 크기에 따라 더 걸림)

[Quarkus Dev Mode]
코드 수정 → 변경된 ClassLoader만 교체 → 변경된 부분만 재처리 → 준비 완료
약 0.5~2초 (대부분 1초 이내)

// UserResource.java를 수정하고 저장
@Path("/users")
public class UserResource {

    @GET
    @Produces(MediaType.APPLICATION_JSON)
    public List<UserDto> listUsers() {
        // 이 메서드를 수정하고 저장한 뒤
        // curl localhost:8080/users 를 치면 바로 반영됨
        return userService.findAll();
    }
}

<!-- pom.xml에 PostgreSQL 의존성만 추가 -->
<dependency>
    <groupId>io.quarkus</groupId>
    <artifactId>quarkus-jdbc-postgresql</artifactId>
</dependency>
<dependency>
    <groupId>io.quarkus</groupId>
    <artifactId>quarkus-hibernate-orm-panache</artifactId>
</dependency>

[Dev Mode 시작 로그]

2026-03-28 10:00:01 INFO  [io.qua.dev.pos.dep] DevServices for PostgreSQL started
  - Container: testcontainers/ryuk:0.5.1
  - PostgreSQL: postgres:16
  - JDBC URL: jdbc:postgresql://localhost:55432/quarkus
  - Username: quarkus
  - Password: quarkus

Quarkus application started in 2.134s

[기존: 로컬 개발 환경 세팅]
1. docker-compose.yml 작성
2. docker-compose up -d
3. application-local.properties에 연결 정보 작성
4. 프로파일 설정 (-Dspring.profiles.active=local)
5. 애플리케이션 시작
6. 개발 끝나면 docker-compose down

[Quarkus DevServices]
1. 의존성 추가
2. quarkus dev
3. 끝

# application.properties

# PostgreSQL 버전 지정
quarkus.datasource.devservices.image-name=postgres:15

# 초기 SQL 실행
quarkus.datasource.devservices.init-script-path=init.sql

# 포트 고정 (기본은 랜덤 포트)
quarkus.datasource.devservices.port=5432

# DevServices 비활성화 (이미 DB가 있을 때)
quarkus.datasource.devservices.enabled=false

# Kafka 설정
quarkus.kafka.devservices.image-name=vectorized/redpanda:latest
quarkus.kafka.devservices.topic-partitions.orders=3

[Spring Actuator]
- 프로덕션 모니터링 용도
- /actuator/health, /actuator/metrics 등
- 별도 의존성 추가 필요
- 보안 설정 필요 (프로덕션 노출 주의)

[Quarkus Dev UI]
- 개발 시 디버깅/탐색 용도
- 그래픽 UI로 직관적
- Dev Mode에서만 활성화 (프로덕션에선 자동 비활성화)
- 확장마다 커스텀 페이지 제공

[ArC Beans 페이지]
- 등록된 빈 수, 제거된 빈 수 확인
- 빈의 의존성 그래프 시각화
- 인터셉터 바인딩 확인

[Configuration 페이지]
- 모든 설정 키와 현재 값
- 설정 출처 (기본값 / application.properties / 환경변수 / 시스템 프로퍼티)
- 설정값 실시간 변경 (일부)

[Endpoints 페이지]
- 모든 REST 엔드포인트 목록
- HTTP 메서드, 경로, 파라미터
- 바로 테스트 호출 가능

Tests paused
Press [r] to resume testing, [o] Toggle test output, [h] for more options>

[코드 수정 흐름]
UserService.java 수정
     │
     ▼
Quarkus가 변경된 클래스와 관련된 테스트를 식별
     │
     ├── UserServiceTest.java ← UserService를 직접 테스트
     ├── UserResourceTest.java ← UserService를 간접 사용
     └── OrderServiceTest.java ← 변경과 무관, 실행 안 함
     │
     ▼
관련 테스트만 자동 실행, 결과를 콘솔과 Dev UI에 표시

All 15 tests are passing (2 disabled), 3 tests were run in 1.2s.
Press [r] to re-run, [o] Toggle test output, [v] Toggle debug, [h] for more options>

# application.properties

# 기본 활성화 (Dev Mode에서)
quarkus.test.continuous-testing=enabled

# 테스트 변경 감지 간격 (ms)
quarkus.test.poll-interval=500

# 특정 태그의 테스트만 실행
quarkus.test.include-tags=unit

# 특정 태그의 테스트 제외
quarkus.test.exclude-tags=integration,slow

# 테스트 실패 시 알림 (IDE 연동)
quarkus.test.display-test-output=true

[기존: 수동 테스트 실행]
1. 코드 수정
2. IDE에서 해당 테스트 클래스 찾기
3. 테스트 실행
4. 결과 확인
5. 관련된 다른 테스트도 실행해야 하나 고민
6. 전체 테스트 실행 (시간 오래 걸림)

[Quarkus Continuous Testing]
1. 코드 수정
2. 자동으로 관련 테스트 실행 + 결과 표시

# macOS
brew install quarkusio/tap/quarkus

# Linux (SDKMAN)
sdk install quarkus

# Windows (Chocolatey)
choco install quarkus

# 프로젝트 생성
quarkus create app com.example:my-app

# 개발 모드 실행
quarkus dev

# 확장 검색
quarkus extension list --installable --search="kafka"

# 확장 추가
quarkus extension add smallrye-reactive-messaging-kafka

# 확장 제거
quarkus extension remove smallrye-reactive-messaging-kafka

# 빌드
quarkus build

# 네이티브 빌드
quarkus build --native

# 정보 확인
quarkus info

# Spring Boot (Initializr 웹에서 생성하는 경우가 많음)
curl https://start.spring.io/starter.tgz \
  -d dependencies=web,data-jpa,postgresql | tar -xz

# Quarkus CLI
quarkus create app --extension='resteasy-reactive,hibernate-orm-panache,jdbc-postgresql'

@QuarkusTest
public class UserResourceTest {

    @Test
    public void testGetUser() {
        given()
            .when().get("/users/1")
            .then()
            .statusCode(200)
            .body("name", is("홍길동"));
    }

    @Test
    public void testCreateUser() {
        given()
            .contentType(ContentType.JSON)
            .body("""
                {
                    "name": "김철수",
                    "email": "kim@example.com"
                }
                """)
            .when().post("/users")
            .then()
            .statusCode(201)
            .body("name", is("김철수"));
    }
}

@QuarkusIntegrationTest
public class UserResourceIT {

    // @QuarkusTest와 동일한 테스트 코드
    // 네이티브 바이너리를 대상으로 실행됨
    @Test
    public void testGetUser() {
        given()
            .when().get("/users/1")
            .then()
            .statusCode(200);
    }
}

@QuarkusTest
public class UserServiceTest {

    @InjectMock
    UserRepository userRepository;  // 모킹된 빈이 주입됨

    @Inject
    UserService userService;  // 실제 빈, 위 모킹된 빈을 사용

    @Test
    public void testFindById() {
        // given
        when(userRepository.findById(1L))
            .thenReturn(Optional.of(new User("홍길동")));

        // when
        UserDto result = userService.findById(1L);

        // then
        assertEquals("홍길동", result.name());
    }
}

[터미널]
$ quarkus dev

[자동으로 일어나는 일]
1. Quarkus 시작 (1~2초)
2. DevServices: PostgreSQL 컨테이너 자동 시작
3. DevServices: Redis 컨테이너 자동 시작
4. Dev UI 활성화 (localhost:8080/q/dev-ui)
5. Continuous Testing 대기

[개발 중]
1. UserResource.java 수정 + 저장
2. Live Reload: 0.5초 후 변경 반영
3. Continuous Testing: UserResourceTest 자동 실행
4. 브라우저: Dev UI에서 결과 확인
5. API 테스트: curl로 바로 확인

[개발 종료]
$ Ctrl+C
→ Quarkus 종료
→ DevServices 컨테이너 자동 정리