Percursos
/
Factor
Factor
/
Exercícios
/
Porão do Contramestre
Porão do Contramestre

Porão do Contramestre

Exercício de aprendizagem

Introdução

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.

A classe e o genérico

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.

A interface pública usa 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.

Instruções

É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.

1. Drenar o porão

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

2. Rotina de bombagem

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

3. Rotina de turno completo

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

4. Bombagem arriscada

À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

5. Um disposable personalizado: a válvula

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 ;
  • Define <valve> ( -- valve ) para construir uma válvula nova através de new-disposable, com is-open definido como t.
  • Implementa M: valve dispose* para alterar is-open para f.
<valve> is-open>> .                ! => t
<valve> dup dispose is-open>> .    ! => f
Editar via GitHub A ligação abre numa nova janela ou separador
Factor Exercism

Estás pronto para começar Porão do Contramestre?

Inscreve-te no Exercism para aprenderes e dominares Factor com 47 conceitos163 exercícios, e mentoria humana real, tudo grátis.