1. 建立映射類的執行個體(Instance)
前面介紹了如何將資料庫實體表映射到Python類上,下面我們可以建立這個類的一個執行個體(Instance),我們還是以前一篇文章的User類為例,讓我們建立User對象:
複製代碼 代碼如下:
>>> ed_user = User('ed', 'Ed Jones', 'edspassword')
>>> ed_user.name
'ed'
>>> ed_user.password
'edspassword'
>>> str(ed_user.id)
'None'
和普通的Python類一樣執行個體化,大家可能會問為什麼ed_user.id會是None值,首先id這個屬性沒有通過__init__()構造方法初始化,所以預設會因為先前定義的ORM的id列(Column)而產生一個None值,在預設情況下,ORM會為所有被映射的表列建立類屬性,這些屬性是通過Python語言中描述符(Descriptors)機制來實現的。所以這些屬性的使用會包含一些額外的行為,包括跟蹤修改,或者當需要時自動從資料庫載入新的資料,也就是說我們在使用這些屬性時,包括修改或者讀取,都會觸發ORM內部的一系列動作。
等等,你還沒有說明白為什麼id這個屬性會為None值呢。呵呵,其實我們現在並沒有將資料插入資料庫,一般主鍵這個屬性會在插入資料庫時自動產生一個不重複的值以保證唯一性。由於我們沒有對對象實行持久化(Persist) (所謂的持久化就是把對象資料按照映射關係儲存入資料庫裡) 所以這裡id值為None。別著急,稍後當我們介紹將資料持久化後你就可以看到一個新的自動產生的id了。
接下來小偷懶一下,介紹一個偷懶的技巧:-)
假如我們不定義映射類的構造方法__init__()會帶來什麼不良影響嗎?完全不會,SQLAlchemy為我們考慮到這點,假如我們偷懶將先前的User類定義成這樣:
複製代碼 代碼如下:
class User(Base):
__tablename__ = 'users'
id = Column(Integer, primary_key=True)
name = Column(String)
fullname = Column(String)
password = Column(String)
由於User繼承自Base (Base定義見上一篇文章),所以受到Declarative系統的管理,Declarative系統發現這個類缺少構造方法,於是很友善的給我們補上了一個構造方法,當然其提供的構造方法則不能像我們自己定義的構造方法那樣使用基於位置的參數訪問,建議使用基於鍵的參數訪問方式,包括我們所有用Column定義映射的列,比如如下方式:
複製代碼 代碼如下:
u1 = User(name='ed', fullname='Ed Jones', password='foobar')
id也可以傳入,通常意義上這類主鍵由系統自動維護,我們無需為其賦值。
2. 建立並使用會話(Session)
到這裡可謂是“萬事俱備,只欠東風了”,用官方文檔的話說“我們現在已經準備好和資料庫‘交談'了” (We're now ready to start talking to the database)。ORM的操作控制代碼(Handle)被稱為會話(Session)。為了使用會話,我們需要先配置它,配置Session的代碼語句應該和create_engine()建立引擎的代碼語句在一個代碼層級上(放在一起就行了)。
比如我們利用create_engine()先建立起引擎名字為engine(關於引擎的建立代碼可以參考我第一篇文章),然後利用sessionmaker()工廠函數建立起Session類,同時綁定我們現有的引擎,比如代碼如下:
複製代碼 代碼如下:
>>> from sqlalchemy.orm import sessionmaker
>>> Session = sessionmaker(bind=engine)
假如我們建立Session的代碼與建立引擎的代碼不在一個層級上呢,比如先sessionmaker()一個Session類,然後才用create_engine()建立了引擎,那麼我們還有機會將Session和引擎綁定到一起嗎?當然可以,我們可以利用Session類的configure方法來配置引擎綁定,比如這樣的:
複製代碼 代碼如下:
Session = sessionmaker()
# engine = create_engine(...) 建立引擎
Session.configure(bind=engine) # 到這裡engine應該已經建立
到這裡通過sessionmaker()工廠創造出的Session類應該綁定了我們先前建立的Engine了,但是會話還沒有真正開始,要開始會話我們需要執行個體化這個Session類:
複製代碼 代碼如下:
>>> session = Session()
到這裡session就擷取了由Engine維護的資料庫連接池,並且會維持記憶體中的映射資料直到提交(commit)更改或者關閉會話對象。
到這裡會話的建立就講解完了,接下來會講解真正的ORM資料庫查詢部分,歡迎關注!