Bỏ qua đến nội dung chính
Mục lục

@property trong Python: getter và setter

AIDev Team · duyệt: Nguyễn Việt Chung

Bài 1/17 · Chương 15

OOP nâng cao

  • 7 phút
  • Trung cấp
  • Python 3.14
  • Cập nhật

Decorator property trong Python (@property) biến một phương thức thành thuộc tính: nơi gọi viết sp.gia như đọc một biến, còn phía sau là một hàm chạy và có thể kiểm tra giá trị khi gán. Bạn dùng nó khi muốn chặn giá âm của một sản phẩm, hay đọc diện tích hình chữ nhật mà không bắt nơi gọi thêm cặp ngoặc tròn.

Cần biết trước: đóng gói, decorator và raise.

Đọc phương thức như một thuộc tính

Bài đóng gói giữ giá trong thuộc tính nội bộ _gia và cho bên ngoài đọc qua một phương thức. Đặt @property lên phương thức đó thì nơi gọi bỏ được cặp ngoặc tròn. Phương thức này gọi là getter:

python
class SanPham:
    def __init__(self, ten, gia):
        self.ten = ten
        self._gia = gia

    @property
    def gia(self):
        return self._gia

sp = SanPham("cà phê sữa", 29000)
print(sp.gia)
print(sp.gia + 3000)

KẾT QUẢ

29000
32000

sp.gia trông như đọc thuộc tính, nhưng Python gọi phương thức gia() và lấy giá trị nó trả về. @property là một decorator: nó bọc phương thức thành một object property đặt trong class, và object đó quyết định việc gì xảy ra khi bạn đọc sp.gia. Đổi 29000 thành 32000 rồi chạy lại: dòng thứ hai in 35000.

Kiểm tra giá trị khi gán bằng setter

Getter mới cho đọc. Muốn cho gán mà vẫn chặn giá âm, bạn viết thêm một phương thức cùng tên, đặt @gia.setter lên trên. Phương thức này gọi là setter, nhận giá trị ở vế phải của dấu bằng:

python
class SanPham:
    def __init__(self, gia):
        self.gia = gia
    @property
    def gia(self):
        return self._gia
    @gia.setter
    def gia(self, gia_moi):
        if gia_moi < 0:
            raise ValueError("giá không được âm")
        self._gia = gia_moi

sp = SanPham(32000)
sp.gia = 35000
print(sp.gia)

KẾT QUẢ

35000

Dòng sp.gia = 35000 chạy setter với gia_moi là 35000. Setter kiểm trước, đạt thì mới lưu vào _gia. Tên _gia khác tên gia của property, vì nếu setter gán self.gia thì nó lại gọi chính nó. Trong __init__, dòng self.gia = gia cũng đi qua setter, nên một sản phẩm sai giá không tạo ra được:

python
class SanPham:
    def __init__(self, gia):
        self.gia = gia
    @property
    def gia(self):
        return self._gia
    @gia.setter
    def gia(self, gia_moi):
        if gia_moi < 0:
            raise ValueError("giá không được âm")
        self._gia = gia_moi
try:
    sp = SanPham(-5000)
except ValueError as e:
    print("Không tạo được:", e)

KẾT QUẢ

Không tạo được: giá không được âm

Đổi SanPham(-5000) thành SanPham(0) rồi chạy lại: không dòng nào được in, vì giá 0 qua được phép kiểm.

Thuộc tính tính toán chỉ đọc

Diện tích hình chữ nhật không cần lưu: nó suy ra từ chiều dài và chiều rộng. Một property chỉ có getter là thuộc tính tính toán, đọc lúc nào cũng khớp dữ liệu hiện tại:

python
class HinhChuNhat:
    def __init__(self, dai, rong):
        self.dai = dai
        self.rong = rong

    @property
    def dien_tich(self):
        return self.dai * self.rong

hcn = HinhChuNhat(5, 3)
print(hcn.dien_tich)
hcn.dai = 8
print(hcn.dien_tich)

KẾT QUẢ

15
24

Mỗi lần đọc hcn.dien_tich, getter nhân lại hai cạnh, nên sau khi dai đổi thì diện tích đổi theo. Nếu bạn tính diện tích một lần trong __init__ rồi lưu, con số đó sẽ cũ ngay khi một cạnh đổi. Đổi hcn.dai = 8 thành hcn.dai = 10 rồi chạy lại: dòng thứ hai in 30.

Getter và setter cùng tính toán

Setter không bắt buộc lưu đúng giá trị nhận vào. Một nhiệt kế lưu độ C, nhưng cho đọc và gán bằng độ F; setter đổi độ F về độ C rồi mới lưu:

python
class NhietDo:
    def __init__(self, c):
        self.c = c
    @property
    def f(self):
        return self.c * 9 / 5 + 32
    @f.setter
    def f(self, do_f):
        self.c = (do_f - 32) * 5 / 9

phong = NhietDo(25)
print(phong.f)
phong.f = 212
print(phong.c)

KẾT QUẢ

77.0
100.0

Chỉ c được lưu, còn f là một cửa sổ nhìn vào c theo thang đo khác: hai thuộc tính không bao giờ lệch nhau. Đây cũng là lợi ích lớn của property: class có thể bắt đầu bằng thuộc tính thường, rồi đổi sang property khi cần kiểm tra hay tính toán, mà nơi gọi vẫn viết phong.f như cũ. Đổi NhietDo(25) thành NhietDo(30) rồi chạy lại: dòng đầu in 86.0.

Kiểm tra nhanh

  1. Trong khung bẫy đầu tiên, sửa dòng cuối thành print(SanPham().gia). Dòng đó cho kết quả gì?

    • Báo lỗi TypeError, vì thiếu cặp ngoặc tròn
    • In 29000
    • In tên phương thức gia
  2. Với class SanPham có setter kiểm giá ở mục setter, những câu nào đúng?

    • sp.gia = 35000 chạy setter với gia_moi là 35000
    • Gán self._gia = gia trong __init__ vẫn đi qua phép kiểm của setter
    • SanPham(-5000) báo ValueError, vì __init__ gán self.gia
    • Setter phải lưu giá vào self.gia để getter đọc được
  3. Trong ví dụ hình chữ nhật, nếu thêm hcn.rong = 4 ngay sau dòng hcn.dai = 8 thì dòng thứ hai in số nào?

    • 24
    • 20
    • 32
  4. Class HinhVuong ở khung bẫy cuối chỉ có getter dien_tich. Dòng HinhVuong().dien_tich = 20 làm gì?

    • Báo lỗi AttributeError, vì property không có setter
    • Tạo thuộc tính mới dien_tich của object, bằng 20
    • Đổi canh thành căn bậc hai của 20
Đúng hết lần đầu +15 XP

Bài tập

Viết property giá và thành tiền cho sản phẩm

Class SanPham lưu tên, giá và số lượng; __init__ đã viết sẵn và gán giá qua property. Đặt decorator cho ba phương thức rồi viết thân của chúng:

  • getter gia (@property): trả về giá lưu trong thuộc tính nội bộ _gia.

  • setter gia (decorator setter của gia): giá mới nhỏ hơn 0 thì raise một ValueError và giữ nguyên giá cũ; còn lại lưu giá mới vào _gia. Giá 0 hợp lệ.

  • thanh_tien: property chỉ đọc, bằng giá nhân số lượng ở lúc đọc.

Trả về: gia một int, thanh_tien một int.

python
class SanPham:
    def __init__(self, ten, gia, so_luong):
        self.ten = ten
        self.gia = gia
        self.so_luong = so_luong
    # Đặt decorator phù hợp lên ba phương thức dưới đây
    def gia(self):
        pass  # Viết thân các phương thức thay cho các dòng pass
    def gia(self, gia_moi):
        pass
    def thanh_tien(self):
        pass

Tóm tắt

  • @property đặt trên một phương thức biến nó thành getter: nơi gọi đọc sp.gia, không có ngoặc tròn.

  • @gia.setter đặt trên phương thức cùng tên tạo setter, chạy mỗi khi gán sp.gia = ….

  • Setter kiểm giá trị rồi mới lưu vào tên nội bộ như _gia; giá trị sai thì raise ValueError.

  • __init__ gán self.gia để giá lúc tạo object cũng qua setter.

  • Property chỉ có getter là thuộc tính tính toán chỉ đọc; gán vào nó báo AttributeError.

  • Gọi property kèm ngoặc tròn báo TypeError, vì giá trị đọc ra không gọi được.

Câu hỏi thường gặp

Getter và setter trong Python có cần viết cho từng thuộc tính như Java không?

Không cần. Bạn bắt đầu bằng thuộc tính thường như self.ten. Khi một thuộc tính cần kiểm tra hay cần tính, bạn đổi nó sang property, và nơi gọi vẫn viết sp.ten như cũ. Viết sẵn getter, setter không làm gì chỉ thêm code thừa.

Khi nào dùng property, khi nào dùng phương thức thường?

Dùng property khi kết quả trông như một đặc tính của object và đọc nhanh: giá, diện tích, độ F. Việc tốn công hay có tác dụng phụ (gửi đơn, ghi file) nên là phương thức thường có ngoặc tròn, như rut() ở bài đóng gói, để nơi gọi thấy rõ có việc đang chạy.

Vì sao giá trị thật nằm ở _gia chứ không ở gia?

Tên gia đã thuộc về property. Setter gán self.gia = gia_moi sẽ gọi lại chính setter, cứ thế không dừng cho tới khi Python dừng bằng RecursionError. Lưu vào _gia tránh vòng gọi đó, và gạch dưới nói đây là dữ liệu nội bộ, theo quy ước của bài đóng gói.

Có cách nào viết class chỉ chứa dữ liệu ngắn hơn không?

Có: @dataclass tự sinh __init__ từ danh sách trường, xem bài dataclass.

Chủ đề

property python

Bài này có hữu ích?

Hỏi đáp

Đang tải câu hỏi…

Tham vấn chuyên môn

Nguyễn Việt Chung

Nhà sáng lập AIDev và VietPlatform · Thạc sĩ AI MSE

  • Tốt nghiệp thủ khoa xuất sắc Thạc sĩ AI MSE.
  • Đồng sáng lập, CTO E-University, SVOnline: số hóa 10+ đại học, 40.000+ sinh viên.
  • Xây hệ thống AI cho doanh nghiệp tại VietPlatform.
Biên soạn: AIDev Team · Rà soát · Quy trình biên tập