ポンプ、バルブ、ホース。オペレーティングシステムのリソース(開いているファイルやネットワーク接続など)を握るものは、使い終わったら解放しなければなりません。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*がオブジェクトごとに最大1回だけ実行されることを保証します。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はリソース1つ用の形です。内側のクォーテーションのためにdisposableを積み、終了時に解放します。
USING: destructors io ;
<pump> [
"pumping" print
] with-disposal
! pump released on the way out — even if `print` had thrown
リソースが2つ以上あるときは、with-destructorsのスコープを開き、リソースを確保するたびに登録します。&dispose(アンパサンド)は「成功しても失敗しても、終了時に必ず解放する」という意味です。|dispose(パイプ)は「失敗したときにだけ解放する」という意味で、成功したときは所有権を引き継ぐ呼び出し側にリソースを渡したい、という場合に便利です。
[
<pump> &dispose
<pump> &dispose
! ... use the pumps ...
] with-destructors
! both pumps released
レジストリを使わずにtry/finallyだけを行うなら、cleanup(continuationsにあります)がより低レベルな基本操作です。ただし、現代のFactorで慣用的なのはwith-destructorsです。
あなたは沿岸貨物船でボースンを務めています。ビルジ、つまり船体で最も低い区画には廃水がたまります。そして毎シフト、ビルジ用の装備を開けて動かし、最後は片づけなければなりません。ポンプ作業の途中で何が起ころうと、装備は必ず元の収納状態に戻らなければなりません。
テストからは、新品のポンプを取得するための<test-pump>が与えられます。各ポンプにはopened>>というスロットがあり、開いている間はt、処分が済むとfになります。
drain-bilgeを定義し、ポンプを1つ解放します。同じポンプに対してdrain-bilgeを2回呼び出しても問題ありません。そのあたりはフレームワークが処理してくれます。
<test-pump> dup drain-bilge opened>> . ! => f
pump-outを定義します。ポンプとクォーテーションを受け取り、クォーテーションが使えるようにポンプをスタックに積み、そのあとでポンプを解放します。クォーテーションが例外を投げた場合でも、必ず解放します。
<test-pump> [ drop ] pump-out ! pump released
shift-routineを定義します。2つのポンプとクォーテーションを受け取り、デストラクタースコープを開き、両方のポンプを無条件解放として登録してから、クォーテーションを呼び出します。クォーテーションが正常に終わっても例外を投げても、どちらのポンプも解放されます。
クォーテーションは、スタックに積まれた2つのポンプを入力として受け取ります。
<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