Konvert

[![Maven Central][maven-image]][maven-url] [![License][license-image]](LICENSE) [![Code Coverage][codecov-image]][codecov-url]

이것은 Kotlin Symbol Processing (KSP)를 사용하는 Kotlin 매핑 코드 생성기인 Konvert입니다. Kotlin과 그 기능을 위해 특별히 설계되었으며, Konvert는 다양한 사용 사례를 지원합니다.

주요 기능:

• 🧩 다양한 클래스 종류 지원 → data, enum, value, 일반 POJO
• 🔄 기본적으로 널 안전성(Null-safe)
• ⚙️ 스마트 변환 (Int → String, Instant → Date, …)
• 🔧 @Konverter로 재사용 가능한 변환기 정의
• 🔌 궁극적인 제어를 위한 SPI 확장
• 🔗 컬렉션 및 맵 — 요소 매핑 포함
• 🛠️ 세밀한 속성 매핑 커스터마이징
• ☕ 100% Java 상호 운용성
• ✨ 깔끔하고 관용적인 Kotlin 코드 생성
• ⏱️ 컴파일 타임에 생성
• 🚫 리플렉션 없음, 런타임 오버헤드 없음
• 📦 Gradle 및 Maven과 원활하게 작동

사용법

Konvert를 사용하는 세 가지 방법이 있습니다:

• @KonvertTo 사용:

   @KonvertTo(PersonDto::class)
   data class Person(val firstName: String, val lastName: String)
   data class PersonDto(val firstName: String, val lastName: String)
   ``
   이는 다음과 같은 확장 함수를 생성합니다
   `kotlin
   fun Person.toPersonDto(): PersonDto =
      PersonDto(firstName = firstName, lastName = lastName)
   `
@KonvertFrom 사용하기 (특히 소스 클래스의 코드를 변경할 수 없을 때 유용)

   
`kotlin
   class Person(val firstName: String, val lastName: String) {
      @KonvertFrom(PersonDto::class)
      companion object
   }
   class PersonDto(val firstName: String, val lastName: String)
   `
   이것은 다음과 같은 확장 함수를 생성합니다
   `kotlin
   fun Person.Companion.fromPersonDto(personDto: PersonDto): Person =
      Person(firstName = personDto.firstName, lastName = personDto.lastName)
   `
@Konverter 사용:

   
`kotlin
   class Person(val firstName: String, val lastName: String)
   data class PersonDto(val firstName: String, val lastName: String)
   @Konverter
   interface PersonMapper {
      fun toDto(person: Person): PersonDto
   }
   `
   이것은 다음 객체를 생성합니다
   `kotlin
   object PersonMapperImpl: PersonMapper {
      override fun toDto(person: Person): PersonDto
         = PersonDto(firstName = person.firstName, lastName = person.lastName)
   }
   `
간단한 예제 프로젝트는 example 디렉터리를 참조하세요.
타입 매핑
Instant에서 Date로와 같은 간단한 타입 매핑의 경우, Konvert에 이미 제공된 타입 변환기가 있습니다:

이것은 다음 확장 함수를 생성합니다

문서에서 제공되는 타입 변환기 목록을 확인하세요.
🛈: 또한 TypeConverter를 구현하여
자체 타입 변환기 라이브러리를 만들고 SPI를 사용해 등록할 수 있습니다.
미세 조정
대부분의 경우, 소스와 대상 클래스는 동일한 속성 이름과 타입을 가지지 않을 수 있습니다.
특정 매핑을 구성하고 생성된 확장 함수 이름을 다음과 같이 변경할 수 있습니다:

이것은 다음과 같은 확장 함수를 생성합니다

• 어노테이션을 사용하기 위해 konvert-api를 의존성에 추가하세요:

• konvert를 ksp 의존성으로 추가합니다:

• 어노테이션을 사용하기 위해 konvert-api를 의존성으로 추가합니다:

• konvert를 의존성으로 사용하여 ksp-maven-plugin을 사용하세요:

기본적으로 사용 가능한 테스트 중 일부만 실행되며, 이는 Konvert의 대부분 기능을 검증합니다. 모든 테스트를 실행하려면 runAllTests 속성을 추가하세요. 예를 들어:

gradle test -PrunAllTests

문서

Jekyll 사이트를 로컬에서 제공하려면 docs` 폴더 내에서 다음 명령을 실행하세요:

docker run --rm -it -v "$PWD":/site -p 4000:4000 bretfisher/jekyll-serve

CI

GitHub Actions는 다음 작업에 사용됩니다:

• 빌드 및 테스트
• Maven 저장소에 릴리스 및 배포
• 문서 생성 및 GitHub Pages에 배포

변경 로그

변경 로그에는 모든 주요 변경 사항이 포함되어 있습니다.

라이선스

저작권 2023 Marcel Carlé

Apache License, Version 2.0 ("라이선스")에 따라 허가됨 이 파일을 라이선스 조건에 따르지 않고 사용할 수 없습니다. 라이선스 사본은 다음에서 확인할 수 있습니다.

http://www.apache.org/licenses/LICENSE-2.0

관련 법률에 의해 요구되거나 서면 동의가 없는 한, 라이선스에 따라 배포되는 소프트웨어는 "있는 그대로" 제공됩니다.

명시적이거나 묵시적인 어떠한 보증이나 조건 없이 제공됩니다. 권한 및 제한 사항에 대해서는 라이선스를 참조하십시오.

[maven-image]: https://img.shields.io/maven-central/v/io.mcarle/konvert.svg

[maven-url]: https://central.sonatype.com/artifact/io.mcarle/konvert/

[license-image]: https://img.shields.io/github/license/mcarleio/konvert.svg

[codecov-image]: https://img.shields.io/codecov/c/github/mcarleio/konvert.svg

[codecov-url]: https://codecov.io/gh/mcarleio/konvert

--- Tranlated By Open Ai Tx | Last indexed: 2026-04-08 ---