본문 바로가기

분류 전체보기86

[Kotlin] KAPT와 KSP 들어가기 전 KAPT와 KSP를 이해하려면, 결국 자바 어노테이션 프로세서부터 봐야 한다. 코틀린에서 KAPT와 KSP를 논하기 전에 반드시 짚고 넘어가야 할 전제가 하나 있다. KAPT와 KSP는 “코틀린의 기능”이 아니라, 자바 어노테이션 프로세싱이라는 오래된 JVM 생태계의 설계를 어떻게 수용하거나, 혹은 거부할 것인가에 대한 선택지다. 자바의 어노테이션 프로세서는 컴파일러 확장 포인트로서 설계되었다. 소스 코드에 선언된 어노테이션을 읽고, 그 정보를 기반으로 새로운 소스 코드를 생성하는 메커니즘이다. 대표적으로 Lombok, MapStruct, Dagger, QueryDSL 같은 라이브러리들이 이 메커니즘 위에서 동작한다. 중요한 점은 이 시스템이 자바 컴파일러(javac)의 타.. 2026. 2. 13.
[Issues] 성능 개선 전략: 인덱스, 역정규화 들어가기 전성능 개선을 이야기할 때 가장 흔하게 등장하는 단어는 인덱스다.쿼리가 느리면 인덱스를 추가하고 그래도 느리면 인덱스를 하나 더 추가한다.하지만 실무에서는 인덱스를 아무리 추가해도 성능이 거의 개선되지 않는 경우가 분명히 있을 뿐더러 오히려 무분별한 인덱스 추가는 쓰기 성능 저하, 저장 공간 증가, 인덱스 유지·관리 비용 상승 같은 부작용을 낳을 수 있다.이 글은 그런 상황에서 출발한다.호텔을 검색할 때 전형적인 읽기 중심 도메인을 기준으로 정규화된 모델이 왜 느려지는지 그 문제를 해결하기 위해 왜 역정규화를 먼저 선택하게 되는지 그 이후 인덱스와 비트맵 설계가 어떤 역할을 맡게 되는지를 순서대로 정리한다.핵심은 "어떤 기법이 빠르다"가 아니라 "어떤 문제에 어떤 순서로 접근해야 하는가" 다.1.. 2026. 2. 2.
[Spring] TransactionManager 들어가기 전Spring의 트랜잭션 매니저는 PlatformTransactionManager라는 추상화를 통해 다양한 데이터 접근 기술에 대해 일관된 트랜잭션 처리를 제공한다. 그러나 실전에서는 단일 트랜잭션 경계만으로 설명되지 않는 복잡한 상황이 자주 등장한다. 특히 멀티 데이터소스, 이벤트 기반 처리, 비동기 작업 등이 혼재하는 환경에서는 Spring의 추상화 이면을 명확히 이해하고 있어야 한다. 본 글은 이러한 맥락에서 트랜잭션 매니저의 역할, 동기화 메커니즘, 컨테이너 내부 동작 방식, 이벤트 연계와 경계의 모호성까지 작성하고자 한다.TransactionManager의 추상화Spring의 트랜잭션 매니저는 단순히 데이터베이스 트랜잭션을 제어하는 기술적 역할을 넘어 본질적인 애플리케이션의 상태 전이와.. 2026. 1. 26.
[Spring] JobRepository의 역할과 실행 흐름 들어가기 전Spring Batch는 대용량 데이터 처리를 위해 Job, Step 등의 컴포넌트로 구성된 프레임워크입니다. 이 글에서는 배치(Job)를 실행할 때 내부에서 JobRepository가 어떤 역할을 하고 기본 구현체가 어떻게 동작하는지 살펴보겠습니다. Spring Boot의 기본 설정을 활용하여 별도 커스터마이징 없이 (기본 구현체 그대로) 애플리케이션 코드에서 배치를 직접 호출하는 상황으로 가정할 것이며 이를 통해 JobRepository를 중심으로 JobLauncher가 Job을 실행하고 메타데이터를 관리하는 흐름을 알아보고자 합니다.JobRepositorySpring Batch의 기본 아키텍처는 배치 작업 단위를 표현하는 Job과 그 구성요소인 Step들로 이루어져 있습니다. JobLau.. 2026. 1. 11.
[Issues] 대량 Delete 작업 중 발생한 lock 문제 분석 1.문제 상황 Spring Batch 기반의 백엔드 시스템에서 멀티 스레드로 대용량 삭제 작업을 수행하는 중 지속적으로 락 대기 시간 초과(Lock wait timeout) 이 발생하였습니다. 해당 배치 작업은 총 10개의 스레드가 병렬로 실행되며 대부분의 데이터를 미리 Processor 레벨에서 가공하여 삭제 -> insert 하는 방식으로 실행되었는데 예를 들어 tb_order_item 테이블에서 특정 order_id 목록에 해당하는 행들을 한꺼번에 삭제하는 형태였습니다. -- 예시: 하나의 스레드가 실행하는 삭제 쿼리 (IN 절에 다수의 ID 포함)deletefrom tb_order_itemwhere order_id in (101, 102, ..., 250); 대게 그렇듯이 다른 테이블.. 2026. 1. 6.
[Spring] HikariCp(2) 들어가기 전이전 글에서는 HikariCP가 언제 커넥션 풀을 초기화하고 어떤 판단 과정을 거쳐 커넥션을 생성하는지를 살펴보았습니다. HouseKeeper는 주기적으로 풀의 상태를 점검하고, minimumIdle을 유지해야 한다고 판단되는 경우 직접 커넥션을 생성하지 않고 전용 커넥션 생성 스레드(connection-adder) 에게 작업을 위임합니다. 이전 글이 "커넥션을 만들어야 하는가"에 대한 판단의 영역이라면 이번 글에서는 그 결과로 생성된 커넥션들이 실제로 어디에 보관되고 어떤 방식으로 대여되고 반납되는지를 다뤄보려고 합니다. 즉 HikariPool 에서의 커넥션풀의 자료 구조를 담당하는 ConcurrentBag 입니다.ConcurrentBagConcurrentBag은 커넥션 풀처럼 "아주 짧은 .. 2025. 12. 29.
[Spring] HikariCp(1) 애플리케이션을 개발할 때 데이터베이스 접근이 필요한 경우 보통 스프링 진영에서는 datasource 설정을 통해 연결 정보를 구성합니다.이 과정에서 다양한 설정 값을 정의하게 되는데 각각의 값이 실제로 어떤 역할을 하고 애플리케이션 내부에서 어떤 시점에 적용되는지 명확하게 이해하기 위해 이 글을 작성합니다.특히 커넥션 풀과 관련된 설정은 상황에 따라 애플리케이션의 처리량과 안정성에 직접적인 영향을 미칩니다.애플리케이션을 개발하면서 커넥션 풀 사이즈와 스레드 풀 사이즈를 조정해야 하는 일이 있고 병목 현상이나 타임아웃 문제를 겪으면서 내부 원리를 정확히 이해할 필요성을 절감한 바 있습니다. 이러한 경험을 바탕으로 이 글에서는 다음 두 가지를 중심으로 정리하고자 합니다.Spring Boot가 HikariCP.. 2025. 12. 18.
[Kotlin] Kotlin DSL DSL이란DSL(Domain-Specific Language) 은 특정 도메인의 문제를 다루기 위해 설계된 전용 언어입니다. 일반적인 프로그래밍 언어인 GPL(General Purpose Language) 이 다양한 문제를 폭넓게 해결하도록 만들어진 범용 언어라면, DSL은 반대로 특정 영역에만 집중해 표현력을 극대화한 언어라고 볼 수 있습니다. 대표적인 DSL에는 SQL, HTML, CSS, 정규표현식(Regex) 등이 있습니다. 이들은 각각 데이터 질의/조작, 문서 구조 정의, 스타일링, 문자열 패턴 매칭처럼 명확한 목적을 갖는 도메인에서 매우 강력한 표현력을 보여줍니다. 예를 들어 SQL(Structured Query Language)은 데이터 필터링과 정렬을 직관적으로 표현할 수 있는 대표적인 D.. 2025. 12. 3.
[Spring] @TransactionalEventListener TransactionalEventListener@EventListener는 코드의 결합도를 낮추고 도메인 이벤트를 기반으로 유연한 구조를 만드는 데 유용하지만 트랜잭션을 사용하는 환경에서는 예상치 못한 문제가 발생할 수 있습니다. 다음과 같은 코드가 있다고 예를 들겠습니다.@Transactionalfun createOrder() { orderRepository.save(...) applicationEventPublisher.publishEvent(OrderCreatedEvent(...))}앞서 작성한 이벤트리스너에서 알아봤듯이 @EventListener는 동기적으로 실행됩니다. orderRepository.save()는 아직 커밋되지 않았지만 이벤트 리스너에서 이 해당 값에 접근하거나 관련 작업을 시.. 2025. 7. 23.