1. 인라인 클래스

• 함수 뿐만 아니라 클래스도 인라인으로 만들 수 있음
  • *인라인 함수
• 인라인 클래스는 value wrapper를 만들 때 런타임 오버헤드를 줄이는 기능
• 코틀린 1.3에서 inline class 로 도입되었으며, 1.5부턴 value class 로 명칭이 변경되었음

2. 핵심 개념

• 단일 값을 감싸는 type safe한 wrapper
• 런타임에 해당 wrapper 객체가 생성되지 않고 내부 값으로 대체됨
• 컴파일 타임에는 타입 체크를 제공하지만 런타임에는 primitive 타입처럼 동작함

// 인라인 클래스 선언
@JvmInline
value class UserId(val id: Long)

@JvmInline
value class EmailAddress(val email: String) {
    fun isValid(): Boolean = email.contains("@")
}

// 사용 예
fun main() {
    val userId = UserId(42L)
    val emailAddress = EmailAddress("[email protected]")
}

// 컴파일 후
fun main {
    val userId: Long = 42L // 내부 값인 Long 타입으로 대체됨
    val emailAddress: String = "[email protected]" // 내부 값인 String 타입으로 대체됨
}

3. 언제 사용하면 좋은지?

1. 측정 단위 표현

   @JvmInline
   value class Meters(val value: Double)
   
   @JvmInline
   value class Kilometers(val value: Double)
   

2. type-safe한 ID 만들기

   • Long 타입만 사용할 때 발생할 수 있는 실수(e.g. 주문 ID와 사용자 ID 파라미터 순서 혼동)를 컴파일 타임에 방지할 수 있음

   @JvmInline
   value class UserId(val value: Long)
   
   @JvmInline
   value class OrderId(val value: Long)
   

3. 도메인 특화 타입 정의

   • primitive 타입에 의미를 부여하고 유효성 검사를 캡슐화할 수 있음

   @JvmInline
   value class EmailAddress(val value: String) {
       init {
           require(value.contains("@")) { "Invalid email format" }
       }
   }
   

4. enum을 대체하면서 더 유연한 값 표현

   • enum보다 더 동적으로 값을 사용할 수 있게 해줌

   @JvmInline
   value class Currency(val code: String)
   
   val usd = Currency("USD")
   

4. 주의사항

1. 인터페이스

   // 인터페이스로 ID 타입 정의
   interface TimeUnit { val millis: Long }
   
   @JvmInline
   value class Minutes(val minutes: Long): TimeUnit {
       override val millis: Long
           get() = minutes * 60 * 1000
   }
   
   @JvmInline
   value class Millis(val milliseconds: Long): TimeUnit {
       override val millis: Long
           get() = milliseconds
   }
   
   fun setUpTimer(time: TimeUnit) {
       val millis = time.millis
       // ...
   }
   
   fun main() {
       setUpTimer(Minutes(123))
       setUpTimer(Millis(456789))
   }
   

   • 위 코드는 클래스가 inline으로 동작하지 않음
   • 인터페이스를 통해서 타입을 나타내려면 객체를 래핑해서 사용해야 하기 때문
   • 따라서 인터페이스를 구현하는 인라인 클래스는 아무런 의미가 없음