一文詳述 Python 中的 property 語(yǔ)法

更新時(shí)間：2020年09月01日 09:24:26 作者：小名叫小明

這篇文章主要介紹了一文詳述 Python 中的 property 語(yǔ)法,本文給大家介紹的非常詳細(xì)，對(duì)大家的學(xué)習(xí)或工作具有一定的參考借鑒價(jià)值，需要的朋友可以參考下

property() 函數(shù)的作用是在新式類(lèi)中返回屬性值。

Python中有一個(gè)property的語(yǔ)法，它類(lèi)似于C#的get set語(yǔ)法，其功能有以下兩點(diǎn)：

將類(lèi)方法設(shè)置為只讀屬性；
實(shí)現(xiàn)屬性的getter和setter方法；

下面開(kāi)始本文的重點(diǎn)介紹，Python 中的 property 語(yǔ)法介紹，具體內(nèi)容如下所示：

在大多數(shù)語(yǔ)言的程序中，一個(gè)類(lèi)，每有一個(gè)屬性，就會(huì)對(duì)應(yīng) setter 和 getter，基本都是標(biāo)配。

示例：

class Money(object):
  def __init__(self):
    self.__money = 0

  def getMoney(self):
    return self.__money

  def setMoney(self, value):
    if isinstance(value, int):
      self.__money = value
    else:
      print("error:不是整型數(shù)字")

設(shè)置私有屬性的目的就是不想讓數(shù)據(jù)被誤取出來(lái)，增加一個(gè)方法去獲取私有屬性或者設(shè)置私有屬性，那么就保證將來(lái)想獲取屬性的時(shí)候就獲取，想設(shè)置的時(shí)候還可以進(jìn)行過(guò)濾。

其他語(yǔ)言基本都是這么做的，但是 Python 不推薦。 Python 有 property。

一、什么是property屬性

一種用起來(lái)像是使用的實(shí)例屬性一樣的特殊屬性，可以對(duì)應(yīng)于某個(gè)方法。

class Foo:
  def func(self):
    pass

  # 定義property屬性
  @property
  def prop(self):
    pass

foo_obj = Foo()
foo_obj.func() # 調(diào)用實(shí)例方法
foo_obj.prop # 調(diào)用property屬性

示例：

class Goods:
  @property
  def size(self):
    return 100

obj = Goods()
ret = obj.size # 調(diào)用屬性
print(ret) # 100

obj.size 會(huì)自動(dòng)地去調(diào)用 size 方法，返回 size 方法的返回值。

property屬性的定義和調(diào)用要注意以下幾點(diǎn)：

定義時(shí)，在實(shí)例方法的基礎(chǔ)上添加 @property 裝飾器；
僅有一個(gè)self參數(shù)；
調(diào)用時(shí)，無(wú)需括號(hào)。

那 property 屬性到底是用來(lái)干什么的？下面看一個(gè)實(shí)例。

對(duì)于京東商城中顯示電腦主機(jī)的列表頁(yè)面，每次請(qǐng)求不可能把數(shù)據(jù)庫(kù)中的所有內(nèi)容都顯示到頁(yè)面上，而是通過(guò)分頁(yè)的功能局部顯示，所以在向數(shù)據(jù)庫(kù)中請(qǐng)求數(shù)據(jù)時(shí)就要顯示的指定獲取從第m條到第n條的所有數(shù)據(jù)，這個(gè)分頁(yè)的功能包括：

根據(jù)用戶(hù)請(qǐng)求的當(dāng)前頁(yè)和總數(shù)據(jù)條數(shù)計(jì)算出 m 和 n。
根據(jù)m 和 n 去數(shù)據(jù)庫(kù)中請(qǐng)求數(shù)據(jù)。

class Pager:
  def __init__(self, current_page):
    # 用戶(hù)當(dāng)前請(qǐng)求的頁(yè)碼（第一頁(yè)、第二頁(yè)...）
    self.current_page = current_page
    # 每頁(yè)默認(rèn)顯示10條數(shù)據(jù)
    self.per_items = 10

  @property
  def start(self):
    val = (self.current_page - 1) * self.per_items
    return val

  @property
  def end(self):
    val = self.current_page * self.per_items
    return val

p = Pager(1)
p.start # 就是起始值，即：m
p.end # 就是結(jié)束值，即：n

從上述可見(jiàn)，Python 的 property 屬性的功能是：property屬性?xún)?nèi)部進(jìn)行一系列的邏輯計(jì)算，最終將計(jì)算結(jié)果返回。

二、property屬性的有兩種方式

裝飾器即：在方法上應(yīng)用裝飾器。
類(lèi)屬性即：在類(lèi)中定義值為 property 對(duì)象的類(lèi)屬性。

1、裝飾器方式

在類(lèi)的實(shí)例方法上應(yīng)用 @property 裝飾器。

Python中的類(lèi)有經(jīng)典類(lèi)和新式類(lèi)，新式類(lèi)的屬性比經(jīng)典類(lèi)的屬性豐富。（如果類(lèi)繼object，那么該類(lèi)是新式類(lèi) ）

經(jīng)典類(lèi)，具有一種 @property 裝飾器。

class Goods:
  @property
  def price(self):
    return "laowang"

obj = Goods()
# 自動(dòng)執(zhí)行 @property 修飾的 price 方法，并獲取方法的返回值
result = obj.price 
print(result) # laowang

新式類(lèi)，具有三種@property裝飾器。

python3 中默認(rèn)繼承object類(lèi)，只有在 python3 中才有@xxx.setter @xxx.deleter。

class Goods:
  
  @property
  def price(self):
    print('@property')

  @price.setter
  def price(self, value):
    print('@price.setter')

  @price.deleter
  def price(self):
    print('@price.deleter')

obj = Goods()
# 自動(dòng)執(zhí)行 @property 修飾的 price 方法，并獲取方法的返回值
obj.price # @property
# 自動(dòng)執(zhí)行 @price.setter 修飾的 price 方法，并將 123 賦值給方法的參數(shù)
obj.price = 123 # @price.setter
# 自動(dòng)執(zhí)行 @price.deleter 修飾的 price 方法
del obj.price # @price.deleter

注意：

經(jīng)典類(lèi)中的屬性只有一種訪問(wèn)方式，其對(duì)應(yīng)被 @property 修飾的方法。
新式類(lèi)中的屬性有三種訪問(wèn)方式，并分別對(duì)應(yīng)了三個(gè)被@property、@方法名.setter、@方法名.deleter修飾的方法。

由于新式類(lèi)中具有三種訪問(wèn)方式，我們可以根據(jù)它們幾個(gè)屬性的訪問(wèn)特點(diǎn)，分別將三個(gè)方法定義為對(duì)同一個(gè)屬性：獲取、修改、刪除。

示例：

class Goods(object):

  def __init__(self):
    # 原價(jià)
    self.original_price = 100
    # 折扣
    self.discount = 0.8

  @property
  def price(self):
    # 實(shí)際價(jià)格 = 原價(jià) * 折扣
    new_price = self.original_price * self.discount
    return new_price

  @price.setter
  def price(self, value):
    self.original_price = value

  @price.deleter
  def price(self):
    del self.original_price

obj = Goods()
obj.price     # 獲取商品價(jià)格
obj.price = 200  # 修改商品原價(jià)
del obj.price   # 刪除商品原價(jià)

2、類(lèi)屬性方式

創(chuàng)建值為 property 對(duì)象的類(lèi)屬性。

當(dāng)使用類(lèi)屬性的方式創(chuàng)建property屬性時(shí)，經(jīng)典類(lèi)和新式類(lèi)無(wú)區(qū)別。

示例：

class Foo:
  def get_bar(self):
    return 'laowang'

  BAR = property(get_bar)

obj = Foo()
reuslt = obj.BAR # 自動(dòng)調(diào)用get_bar方法，并獲取方法的返回值
print(reuslt) # laowang

property方法中有個(gè)四個(gè)參數(shù)

第一個(gè)參數(shù)是方法名，調(diào)用對(duì)象.屬性時(shí)自動(dòng)觸發(fā)執(zhí)行方法。
第二個(gè)參數(shù)是方法名，調(diào)用對(duì)象.屬性＝ XXX 時(shí)自動(dòng)觸發(fā)執(zhí)行方法。
第三個(gè)參數(shù)是方法名，調(diào)用 del 對(duì)象.屬性時(shí)自動(dòng)觸發(fā)執(zhí)行方法。第四個(gè)參數(shù)是字符串，調(diào)用對(duì)象.屬性.__doc__ ，此參數(shù)是該屬性的描述信息。

示例：

class Foo(object):
  def get_bar(self):
    print("getter...")
    return 'laowang'

  def set_bar(self, value):
    """必須兩個(gè)參數(shù)"""
    print("setter...")
    return 'set value' + value

  def del_bar(self):
    print("deleter...")
    return 'laowang'

  BAR = property(get_bar, set_bar, del_bar, "description...")

obj = Foo()
# 自動(dòng)調(diào)用第一個(gè)參數(shù)中定義的方法：get_bar
obj.BAR # getter...
# 自動(dòng)調(diào)用第二個(gè)參數(shù)中定義的方法：set_bar方法，并將“alex”當(dāng)作參數(shù)傳入
obj.BAR = "alex" # setter...
# 自動(dòng)獲取第四個(gè)參數(shù)中設(shè)置的值：description...
desc = Foo.BAR.__doc__
print(desc) # description...
# 自動(dòng)調(diào)用第三個(gè)參數(shù)中定義的方法：del_bar方法
del obj.BAR # deleter...

由于類(lèi)屬性方式創(chuàng)建 property 屬性具有3種訪問(wèn)方式，我們可以根據(jù)它們幾個(gè)屬性的訪問(wèn)特點(diǎn)，分別將三個(gè)方法定義為對(duì)同一個(gè)屬性：獲取、修改、刪除。

class Goods(object):

  def __init__(self):
    # 原價(jià)
    self.original_price = 100
    # 折扣
    self.discount = 0.8

  def get_price(self):
    # 實(shí)際價(jià)格 = 原價(jià) * 折扣
    new_price = self.original_price * self.discount
    return new_price

  def set_price(self, value):
    self.original_price = value

  def del_price(self):
    del self.original_price

  PRICE = property(get_price, set_price, del_price, '價(jià)格屬性描述...')

obj = Goods()
obj.PRICE     # 獲取商品價(jià)格
obj.PRICE = 200  # 修改商品原價(jià)
del obj.PRICE   # 刪除商品原價(jià)

綜上所述: