Files
ProcessControl/_book/fr/02-part-ii-processes.html
T

1224 lines
56 KiB
HTML
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
<!DOCTYPE html>
<html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr"><head>
<meta charset="utf-8">
<meta name="generator" content="quarto-1.10.18">
<meta name="viewport" content="width=device-width, initial-scale=1.0, user-scalable=yes">
<title>3&nbsp; Partie II — Franchir la frontière de processus – Contrôle de processus</title>
<style>
/* Default styles provided by pandoc.
** See https://pandoc.org/MANUAL.html#variables-for-html for config info.
*/
span.smallcaps{font-variant: small-caps;}
div.columns{display: flex; gap: 1.5em;}
div.column{flex: auto;}
@media screen {
div.columns{gap: min(4vw, 1.5em);}
div.column{overflow-x: auto;}
}
div.hanging-indent{margin-left: 1.5em; text-indent: -1.5em;}
ul.task-list{list-style: none;}
ul.task-list li input[type="checkbox"] {
width: 0.8em;
margin: 0 0.8em 0.2em -1em; /* quarto-specific, see https://github.com/quarto-dev/quarto-cli/issues/4556 */
vertical-align: middle;
}
/* CSS for syntax highlighting */
html { -webkit-text-size-adjust: 100%; }
pre > code.sourceCode { white-space: pre; position: relative; }
pre > code.sourceCode > span { display: inline-block; line-height: 1.25; }
pre > code.sourceCode > span:empty { height: 1.2em; }
.sourceCode { overflow: visible; }
code.sourceCode > span { color: inherit; text-decoration: inherit; }
div.sourceCode { margin: 1em 0; }
pre.sourceCode { margin: 0; }
@media screen {
div.sourceCode { overflow: auto; }
}
@media print {
pre > code.sourceCode { white-space: pre-wrap; }
pre > code.sourceCode > span { text-indent: -5em; padding-left: 5em; }
}
pre.numberSource code
{ counter-reset: source-line 0; }
pre.numberSource code > span
{ position: relative; left: -4em; counter-increment: source-line; }
pre.numberSource code > span > a:first-child::before
{ content: counter(source-line);
position: relative; left: -1em; text-align: right; vertical-align: baseline;
border: none; display: inline-block;
-webkit-touch-callout: none; -webkit-user-select: none;
-khtml-user-select: none; -moz-user-select: none;
-ms-user-select: none; user-select: none;
padding: 0 4px; width: 4em;
}
pre.numberSource { margin-left: 3em; padding-left: 4px; }
div.sourceCode
{ }
@media screen {
pre > code.sourceCode > span > a:first-child::before { text-decoration: underline; }
}
</style>
<script src="site_libs/quarto-nav/quarto-nav.js"></script>
<script src="site_libs/quarto-nav/headroom.min.js"></script>
<script src="site_libs/clipboard/clipboard.min.js"></script>
<script src="site_libs/quarto-search/autocomplete.umd.js"></script>
<script src="site_libs/quarto-search/fuse.min.js"></script>
<script src="site_libs/quarto-search/quarto-search.js"></script>
<meta name="quarto:offset" content="./">
<link href="./glossary.html" rel="next">
<link href="./01-part-i-calls.html" rel="prev">
<script src="site_libs/quarto-html/quarto.js" type="module"></script>
<script src="site_libs/quarto-html/tabsets/tabsets.js" type="module"></script>
<script src="site_libs/quarto-html/popper.min.js"></script>
<script src="site_libs/quarto-html/tippy.umd.min.js"></script>
<script src="site_libs/quarto-html/anchor.min.js"></script>
<link href="site_libs/quarto-html/tippy.css" rel="stylesheet">
<link href="site_libs/quarto-html/quarto-syntax-highlighting-7c68a30ea258f1cbeb56603bc0a48370.css" rel="stylesheet" id="quarto-text-highlighting-styles">
<script src="site_libs/bootstrap/bootstrap.min.js"></script>
<link href="site_libs/bootstrap/bootstrap-icons.css" rel="stylesheet">
<link href="site_libs/bootstrap/bootstrap-cfe7114cbc4adb2af5ff3a891545d7fa.min.css" rel="stylesheet" append-hash="true" id="quarto-bootstrap" data-mode="light">
<script src="site_libs/quarto-contrib/calc-exo-2.0.0/exo.js"></script>
<link href="site_libs/quarto-contrib/calc-exo-2.0.0/exo.css" rel="stylesheet">
<script src="site_libs/quarto-contrib/calc-quiz-1.0.0/quiz.js"></script>
<link href="site_libs/quarto-contrib/calc-quiz-1.0.0/quiz.css" rel="stylesheet">
<link href="site_libs/quarto-contrib/calc-further-1.0.0/further.css" rel="stylesheet">
<link href="site_libs/quarto-contrib/calc-latex-tables-1.0.0/latex-tables.css" rel="stylesheet">
<script src="site_libs/quarto-contrib/calc-notes-1.0.0/calc-notes.js"></script>
<link href="site_libs/quarto-contrib/calc-notes-1.0.0/theme.css" rel="stylesheet">
<link href="site_libs/quarto-contrib/calc-notes-1.0.0/high-contrast.css" rel="stylesheet">
<link href="site_libs/quarto-contrib/calc-notes-1.0.0/calc-notes.css" rel="stylesheet">
<link href="site_libs/quarto-contrib/calc-notes-1.0.0/narrow.css" rel="stylesheet">
<script src="site_libs/quarto-contrib/calc-glossary-2.0.0/glossary.js"></script>
<link href="site_libs/quarto-contrib/calc-glossary-2.0.0/glossary.css" rel="stylesheet">
<script id="quarto-search-options" type="application/json">{
"location": "sidebar",
"copy-button": false,
"collapse-after": 3,
"panel-placement": "start",
"type": "textbox",
"limit": 50,
"keyboard-shortcut": [
"f",
"/",
"s"
],
"show-item-context": false,
"language": {
"search-no-results-text": "Pas de résultats",
"search-matching-documents-text": "documents trouvés",
"search-copy-link-title": "Copier le lien vers la recherche",
"search-hide-matches-text": "Cacher les correspondances additionnelles",
"search-more-match-text": "correspondance de plus dans ce document",
"search-more-matches-text": "correspondances de plus dans ce document",
"search-clear-button-title": "Effacer",
"search-text-placeholder": "",
"search-detached-cancel-button-title": "Annuler",
"search-submit-button-title": "Envoyer",
"search-label": "Recherche"
}
}</script>
<style>html{ scroll-behavior: smooth; }</style>
<!-- Language switcher for the html output only (included in the <head>).
Each profile's sidebar translate menu links to the start page of the other
languages (_book/ English, _book/fr/, _book/de/). All three books share the
same file names and section ids (#sec-...), so a click is sent to the same
page and section of the other language instead.
Quarto's page scripts rewrite those links in the browser (to an absolute
address without index.html), and can do so after this script runs. So
nothing is attached to the links themselves: one capture-phase listener on
the document reads the link's final address at click time.
If a language has not been built, its pages do not exist:
the target is checked first and a short note is shown instead of a
"Not Found" page.
The language picked in the menu is remembered for a year in a cookie
(notes-lang, limited to the book's address). A later visit to a page in
another language goes straight to the same page in the remembered one; this
runs in the <head>, before anything is drawn. Not in the local preview
(file:, localhost), where the other languages may not be built. -->
<script>
(function () {
var CODE = { 'Deutsch': 'de', 'Français': 'fr', 'English': 'en' };
var ROOT_LANG = 'en'; // the language at the top of _book/
var COOKIE = 'notes-lang';
var NOTE = {
de: 'Diese Sprache ist hier noch nicht verfügbar.',
fr: 'Cette langue n’est pas encore disponible ici.',
en: 'This language is not available here yet.'
};
var here = (document.documentElement.lang || ROOT_LANG).slice(0, 2);
// the book's top folder: /…/fr/page.html -> /…/ ; /…/page.html -> /…/
var dir = location.pathname.replace(/[^\/]*$/, '');
var root = (here !== ROOT_LANG && dir.slice(-(here.length + 2)) === '/' + here + '/')
? dir.slice(0, -(here.length + 1)) : dir;
var page = location.pathname.slice(dir.length); // "" for a folder
function remembered() {
var m = document.cookie.match(/(?:^|;\s*)notes-lang=(de|fr|en)(?:;|$)/);
return m ? m[1] : null;
}
// path '/' on purpose: every book of these notes is served from one host,
// each under its own folder, so a language picked in any of them is the
// language all of them open in. A book hosted on its own would be no worse
// off -- the cookie simply has nothing else to reach.
var COOKIE_PATH = '/';
function remember(code) {
document.cookie = COOKIE + '=' + code + '; path=' + COOKIE_PATH
+ '; max-age=31536000; SameSite=Lax'
+ (location.protocol === 'https:' ? '; Secure' : '');
// a copy written under the book's own path by an earlier version would be
// the more specific one and would shadow the shared cookie for good
if (root !== COOKIE_PATH) {
document.cookie = COOKIE + '=; path=' + root + '; max-age=0';
}
}
// a returning reader lands in the language picked last time
var live = /^https?:$/.test(location.protocol)
&& !/^(localhost|127\.0\.0\.1|\[::1\])$/.test(location.hostname);
var wanted = remembered();
if (live && wanted && wanted !== here) {
location.replace(root + (wanted === ROOT_LANG ? '' : wanted + '/') + page
+ location.search + location.hash);
return;
}
function note() {
var lang = (document.documentElement.lang || 'en').slice(0, 2);
var box = document.createElement('div');
box.setAttribute('role', 'status');
box.className = 'i18n-note';
box.textContent = NOTE[lang] || NOTE.en;
box.style.cssText = 'position:fixed;left:50%;bottom:1.25rem;transform:translateX(-50%);'
+ 'max-width:min(34rem,calc(100vw - 2rem));padding:.6rem .9rem;border-radius:6px;'
+ 'background:#1f2328;color:#fff;font-size:.85rem;line-height:1.4;z-index:2000;'
// a status message, so it keeps its own dark surface in either mode; the
// hairline is the page's rule colour, invisible on a light page and an
// edge against a dark one, where the shadow alone no longer separates it
+ 'border:1px solid var(--calc-line,#444);'
+ 'box-shadow:0 4px 16px var(--calc-shadow,rgba(0,0,0,.25))';
document.body.appendChild(box);
setTimeout(function () { box.remove(); }, 7000);
}
function exists(url) {
return fetch(url, { method: 'HEAD', cache: 'no-store' })
.then(function (r) { return r.status !== 404; }, function () { return true; });
}
document.addEventListener('click', function (ev) {
if (ev.button !== 0 || ev.metaKey || ev.ctrlKey || ev.shiftKey || ev.altKey) return;
var a = ev.target.closest && ev.target.closest('a.sidebar-tools-main-item');
if (!a || !a.href) return;
var code = CODE[a.textContent.trim()];
if (!code) return; // some other tool link
ev.preventDefault();
// the language being read already: just remember it
if (code === here) { remember(code); return; }
var link = new URL(a.href, location.href);
var target_root = link.pathname.replace(/index\.html$/, ''); // "/" or "/fr/"
if (target_root.slice(-1) !== '/') target_root += '/';
var target = link.origin + target_root + (page || 'index.html');
if (location.protocol === 'file:' || !window.fetch) {
remember(code);
location.href = target + location.hash;
return;
}
// same page in the other language, else its start page, else explain
exists(target).then(function (ok) {
if (ok) { remember(code); location.href = target + location.hash; return; }
return exists(link.origin + target_root).then(function (rootOk) {
if (rootOk) { remember(code); location.href = link.origin + target_root; }
else note();
});
});
}, true);
})();
</script>
<style>:root {
--calc-furthercolor-src: #6B3FA0;
--calc-furthercolor: var(--calc-furthercolor-src);
}</style>
<style>:root {
--calc-notecolor-src: #B45309;
--calc-notecolor: var(--calc-notecolor-src);
}</style>
<script>(function (e) {
var KEY = 'notes-contrast', forced = false;
var picked = null;
try { picked = localStorage.getItem(KEY); } catch (err) {}
var q = null;
try { q = window.matchMedia && window.matchMedia('(prefers-contrast: more)'); } catch (err) {}
if (picked === 'more' || (picked !== 'normal' && (forced || (q && q.matches)))) {
e.classList.add('hc');
}
if (q) {
var f = function () {
var p = null;
try { p = localStorage.getItem(KEY); } catch (err) {}
if (p === null) e.classList.toggle('hc', forced || q.matches);
};
if (q.addEventListener) q.addEventListener('change', f);
else if (q.addListener) q.addListener(f);
}
})(document.documentElement);</script>
</head>
<body class="nav-sidebar docked quarto-light">
<div id="quarto-search-results"></div>
<header id="quarto-header" class="headroom fixed-top">
<nav class="quarto-secondary-nav">
<div class="container-fluid d-flex">
<button type="button" class="quarto-btn-toggle btn" data-bs-toggle="collapse" role="button" data-bs-target=".quarto-sidebar-collapse-item" aria-controls="quarto-sidebar" aria-expanded="false" aria-label="Basculer la barre latérale" onclick="if (window.quartoToggleHeadroom) { window.quartoToggleHeadroom(); }">
<i class="bi bi-layout-text-sidebar-reverse"></i>
</button>
<nav class="quarto-page-breadcrumbs" aria-label="breadcrumb"><ol class="breadcrumb"><li class="breadcrumb-item"><a href="./02-part-ii-processes.html"><span class="chapter-number">3</span>&nbsp; <span class="chapter-title">Partie II — Franchir la frontière de processus</span></a></li></ol></nav>
<a class="flex-grow-1" role="navigation" data-bs-toggle="collapse" data-bs-target=".quarto-sidebar-collapse-item" aria-controls="quarto-sidebar" aria-expanded="false" aria-label="Basculer la barre latérale" onclick="if (window.quartoToggleHeadroom) { window.quartoToggleHeadroom(); }">
</a>
<button type="button" class="btn quarto-search-button" aria-label="Recherche" onclick="window.quartoOpenSearch();">
<i class="bi bi-search"></i>
</button>
</div>
</nav>
</header>
<!-- content -->
<div id="quarto-content" class="quarto-container page-columns page-rows-contents page-layout-article">
<!-- sidebar -->
<nav id="quarto-sidebar" class="sidebar collapse collapse-horizontal quarto-sidebar-collapse-item sidebar-navigation docked overflow-auto">
<div class="pt-lg-2 mt-2 text-left sidebar-header">
<div class="sidebar-title mb-0 py-0">
<a href="./">Contrôle de processus</a>
<div class="sidebar-tools-main tools-wide">
<div class="dropdown">
<a href="" title="" id="quarto-navigation-tool-dropdown-0" class="quarto-navigation-tool dropdown-toggle px-1" data-bs-toggle="dropdown" aria-expanded="false" role="link" aria-label=""><i class="bi bi-translate"></i></a>
<ul class="dropdown-menu" aria-labelledby="quarto-navigation-tool-dropdown-0">
<li>
<a class="dropdown-item sidebar-tools-main-item" href="./../index.html">
English
</a>
</li>
<li>
<a class="dropdown-item sidebar-tools-main-item" href="./index.html">
Français
</a>
</li>
<li>
<a class="dropdown-item sidebar-tools-main-item" href="./../de/index.html">
Deutsch
</a>
</li>
</ul>
</div>
<a href="./Contrôle-de-processus.pdf" title="Download PDF" class="quarto-navigation-tool px-1" aria-label="Download PDF"><i class="bi bi-file-pdf"></i></a>
<a href="" class="quarto-reader-toggle quarto-navigation-tool px-1" onclick="window.quartoToggleReader(); return false;" title="Basculer en mode lecteur">
<div class="quarto-reader-toggle-btn">
<i class="bi"></i>
</div>
</a>
</div>
</div>
</div>
<div class="mt-2 flex-shrink-0 align-items-center">
<div class="sidebar-search">
<div id="quarto-search" class="" title="Recherche"></div>
</div>
</div>
<div class="sidebar-menu-container">
<ul class="list-unstyled mt-1">
<li class="sidebar-item">
<div class="sidebar-item-container">
<a href="./index.html" class="sidebar-item-text sidebar-link">
<span class="menu-text">À propos de ces notes</span></a>
</div>
</li>
<li class="sidebar-item">
<div class="sidebar-item-container">
<a href="./00-orientation.html" class="sidebar-item-text sidebar-link">
<span class="menu-text"><span class="chapter-number">1</span>&nbsp; <span class="chapter-title">Étape 0 — De quoi il s’agit</span></span></a>
</div>
</li>
<li class="sidebar-item">
<div class="sidebar-item-container">
<a href="./01-part-i-calls.html" class="sidebar-item-text sidebar-link">
<span class="menu-text"><span class="chapter-number">2</span>&nbsp; <span class="chapter-title">Partie I — Commencer par ce que l’on connaît déjà</span></span></a>
</div>
</li>
<li class="sidebar-item">
<div class="sidebar-item-container">
<a href="./02-part-ii-processes.html" class="sidebar-item-text sidebar-link active">
<span class="menu-text"><span class="chapter-number">3</span>&nbsp; <span class="chapter-title">Partie II — Franchir la frontière de processus</span></span></a>
</div>
</li>
<li class="sidebar-item sidebar-item-section">
<div class="sidebar-item-container">
<a class="sidebar-item-text sidebar-link text-start collapsed" data-bs-toggle="collapse" data-bs-target="#quarto-sidebar-section-1" role="navigation" aria-expanded="false">
<span class="menu-text">Annexes</span></a>
<a class="sidebar-item-toggle text-start collapsed" data-bs-toggle="collapse" data-bs-target="#quarto-sidebar-section-1" role="navigation" aria-expanded="false" aria-label="Basculer la section">
<i class="bi bi-chevron-right ms-2"></i>
</a>
</div>
<ul id="quarto-sidebar-section-1" class="collapse list-unstyled sidebar-section depth1 ">
<li class="sidebar-item">
<div class="sidebar-item-container">
<a href="./glossary.html" class="sidebar-item-text sidebar-link">
<span class="menu-text">Glossaire</span></a>
</div>
</li>
</ul>
</li>
</ul>
</div>
</nav>
<div id="quarto-sidebar-glass" class="quarto-sidebar-collapse-item" data-bs-toggle="collapse" data-bs-target=".quarto-sidebar-collapse-item"></div>
<!-- margin-sidebar -->
<div id="quarto-margin-sidebar" class="sidebar margin-sidebar">
<nav id="TOC" role="doc-toc" class="toc-active">
<h2 id="toc-title">Sur cette page</h2>
<ul>
<li><a href="#sec-step-11" id="toc-sec-step-11" class="nav-link active" data-scroll-target="#sec-step-11"><span class="header-section-number">3.1</span> Étape 11 — Séparer les composants</a></li>
<li><a href="#sec-steps-12-13" id="toc-sec-steps-12-13" class="nav-link" data-scroll-target="#sec-steps-12-13"><span class="header-section-number">3.2</span> Étapes 12–13 — Un répertoire devient une boîte aux lettres</a></li>
<li><a href="#sec-step-14" id="toc-sec-step-14" class="nav-link" data-scroll-target="#sec-step-14"><span class="header-section-number">3.3</span> Étape 14 — Le premier problème de système distribué : la publication</a></li>
<li><a href="#sec-step-15" id="toc-sec-step-15" class="nav-link" data-scroll-target="#sec-step-15"><span class="header-section-number">3.4</span> Étape 15 — Observer une boîte avec <code>WatchService</code></a></li>
<li><a href="#sec-steps-16-17" id="toc-sec-steps-16-17" class="nav-link" data-scroll-target="#sec-steps-16-17"><span class="header-section-number">3.5</span> Étapes 16–17 — Services et médiateur deviennent des processus</a></li>
<li><a href="#sec-step-18" id="toc-sec-step-18" class="nav-link" data-scroll-target="#sec-step-18"><span class="header-section-number">3.6</span> Étape 18 — Exécuter la version entièrement externe, en local</a></li>
<li><a href="#sec-part-ii-result" id="toc-sec-part-ii-result" class="nav-link" data-scroll-target="#sec-part-ii-result"><span class="header-section-number">3.7</span> Ce que la partie II a déplacé</a></li>
</ul>
</nav>
</div>
<!-- main -->
<main class="content" id="quarto-document-content">
<header id="title-block-header" class="quarto-title-block default">
<div class="quarto-title">
<h1 class="title"><span id="sec-part-ii" class="quarto-section-identifier"><span class="chapter-number">3</span>&nbsp; <span class="chapter-title">Partie II — Franchir la frontière de processus</span></span></h1>
</div>
<div class="quarto-title-meta">
</div>
</header>
<!-- MULTILINGUAL: see the comment at the top of index.qmd. -->
<p>Les étapes 11 à 18 reprennent l’architecture de la partie I et la répartissent sur cinq processus du système d’exploitation, sur un seul ordinateur. Les capacités gardent leurs noms de boîtes ; seul le transport en dessous change, des objets Java vers des fichiers dans des répertoires. Le premier problème réellement distribué apparaît ici, et il n’a rien à voir avec ROT13.</p>
<section id="sec-step-11" class="level2" data-number="3.1">
<h2 data-number="3.1" class="anchored" data-anchor-id="sec-step-11"><span class="header-section-number">3.1</span> Étape 11 — Séparer les composants</h2>
<p>Trois processus ne peuvent pas partager une <code>BlockingQueue</code> : chaque commande <code>java</code> démarre sa propre JVM avec sa propre mémoire, la carte <code>mailboxes</code> existerait donc en trois exemplaires et chacun ne verrait que ses propres messages. Il faut un transport externe.</p>
<p>TCP conviendrait, MQTT conviendrait. C’est délibérément l’option la plus primitive qui est choisie, le <strong>système de fichiers</strong>, pour une raison en une ligne : <em>parce qu’on peut le voir</em>. Les messages deviennent des fichiers que l’on peut lister avec <code>ls</code> et lire avec <code>cat</code> pendant que le système tourne. Primitif ne veut pas dire inférieur : la partie VIII revient sur ce que le système de fichiers fait vraiment bien et vraiment mal.</p>
</section>
<section id="sec-steps-12-13" class="level2" data-number="3.2">
<h2 data-number="3.2" class="anchored" data-anchor-id="sec-steps-12-13"><span class="header-section-number">3.2</span> Étapes 12–13 — Un répertoire devient une boîte aux lettres</h2>
<p>La correspondance tient en une ligne :</p>
<pre class="text"><code>directory = mailbox file = message
publish = create file receive = watch directory</code></pre>
<pre class="text"><code>messageBoard/
├── consoleIn/outbox/
├── rot13/inbox/
├── rot13/outbox/
└── consoleOut/inbox/</code></pre>
<p>Le record <code>Message</code> gagne un horodatage optionnel, et le format de fichier reste deux lignes plus une troisième facultative :</p>
<pre class="text"><code>TEXT
Hello World
TIMESTAMP: 2026-09-22T10:42:12.123Z</code></pre>
<p>Un message écrit à la main peut omettre l’horodatage. Le marqueur <code>TIMESTAMP:</code> empêche qu’une ligne de contenu ressemblant à une date soit prise pour une métadonnée ; dans ce format minuscule, une dernière ligne commençant par <code>TIMESTAMP:</code> est réservée.</p>
<p>Jackson pourrait être introduit ici et ne l’est volontairement pas. L’intérêt d’un format ridiculement simple, c’est que presque rien ne cache l’architecture — le message entier est lisible dans n’importe quel éditeur de texte, ce qui maintient l’attention sur qui parle à qui.</p>
</section>
<section id="sec-step-14" class="level2" data-number="3.3">
<h2 data-number="3.3" class="anchored" data-anchor-id="sec-step-14"><span class="header-section-number">3.3</span> Étape 14 — Le premier problème de système distribué : la publication</h2>
<p>Un lecteur qui surveille un répertoire peut découvrir un fichier <em>avant que l’écrivain ait fini de l’écrire</em>. D’où un protocole de publication :</p>
<ol type="1">
<li>créer un fichier temporaire privé ;</li>
<li>écrire le message complet ;</li>
<li>le fermer ;</li>
<li>le renommer atomiquement vers son nom final <code>.msg</code> ;</li>
<li>les consommateurs ne réagissent qu’aux fichiers finaux.</li>
</ol>
<div class="code-copy-outer-scaffold"><div class="sourceCode" id="cb4"><pre class="sourceCode java code-with-copy"><code class="sourceCode java"><span id="cb4-1"><a href="#cb4-1" aria-hidden="true" tabindex="-1"></a>Files<span class="op">.</span><span class="fu">writeString</span><span class="op">(</span>temporary<span class="op">,</span> content<span class="op">);</span></span>
<span id="cb4-2"><a href="#cb4-2" aria-hidden="true" tabindex="-1"></a>Files<span class="op">.</span><span class="fu">move</span><span class="op">(</span>temporary<span class="op">,</span> published<span class="op">,</span> StandardCopyOption<span class="op">.</span><span class="fu">ATOMIC_MOVE</span><span class="op">);</span></span></code></pre></div><button title="Copier vers le presse-papier" class="code-copy-button"><i class="bi"></i></button></div>
<p>Les deux moitiés sont nécessaires. Le renommage est atomique — un lecteur voit soit aucun fichier <code>.msg</code>, soit le fichier complet — mais il ne protège rien si les lecteurs ramassent aussi les <code>.tmp</code>. <code>.tmp</code> et <code>.msg</code> restent dans le même répertoire, pour que le déplacement ne traverse pas de système de fichiers, où l’atomicité serait perdue.</p>
<blockquote class="blockquote">
<p><strong>Écrire et publier ne sont pas la même opération.</strong></p>
</blockquote>
</section>
<section id="sec-step-15" class="level2" data-number="3.4">
<h2 data-number="3.4" class="anchored" data-anchor-id="sec-step-15"><span class="header-section-number">3.4</span> Étape 15 — Observer une boîte avec <code>WatchService</code></h2>
<p>L’observateur de système de fichiers de Java fournit la moitié consommateur : enregistrer un répertoire pour <code>ENTRY_CREATE</code>, se bloquer dans <code>watcher.take()</code>, et ignorer tout nom de fichier qui ne finit pas par <code>.msg</code>.</p>
<p>Cela donne aussi un outil d’injection très rudimentaire. Avec <code>ActuatorService</code> lancé comme consommateur :</p>
<div class="code-copy-outer-scaffold"><div class="sourceCode" id="cb5"><pre class="sourceCode bash code-with-copy"><code class="sourceCode bash"><span id="cb5-1"><a href="#cb5-1" aria-hidden="true" tabindex="-1"></a><span class="bu">printf</span> <span class="st">'TEXT\nHello from a file'</span> <span class="op">&gt;</span> messageBoard/consoleOut/inbox/manual.tmp</span>
<span id="cb5-2"><a href="#cb5-2" aria-hidden="true" tabindex="-1"></a><span class="fu">mv</span> messageBoard/consoleOut/inbox/manual.tmp messageBoard/consoleOut/inbox/manual.msg</span></code></pre></div><button title="Copier vers le presse-papier" class="code-copy-button"><i class="bi"></i></button></div>
<p><strong>Observé :</strong> rien ne se passe à l’apparition du fichier <code>.tmp</code> ; la ligne est affichée à l’instant où le renommage crée le nom <code>.msg</code>. Les deux formats acceptés fonctionnent, avec et sans horodatage final.</p>
<p>Le point architectural s’écrit <code>producer → filesystem → consumer</code> : le consommateur n’a pas pu distinguer un humain tapant <code>mv</code> d’un véritable service. Il connaît sa propre boîte d’entrée, pas qui y écrit. L’égoïsme a survécu à la frontière de processus.</p>
</section>
<section id="sec-steps-16-17" class="level2" data-number="3.5">
<h2 data-number="3.5" class="anchored" data-anchor-id="sec-steps-16-17"><span class="header-section-number">3.5</span> Étapes 16–17 — Services et médiateur deviennent des processus</h2>
<p>Les trois capacités deviennent trois programmes, et le médiateur un quatrième type de programme :</p>
<table class="caption-top table">
<colgroup>
<col style="width: 25%">
<col style="width: 25%">
<col style="width: 25%">
<col style="width: 25%">
</colgroup>
<thead>
<tr class="header">
<th>programme</th>
<th>joue</th>
<th>lit</th>
<th>écrit</th>
</tr>
</thead>
<tbody>
<tr class="odd">
<td><code>SensorService.java</code></td>
<td>ConsoleIn</td>
<td>le clavier</td>
<td><code>consoleIn/outbox</code></td>
</tr>
<tr class="even">
<td><code>ProcessorService.java</code></td>
<td>ROT13</td>
<td><code>rot13/inbox</code></td>
<td><code>rot13/outbox</code></td>
</tr>
<tr class="odd">
<td><code>ActuatorService.java</code></td>
<td>ConsoleOut</td>
<td><code>consoleOut/inbox</code></td>
<td>la console</td>
</tr>
<tr class="even">
<td><code>Mediator.java &lt;from&gt; &lt;to&gt;</code></td>
<td>la colle</td>
<td><code>&lt;from&gt;</code></td>
<td><code>&lt;to&gt;</code></td>
</tr>
</tbody>
</table>
<p>Le médiateur est générique : sa route n’est pas compilée en dur, elle arrive en deux arguments de démarrage. Mais une asymétrie mérite d’être gardée en tête : les trois capacités reçoivent leur <strong>travail</strong> sous forme de messages dans une boîte, tandis que le médiateur reçoit sa <strong>route</strong> comme configuration de démarrage, et il n’a ni nom ni boîte de contrôle propre où quelqu’un pourrait écrire.</p>
<p>Conséquence pratique : les arguments sont lus une seule fois, donc changer la route d’un médiateur en cours d’exécution exige de l’arrêter et de le relancer. Un fichier de configuration ne changerait rien — il est lui aussi lu au démarrage. Ce point reste volontairement ouvert jusqu’à ce que le coût des médiateurs distribués ait été ressenti.</p>
</section>
<section id="sec-step-18" class="level2" data-number="3.6">
<h2 data-number="3.6" class="anchored" data-anchor-id="sec-step-18"><span class="header-section-number">3.6</span> Étape 18 — Exécuter la version entièrement externe, en local</h2>
<p>Cinq terminaux, cinq processus, un seul système de fichiers local entre eux :</p>
<div class="code-copy-outer-scaffold"><div class="sourceCode" id="cb6"><pre class="sourceCode bash code-with-copy"><code class="sourceCode bash"><span id="cb6-1"><a href="#cb6-1" aria-hidden="true" tabindex="-1"></a><span class="ex">java</span> SensorService.java <span class="co"># terminal 1</span></span>
<span id="cb6-2"><a href="#cb6-2" aria-hidden="true" tabindex="-1"></a><span class="ex">java</span> Mediator.java consoleIn/outbox rot13/inbox <span class="co"># terminal 2</span></span>
<span id="cb6-3"><a href="#cb6-3" aria-hidden="true" tabindex="-1"></a><span class="ex">java</span> ProcessorService.java <span class="co"># terminal 3</span></span>
<span id="cb6-4"><a href="#cb6-4" aria-hidden="true" tabindex="-1"></a><span class="ex">java</span> Mediator.java rot13/outbox consoleOut/inbox <span class="co"># terminal 4</span></span>
<span id="cb6-5"><a href="#cb6-5" aria-hidden="true" tabindex="-1"></a><span class="ex">java</span> ActuatorService.java <span class="co"># terminal 5</span></span></code></pre></div><button title="Copier vers le presse-papier" class="code-copy-button"><i class="bi"></i></button></div>
<p><strong>Observé :</strong> <code>Hello World</code> tapé dans le terminal 1 est apparu comme <code>Uryyb Jbeyq</code> dans le terminal 5. Les trois terminaux du milieu n’ont rien affiché de nouveau — chaque médiateur affiche une ligne « Mediating: … » au démarrage, et <code>ProcessorService</code> n’affiche rien du tout. Ensuite, chacun des quatre répertoires de boîtes contenait un fichier <code>.msg</code> : la même ligne, recopiée le long de la chaîne.</p>
<p>Comptons : <strong>cinq processus</strong> pour ce que l’étape 1 faisait en une instruction. Ce n’est pas le moment d’optimiser : ce n’est pas encore censé être confortable.</p>
<div id="fig-filesystem-processes" class="flow-figure quarto-float quarto-figure quarto-figure-center anchored">
<figure class="quarto-float quarto-float-fig figure">
<div aria-describedby="fig-filesystem-processes-caption-0ceaefa1-69ba-4598-a22c-09a6ac19f8ca">
<img src="figures/filesystem-processes-fr.svg" class="flow-figure img-fluid figure-img">
</div>
<figcaption class="quarto-float-caption-bottom quarto-float-caption quarto-float-fig" id="fig-filesystem-processes-caption-0ceaefa1-69ba-4598-a22c-09a6ac19f8ca">
Figure&nbsp;3.1: Les cinq processus et les quatre répertoires de boîtes. Dans la version web, <strong>Lancer</strong> suit une ligne de texte du clavier à la console.
</figcaption>
</figure>
</div>
</section>
<section id="sec-part-ii-result" class="level2" data-number="3.7">
<h2 data-number="3.7" class="anchored" data-anchor-id="sec-part-ii-result"><span class="header-section-number">3.7</span> Ce que la partie II a déplacé</h2>
<table class="caption-top table">
<colgroup>
<col style="width: 33%">
<col style="width: 33%">
<col style="width: 33%">
</colgroup>
<thead>
<tr class="header">
<th>étape</th>
<th>où vit la topologie</th>
<th>qui peut recâbler</th>
</tr>
</thead>
<tbody>
<tr class="odd">
<td>étape 1</td>
<td>dans le code de la capacité</td>
<td>celui qui édite ce code</td>
</tr>
<tr class="even">
<td>étapes 7–8</td>
<td>dans <code>main()</code>, en noms de boîtes</td>
<td>celui qui édite <code>main()</code></td>
</tr>
<tr class="odd">
<td>étape 18</td>
<td>dans les deux lignes de commande <code>Mediator.java &lt;from&gt; &lt;to&gt;</code></td>
<td>celui qui lance les processus</td>
</tr>
</tbody>
</table>
<p>La topologie a maintenant quitté le code source : aucun fichier <code>.java</code> ne contient la route. Elle vit dans ce que l’opérateur a tapé, ce qui fait d’une personne l’orchestrateur actuel. Ce que la version à cinq processus apporte est réel — le câblage peut changer sans toucher aucun programme — et ce qu’elle coûte l’est tout autant : cinq processus, quatre copies de chaque message, et un programme qui ne s’arrête plus quand on appuie sur <code>Ctrl+D</code>.</p>
</section>
</main> <!-- /main -->
<!-- figures/flow-player.html -- the web version's interactive diagrams.
Injected at the end of <body> by include-in-header's sibling
include-after-body in _quarto.yml, so it is a no-op on a page that holds
no img.flow-figure.
A chapter writes an ordinary Quarto figure and adds the class:
![caption](figures/mailboxes-jvm-@tr{langcode}){#fig-x .flow-figure}
That keeps the PDF and the no-JavaScript case working: the built svg is
already the whole picture. Here the image is fetched, inlined, and given
a play bar that walks a message through the mailboxes, one hop per
[data-flow] edge of the svg, highlighting the [data-flow-node] each hop
ends at. Colours are diagram.css's, so the two stay in step. -->
<style>
.flow-wrap { margin: 0; }
.flow-wrap svg { width: 100%; height: auto; display: block; }
.flow-token { fill: #8a5a08; stroke: #fbfcfd; stroke-width: 1.2; }
.flow-wrap .flow-on .box,
.flow-wrap .flow-on .box-plain,
.flow-wrap .flow-on .box-accent { stroke-width: 3; }
.flow-wrap .flow-done { stroke: #8a5a08; }
.flow-bar {
display: flex; align-items: center; gap: .5rem; flex-wrap: wrap;
max-width: 100%; margin: .45rem 0 0;
}
.flow-bar button {
font: inherit; font-size: .82rem; padding: .18rem .7rem; cursor: pointer;
border: 1px solid #dae0e8; border-radius: 999px;
background: #fbfcfd; color: #5a6879;
}
.flow-bar button:hover { border-color: #20666f; color: #20666f; }
.flow-bar button[disabled] { opacity: .45; cursor: default; }
.flow-status { font-size: .8rem; color: #5a6879; }
.flow-status b { color: #20666f; font-weight: 600; }
@media (prefers-color-scheme: dark) {
.flow-token { fill: #c99a3a; stroke: #161b22; }
.flow-bar button { background: #161b22; border-color: #30363d; color: #8b98a8; }
.flow-bar button:hover { border-color: #4c9aa5; color: #7fc4cf; }
.flow-status { color: #8b98a8; }
.flow-status b { color: #7fc4cf; }
}
</style>
<script>
(() => {
const images = document.querySelectorAll("img.flow-figure");
if (!images.length) return;
const LANG = (document.documentElement.lang || "en").slice(0, 2);
const WORDS = {
en: { play: "Play", pause: "Pause", step: "One hop", reset: "Reset",
idle: "the message has not been sent yet", done: "arrived" },
fr: { play: "Lancer", pause: "Pause", step: "Un saut", reset: "Réinitialiser",
idle: "le message n'est pas encore parti", done: "arrivé" },
de: { play: "Abspielen", pause: "Pause", step: "Ein Sprung", reset: "Zurücksetzen",
idle: "die Nachricht ist noch nicht unterwegs", done: "angekommen" },
};
const W = WORDS[LANG] || WORDS.en;
const STILL = window.matchMedia("(prefers-reduced-motion: reduce)").matches;
const HOP = 620; // ms per hop
const label = (node) => {
const text = node && node.querySelector("text");
return text ? text.textContent.trim() : "";
};
async function upgrade(img) {
let svg;
try {
const response = await fetch(img.currentSrc || img.src);
if (!response.ok) return; // leave the plain image in place
const doc = new DOMParser().parseFromString(await response.text(), "image/svg+xml");
svg = doc.documentElement;
if (!svg || svg.nodeName !== "svg" || doc.querySelector("parsererror")) return;
} catch { return; } // file:// or offline: plain image
const edges = [...svg.querySelectorAll("[data-flow]")]
.sort((a, b) => Number(a.dataset.flow) - Number(b.dataset.flow));
if (!edges.length) return;
svg.removeAttribute("width");
svg.removeAttribute("height");
const wrap = document.createElement("div");
wrap.className = "flow-wrap";
wrap.appendChild(svg);
const bar = document.createElement("div");
bar.className = "flow-bar";
const make = (name) => {
const button = document.createElement("button");
button.type = "button";
button.textContent = W[name];
bar.appendChild(button);
return button;
};
const playButton = make("play");
const stepButton = make("step");
const resetButton = make("reset");
const status = document.createElement("span");
status.className = "flow-status";
bar.appendChild(status);
wrap.appendChild(bar);
img.hidden = true;
img.after(wrap);
const token = document.createElementNS("http://www.w3.org/2000/svg", "circle");
token.setAttribute("r", "6");
token.setAttribute("class", "flow-token");
token.style.display = "none";
svg.appendChild(token);
let at = 0; // hops already made
let playing = false;
let frame = null;
const nodeOf = (edge) =>
edge.dataset.flowTo
? svg.querySelector(`[data-flow-node="${edge.dataset.flowTo}"]`)
: null;
const say = () => {
if (at === 0) { status.textContent = W.idle; return; }
const here = label(nodeOf(edges[at - 1]));
status.innerHTML = `${at} / ${edges.length} — <b></b>`;
status.querySelector("b").textContent =
at === edges.length ? `${here} (${W.done})` : here;
};
const clear = () => {
svg.querySelectorAll(".flow-on").forEach((n) => n.classList.remove("flow-on"));
edges.forEach((e) => e.classList.remove("flow-done"));
};
const place = (edge, fraction) => {
const length = edge.getTotalLength();
const point = edge.getPointAtLength(length * fraction);
token.setAttribute("cx", point.x);
token.setAttribute("cy", point.y);
token.style.display = "";
};
function hop(then) {
const edge = edges[at];
if (!edge) { then && then(false); return; }
clear();
const arrive = () => {
edge.classList.add("flow-done");
const node = nodeOf(edge);
if (node) node.classList.add("flow-on");
at += 1;
say();
buttons();
then && then(at < edges.length);
};
if (STILL) { place(edge, 1); arrive(); return; }
const start = performance.now();
const tick = (now) => {
const done = Math.min((now - start) / HOP, 1);
place(edge, done);
if (done < 1) { frame = requestAnimationFrame(tick); } else { frame = null; arrive(); }
};
frame = requestAnimationFrame(tick);
}
function buttons() {
const end = at >= edges.length;
playButton.textContent = playing ? W.pause : W.play;
playButton.disabled = end && !playing;
stepButton.disabled = end || playing;
resetButton.disabled = at === 0 && !playing;
}
function stop() {
playing = false;
if (frame) { cancelAnimationFrame(frame); frame = null; }
buttons();
}
function run() {
if (at >= edges.length) at = 0;
playing = true;
buttons();
const next = (more) => {
if (!playing) return;
if (more) { hop(next); } else { stop(); }
};
hop(next);
}
playButton.addEventListener("click", () => (playing ? stop() : run()));
stepButton.addEventListener("click", () => { stop(); hop(); });
resetButton.addEventListener("click", () => {
stop();
at = 0;
clear();
token.style.display = "none";
say();
buttons();
});
say();
buttons();
}
images.forEach(upgrade);
})();
</script>
<script id="quarto-html-after-body" type="application/javascript">
window.document.addEventListener("DOMContentLoaded", function (event) {
const icon = "";
const anchorJS = new window.AnchorJS();
anchorJS.options = {
placement: 'right',
icon: icon
};
anchorJS.add('.anchored');
const isCodeAnnotation = (el) => {
for (const clz of el.classList) {
if (clz.startsWith('code-annotation-')) {
return true;
}
}
return false;
}
const onCopySuccess = function(e) {
// button target
const button = e.trigger;
// don't keep focus
button.blur();
// flash "checked"
button.classList.add('code-copy-button-checked');
var currentTitle = button.getAttribute("title");
button.setAttribute("title", "Copié");
let tooltip;
if (window.bootstrap) {
button.setAttribute("data-bs-toggle", "tooltip");
button.setAttribute("data-bs-placement", "left");
button.setAttribute("data-bs-title", "Copié");
tooltip = new bootstrap.Tooltip(button,
{ trigger: "manual",
customClass: "code-copy-button-tooltip",
offset: [0, -8]});
tooltip.show();
}
setTimeout(function() {
if (tooltip) {
tooltip.hide();
button.removeAttribute("data-bs-title");
button.removeAttribute("data-bs-toggle");
button.removeAttribute("data-bs-placement");
}
button.setAttribute("title", currentTitle);
button.classList.remove('code-copy-button-checked');
}, 1000);
// clear code selection
e.clearSelection();
}
const getTextToCopy = function(trigger) {
const outerScaffold = trigger.parentElement.cloneNode(true);
const codeEl = outerScaffold.querySelector('code');
for (const childEl of codeEl.children) {
if (isCodeAnnotation(childEl)) {
childEl.remove();
}
}
return codeEl.innerText;
}
const clipboard = new window.ClipboardJS('.code-copy-button:not([data-in-quarto-modal])', {
text: getTextToCopy
});
clipboard.on('success', onCopySuccess);
if (window.document.getElementById('quarto-embedded-source-code-modal')) {
const clipboardModal = new window.ClipboardJS('.code-copy-button[data-in-quarto-modal]', {
text: getTextToCopy,
container: window.document.getElementById('quarto-embedded-source-code-modal')
});
clipboardModal.on('success', onCopySuccess);
}
var localhostRegex = new RegExp(/^(?:http|https):\/\/localhost\:?[0-9]*\//);
var mailtoRegex = new RegExp(/^mailto:/);
var filterRegex = new RegExp('/' + window.location.host + '/');
var isInternal = (href) => {
return filterRegex.test(href) || localhostRegex.test(href) || mailtoRegex.test(href);
}
// Inspect non-navigation links and adorn them if external
var links = window.document.querySelectorAll('a[href]:not(.nav-link):not(.navbar-brand):not(.toc-action):not(.sidebar-link):not(.sidebar-item-toggle):not(.pagination-link):not(.no-external):not([aria-hidden]):not(.dropdown-item):not(.quarto-navigation-tool):not(.about-link)');
for (var i=0; i<links.length; i++) {
const link = links[i];
if (!isInternal(link.href)) {
// undo the damage that might have been done by quarto-nav.js in the case of
// links that we want to consider external
if (link.dataset.originalHref !== undefined) {
link.href = link.dataset.originalHref;
}
// target, if specified
link.setAttribute("target", "_blank");
if (link.getAttribute("rel") === null) {
link.setAttribute("rel", "noopener");
}
}
}
function tippyHover(el, contentFn, onTriggerFn, onUntriggerFn) {
const config = {
allowHTML: true,
maxWidth: 500,
delay: 100,
arrow: false,
appendTo: function(el) {
return el.parentElement;
},
interactive: true,
interactiveBorder: 10,
theme: 'quarto',
placement: 'bottom-start',
};
if (contentFn) {
config.content = contentFn;
}
if (onTriggerFn) {
config.onTrigger = onTriggerFn;
}
if (onUntriggerFn) {
config.onUntrigger = onUntriggerFn;
}
window.tippy(el, config);
}
const noterefs = window.document.querySelectorAll('a[role="doc-noteref"]');
for (var i=0; i<noterefs.length; i++) {
const ref = noterefs[i];
tippyHover(ref, function() {
// use id or data attribute instead here
let href = ref.getAttribute('data-footnote-href') || ref.getAttribute('href');
try { href = new URL(href).hash; } catch {}
const id = href.replace(/^#\/?/, "");
const note = window.document.getElementById(id);
if (note) {
return note.innerHTML;
} else {
return "";
}
});
}
const xrefs = window.document.querySelectorAll('a.quarto-xref');
const processXRef = (id, note) => {
// Strip column container classes
const stripColumnClz = (el) => {
el.classList.remove("page-full", "page-columns");
if (el.children) {
for (const child of el.children) {
stripColumnClz(child);
}
}
}
stripColumnClz(note)
if (id === null || id.startsWith('sec-')) {
// Special case sections, only their first couple elements
const container = document.createElement("div");
if (note.children && note.children.length > 2) {
container.appendChild(note.children[0].cloneNode(true));
for (let i = 1; i < note.children.length; i++) {
const child = note.children[i];
if (child.tagName === "P" && child.innerText === "") {
continue;
} else {
container.appendChild(child.cloneNode(true));
break;
}
}
if (window.Quarto?.typesetMath) {
window.Quarto.typesetMath(container);
}
return container.innerHTML
} else {
if (window.Quarto?.typesetMath) {
window.Quarto.typesetMath(note);
}
return note.innerHTML;
}
} else {
// Remove any anchor links if they are present
const anchorLink = note.querySelector('a.anchorjs-link');
if (anchorLink) {
anchorLink.remove();
}
if (window.Quarto?.typesetMath) {
window.Quarto.typesetMath(note);
}
if (note.classList.contains("callout")) {
return note.outerHTML;
} else {
return note.innerHTML;
}
}
}
for (var i=0; i<xrefs.length; i++) {
const xref = xrefs[i];
tippyHover(xref, undefined, function(instance) {
instance.disable();
let url = xref.getAttribute('href');
let hash = undefined;
if (url.startsWith('#')) {
hash = url;
} else {
try { hash = new URL(url).hash; } catch {}
}
if (hash) {
const id = hash.replace(/^#\/?/, "");
const note = window.document.getElementById(id);
if (note !== null) {
try {
const html = processXRef(id, note.cloneNode(true));
instance.setContent(html);
} finally {
instance.enable();
instance.show();
}
} else {
// See if we can fetch this
fetch(url.split('#')[0])
.then(res => res.text())
.then(html => {
const parser = new DOMParser();
const htmlDoc = parser.parseFromString(html, "text/html");
const note = htmlDoc.getElementById(id);
if (note !== null) {
const html = processXRef(id, note);
instance.setContent(html);
}
}).finally(() => {
instance.enable();
instance.show();
});
}
} else {
// See if we can fetch a full url (with no hash to target)
// This is a special case and we should probably do some content thinning / targeting
fetch(url)
.then(res => res.text())
.then(html => {
const parser = new DOMParser();
const htmlDoc = parser.parseFromString(html, "text/html");
const note = htmlDoc.querySelector('main.content');
if (note !== null) {
// This should only happen for chapter cross references
// (since there is no id in the URL)
// remove the first header
if (note.children.length > 0 && note.children[0].tagName === "HEADER") {
note.children[0].remove();
}
const html = processXRef(null, note);
instance.setContent(html);
}
}).finally(() => {
instance.enable();
instance.show();
});
}
}, function(instance) {
});
}
let selectedAnnoteEl;
const selectorForAnnotation = ( cell, annotation) => {
let cellAttr = 'data-code-cell="' + cell + '"';
let lineAttr = 'data-code-annotation="' + annotation + '"';
const selector = 'span[' + cellAttr + '][' + lineAttr + ']';
return selector;
}
const selectCodeLines = (annoteEl) => {
const doc = window.document;
const targetCell = annoteEl.getAttribute("data-target-cell");
const targetAnnotation = annoteEl.getAttribute("data-target-annotation");
const annoteSpan = window.document.querySelector(selectorForAnnotation(targetCell, targetAnnotation));
const lines = annoteSpan.getAttribute("data-code-lines").split(",");
const lineIds = lines.map((line) => {
return targetCell + "-" + line;
})
let top = null;
let height = null;
let parent = null;
if (lineIds.length > 0) {
//compute the position of the single el (top and bottom and make a div)
const el = window.document.getElementById(lineIds[0]);
top = el.offsetTop;
height = el.offsetHeight;
parent = el.parentElement.parentElement;
if (lineIds.length > 1) {
const lastEl = window.document.getElementById(lineIds[lineIds.length - 1]);
const bottom = lastEl.offsetTop + lastEl.offsetHeight;
height = bottom - top;
}
if (top !== null && height !== null && parent !== null) {
// cook up a div (if necessary) and position it
let div = window.document.getElementById("code-annotation-line-highlight");
if (div === null) {
div = window.document.createElement("div");
div.setAttribute("id", "code-annotation-line-highlight");
div.style.position = 'absolute';
parent.appendChild(div);
}
div.style.top = top - 2 + "px";
div.style.height = height + 4 + "px";
div.style.left = 0;
let gutterDiv = window.document.getElementById("code-annotation-line-highlight-gutter");
if (gutterDiv === null) {
gutterDiv = window.document.createElement("div");
gutterDiv.setAttribute("id", "code-annotation-line-highlight-gutter");
gutterDiv.style.position = 'absolute';
const codeCell = window.document.getElementById(targetCell);
const gutter = codeCell.querySelector('.code-annotation-gutter');
gutter.appendChild(gutterDiv);
}
gutterDiv.style.top = top - 2 + "px";
gutterDiv.style.height = height + 4 + "px";
}
selectedAnnoteEl = annoteEl;
}
};
const unselectCodeLines = () => {
const elementsIds = ["code-annotation-line-highlight", "code-annotation-line-highlight-gutter"];
elementsIds.forEach((elId) => {
const div = window.document.getElementById(elId);
if (div) {
div.remove();
}
});
selectedAnnoteEl = undefined;
};
// Handle positioning of the toggle
window.addEventListener(
"resize",
throttle(() => {
elRect = undefined;
if (selectedAnnoteEl) {
selectCodeLines(selectedAnnoteEl);
}
}, 10)
);
function throttle(fn, ms) {
let throttle = false;
let timer;
return (...args) => {
if(!throttle) { // first call gets through
fn.apply(this, args);
throttle = true;
} else { // all the others get throttled
if(timer) clearTimeout(timer); // cancel #2
timer = setTimeout(() => {
fn.apply(this, args);
timer = throttle = false;
}, ms);
}
};
}
// Attach click handler to the DT
const annoteDls = window.document.querySelectorAll('dt[data-target-cell]');
for (const annoteDlNode of annoteDls) {
annoteDlNode.addEventListener('click', (event) => {
const clickedEl = event.target;
if (clickedEl !== selectedAnnoteEl) {
unselectCodeLines();
const activeEl = window.document.querySelector('dt[data-target-cell].code-annotation-active');
if (activeEl) {
activeEl.classList.remove('code-annotation-active');
}
selectCodeLines(clickedEl);
clickedEl.classList.add('code-annotation-active');
} else {
// Unselect the line
unselectCodeLines();
clickedEl.classList.remove('code-annotation-active');
}
});
}
const findCites = (el) => {
const parentEl = el.parentElement;
if (parentEl) {
const cites = parentEl.dataset.cites;
if (cites) {
return {
el,
cites: cites.split(' ')
};
} else {
return findCites(el.parentElement)
}
} else {
return undefined;
}
};
var bibliorefs = window.document.querySelectorAll('a[role="doc-biblioref"]');
for (var i=0; i<bibliorefs.length; i++) {
const ref = bibliorefs[i];
const citeInfo = findCites(ref);
if (citeInfo) {
tippyHover(citeInfo.el, function() {
var popup = window.document.createElement('div');
citeInfo.cites.forEach(function(cite) {
var citeDiv = window.document.createElement('div');
citeDiv.classList.add('hanging-indent');
citeDiv.classList.add('csl-entry');
var biblioDiv = window.document.getElementById('ref-' + cite);
if (biblioDiv) {
citeDiv.innerHTML = biblioDiv.innerHTML;
}
popup.appendChild(citeDiv);
});
return popup.innerHTML;
});
}
}
});
</script>
<nav class="page-navigation">
<div class="nav-page nav-page-previous">
<a href="./01-part-i-calls.html" class="pagination-link" aria-label="[Part I — Start with what you already know]{.en}[Partie I — Commencer par ce que l'on connaît déjà]{.fr}[Teil I — Mit dem beginnen, was man schon kennt]{.de}">
<i class="bi bi-arrow-left-short"></i> <span class="nav-page-text"><span class="chapter-number">2</span>&nbsp; <span class="chapter-title">Partie I — Commencer par ce que l’on connaît déjà</span></span>
</a>
</div>
<div class="nav-page nav-page-next">
<a href="./glossary.html" class="pagination-link" aria-label="[Glossary]{.en}[Glossaire]{.fr}[Glossar]{.de}">
<span class="nav-page-text">Glossaire</span> <i class="bi bi-arrow-right-short"></i>
</a>
</div>
</nav>
</div> <!-- /content -->
<script src="site_libs/quarto-html/zenscroll-min.js"></script>
</body></html>