幫浦、閥門、軟管,任何佔用作業系統資源(開啟的檔案、網路連線)的東西,用完之後都必須被釋放。Factor 的destructors詞彙把這些資源包進一個框架裡,保證一定會清理乾淨,即使程式執行到一半被錯誤打斷也一樣。
類別只要擴充disposable並實作dispose*泛型詞,就能加入這個框架:
USING: accessors destructors kernel ;
TUPLE: pump < disposable opened ;
: <pump> ( -- pump )
pump new-disposable t >>opened ;
M: pump dispose* f >>opened drop ;
new-disposable ( class -- obj )會配置元組,同時把它註冊到框架裡。就算在配置完成之後、下一個安全點之前發生例外,資源也不會外洩。框架保證每個物件的dispose*最多執行一次,重複呼叫dispose不會有任何作用。
dispose
dispose ( obj -- ) ! release; safe to call twice
with-disposal ( disposable quot -- ) ! scope one resource
with-destructors ( quot -- ) ! open a registry scope
&dispose ( obj -- obj ) ! dispose on normal *or* failure exit
|dispose ( obj -- obj ) ! dispose only if the scope unwinds
with-disposal是單一資源的形式:它會把 disposable 推給內部的引述,並在離開時釋放它。
USING: destructors io ;
<pump> [
"pumping" print
] with-disposal
! pump released on the way out — even if `print` had thrown
需要處理多個資源時,就開一個with-destructors作用域,把每一次取得的資源都註冊進去。&dispose(& 符號)表示「離開時一律釋放,不論成功或失敗」;|dispose(| 符號)表示「只在失敗時釋放」,適合成功路徑要把資源交給願意接手的呼叫者時使用。
[
<pump> &dispose
<pump> &dispose
! ... use the pumps ...
] with-destructors
! both pumps released
如果只想要單純的 try/finally 而不需要註冊表,cleanup(位於continuations)是更底層的基本工具,但with-destructors才是現代 Factor 的慣用寫法。
你是沿海貨輪上的水手長。艙底是船體最底層的隔艙,會收集廢水;每到一班,艙底設備都得打開、運轉,然後收納歸位。無論抽水過程中發生什麼事,設備一定得回到收納狀態。
測試會提供<test-pump>讓你取得新的幫浦。每個幫浦都有一個opened>>槽位,開啟時讀值為t,處置後則為f。
定義drain-bilge來釋放單一幫浦。對同一個幫浦呼叫drain-bilge兩次應該不會有任何問題,框架會替你處理。
<test-pump> dup drain-bilge opened>> . ! => f
定義pump-out,讓它接受一個幫浦和一個引述,把幫浦推入堆疊供引述使用,然後在之後釋放幫浦,即使引述拋出例外也一樣。
<test-pump> [ drop ] pump-out ! pump released
定義shift-routine,讓它接受兩個幫浦和一個引述。開啟一個解構子作用域,把兩個幫浦都註冊為無條件釋放,然後呼叫引述。不論引述正常結束還是拋出例外,兩個幫浦最後都會被釋放。
引述會從堆疊接收這兩個幫浦作為輸入。
<test-pump> <test-pump> [ 2drop ] shift-routine
! both pumps released
有時候幫浦是借來的,只有在出錯時你才想丟棄它,否則下一班值班人員需要它保持開啟。定義risky-pump-out,讓它接受一個幫浦和一個引述,把幫浦註冊為僅在失敗時釋放,並帶著堆疊上的幫浦呼叫引述。
如果引述成功,幫浦會保持開啟。如果引述拋出例外,幫浦會被釋放,例外則會繼續向外傳播。
<test-pump> [ drop ] risky-pump-out ! stays open
<test-pump> [ drop "boom" throw ] risky-pump-out ! pump released, throws
用一個全新的可處置物件,也就是valve,來補齊工具組。元組已經替你宣告好了:
TUPLE: valve < disposable is-open ;
<valve> ( -- valve ),透過new-disposable建構一個全新的閥,並把is-open設為t。M: valve dispose*,把is-open切換成f。<valve> is-open>> . ! => t
<valve> dup dispose is-open>> . ! => f