...
Eroare Kotlin · Clase, moștenire și interfețe

Value class must have exactly one primary constructor parameter

Pe scurt

O value class poate învelui o singură valoare, dar ai pus două sau mai multe proprietăți în constructor. Pentru mai multe câmpuri folosește data class; păstrează value class doar pentru un singur câmp (de exemplu suma în bani).

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

Ideea unei value class este că la rulare dispare și rămâne doar valoarea din interior. Asta funcționează numai dacă există exact o valoare: un Int, un String, un Long. Cu două sau mai multe proprietăți în constructorul primar (value class Pret(val suma: Int, val moneda: String)), compilatorul spune Value class must have exactly one primary constructor parameter. Același mesaj apare și dacă ai lăsat constructorul gol.

Alege după nevoie:

  • un singur câmp și vrei un tip separat → @JvmInline value class;
  • mai multe câmpuri → data class;
  • vrei totuși un tip „subțire” → învelește un singur câmp (de exemplu suma în bani, cu moneda fixă) sau grupează câmpurile într-o data class și pune-o pe aceea în value class.

Parametrul trebuie să fie și val (nu var, nici parametru simplu).

De ce apare: cauzele frecvente

1Două câmpuri într-o value class

Greșit
KOTLIN
@JvmInline
value class Pret(val suma: Int, val moneda: String)
Corect
KOTLIN
data class Pret(val suma: Int, val moneda: String)

data class acceptă oricâte câmpuri și îți dă equals, toString, copy.

2Constructor gol

Greșit
KOTLIN
@JvmInline
value class Marcaj()
Corect
KOTLIN
object Marcaj

Fără valoare de învelit, nu e nevoie de value class; un object reprezintă o singură instanță.

3Parametru var

Greșit
KOTLIN
@JvmInline
value class Bani(var bani: Long)
Corect
KOTLIN
@JvmInline
value class Bani(val bani: Long)

Value class e imutabilă: parametrul trebuie să fie val (aici mesajul e diferit, dar reparația ține de aceeași regulă).

Repară tu

Repară eroarea, direct în pagină

Programul declară Pret ca value class cu două câmpuri (suma și moneda), iar compilarea se oprește cu Value class must have exactly one primary constructor parameter. Transformă Pret într-o clasă care acceptă ambele câmpuri, ca programul să afișeze 25 lei.

Codul care dă eroarea
KOTLIN
@JvmInline
value class Pret(val suma: Int, val moneda: String)

fun main() {
    val p = Pret(25, "lei")
    println("${p.suma} ${p.moneda}")
}
După reparație, programul afișează
25 lei
Indiciu

Clasa potrivită pentru mai multe câmpuri cu equals și toString generate este data class (fără @JvmInline).

Alte forme ale mesajului

  • error: value class must have exactly one primary constructor parameter.
  • Inline class must have exactly one primary constructor parameter

Cum o eviți pe viitor

Folosește value class doar pentru o singură valoare cu sens propriu (Email, ClientId, Bani). Pentru obiecte cu mai multe câmpuri, pornește de la data class. Dacă ezitați între ele, întreabă-te: obiectul ar putea fi înlocuit de un singur String sau număr? Dacă nu, nu e o value class.

Întrebări frecvente

Vor exista value class cu mai multe câmpuri?

Sunt discutate pentru viitor, dar în versiunea pe care o folosim regula este strictă: exact un parametru în constructorul primar.

Pot avea proprietăți calculate într-o value class?

Da, proprietăți fără câmp de stocare (de exemplu val lei get() = bani / 100) și funcții sunt permise; doar constructorul primar trebuie să aibă exact un parametru.

Erori înrudite

← Toate erorile Kotlin

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Învață Kotlin de la zero, cu exerciții la fiecare lecție

Curs Kotlin (Android): lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.