哪种UML类图能更精准表示Kotlin类的属性？

待建模的Kotlin类代码 #

class Student(val name: String, var address: String) {

    private var numCourses: Int = 0

    private val courses: Array<String> = Array(MAX_COURSES) { "" }

    private val grades: IntArray = IntArray(MAX_COURSES)
    companion object {
        const val MAX_COURSES = 30
    }

    fun printGrades() {
        print(name)
        for (i in 0 until numCourses) {
            print(" ${courses[i]}:${grades[i]}, ")
        }
        println()
    }

    fun calculateAverageGrade() = grades.sum().toDouble() / grades.size

    fun addCourseGrade(course: String, grade: Int) {

        require(numCourses < MAX_COURSES) {
            "A student cannot take more than $MAX_COURSES courses"
        }

        require(grade in 0..100) {
            "Grade must be between 0 and 100"
        }

        courses[numCourses] = course
        grades[numCourses] = grade
        numCourses++
    }

    override fun toString() = "name($address)"

}

两种方案分析 #

方案1：显式标注getter/setter，所有属性设为私有

这种方案会把每个公开属性拆分为私有字段和对应的公开访问器方法，比如把val name拆成私有- name: String和公开+ getName(): String，var address拆成私有- address: String、+ getAddress(): String和+ setAddress(address: String): Unit。

缺点在于：Kotlin的属性语法本身就封装了字段与访问器的逻辑，显式拆分后会让UML图冗余复杂，无法体现Kotlin语言的特性，反而把简洁的属性定义拆成多个元素，增加理解成本。

方案2：使用UML标记（{readOnly}、<<get/set>>）

这种方案贴合Kotlin的属性设计语义，建模方式如下：

• 公开只读属性name：标记为 + name: String {readOnly}，明确表示该属性仅对外提供读取权限
• 公开读写属性address：标记为 + address: String <<get/set>>，表示同时提供读、写访问器
• 私有内部属性numCourses、courses、grades：直接标记为 - numCourses: Int、- courses: Array<String>、- grades: IntArray，因为它们仅用于类内部逻辑，对外无访问入口
• 伴生对象常量MAX_COURSES：标记为 + MAX_COURSES: Int <<static>> {final}，体现其静态常量的特性

优势在于：既精准反映了Kotlin属性的访问规则与特性，又保持了UML图的简洁性，无需冗余的显式访问器方法，符合面向对象建模“聚焦核心语义”的原则。

结论 #

方案2更适配该Kotlin类的UML建模需求，它能直接对应Kotlin的语法特性，同时让UML图清晰易懂，避免不必要的信息冗余。

内容的提问来源于stack exchange，提问作者Ali Dehkhodaei