Треки
/
Factor
Factor
/
Вправи
/
Трюм боцмана
Трюм боцмана

Трюм боцмана

Навчальна вправа

Вступ

Насоси, клапани, шланги: усе, що утримує ресурс операційної системи (відкритий файл, мережеве зʼєднання), потрібно звільнити, коли ми закінчили з ним працювати. Словник destructors у Factor обгортає їх у фреймворк, який гарантує прибирання, навіть коли помилка перериває наш код десь посередині.

Клас і дженерик

Клас долучається до фреймворку, успадковуючи 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 - форма для одного ресурсу: він додає до стека обʼєкт, який слід звільнити, для внутрішньої quotation і звільняє його на виході.

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, коли його звільнено.

1. Осушити трюм

Визначте drain-bilge, щоб звільняти один насос. Виклик drain-bilge для того самого насоса двічі має бути нешкідливим, адже про це подбає фреймворк.

<test-pump> dup drain-bilge opened>> .   ! => f

2. Процедура відкачування

Визначте pump-out, який приймає насос і quotation, кладе насос у стек, щоб quotation ним скористався, і після цього звільняє насос, навіть якщо quotation викине виняток.

<test-pump> [ drop ] pump-out   ! pump released

3. Процедура на цілу зміну

Визначте shift-routine, який приймає два насоси і quotation. Відкрийте область видимості деструкторів, зареєструйте обидва насоси для безумовного звільнення, а тоді викличте quotation. Обидва насоси виявляться звільненими незалежно від того, чи quotation завершиться нормально, чи викине виняток.

На вхід quotation отримує обидва насоси у стеку.

<test-pump> <test-pump> [ 2drop ] shift-routine
! both pumps released

4. Ризиковане відкачування

Іноді насос позичений: звільняти його хочеться лише тоді, коли щось піде не так, бо інакше наступній вахті він потрібен відкритим. Визначте 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

5. Власний disposable: клапан

Доповніть набір інструментів зовсім новим 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
Редагувати через GitHub Посилання відкривається в новому вікні або вкладці
Factor Exercism

Час розпочати Трюм боцмана?

Зареєструйтеся на Exercism, щоб вивчати й опановувати Factor, а також 47 концепцій163 вправи та справжнє наставництво від людей, і все це безкоштовно.