Bombas, válvulas, mangueiras: tudo o que retém um recurso do sistema operativo (um ficheiro aberto, uma ligação de rede) tem de ser libertado quando já não precisas dele. O vocabulário destructors do Factor envolve tudo isto num framework que garante a limpeza, mesmo quando um erro interrompe o teu código a meio.
Uma classe passa a fazer parte do framework ao estender disposable e implementar o genérico 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 ) aloca o tuplo e regista-o no framework: uma exceção entre a alocação e o ponto seguro seguinte não deixa escapar o recurso. O framework garante que dispose* corre no máximo uma vez por objeto; chamadas repetidas a dispose não fazem nada.
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 é a forma para um único recurso: coloca na pilha o disposable para a citação interior e liberta-o à saída.
USING: destructors io ;
<pump> [
"pumping" print
] with-disposal
! pump released on the way out — even if `print` had thrown
Para mais do que um recurso, abre um âmbito de registo com with-destructors e regista cada aquisição. &dispose (e comercial) significa "liberta sempre à saída, tanto no sucesso como no erro". |dispose (barra vertical) significa "liberta apenas em caso de erro"; é útil quando o caminho de sucesso entrega o recurso a quem chama e que passa a ser responsável por ele.
[
<pump> &dispose
<pump> &dispose
! ... use the pumps ...
] with-destructors
! both pumps released
Para um simples try/finally sem registo, cleanup (em continuations) é a primitiva de nível mais baixo, mas with-destructors é o Factor moderno e idiomático.
És o contramestre de um cargueiro costeiro. O porão, o compartimento mais baixo do casco, recolhe águas residuais, e em cada turno o equipamento do porão tem de ser aberto, posto a funcionar e guardado. Aconteça o que acontecer durante a bombagem, o equipamento tem de voltar ao seu estado guardado.
Os testes dão-te <test-pump> para adquirires bombas novas. Cada bomba tem uma fenda opened>> que lê t enquanto está aberta e f depois de ser descartada.
Define drain-bilge para libertar uma única bomba. Chamar drain-bilge duas vezes à mesma bomba não deve fazer mal: o framework trata disso por ti.
<test-pump> dup drain-bilge opened>> . ! => f
Define pump-out para receber uma bomba e uma quotation, colocar a bomba na pilha para a quotation usar e libertar a bomba depois, mesmo que a quotation lance uma exceção.
<test-pump> [ drop ] pump-out ! pump released
Define shift-routine para receber duas bombas e uma quotation. Abre um âmbito de destruidores, regista as duas bombas para libertação incondicional e depois chama a quotation. As duas bombas acabam por ser libertadas, quer a quotation termine normalmente, quer lance uma exceção.
A quotation recebe as duas bombas na pilha como valores de entrada.
<test-pump> <test-pump> [ 2drop ] shift-routine
! both pumps released
Às vezes uma bomba está emprestada: só a queres descartar se algo correr mal, caso contrário o próximo turno precisa que ela fique aberta. Define risky-pump-out para receber uma bomba e uma quotation, registar a bomba para libertação apenas em caso de falha e chamar a quotation com a bomba na pilha.
Se a quotation tiver sucesso, a bomba fica aberta. Se a quotation lançar uma exceção, a bomba é libertada e a exceção propaga-se.
<test-pump> [ drop ] risky-pump-out ! stays open
<test-pump> [ drop "boom" throw ] risky-pump-out ! pump released, throws
Completa o conjunto de ferramentas com um disposable novinho em folha: uma valve. A tupla já está declarada para ti:
TUPLE: valve < disposable is-open ;
<valve> ( -- valve ) para construir uma válvula nova através de new-disposable, com is-open definido como t.M: valve dispose* para alterar is-open para f.<valve> is-open>> . ! => t
<valve> dup dispose is-open>> . ! => f
Inscreve-te no Exercism para aprenderes e dominares Factor com 47 conceitos163 exercícios, e mentoria humana real, tudo grátis.