Value class must have exactly one primary constructor parameter
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
@JvmInline
value class Pret(val suma: Int, val moneda: String)data class Pret(val suma: Int, val moneda: String)data class acceptă oricâte câmpuri și îți dă equals, toString, copy.
2Constructor gol
@JvmInline
value class Marcaj()object MarcajFără valoare de învelit, nu e nevoie de value class; un object reprezintă o singură instanță.
3Parametru var
@JvmInline
value class Bani(var bani: Long)@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ă 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.
@JvmInline
value class Pret(val suma: Int, val moneda: String)
fun main() {
val p = Pret(25, "lei")
println("${p.suma} ${p.moneda}")
}25 lei
Indiciu
Clasa potrivită pentru mai multe câmpuri cu equals și toString generate este data class (fără @JvmInline).
Reparația
data class Pret(val suma: Int, val moneda: String)
fun main() {
val p = Pret(25, "lei")
println("${p.suma} ${p.moneda}")
}De ce merge
O value class poate învelui o singură valoare, pentru că la rulare obiectul e înlocuit chiar cu acea valoare. Cu două câmpuri, nu mai există o singură valoare care să-l înlocuiască. data class Pret(val suma: Int, val moneda: String) păstrează ambele câmpuri și îți generează equals, hashCode, toString și copy. Adnotarea @JvmInline se șterge, pentru că e doar pentru value class.
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
Value classes without '@JvmInline' annotation are not yet supported Ai declarat o value class fără adnotarea @JvmInline. Pe JVM (Kotlin pentru server, Android, desktop), o value class trebuie scrisă cu @JvmInline pe rândul de deasupra: @JvmInline value class Email(val adresa: String). Data class must have at least one primary constructor parameter Ai declarat data class fără parametri în constructor (data class Gol() sau data class Setari { ... }). O data class există ca să țină date, deci are nevoie de cel puțin un val/var în paranteze. Adaugă proprietățile în constructor sau, pentru o singură instanță fără date, folosește object (data object în Kotlin 1.9+). Primary constructor of data class must only have property ('val' / 'var') parameters Un parametru din constructorul data class nu are val sau var în față (data class Produs(nume: String)). Toți parametrii unei data class trebuie să fie proprietăți: scrie val nume: String. Dacă o valoare e doar de calcul, mut-o într-un constructor secundar sau într-o funcție fabrică. Î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.
