POI는 파일을 만들고, DSL은 문서를 설명한다

val workbook = XSSFWorkbook()
val sheet = workbook.createSheet("사용자")

val header = sheet.createRow(0)
listOf("이름", "전화번호", "신청일", "상태").forEachIndexed { index, title ->
    header.createCell(index).setCellValue(title)
}

users.forEachIndexed { rowIndex, user ->
    val row = sheet.createRow(rowIndex + 1)
    row.createCell(0).setCellValue(user.name)
    row.createCell(1).setCellValue(user.phoneNumber)
    row.createCell(2).setCellValue(user.createdAt.toLocalDate())
    row.createCell(3).setCellValue(user.status.displayName)
}

workbook.write(output)

sheet.addHeader("이름", "전화번호", "신청일", "상태")
sheet.addRow(
    user.name,
    user.phoneNumber,
    user.createdAt,
    user.status.displayName,
)

createHeader(row)
writeBodyRows(sheet, users)
applyDateStyle(sheet)
resizeColumns(sheet)

@Excel
data class UserExcelRow(
    @Column("이름", order = 1)
    val name: String,

    @Column("전화번호", order = 2)
    val phoneNumber: String,

    @Column("신청일", order = 3)
    val createdAt: LocalDate,
)

excelOf(rows).writeTo(output)

@Excel
data class UserUploadRow(
    @Column("이름")
    val name: String,

    @Column("이메일")
    val email: String,
)

val result = parseExcel<UserUploadRow>(input)

@Column(
    name = "내부 메모",
    visibleWhen = "currentUser.isAdmin",
)

excel {
    sheet<User>("사용자") {
        column("이름") { it.name }
        column("전화번호") { it.phoneNumber }
        column("신청일") { it.createdAt.toLocalDate() }
        column("상태") { it.status.displayName }

        if (currentUser.isAdmin) {
            column("내부 메모") { it.internalMemo ?: "-" }
        }

        rows(users)
    }
}.writeTo(output)

excel(theme = Theme.Modern) {
    sheet<Transaction>("거래 내역") {
        column("내역") { it.description }
        column(
            "금액",
            conditionalStyle = { value: Int? ->
                when {
                    value == null -> null
                    value < 0 -> fontColor(Color.RED)
                    value > 1_000_000 -> fontColor(Color.GREEN)
                    else -> null
                }
            },
        ) { it.amount }

        rows(transactions)
    }
}.writeTo(output)

Kotlin DSL → ExcelDocument → POI renderer → XLSX

data class ExcelDocument(
    val sheets: List<Sheet> = emptyList(),
    val headerStyle: CellStyle? = null,
    val bodyStyle: CellStyle? = null,
)

data class Sheet(
    val name: String,
    val columns: List<ColumnDefinition<*>> = emptyList(),
    val dataSource: Iterable<*>? = null,
    val freezePane: FreezePane? = null,
    val autoFilter: Boolean = false,
)

data class ColumnDefinition<T>(
    val header: String,
    val width: ColumnWidth = ColumnWidth.Auto,
    val bodyStyle: CellStyle? = null,
    val valueExtractor: (T) -> Any?,
)

class PoiRenderer(
    private val rowAccessWindowSize: Int = 100,
) : ExcelRenderer {
    override fun render(
        document: ExcelDocument,
        output: OutputStream,
    ) {
        SXSSFWorkbook(rowAccessWindowSize).use { workbook ->
            val styleCache = StyleCache(workbook)
            val styleResolver = StyleResolver.from(document)

            document.sheets.forEach { sheetModel ->
                val sheet = workbook.createSheet(sheetModel.name)
                SheetRenderer(
                    sheet = sheet,
                    sheetModel = sheetModel,
                    styleResolver = styleResolver,
                    styleCache = styleCache,
                ).render()
            }

            workbook.write(output)
        }
    }
}

core       : 문서 모델과 Kotlin DSL
annotation : 정적인 행 타입과 스타일 선언
render     : ExcelDocument를 XLSX로 변환하는 POI 구현
parser     : 업로드된 XLSX를 타입으로 변환
theme      : 재사용할 테마
excel-dsl  : 위 기능을 한 번에 사용하는 통합 모듈
benchmarks : 대용량 생성 성능 측정

컬럼 값과 노출 조건     → 사용자 DSL
문서 구조와 공통 스타일 → core / theme
XLSX 생성과 성능        → render / benchmarks
정적인 행 선언          → annotation
업로드 변환과 검증      → parser