이 저장소는 Kotlin Exposed 프레임워크의 사용법을 단계별로 학습할 수 있는 예제와 워크샵 모음입니다. 초보자부터 고급 사용자까지 Exposed의 다양한 기능을 실습하며 익힐 수 있도록 구성되어 있습니다.
Kotlin Exposed는 JetBrains에서 개발한 Kotlin 언어 전용 SQL 프레임워크입니다. Kotlin의 강력한 타입 시스템을 활용하여 컴파일 타임에 SQL 쿼리의 안전성을 보장하며, DSL(Domain Specific Language)과 DAO(Data Access Object) 두 가지 스타일을 모두 지원합니다.
| 특징 | 설명 |
|---|---|
| 타입 안전성 | 컴파일 타임에 SQL 오류 감지 |
| DSL & DAO | SQL 스타일과 ORM 스타일 모두 지원 |
| 코루틴 지원 | 비동기 프로그래밍 완벽 지원 |
| 경량화 | JPA 대비 적은 메모리 사용량 |
| 다양한 DB 지원 | H2, MySQL, PostgreSQL, Oracle, SQL Server 등 |
이 워크샵은 다음과 같은 순서로 학습하는 것을 권장합니다:
- 기본: Spring Boot + Exposed 기본 통합
- 대안 기술: JPA 대안 기술들 비교
- Exposed 기본: DSL과 DAO 패턴 익히기
- DDL/DML: 스키마 정의와 데이터 조작
- 고급 기능: 암호화, JSON, 커스텀 타입 등
- JPA 마이그레이션: JPA 코드를 Exposed로 변환
- 비동기 처리: Coroutines, Virtual Threads
- Spring 통합: 트랜잭션, 캐시, 리포지토리 패턴
- 멀티테넌시: 다중 테넌트 아키텍처
- 고성능: 캐시 전략, 라우팅 데이터소스
모든 예제의 상세 설명은 Kotlin Exposed Book에서 확인할 수 있습니다.
exposed-workshop 프로젝트 전반에서 사용되는 공통 테스트 유틸리티와 리소스를 제공합니다. 다양한 데이터베이스 환경에서 일관된 테스트를 수행할 수 있도록 지원합니다.
Spring MVC + Virtual Threads + Exposed를 이용하여 동기식 REST API를 구축하는 방법을 학습합니다. 영화와 배우 데이터를 다루며 다대다 관계 매핑을 실습합니다.
Spring WebFlux + Kotlin Coroutines + Exposed를 이용하여 비동기 REST API를 구축하는 방법을 학습합니다. 반응형 프로그래밍 모델과 Exposed의 통합 방법을 익힙니다.
Hibernate Reactive를 이용한 반응형 Spring Boot 애플리케이션 구축 예제입니다.
Spring Data R2DBC를 이용한 반응형 데이터베이스 접근 예제입니다.
Vert.x SQL Client를 이용한 이벤트 기반 비동기 데이터베이스 작업 예제입니다.
Exposed의 DAO(Data Access Object) 패턴을 학습합니다. Entity와 EntityClass를 사용하여 객체지향적으로 데이터베이스 작업을 수행하는 방법을 익힙니다.
Exposed의 SQL DSL(Domain Specific Language)을 학습합니다. 타입 안전한 SQL 쿼리 작성 방법과 DSL의 장점을 익힙니다.
데이터베이스 연결 설정, 예외 처리, 타임아웃, 커넥션 풀링 등 연결 관리의 핵심 개념을 학습합니다.
Exposed의 DDL 기능을 학습합니다. 테이블, 컬럼, 인덱스, 시퀀스 정의 방법을 익힙니다.
SELECT, INSERT, UPDATE, DELETE의 기본 패턴을 학습합니다. 조건식, 서브쿼리, 페이징 등 실무에서 자주 사용하는 패턴을 익힙니다.
Exposed에서 제공하는 다양한 컬럼 타입을 학습합니다. 기본 타입부터 배열, BLOB, UUID, unsigned 수형까지 폭넓게 다룹니다.
Exposed 쿼리에서 다양한 SQL 함수를 사용하는 방법을 학습합니다. 집계 함수, 윈도우 함수, 수학/삼각 함수 등을 다룹니다.
Exposed의 트랜잭션 관리 기능을 학습합니다. 격리 수준, 중첩 트랜잭션, 롤백, 코루틴 통합 등을 다룹니다.
Exposed의 강력한 Entity API를 학습합니다. 다양한 기본키 전략, 관계 매핑, 라이프사이클 훅, 캐싱 등을 다룹니다.
exposed-crypt 확장을 사용하여 데이터베이스 컬럼을 투명하게 암호화/복호화하는 방법을 학습합니다.
Java 8의 java.time API와 Exposed의 통합 방법을 학습합니다.
kotlinx.datetime 라이브러리와 Exposed의 통합 방법을 학습합니다. 멀티플랫폼 프로젝트에 적합합니다.
exposed-json 모듈을 사용하여 JSON/JSONB 컬럼을 다루는 방법을 학습합니다.
exposed-money 모듈을 사용하여 통화 값을 안전하게 처리하는 방법을 학습합니다.
사용자 정의 컬럼 타입을 구현하는 방법을 학습합니다. 암호화, 압축, 직렬화 등의 투명한 변환을 구현합니다.
Snowflake, KSUID, Time-based UUID 등 다양한 ID 생성 전략을 가진 커스텀 Entity를 구현합니다.
Jackson 라이브러리를 사용하여 JSON/JSONB 컬럼을 처리하는 방법을 학습합니다.
Alibaba Fastjson2 라이브러리를 사용하여 JSON 컬럼을 처리하는 방법을 학습합니다.
Jasypt를 사용하여 검색 가능한(결정적) 암호화를 구현하는 방법을 학습합니다.
Jackson 3.x 버전을 사용하여 JSON/JSONB 컬럼을 처리하는 방법을 학습합니다.
JPA의 기본 기능을 Exposed로 구현하는 방법을 학습합니다. Entity, 연관관계, 기본키, 복합키 등을 다룹니다.
JPA의 고급 기능을 Exposed로 구현하는 방법을 학습합니다. 상속 매핑, Self-Reference, Auditable, 낙관적 잠금 등을 다룹니다.
Exposed를 Kotlin Coroutines 환경에서 사용하는 방법을 학습합니다.
newSuspendedTransaction, suspendedTransactionAsync 등을 다룹니다.
Exposed를 Java 21 Virtual Threads 환경에서 사용하는 방법을 학습합니다. 블로킹 코드 스타일을 유지하면서 고성능 비동기 처리를 구현합니다.
Spring Boot의 자동 설정을 활용하여 Exposed를 설정하는 방법을 학습합니다.
Spring의 TransactionTemplate으로 프로그래밍 방식 트랜잭션을 관리하는 방법을 학습합니다.
@Transactional 어노테이션으로 선언적 트랜잭션을 관리하는 방법을 학습합니다.
Spring Data Repository 패턴을 적용한 Exposed 리포지토리 구현 방법을 학습합니다.
코루틴 환경에서 Repository 패턴을 사용하여 비동기 데이터 접근을 구현합니다.
Spring Boot Cache를 Exposed와 함께 사용하는 방법을 학습합니다.
Lettuce를 활용한 Suspended Cache를 코루틴 환경에서 Exposed와 함께 사용하는 방법을 학습합니다.
Spring Web Application에서 Schema-based Multi-tenancy를 구현하는 방법을 학습합니다.
Virtual Threads 환경에서 멀티테넌시를 구현하는 방법을 학습합니다.
WebFlux와 Coroutines를 이용하여 반응형 멀티테넌시를 구현하는 방법을 학습합니다.
Redisson + Exposed로 다양한 캐시 전략(Read Through, Write Through, Write Behind)을 구현합니다.
코루틴 환경에서 비동기로 작동하는 캐시 전략을 구현합니다.
Multi-Tenant 또는 Read Replica 구조를 위한 유연한 DataSource 라우팅 구성 방법을 학습합니다.
- JDK 17 이상 (Virtual Threads 사용 시 JDK 21 이상)
- Gradle 8.x 이상
- Docker (Testcontainers 사용 시)
# 전체 프로젝트 빌드
./gradlew build
# 특정 모듈 테스트 실행
./gradlew :05-exposed-dml:01-dml:testIntelliJ IDEA를 권장합니다. Kotlin 플러그인이 설치되어 있어야 합니다.
이 프로젝트는 학습 목적으로 제작되었습니다. 오타 수정, 예제 추가, 번역 개선 등 모든 기여를 환영합니다.
Apache License 2.0