Rename book to Process Control

This commit is contained in:
MatsuneMikuroi committed 2026-09-29 12:34:56 +02:00
1 parent 919e79eb2a
commit afb816f459
53 files changed
+5587 -503

No files matched your search

+88 -67
View File
@@ -7,9 +7,9 @@
<meta name="viewport" content="width=device-width, initial-scale=1.0, user-scalable=yes">
<meta name="author" content="Romain De Groote">
<meta name="dcterms.date" content="2026-09-24">
<meta name="dcterms.date" content="2026-09-25">
<title>From Calling to Eventing</title>
<title>Process Control</title>
<style>
/* Default styles provided by pandoc.
** See https://pandoc.org/MANUAL.html#variables-for-html for config info.
@@ -28,41 +28,6 @@ ul.task-list li input[type="checkbox"] {
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>
@@ -86,9 +51,15 @@ pre > code.sourceCode > span > a:first-child::before { text-decoration: underlin
<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">{
@@ -131,7 +102,7 @@ pre > code.sourceCode > span > a:first-child::before { text-decoration: underlin
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 (./render-all.sh), its pages do not exist:
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.
@@ -147,12 +118,9 @@ pre > code.sourceCode > span > a:first-child::before { text-decoration: underlin
var ROOT_LANG = 'en'; // the language at the top of _book/
var COOKIE = 'notes-lang';
var NOTE = {
de: 'Diese Sprache wurde noch nicht erstellt. Einmal ./render-all.sh ausführen – '
+ 'danach funktioniert der Wechsel auch in der Vorschau.',
fr: 'Cette langue n’a pas encore été générée. Lancez une fois ./render-all.sh : '
+ 'ensuite le changement fonctionne aussi dans l’aperçu.',
en: 'This language hasn’t been built yet. Run ./render-all.sh once, '
+ 'then switching works in the preview too.'
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);
@@ -166,9 +134,20 @@ pre > code.sourceCode > span > a:first-child::before { text-decoration: underlin
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=' + root + '; max-age=31536000; SameSite=Lax'
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
@@ -190,7 +169,11 @@ pre > code.sourceCode > span > a:first-child::before { text-decoration: underlin
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;'
+ 'box-shadow:0 4px 16px rgba(0,0,0,.25)';
// 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);
}
@@ -231,7 +214,35 @@ pre > code.sourceCode > span > a:first-child::before { text-decoration: underlin
}, true);
})();
</script>
<style>:root { --calc-notecolor: #B45309; }</style>
<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>
@@ -260,7 +271,7 @@ pre > code.sourceCode > span > a:first-child::before { text-decoration: underlin
<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="./">From Calling to Eventing</a>
<a href="./">Process Control</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>
@@ -282,7 +293,7 @@ pre > code.sourceCode > span > a:first-child::before { text-decoration: underlin
</li>
</ul>
</div>
<a href="./From-Calling-to-Eventing.pdf" title="Download PDF" class="quarto-navigation-tool px-1" aria-label="Download PDF"><i class="bi bi-file-pdf"></i></a>
<a href="./Process-Control.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="Toggle reader mode">
<div class="quarto-reader-toggle-btn">
<i class="bi"></i>
@@ -307,7 +318,7 @@ pre > code.sourceCode > span > a:first-child::before { text-decoration: underlin
<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">Step 0 — What the tutorial is about</span></span></a>
<span class="menu-text"><span class="chapter-number">1</span>&nbsp; <span class="chapter-title">Step 0 — What this is about</span></span></a>
</div>
</li>
<li class="sidebar-item">
@@ -322,6 +333,23 @@ pre > code.sourceCode > span > a:first-child::before { text-decoration: underlin
<span class="menu-text"><span class="chapter-number">3</span>&nbsp; <span class="chapter-title">Part II — Cross the process boundary</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">Appendices</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="Toggle 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">Glossary</span></a>
</div>
</li>
</ul>
</li>
</ul>
</div>
</nav>
@@ -335,7 +363,6 @@ pre > code.sourceCode > span > a:first-child::before { text-decoration: underlin
<li><a href="#sec-about" id="toc-sec-about" class="nav-link active" data-scroll-target="#sec-about">About these notes</a>
<ul class="collapse">
<li><a href="#sec-diagrams" id="toc-sec-diagrams" class="nav-link" data-scroll-target="#sec-diagrams">How to read the diagrams</a></li>
<li><a href="#sec-build" id="toc-sec-build" class="nav-link" data-scroll-target="#sec-build">Building this book</a></li>
</ul></li>
</ul>
</nav>
@@ -345,7 +372,7 @@ pre > code.sourceCode > span > a:first-child::before { text-decoration: underlin
<header id="title-block-header" class="quarto-title-block default">
<div class="quarto-title">
<h1 class="title">From Calling to Eventing</h1>
<h1 class="title">Process Control</h1>
</div>
@@ -362,7 +389,7 @@ pre > code.sourceCode > span > a:first-child::before { text-decoration: underlin
<div>
<div class="quarto-title-meta-heading">Published</div>
<div class="quarto-title-meta-contents">
<p class="date">24 September 2026</p>
<p class="date">25 September 2026</p>
</div>
</div>
@@ -372,7 +399,7 @@ pre > code.sourceCode > span > a:first-child::before { text-decoration: underlin
<div>
<div class="abstract">
<div class="block-title">Abstract</div>
Step-by-step summaries of the SIN.04028 tutorial “From Calling to Eventing”, from direct method calls to an Event-Driven Architecture over MQTT. Process Control, given by Reto Konig, University of Fribourg, autumn semester 2026.
One small program, rebuilt step by step from direct method calls to an Event-Driven Architecture over MQTT: what moves at each step, and who ends up knowing whom.
</div>
</div>
@@ -395,34 +422,28 @@ MULTILINGUAL (see _extensions/notes/i18n.lua):
picture, just still.
- fixed section ids (#sec-...) so anchors are identical in all three books.
English is the verified source: the tutorial being summarised is written in
English. French and German are translations of it.
English is the verified source: the material these notes are built from is
written in English. French and German are translations of it.
Code identifiers, mailbox and topic names, file names, commands and protocol
terms are never translated (consoleIn.outbox, rot13/inbox, WatchService,
Mediator.java, .msg, put/take, Intent/Status/Event).
-->
<p>These notes summarise the tutorial <strong>“SIN.04028 — From Calling to Eventing”</strong>, worked through step by step. The tutorial itself lives next to this book, in <code>SIN.04028-From-Calling-to-Eventing/README.md</code>, and belongs to the <em>Process Control</em> course given by Reto Konig at the University of Fribourg (autumn semester 2026).</p>
<p>These notes follow one small program through a long series of rebuilds, from direct method calls to an event-driven architecture over MQTT. Every rebuild leaves the program doing exactly what it did before, and changes who knows about whom.</p>
<p>The program under construction never changes: you type a line, it comes back rotated by 13 letters.</p>
<pre class="text"><code>keyboard → ROT13 → console</code></pre>
<p>What changes is everything around it. The tutorial rebuilds the same system again and again while asking three questions, in this order:</p>
<p>What changes is everything around it. The same system is rebuilt again and again, and each rebuild asks three questions, in this order:</p>
<blockquote class="blockquote">
<p><strong>Who knows whom?</strong></p>
<p><strong>Who owns what?</strong></p>
<p><strong>Who decides how the system is wired together?</strong></p>
</blockquote>
<p>One summary is added here each time a step is finished, so the book grows at the pace of the work. Each summary says what the step did, what was observed when it ran, and what moved architecturally — usually a piece of knowledge that changed hands.</p>
<p><em>Based on material by Reto Konig, University of Fribourg.</em></p>
<section id="sec-diagrams" class="level2">
<h2 class="anchored" data-anchor-id="sec-diagrams">How to read the diagrams</h2>
<p>Every diagram exists once as a drawing and three times as a language. In the web version, a diagram that carries a message flow has a small play bar under it: <strong>Play</strong> walks one message through the whole chain, <strong>One hop</strong> advances a single step, and <strong>Reset</strong> puts it back. Boxes light up as the message reaches them, so you can see which component is waiting and which one is working.</p>
<p>In the PDF, and in a browser with JavaScript switched off, the same picture is there — just still. Nothing in the notes depends on the animation.</p>
</section>
<section id="sec-build" class="level2">
<h2 class="anchored" data-anchor-id="sec-build">Building this book</h2>
<p>The three books come from one source:</p>
<div class="code-copy-outer-scaffold"><div class="sourceCode" id="cb2"><pre class="sourceCode bash code-with-copy"><code class="sourceCode bash"><span id="cb2-1"><a href="#cb2-1" aria-hidden="true" tabindex="-1"></a><span class="ex">./render-all.sh</span> <span class="co"># figures, then html + pdf for en, fr, de</span></span>
<span id="cb2-2"><a href="#cb2-2" aria-hidden="true" tabindex="-1"></a><span class="ex">./render-all.sh</span> <span class="at">--serve</span> <span class="co"># …and serve _book/ on http://localhost:8000</span></span></code></pre></div><button title="Copy to Clipboard" class="code-copy-button"><i class="bi"></i></button></div>
<p><code>_book/</code> holds the English book, <code>_book/fr/</code> the French one and <code>_book/de/</code> the German one; the language menu in the sidebar switches between them and remembers the choice. A single <code>quarto render</code> builds English only and empties <code>_book/</code>, which removes the other two — so use the script.</p>
</section>
@@ -1052,8 +1073,8 @@ Mediator.java, .msg, put/take, Intent/Status/Event).
<div class="nav-page nav-page-previous">
</div>
<div class="nav-page nav-page-next">
<a href="./00-orientation.html" class="pagination-link" aria-label="[Step 0 — What the tutorial is about]{.en}[Étape 0 — De quoi parle le tutoriel]{.fr}[Schritt 0 — Worum es im Tutorial geht]{.de}">
<span class="nav-page-text"><span class="chapter-number">1</span>&nbsp; <span class="chapter-title">Step 0 — What the tutorial is about</span></span> <i class="bi bi-arrow-right-short"></i>
<a href="./00-orientation.html" class="pagination-link" aria-label="[Step 0 — What this is about]{.en}[Étape 0 — De quoi il s'agit]{.fr}[Schritt 0 — Worum es geht]{.de}">
<span class="nav-page-text"><span class="chapter-number">1</span>&nbsp; <span class="chapter-title">Step 0 — What this is about</span></span> <i class="bi bi-arrow-right-short"></i>
</a>
</div>
</nav>