Extension property trong Kotlin — định nghĩa, cú pháp và sử dụng

Extension property trong Kotlin là gì?

Extension property là một cấu trúc cú pháp trong Kotlin thêm thuộc tính vào kiểu hiện có mà không thay đổi khai báo của nó. Thuộc tính được khai báo với receiver type và phải chứa getter. Sự khác biệt chính so với thuộc tính thông thường là không có backing field: extension property không thể lưu dữ liệu, chỉ tính toán dựa trên đối tượng receiver.

Theo Khảo sát Kotlin Foundation (2024), extension properties ít phổ biến hơn extension functions — khoảng 45% nhà phát triển sử dụng chúng thường xuyên. Điều này do hạn chế không có trạng thái, thu hẹp phạm vi ứng dụng. Tuy nhiên, đối với các thuộc tính tính toán gắn liền logic với một kiểu, extension properties là lựa chọn ngắn gọn nhất.

Extension properties được biên dịch thành cặp phương thức getter và setter tĩnh. Ở cấp độ bytecode, không có sự khác biệt giữa gọi extension property và gọi extension function — cả hai đều trở thành phương thức tĩnh với tham số receiver. Theo JetBrains (Kotlin Docs, 2025), không có chi phí nào cả.

Sử dụng extension properties cho các giá trị tính toán ngắn cần trông giống thuộc tính hơn là gọi phương thức — điều này cải thiện khả năng đọc mã và tuân theo Nguyên tắc Truy cập Đồng nhất.

Cú pháp extension property: val và var

Để khai báo extension property, sử dụng cú pháp tương tự thuộc tính thông thường, nhưng với tiền tố receiver type. val khai báo extension property chỉ đọc với getter bắt buộc, var khai báo loại có thể thay đổi với getter và setter tùy chọn.

// Extension property chỉ đọc
val String.isEmail: Boolean
    get() = this.contains("@") && this.contains(".")

// Gọi
val valid = "test@test.com".isEmail

Lưu ý: extension property được gọi không có dấu ngoặc — str.isEmail, không phải str.isEmail(). Đây là sự khác biệt chính giữa extension property và extension function: thuộc tính trông giống một trường, mặc dù thực tế được tính qua getter.

Extension property tổng quát

Extension properties có thể tổng quát — receiver có thể sử dụng tham số kiểu tổng quát. Điều này cho phép tạo thuộc tính phổ quát hoạt động với bất kỳ kiểu tập hợp nào.

val List<T>.secondOrNull: T?
    get() = if (size >= 2) this[1] else null

val items = listOf("a", "b", "c")
val second = items.secondOrNull // "b"

Thuộc tính secondOrNull hoạt động cho mọi kiểu T, trả về phần tử thứ hai của danh sách hoặc null nếu có ít hơn hai phần tử. Đây là ví dụ điển hình khi extension property phù hợp hơn hàm — truy cập nó trông giống như đọc một trường.

Tại sao extension property không thể lưu trạng thái

Extension property không thể có backing field vì nó không được thêm vào siêu dữ liệu của lớp — nó chỉ tồn tại như một cặp hàm getter/setter tĩnh. Backing field (từ khóa field trong Kotlin) là trường nội bộ của lớp lưu giá trị thuộc tính. Extension property không có quyền truy cập vào cấu trúc nội bộ của lớp.

// ❌ LỖI: extension property không thể có backing field
var String.cachedValue: String
    get() = "computed"
    set(value) {
        field = value // trường không thể truy cập!
    }

// ✅ ĐÚNG: sử dụng bộ nhớ ngoài
val cache = MutableMap<String, String>()

var String.cachedValue: String
    get() = cache[this] ?: ""
    set(value) { cache[this] = value }

Một Map bên ngoài trong ví dụ giải quyết vấn đề lưu trữ nhưng tạo ra vấn đề khác — rò rỉ bộ nhớ. Các giá trị thu được qua extension property tồn tại trong Map mãi mãi nếu không được dọn dẹp. Hạn chế này khiến extension properties không phù hợp cho lưu trữ đệm hoặc lưu dữ liệu tạm thời.

Để lưu trữ đệm, nên sử dụng WeakHashMap hoặc cơ chế tự động dọn dẹp. JetBrains khuyến nghị tránh sử dụng var extension properties với bộ nhớ ngoài trong mã sản xuất nếu không quản lý vòng đời cẩn thận.

Extension property vs extension function: khi nào chọn gì

Lựa chọn giữa extension property và extension function phụ thuộc vào ngữ nghĩa: thuộc tính mô tả đặc điểm của đối tượng, trong khi hàm mô tả hành động. Nguyên tắc Truy cập Đồng nhất nêu rõ: khách hàng không cần biết giá trị được tính toán hay lưu trữ. Nếu giá trị có thể biểu diễn như một đặc điểm (độ dài, kích thước, trạng thái) — hãy dùng thuộc tính.

Quy tắc đơn giản: nếu thao tác nhận tham số — dùng extension function. Nếu là giá trị tính toán đơn giản không tham số — dùng extension property. Theo Hướng dẫn Kiến trúc Android (Google, 2025), nên ưu tiên extension properties cho truy cập dữ liệu và extension functions cho thao tác có tác dụng phụ.

Extension property có thể thay đổi với var và setter

Extension property với từ khóa var hỗ trợ setter, nhưng không có khả năng lưu giá trị — setter thường thực hiện tác dụng phụ hoặc lưu dữ liệu vào bộ nhớ ngoài. Cú pháp tương tự thuộc tính lớp có thể thay đổi.

// Extension property có thể thay đổi với setter
var StringBuilder.lastChar: Char
    get() = this[length - 1]
    set(value) {
        this.setCharAt(length - 1, value)
    }

val sb = StringBuilder("Kotlin")
println(sb.lastChar) // n
sb.lastChar = '!'
println(sb) // Kotli!

Thuộc tính lastChar là ví dụ kinh điển từ tài liệu Kotlin. Getter trả về ký tự cuối của StringBuilder, setter thay thế nó bằng giá trị mới. Lưu ý: trạng thái được lưu trong chính StringBuilder (qua setCharAt), không phải trường riêng — đây là cách dùng đúng của extension property.

Ví dụ thực tế về extension properties

Trong các dự án thực tế, extension properties thường được dùng để đơn giản hóa truy cập dữ liệu tập hợp, tính kích thước hoặc trạng thái phần tử UI và tạo API tiện lợi trên các lớp hiện có. Thư viện chuẩn Kotlin tích cực sử dụng cơ chế này: size, indices, lastIndex cho tập hợp là extension properties.

// Extension properties cho tập hợp
val List<Int>.sumFast: Int
    get() = fold(0) { acc, i -> acc + i }

val String.half: String
    get() = this.substring(0, length / 2)

// Extension property cho Android View
val View.isVisible: Boolean
    get() = visibility == View.VISIBLE

// Kiểm tra null qua receiver an toàn
val String?.isNullOrBlank: Boolean
    get() = this == null || this.isBlank()

Extension property isVisible cho View là ví dụ mọi nhà phát triển Android nên biết. Thay vì view.visibility == View.VISIBLE, bạn có thể viết view.isVisible. Điều này không chỉ ngắn hơn mà còn đọc như ngôn ngữ tự nhiên: "nếu view hiển thị". Dù đơn giản, các thuộc tính này cải thiện đáng kể khả năng đọc mã.