Univocity Parsers, Java에서 가장 빠른 CSV Parser 사용법 정리

개요

• Univocity Parsers는 현재 Java 진영에서 가장 성능이 뛰어난 CSV 파써 라이브러리이다. 이번 글에서는 CSV 파일을 Java Bean의 목록으로 변환하는 방법을 설명하고자 한다.

build.gradle.kts

• 프로젝트의 /build.gradle.kts에 아래 내용을 추가한다.

dependencies {
    implementation("com.univocity:univocity-parsers:2.9.1")
}

CsvBean 클래스 작성

• CSV 파일의 로우를 빈으로 맵핑할 CsvBean 클래스를 작성할 차례이다.

import com.univocity.parsers.annotations.Parsed
import java.math.BigDecimal

data class FooCsvBean(

    @Parsed(field = ["id"])
    var id: Long = 0,

    @Parsed(field = ["name"])
    var name: String = "",

    @Parsed(field = ["price"], defaultNullRead = "0")
    var price: BigDecimal = 0,

    @Parsed(field = ["created_at"])
    var createdAt: String? = null
)

• CSV 로우의 필드 값이 존재하지 않을 경우 빈으로 변환시 NullPointerException이 발생한다. @Parsed의 옵션으로 defaultNullRead = "{default-value}"을 명시하면 null 값을 지정된 기본값으로 변환하여 맵핑해준다.

CSV to List 클래스 작성

• 아래는 CSV 파일을 List 객체로 변환하는 예이다.

// CSV 파일을 Bean으로 상호 변환할 Processor 객체 생성
val beanListProcessor: BeanListProcessor<FooCsvBean> = BeanListProcessor(FooCsvBean::class.java)

val parserSettings = CsvParserSettings().apply{
    // CSV 파일의 각 로우를 식별하는 개행 문자 지정
    this.format.setLineSeparator("\n")
    // CSV 파일을 Bean으로 처리
    this.setProcessor(beanListProcessor)
    // CSV 파일에 헤더 로우가 존재할 경우 true, 아닐 경우 false
    this.isHeaderExtractionEnabled = true
}

// CSV 파일을 Bean 객체 목록으로 변환
CsvParser(parserSettings).apply {
    InputStreamReader(FileInputStream(fileName)).use { inputStreamReader ->
        this.parse(inputStreamReader)
    }
}
var csvBeans: List<FooCsvBean> = beanListProcessor.beans

참고 글

• Introduction to univocity-parsers
• Baeldung - Univocity Parsers