泵、阀门、软管,任何持有操作系统资源(比如打开的文件、网络连接)的东西,用完之后都必须释放。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是单资源形式:它把可释放对象压入,供内部引用使用,并在退出时释放。
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:接受一个泵和一个 quotation,把泵压入栈供 quotation 使用,然后在之后释放这个泵,即使 quotation 抛出异常也不例外。
<test-pump> [ drop ] pump-out ! pump released
定义shift-routine:接受两个泵和一个 quotation。打开一个析构作用域,把两个泵都注册为无条件释放,然后调用 quotation。无论 quotation 正常结束还是抛出异常,两个泵最终都会被释放。
quotation 会从栈上接收这两个泵作为输入。
<test-pump> <test-pump> [ 2drop ] shift-routine
! both pumps released
有时泵是借来的,只有在出问题时才想丢弃它,否则下一班的人还需要它保持打开。定义risky-pump-out:接受一个泵和一个 quotation,把泵注册为仅在失败时释放,然后在栈上有这个泵的情况下调用 quotation。
如果 quotation 正常执行完成,泵会保持打开。如果 quotation 抛出异常,泵会被释放,异常也会继续向外传播。
<test-pump> [ drop ] risky-pump-out ! stays open
<test-pump> [ drop "boom" throw ] risky-pump-out ! pump released, throws
最后用一个全新的 disposable 把工具箱补齐:一个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