Add chapters 05-08 to the three language profiles: the published book stopped at Part IV because only 00-04 were listed. Rename the MQTT topic root Tutorial/ to Demo/ in Part IX (code and output included). Shared notes extension 2.9.1: dependency folders are named after the extension version, so browsers stop serving stale scripts after an update. Full rebuild of _book/ (HTML and PDF, three languages); remove the stray site_libs/ that the last Deploy commit had added at the project root. Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
1547 lines
73 KiB
HTML
1547 lines
73 KiB
HTML
<!DOCTYPE html>
|
||
<html xmlns="http://www.w3.org/1999/xhtml" lang="de" xml:lang="de"><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>9 Teil IX — MQTT – Prozesssteuerung</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="./07-part-vii-mediation.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-210757d7e60e9c473d8941953b4a5eb7.css" rel="stylesheet" class="quarto-color-scheme" id="quarto-text-highlighting-styles">
|
||
<link href="site_libs/quarto-html/quarto-syntax-highlighting-dark-a3970363346c256deb16f4449f99893b.css" rel="stylesheet" class="quarto-color-scheme quarto-color-alternate" id="quarto-text-highlighting-styles">
|
||
<link href="site_libs/quarto-html/quarto-syntax-highlighting-210757d7e60e9c473d8941953b4a5eb7.css" rel="stylesheet" class="quarto-color-scheme-extra" 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-e333b860288efea83b591af437d45305.min.css" rel="stylesheet" append-hash="true" class="quarto-color-scheme" id="quarto-bootstrap" data-mode="light">
|
||
<link href="site_libs/bootstrap/bootstrap-dark-0fb591fb534e4de6e0a74f855bd29ac7.min.css" rel="stylesheet" append-hash="true" class="quarto-color-scheme quarto-color-alternate" id="quarto-bootstrap" data-mode="dark">
|
||
<link href="site_libs/bootstrap/bootstrap-e333b860288efea83b591af437d45305.min.css" rel="stylesheet" append-hash="true" class="quarto-color-scheme-extra" id="quarto-bootstrap" data-mode="light">
|
||
<script src="site_libs/quarto-contrib/calc-exo-2.9.1/exo.js"></script>
|
||
<link href="site_libs/quarto-contrib/calc-exo-2.9.1/exo.css" rel="stylesheet">
|
||
<script src="site_libs/quarto-contrib/calc-quiz-2.9.1/quiz.js"></script>
|
||
<link href="site_libs/quarto-contrib/calc-quiz-2.9.1/quiz.css" rel="stylesheet">
|
||
<link href="site_libs/quarto-contrib/calc-further-2.9.1/further.css" rel="stylesheet">
|
||
<link href="site_libs/quarto-contrib/calc-latex-tables-2.9.1/latex-tables.css" rel="stylesheet">
|
||
<script src="site_libs/quarto-contrib/calc-notes-2.9.1/calc-notes.js"></script>
|
||
<link href="site_libs/quarto-contrib/calc-notes-2.9.1/theme.css" rel="stylesheet">
|
||
<link href="site_libs/quarto-contrib/calc-notes-2.9.1/high-contrast.css" rel="stylesheet">
|
||
<link href="site_libs/quarto-contrib/calc-notes-2.9.1/calc-notes.css" rel="stylesheet">
|
||
<link href="site_libs/quarto-contrib/calc-notes-2.9.1/narrow.css" rel="stylesheet">
|
||
<script src="site_libs/quarto-contrib/calc-glossary-2.9.1/glossary.js"></script>
|
||
<link href="site_libs/quarto-contrib/calc-glossary-2.9.1/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": "Keine Treffer",
|
||
"search-matching-documents-text": "Treffer",
|
||
"search-copy-link-title": "Link in die Suche kopieren",
|
||
"search-hide-matches-text": "Zusätzliche Treffer verbergen",
|
||
"search-more-match-text": "weitere Treffer in diesem Dokument",
|
||
"search-more-matches-text": "weitere Treffer in diesem Dokument",
|
||
"search-clear-button-title": "Zurücksetzen",
|
||
"search-text-placeholder": "",
|
||
"search-detached-cancel-button-title": "Abbrechen",
|
||
"search-submit-button-title": "Abschicken",
|
||
"search-label": "Suchen"
|
||
}
|
||
}</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: #20666f;
|
||
--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"><script id="quarto-html-before-body" type="application/javascript">
|
||
const toggleBodyColorMode = (bsSheetEl) => {
|
||
const mode = bsSheetEl.getAttribute("data-mode");
|
||
const bodyEl = window.document.querySelector("body");
|
||
if (mode === "dark") {
|
||
bodyEl.classList.add("quarto-dark");
|
||
bodyEl.classList.remove("quarto-light");
|
||
} else {
|
||
bodyEl.classList.add("quarto-light");
|
||
bodyEl.classList.remove("quarto-dark");
|
||
}
|
||
}
|
||
const toggleBodyColorPrimary = () => {
|
||
const bsSheetEl = window.document.querySelector("link#quarto-bootstrap:not([rel=disabled-stylesheet])");
|
||
if (bsSheetEl) {
|
||
toggleBodyColorMode(bsSheetEl);
|
||
}
|
||
}
|
||
const setColorSchemeToggle = (alternate) => {
|
||
const toggles = window.document.querySelectorAll('.quarto-color-scheme-toggle');
|
||
for (let i=0; i < toggles.length; i++) {
|
||
const toggle = toggles[i];
|
||
if (toggle) {
|
||
if (alternate) {
|
||
toggle.classList.add("alternate");
|
||
} else {
|
||
toggle.classList.remove("alternate");
|
||
}
|
||
}
|
||
}
|
||
};
|
||
const toggleColorMode = (alternate) => {
|
||
// Switch the stylesheets
|
||
const primaryStylesheets = window.document.querySelectorAll('link.quarto-color-scheme:not(.quarto-color-alternate)');
|
||
const alternateStylesheets = window.document.querySelectorAll('link.quarto-color-scheme.quarto-color-alternate');
|
||
manageTransitions('#quarto-margin-sidebar .nav-link', false);
|
||
if (alternate) {
|
||
// note: dark is layered on light, we don't disable primary!
|
||
enableStylesheet(alternateStylesheets);
|
||
for (const sheetNode of alternateStylesheets) {
|
||
if (sheetNode.id === "quarto-bootstrap") {
|
||
toggleBodyColorMode(sheetNode);
|
||
}
|
||
}
|
||
} else {
|
||
disableStylesheet(alternateStylesheets);
|
||
enableStylesheet(primaryStylesheets)
|
||
toggleBodyColorPrimary();
|
||
}
|
||
manageTransitions('#quarto-margin-sidebar .nav-link', true);
|
||
// Switch the toggles
|
||
setColorSchemeToggle(alternate)
|
||
// Hack to workaround the fact that safari doesn't
|
||
// properly recolor the scrollbar when toggling (#1455)
|
||
if (navigator.userAgent.indexOf('Safari') > 0 && navigator.userAgent.indexOf('Chrome') == -1) {
|
||
manageTransitions("body", false);
|
||
window.scrollTo(0, 1);
|
||
setTimeout(() => {
|
||
window.scrollTo(0, 0);
|
||
manageTransitions("body", true);
|
||
}, 40);
|
||
}
|
||
}
|
||
const disableStylesheet = (stylesheets) => {
|
||
for (let i=0; i < stylesheets.length; i++) {
|
||
const stylesheet = stylesheets[i];
|
||
stylesheet.rel = 'disabled-stylesheet';
|
||
}
|
||
}
|
||
const enableStylesheet = (stylesheets) => {
|
||
for (let i=0; i < stylesheets.length; i++) {
|
||
const stylesheet = stylesheets[i];
|
||
if(stylesheet.rel !== 'stylesheet') { // for Chrome, which will still FOUC without this check
|
||
stylesheet.rel = 'stylesheet';
|
||
}
|
||
}
|
||
}
|
||
const manageTransitions = (selector, allowTransitions) => {
|
||
const els = window.document.querySelectorAll(selector);
|
||
for (let i=0; i < els.length; i++) {
|
||
const el = els[i];
|
||
if (allowTransitions) {
|
||
el.classList.remove('notransition');
|
||
} else {
|
||
el.classList.add('notransition');
|
||
}
|
||
}
|
||
}
|
||
const isFileUrl = () => {
|
||
return window.location.protocol === 'file:';
|
||
}
|
||
const hasAlternateSentinel = () => {
|
||
let styleSentinel = getColorSchemeSentinel();
|
||
if (styleSentinel !== null) {
|
||
return styleSentinel === "alternate";
|
||
} else {
|
||
return false;
|
||
}
|
||
}
|
||
const setStyleSentinel = (alternate) => {
|
||
const value = alternate ? "alternate" : "default";
|
||
if (!isFileUrl()) {
|
||
window.localStorage.setItem("quarto-color-scheme", value);
|
||
} else {
|
||
localAlternateSentinel = value;
|
||
}
|
||
}
|
||
const getColorSchemeSentinel = () => {
|
||
if (!isFileUrl()) {
|
||
const storageValue = window.localStorage.getItem("quarto-color-scheme");
|
||
return storageValue != null ? storageValue : localAlternateSentinel;
|
||
} else {
|
||
return localAlternateSentinel;
|
||
}
|
||
}
|
||
const toggleGiscusIfUsed = (isAlternate, darkModeDefault) => {
|
||
const baseTheme = document.querySelector('#giscus-base-theme')?.value ?? 'light';
|
||
const alternateTheme = document.querySelector('#giscus-alt-theme')?.value ?? 'dark';
|
||
let newTheme = '';
|
||
if(authorPrefersDark) {
|
||
newTheme = isAlternate ? baseTheme : alternateTheme;
|
||
} else {
|
||
newTheme = isAlternate ? alternateTheme : baseTheme;
|
||
}
|
||
const changeGiscusTheme = () => {
|
||
// From: https://github.com/giscus/giscus/issues/336
|
||
const sendMessage = (message) => {
|
||
const iframe = document.querySelector('iframe.giscus-frame');
|
||
if (!iframe) return;
|
||
iframe.contentWindow.postMessage({ giscus: message }, 'https://giscus.app');
|
||
}
|
||
sendMessage({
|
||
setConfig: {
|
||
theme: newTheme
|
||
}
|
||
});
|
||
}
|
||
const isGiscussLoaded = window.document.querySelector('iframe.giscus-frame') !== null;
|
||
if (isGiscussLoaded) {
|
||
changeGiscusTheme();
|
||
}
|
||
};
|
||
const authorPrefersDark = false;
|
||
const darkModeDefault = authorPrefersDark;
|
||
document.querySelector('link#quarto-text-highlighting-styles.quarto-color-scheme-extra').rel = 'disabled-stylesheet';
|
||
document.querySelector('link#quarto-bootstrap.quarto-color-scheme-extra').rel = 'disabled-stylesheet';
|
||
let localAlternateSentinel = darkModeDefault ? 'alternate' : 'default';
|
||
// Dark / light mode switch
|
||
window.quartoToggleColorScheme = () => {
|
||
// Read the current dark / light value
|
||
let toAlternate = !hasAlternateSentinel();
|
||
toggleColorMode(toAlternate);
|
||
setStyleSentinel(toAlternate);
|
||
toggleGiscusIfUsed(toAlternate, darkModeDefault);
|
||
window.dispatchEvent(new Event('resize'));
|
||
};
|
||
// Switch to dark mode if need be
|
||
if (hasAlternateSentinel()) {
|
||
toggleColorMode(true);
|
||
} else {
|
||
toggleColorMode(false);
|
||
}
|
||
</script>
|
||
|
||
<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="Seitenleiste umschalten" 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="./08-part-ix-mqtt.html"><span class="chapter-number">9</span> <span class="chapter-title">Teil IX — MQTT</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="Seitenleiste umschalten" onclick="if (window.quartoToggleHeadroom) { window.quartoToggleHeadroom(); }">
|
||
</a>
|
||
<button type="button" class="btn quarto-search-button" aria-label="Suchen" 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="./">Prozesssteuerung</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="./../fr/index.html">
|
||
Français
|
||
</a>
|
||
</li>
|
||
<li>
|
||
<a class="dropdown-item sidebar-tools-main-item" href="./index.html">
|
||
Deutsch
|
||
</a>
|
||
</li>
|
||
</ul>
|
||
</div>
|
||
<a href="./Prozesssteuerung.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-color-scheme-toggle quarto-navigation-tool px-1" onclick="window.quartoToggleColorScheme(); return false;" title="Dunkelmodus umschalten"><i class="bi"></i></a>
|
||
<a href="" class="quarto-reader-toggle quarto-navigation-tool px-1" onclick="window.quartoToggleReader(); return false;" title="Lesemodus umschalten">
|
||
<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="Suchen"></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">Über diese Notizen</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> <span class="chapter-title">Schritt 0 — Worum es geht</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> <span class="chapter-title">Teil I — Mit dem beginnen, was man schon kennt</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">
|
||
<span class="menu-text"><span class="chapter-number">3</span> <span class="chapter-title">Teil II — Die Prozessgrenze überschreiten</span></span></a>
|
||
</div>
|
||
</li>
|
||
<li class="sidebar-item">
|
||
<div class="sidebar-item-container">
|
||
<a href="./03-part-iii-distributed.html" class="sidebar-item-text sidebar-link">
|
||
<span class="menu-text"><span class="chapter-number">4</span> <span class="chapter-title">Teil III — Es wirklich verteilen</span></span></a>
|
||
</div>
|
||
</li>
|
||
<li class="sidebar-item">
|
||
<div class="sidebar-item-container">
|
||
<a href="./04-part-iv-rewind.html" class="sidebar-item-text sidebar-link">
|
||
<span class="menu-text"><span class="chapter-number">5</span> <span class="chapter-title">Teil IV — Zurückspulen</span></span></a>
|
||
</div>
|
||
</li>
|
||
<li class="sidebar-item">
|
||
<div class="sidebar-item-container">
|
||
<a href="./05-part-v-subscriptions.html" class="sidebar-item-text sidebar-link">
|
||
<span class="menu-text"><span class="chapter-number">6</span> <span class="chapter-title">Teil V — Die dynamische Idee über Prozesse hinweg wiederholen</span></span></a>
|
||
</div>
|
||
</li>
|
||
<li class="sidebar-item">
|
||
<div class="sidebar-item-container">
|
||
<a href="./06-part-vi-vocabulary.html" class="sidebar-item-text sidebar-link">
|
||
<span class="menu-text"><span class="chapter-number">7</span> <span class="chapter-title">Teil VI — Über Syncthing wiederholen und die Nachrichten benennen</span></span></a>
|
||
</div>
|
||
</li>
|
||
<li class="sidebar-item">
|
||
<div class="sidebar-item-container">
|
||
<a href="./07-part-vii-mediation.html" class="sidebar-item-text sidebar-link">
|
||
<span class="menu-text"><span class="chapter-number">8</span> <span class="chapter-title">Teil VII — Die zwei architektonischen Ideen zusammenführen</span></span></a>
|
||
</div>
|
||
</li>
|
||
<li class="sidebar-item">
|
||
<div class="sidebar-item-container">
|
||
<a href="./08-part-ix-mqtt.html" class="sidebar-item-text sidebar-link active">
|
||
<span class="menu-text"><span class="chapter-number">9</span> <span class="chapter-title">Teil IX — MQTT</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">Anhang</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="Abschnitt umschalten">
|
||
<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">Glossar</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">Auf dieser Seite</h2>
|
||
|
||
<ul>
|
||
<li><a href="#sec-filesystem-verdict" id="toc-sec-filesystem-verdict" class="nav-link active" data-scroll-target="#sec-filesystem-verdict"><span class="header-section-number">9.1</span> Was das Dateisystem gelehrt hat und wofür es nicht taugt</a></li>
|
||
<li><a href="#sec-mqtt-mapping" id="toc-sec-mqtt-mapping" class="nav-link" data-scroll-target="#sec-mqtt-mapping"><span class="header-section-number">9.2</span> MQTT sollte vertraut wirken</a></li>
|
||
<li><a href="#sec-paho" id="toc-sec-paho" class="nav-link" data-scroll-target="#sec-paho"><span class="header-section-number">9.3</span> Die Bibliothek, die Client-ID und die Broker-Adresse</a></li>
|
||
<li><a href="#sec-structured-intent" id="toc-sec-structured-intent" class="nav-link" data-scroll-target="#sec-structured-intent"><span class="header-section-number">9.4</span> Strukturierter Intent und zwei Mapper</a></li>
|
||
<li><a href="#sec-duise" id="toc-sec-duise" class="nav-link" data-scroll-target="#sec-duise"><span class="header-section-number">9.5</span> DUISE und das Umverdrahten im Betrieb</a></li>
|
||
<li><a href="#sec-retained-and-will" id="toc-sec-retained-and-will" class="nav-link" data-scroll-target="#sec-retained-and-will"><span class="header-section-number">9.6</span> Was ein neuer Abonnent erfährt und was ein Toter zugibt</a></li>
|
||
<li><a href="#sec-coupling-remains" id="toc-sec-coupling-remains" class="nav-link" data-scroll-target="#sec-coupling-remains"><span class="header-section-number">9.7</span> Was den Transport überlebte und welche Kopplung bleibt</a></li>
|
||
<li><a href="#sec-whole-journey" id="toc-sec-whole-journey" class="nav-link" data-scroll-target="#sec-whole-journey"><span class="header-section-number">9.8</span> Der ganze Weg</a></li>
|
||
<li><a href="#sec-sentences" id="toc-sec-sentences" class="nav-link" data-scroll-target="#sec-sentences"><span class="header-section-number">9.9</span> Die Sätze, die man behalten sollte</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-ix" class="quarto-section-identifier"><span class="chapter-number">9</span> <span class="chapter-title">Teil IX — MQTT</span></span></h1>
|
||
</div>
|
||
|
||
|
||
|
||
<div class="quarto-title-meta">
|
||
|
||
|
||
|
||
|
||
</div>
|
||
|
||
|
||
|
||
</header>
|
||
|
||
|
||
<!-- MULTILINGUAL: see the comment at the top of index.qmd.
|
||
Part VIII (step 53) is one step and opens this chapter rather than
|
||
standing alone. -->
|
||
<section id="sec-filesystem-verdict" class="level2" data-number="9.1">
|
||
<h2 data-number="9.1" class="anchored" data-anchor-id="sec-filesystem-verdict"><span class="header-section-number">9.1</span> Was das Dateisystem gelehrt hat und wofür es nicht taugt</h2>
|
||
<p>Das Dateisystem lehrte Veröffentlichungsgrenzen, Verzeichnisse als Adressen, Beobachtung, unabhängige Prozesse, unabhängige Sprachen, Synchronisationslatenz, Verdrahtung zur Laufzeit, State, Intent, Events, Vermittlerkosten, Dienstbesitz und Transformatordienste. Es war ein guter Lehrer und ist kein eleganter Nachrichten-Broker: am Ende war die Architektur sauber und der Transport ein Haufen <code>.tmp</code>-Dateien, atomarer Verschiebungen, erneuter Scans, geteilter Pfade und Replikationsverzögerung.</p>
|
||
<p>Die Schlussfolgerung ist <strong>nicht</strong> „Dateien schlecht, MQTT gut”. Das Dateisystem hat einen Vorteil, den MQTT nicht erreicht — es speichert routinemässig Gigabytes bis Terabytes, während Broker und Clients für kleine Nachrichten gebaut sind, und das Stückeln einer riesigen Nutzlast über MQTT heisst, ein Dateitransferprotokoll in einem Nachrichtenprotokoll zu erfinden. Also:</p>
|
||
<blockquote class="blockquote">
|
||
<p>Nachrichten für Koordination und Ereignisse. Für grosse Daten ein passender Datei- oder Objektspeicher. Eine Nachricht kann <strong>Ort, Identität und Metadaten</strong> dieser Daten tragen statt der Terabytes selbst.</p>
|
||
</blockquote>
|
||
<p>Ein repliziertes Dateisystem gibt zudem jeder Maschine eine lokale Kopie, eine echte Stärke — doch Replikation ist kein Backup: Löschungen und Beschädigungen replizieren mit, sofern nicht eine Versionierung ältere Kopien bewahrt.</p>
|
||
</section>
|
||
<section id="sec-mqtt-mapping" class="level2" data-number="9.2">
|
||
<h2 data-number="9.2" class="anchored" data-anchor-id="sec-mqtt-mapping"><span class="header-section-number">9.2</span> MQTT sollte vertraut wirken</h2>
|
||
<table class="caption-top table">
|
||
<thead>
|
||
<tr class="header">
|
||
<th>Dateisystem / Syncthing</th>
|
||
<th>MQTT</th>
|
||
</tr>
|
||
</thead>
|
||
<tbody>
|
||
<tr class="odd">
|
||
<td>Wurzel des synchronisierten Nachrichtenbretts</td>
|
||
<td>Broker / Namensraum</td>
|
||
</tr>
|
||
<tr class="even">
|
||
<td>Verzeichnispfad</td>
|
||
<td>Topic</td>
|
||
</tr>
|
||
<tr class="odd">
|
||
<td><code>.msg</code>-Datei</td>
|
||
<td>Veröffentlichung</td>
|
||
</tr>
|
||
<tr class="even">
|
||
<td>Dateiinhalt</td>
|
||
<td>Nutzlast</td>
|
||
</tr>
|
||
<tr class="odd">
|
||
<td><code>WatchService</code></td>
|
||
<td>Abonnement</td>
|
||
</tr>
|
||
<tr class="even">
|
||
<td>dynamisches Verzeichnis</td>
|
||
<td>Topic / Filter</td>
|
||
</tr>
|
||
<tr class="odd">
|
||
<td>Steuerverzeichnis</td>
|
||
<td><code>I</code></td>
|
||
</tr>
|
||
<tr class="even">
|
||
<td>Zustandsverzeichnis</td>
|
||
<td><code>S/…</code></td>
|
||
</tr>
|
||
<tr class="odd">
|
||
<td>Ereignisverzeichnis</td>
|
||
<td><code>E/…</code></td>
|
||
</tr>
|
||
</tbody>
|
||
</table>
|
||
<p>Die gewünschte Reaktion des Materials: „Ach. Diese Architektur kennen wir schon.” MQTT ist ein Transportwechsel, keine architektonische Aussage.</p>
|
||
<p>Zwei Dinge, die ein Verzeichnis nicht konnte, in einer Minute auf der Kommandozeile sichtbar. Eine Veröffentlichung <strong>vor</strong> der Existenz eines Abonnenten erreicht ihn nie — die Lehre der liegengebliebenen Nachrichten zum dritten Mal, nun mit einer Antwort, die das Dateisystem nie hatte. Und ein Filter wie <code>test/#</code> passt auf <code>test/a</code> und <code>test/a/b/c</code>, nicht aber auf <code>testing/x</code>, weil <code>#</code> auf <strong>Ebenen</strong> arbeitet, nicht auf Zeichenpräfixen; <code>test/+</code> passte nur eine Ebene tief.</p>
|
||
<p>Die tiefere Korrektur: <strong>ein Topic ist kein Behälter.</strong> Es gibt kein Objekt namens <code>test/a</code> auf dem Broker. Ein Topic ist ein Routing-Schlüssel, den jede Veröffentlichung trägt und der gegen die Filter derjenigen geprüft wird, die in diesem Moment abonniert haben. Verzeichnisse <em>halten</em> Nachrichten; Topics <em>vergleichen</em> sie. Ein Abonnement deckt daher Topics ab, die noch nicht existieren — wo ein Nachrichtenbrett ein neues Verzeichnis und eine neue Registrierung brauchte.</p>
|
||
</section>
|
||
<section id="sec-paho" class="level2" data-number="9.3">
|
||
<h2 data-number="9.3" class="anchored" data-anchor-id="sec-paho"><span class="header-section-number">9.3</span> Die Bibliothek, die Client-ID und die Broker-Adresse</h2>
|
||
<p>Java hat keinen MQTT-Client in der Standardbibliothek, also kommt Paho jetzt — nach dem Bedarf, wie der Vermittler in Schritt 7 und Jackson in Schritt 64. Vier Dinge braucht man: verbinden, veröffentlichen, abonnieren, Rückruf. Das Verbinden ist absichtlich unspektakulär: „Hier ist architektonisch nichts geschehen. Wir haben unseren Prozess nur an den Transport angeschlossen.”</p>
|
||
<p>Zwei Details des Verbindens haben Gewicht:</p>
|
||
<ul>
|
||
<li><strong>die Client-ID</strong> ist nicht bloss ein Eindeutigkeitsmerkmal. Der Broker erkennt daran einen zurückkehrenden Client und hält Sitzungszustand für ihn: Abonnements, bei QoS > 0 eingereihte Nachrichten und die Verknüpfung mit seinem Last Will. Ein Verzeichnis wusste nie, wer es beobachtete — genau deshalb spielte ein neu gestarteter Beobachter nichts nach.</li>
|
||
<li><strong>die Broker-Adresse</strong> ist Deployment-Konfiguration: jedes Programm liest <code>System.getProperty("mqtt.broker", "tcp://localhost:1883")</code>. Sie ist auch die einzige Konfiguration, die nicht als Intent kommen kann, denn Intent reist <em>durch</em> den Broker. Topologie lässt sich veröffentlichen; die Adresse des Veröffentlichenden nicht.</li>
|
||
</ul>
|
||
<p>Abonnieren kostet ein Paket, und <strong>der Broker führt die Abonnementliste</strong>. Es gibt keinen Standardweg, ihn zu fragen, was ein anderer Client abonniert hat — daher <code>S/subscriptions</code>: die eigene Erklärung einer Komponente über ihre Verdrahtung, veröffentlicht, damit die Architektur weiss, was der Transport privat hält. Nur ihr Eigentümer darf sie veröffentlichen, nach der Ein-Schreiber-Regel, denn nur er weiss, was er angenommen hat.</p>
|
||
</section>
|
||
<section id="sec-structured-intent" class="level2" data-number="9.4">
|
||
<h2 data-number="9.4" class="anchored" data-anchor-id="sec-structured-intent"><span class="header-section-number">9.4</span> Strukturierter Intent und zwei Mapper</h2>
|
||
<p><code>TOPIC some/path</code> hat ein Feld und eine Bedeutung. Es kann nicht sagen, welche <em>Art</em> Intent vorliegt, keinen zweiten Parameter tragen, nicht verschachteln, nicht erweitert werden; und ein Empfänger hat nichts, wogegen er prüfen könnte. Reicherer Intent braucht Struktur:</p>
|
||
<div class="code-copy-outer-scaffold"><div class="sourceCode" id="cb1"><pre class="sourceCode yaml code-with-copy"><code class="sourceCode yaml"><span id="cb1-1"><a href="#cb1-1" aria-hidden="true" tabindex="-1"></a><span class="fu">subscribe</span><span class="kw">:</span></span>
|
||
<span id="cb1-2"><a href="#cb1-2" aria-hidden="true" tabindex="-1"></a><span class="at"> </span><span class="fu">topic</span><span class="kw">:</span><span class="at"> Demo/ConsoleIn/U/alice/E/text</span></span></code></pre></div><button title="In die Zwischenablage kopieren" class="code-copy-button"><i class="bi"></i></button></div>
|
||
<p>Erst dann hat eine Serialisierungsbibliothek eine klare Aufgabe. <code>JsonTools</code> hält <strong>zwei</strong> Mapper, und die Asymmetrie ist Absicht:</p>
|
||
<ul>
|
||
<li>das Lesen nutzt eine <strong>YAML</strong>-Factory mit abgeschaltetem <code>FAIL_ON_UNKNOWN_PROPERTIES</code> — JSON ist eine Teilmenge von YAML, handgetippter Intent wird akzeptiert, und ein neuerer Konfigurator darf Felder senden, die ein älterer Dienst ignoriert;</li>
|
||
<li>das Schreiben nutzt strenges <strong>JSON</strong> mit <code>INDENT_OUTPUT</code>, die veröffentlichten Nutzlasten sind also streng und lesbar.</li>
|
||
</ul>
|
||
<p>Tolerant hinein, streng hinaus. Ein einziger Mapper müsste auf eines davon verzichten.</p>
|
||
</section>
|
||
<section id="sec-duise" class="level2" data-number="9.5">
|
||
<h2 data-number="9.5" class="anchored" data-anchor-id="sec-duise"><span class="header-section-number">9.5</span> DUISE und das Umverdrahten im Betrieb</h2>
|
||
<p>Das Namensschema erhält endlich seinen Namen: <strong>D</strong>escription (welche Verträge dieser Dienst versteht und veröffentlicht), <strong>U</strong>nit (welche Instanz), <strong>I</strong>ntent (gewünschtes Verhalten), <strong>S</strong>tatus (was jetzt gilt), <strong>E</strong>vent (was geschehen ist).</p>
|
||
<pre class="text"><code>Demo/ROT13/U/alice/{I, S/online, S/subscriptions/text, E/crypted}</code></pre>
|
||
<p><code>U/<unit></code> brauchte das Dateisystem nie: jede Maschine hatte ihr eigenes Replikat desselben relativen Pfades, Instanzidentität war implizit. MQTT hat einen gemeinsamen Namensraum, ein Topic muss also sagen, <em>welche</em> Kopie. <code>U/alice</code> in einer Fähigkeit festzuschreiben ist daher schlimmer, als <code>consoleIn.outbox</code> es je war: es bindet das Build an ein Deployment. Per Intent konfiguriert, <strong>dient ein Build allen</strong> — daher die drei Unit-Namen als Argumente von <code>MqttConfigure</code>. Die Unit-Namen <em>sind</em> die Topologie.</p>
|
||
<p>Umverdrahten, am laufenden System beobachtet: einen neuen Intent mit anderer Quelle veröffentlichen, und der Dienst kündigt die alte, abonniert die neue und veröffentlicht <code>S/subscriptions</code> passend neu. Kein Neustart, keine Änderung. Schickt man stattdessen einen ungültigen Filter — <code>Demo/#/E/text</code>, wo <code>#</code> nicht die letzte Ebene ist — weist <code>MqttTools.isValidFilter</code> ihn ab; das alte Abonnement bleibt, und der Status sagt weiter die Wahrheit.</p>
|
||
<p>Diese Abweisung legt eine echte Lücke offen, die man benennen und nicht verstecken sollte: sie wird nur lokal protokolliert. Der Konfigurator erfährt nicht, ob sein Intent angewandt oder abgelehnt wurde, und ein Monitor kann „abgelehnt” nicht von „noch nicht verarbeitet” unterscheiden. In diesem Entwurf erfährt ein Sender das Ergebnis, indem er den Status liest und mit seiner Anfrage vergleicht. Abweisungen als Event zu veröffentlichen oder ein Letzter-Fehler-Status würden die Lücke schliessen; beides steht nicht im Material — es ist eine zu begründende Entwurfsentscheidung.</p>
|
||
</section>
|
||
<section id="sec-retained-and-will" class="level2" data-number="9.6">
|
||
<h2 data-number="9.6" class="anchored" data-anchor-id="sec-retained-and-will"><span class="header-section-number">9.6</span> Was ein neuer Abonnent erfährt und was ein Toter zugibt</h2>
|
||
<p>Drei Sekunden <code>Demo/#</code> abonnieren, ohne dass etwas veröffentlicht wird, ergibt dies:</p>
|
||
<pre class="text"><code>Demo/ROT13/U/nitro5/S/online {"value":true}
|
||
Demo/ROT13/U/nitro5/S/subscriptions/text "Demo/ConsoleIn/U/nitro5/E/text"
|
||
Demo/ConsoleOut/U/nitro5/S/online {"value":true}
|
||
Demo/ConsoleOut/U/nitro5/S/subscriptions/text "Demo/ROT13/U/nitro5/E/crypted"</code></pre>
|
||
<p>Ein Spätankömmling erfährt augenblicklich die gesamte aktuelle Verdrahtung des Systems, ohne jemanden zu fragen und ohne dass eine Komponente von einem Monitor weiss. Das ist retained <strong>Status</strong>. Keine Events kommen an, denn Events werden nicht retained veröffentlicht — „retained State, nicht retained Events”. Es ist auch die richtige Antwort auf den Reflex, einen Dienst zu <em>fragen</em>, was er tut: niemand fragt; der Dienst erklärt es einmal, und der Broker bewahrt es für jeden, der kommt.</p>
|
||
<p>Retained Status allein würde allerdings lügen. Beendet man einen Dienst mit <code>Ctrl+C</code>, bleibt sein <code>S/online = true</code> für immer beim Broker. Daher der <strong>Last Will</strong>, bei der Verbindung registriert:</p>
|
||
<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><span class="dt">var</span> will <span class="op">=</span> <span class="kw">new</span> <span class="fu">MqttMessage</span><span class="op">(</span><span class="st">"{</span><span class="sc">\"</span><span class="st">value</span><span class="sc">\"</span><span class="st">:false}"</span><span class="op">.</span><span class="fu">getBytes</span><span class="op">(</span>UTF_8<span class="op">),</span> <span class="dv">1</span><span class="op">,</span> <span class="kw">true</span><span class="op">,</span> <span class="kw">new</span> <span class="fu">MqttProperties</span><span class="op">());</span></span>
|
||
<span id="cb4-2"><a href="#cb4-2" aria-hidden="true" tabindex="-1"></a>options<span class="op">.</span><span class="fu">setWill</span><span class="op">(</span>lastWillTopic<span class="op">,</span> will<span class="op">);</span></span></code></pre></div><button title="In die Zwischenablage kopieren" class="code-copy-button"><i class="bi"></i></button></div>
|
||
<p>Der Will ist <strong>retained</strong>, ersetzt also beim Veröffentlichen durch den Broker das veraltete <code>true</code>. Die Komponente, die ausfällt, ist nicht die, die den Ausfall meldet — die einzige Anordnung, die funktionieren kann. Ein Vorbehalt: ein sauberes DISCONNECT löst <strong>keinen</strong> Will aus; ein gut erzogener Dienst veröffentlicht daher beim Beenden selbst <code>online=false</code>, und der Will deckt die hässlichen Tode.</p>
|
||
</section>
|
||
<section id="sec-coupling-remains" class="level2" data-number="9.7">
|
||
<h2 data-number="9.7" class="anchored" data-anchor-id="sec-coupling-remains"><span class="header-section-number">9.7</span> Was den Transport überlebte und welche Kopplung bleibt</h2>
|
||
<p>Die untere Hälfte der Tabelle Dateisystem→MQTT ist der Punkt: <code>I</code>, <code>S</code>, <code>E</code>, egoistische Dienste, Topologie zur Laufzeit und „Transformator wenn nötig” sind <strong>unverändert</strong>. Die Architektur überlebte den Transportwechsel, und das ist der stärkste verfügbare Beleg, dass sie nie am Transport hing.</p>
|
||
<p>Lose Kopplung heisst nicht, dass nichts etwas weiss. Notwendig bleibt die Einigkeit über: Nachrichtensyntax, Nachrichtensemantik, Topic-Verträge, Intent, Besitz, Bedeutung von State und Bedeutung von Events. Ziel ist nicht, Kopplung zu beseitigen, sondern <strong>unnötiges Wissen</strong> zu beseitigen. Konkret muss hier jeder Dienst genau einen fremden Event-Vertrag verstehen — ROT13 den <code>E/text</code> von ConsoleIn, ConsoleOut den <code>E/crypted</code> von ROT13 — plus das Intent-Schema, das er auf seinem eigenen <code>I</code> annimmt. Diese Liste ist das unverzichtbare Minimum.</p>
|
||
<p>Davon getrennt: der Broker ist eine geteilte Infrastrukturabhängigkeit; alle brauchen seine Adresse, und ohne ihn läuft nichts. Real, aber anderer Art als das Wissen einer Komponente über eine andere.</p>
|
||
<p>Die Prüfliste aus Schritt 78 ist das Werkzeug, das bleibt. Zwölf Fragen, von denen diese sechs das Argument dieses Systems tragen:</p>
|
||
<table class="caption-top table">
|
||
<colgroup>
|
||
<col style="width: 50%">
|
||
<col style="width: 50%">
|
||
</colgroup>
|
||
<thead>
|
||
<tr class="header">
|
||
<th>Frage</th>
|
||
<th>Antwort hier</th>
|
||
</tr>
|
||
</thead>
|
||
<tbody>
|
||
<tr class="odd">
|
||
<td>enthält eine Fähigkeit eine festgeschriebene Produzentenidentität?</td>
|
||
<td>nein — sie kommt als Intent</td>
|
||
</tr>
|
||
<tr class="even">
|
||
<td>welche fremden Verträge muss sie verstehen?</td>
|
||
<td>je einen Event-Vertrag, plus ihr eigenes Intent-Schema</td>
|
||
</tr>
|
||
<tr class="odd">
|
||
<td>wo ist die Topologie definiert?</td>
|
||
<td>im Konfigurator, ausserhalb des Datenpfads</td>
|
||
</tr>
|
||
<tr class="even">
|
||
<td>kann sich die Topologie ohne Neukompilieren ändern?</td>
|
||
<td>ja — am laufenden System gezeigt</td>
|
||
</tr>
|
||
<tr class="odd">
|
||
<td>könnte der Transport ersetzt werden?</td>
|
||
<td>ja — gezeigt: Dateisystem, dann MQTT</td>
|
||
</tr>
|
||
<tr class="even">
|
||
<td>leistet jeder Vermittler etwas, das Vermittlung braucht?</td>
|
||
<td>ja, trivial: <code>TEXT → TEXT</code> braucht keine, und es gibt keinen</td>
|
||
</tr>
|
||
</tbody>
|
||
</table>
|
||
<p>Die Mahnung des Materials gilt: die Antworten müssen nicht alle „nein” lauten. Sie müssen <strong>absichtlich</strong> sein.</p>
|
||
</section>
|
||
<section id="sec-whole-journey" class="level2" data-number="9.8">
|
||
<h2 data-number="9.8" class="anchored" data-anchor-id="sec-whole-journey"><span class="header-section-number">9.8</span> Der ganze Weg</h2>
|
||
<p>Das Programm hat sich nie geändert: eine Zeile geht hinein, dieselbe kommt um 13 Buchstaben verschoben heraus. Geändert hat sich, elfmal, wie die Teile verbunden sind und wer das Wissen über diese Verbindung hält.</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>Stufe</th>
|
||
<th>wie die Teile verbunden sind</th>
|
||
<th>wo die Topologie liegt</th>
|
||
<th>im Datenpfad ausser den Fähigkeiten</th>
|
||
</tr>
|
||
</thead>
|
||
<tbody>
|
||
<tr class="odd">
|
||
<td>1 prozedural</td>
|
||
<td>direkte Aufrufe</td>
|
||
<td>im Code der Fähigkeit</td>
|
||
<td>—</td>
|
||
</tr>
|
||
<tr class="even">
|
||
<td>2 egoistische Dienste</td>
|
||
<td>gar nicht verbunden</td>
|
||
<td>nirgends — das ist das Problem</td>
|
||
<td>—</td>
|
||
</tr>
|
||
<tr class="odd">
|
||
<td>3 statische Vermittlung, eine JVM</td>
|
||
<td>Postfächer, von Vermittlern kopiert</td>
|
||
<td>die Vermittler, gestartet in <code>main()</code></td>
|
||
<td>zwei Vermittler</td>
|
||
</tr>
|
||
<tr class="even">
|
||
<td>4 statische Vermittlung, Dateisystem</td>
|
||
<td>Verzeichnisse, von Vermittlerprozessen kopiert</td>
|
||
<td>die Befehlszeilen des Bedieners</td>
|
||
<td>zwei Vermittlerprozesse</td>
|
||
</tr>
|
||
<tr class="odd">
|
||
<td>5 statische Vermittlung, Syncthing</td>
|
||
<td>replizierte Verzeichnisse</td>
|
||
<td>die Befehlszeilen des Bedieners</td>
|
||
<td>zwei Vermittlerprozesse, dazu Replikationsverzögerung</td>
|
||
</tr>
|
||
<tr class="even">
|
||
<td>6 benannte, konfigurierbare Vermittler</td>
|
||
<td><code>ROUTE</code>-Intent von einem Orchestrator</td>
|
||
<td>der Orchestrator, ausserhalb des Pfads</td>
|
||
<td>weiterhin die Vermittler</td>
|
||
</tr>
|
||
<tr class="odd">
|
||
<td>7 dynamisch, eine JVM</td>
|
||
<td>die Dienste hören selbst, gesteuert durch <code>TOPIC</code>-Intent</td>
|
||
<td>der Konfigurator</td>
|
||
<td>nichts</td>
|
||
</tr>
|
||
<tr class="even">
|
||
<td>8 dynamisch, Dateisystem</td>
|
||
<td>dasselbe, über Verzeichnisse</td>
|
||
<td>der Konfigurator</td>
|
||
<td>nichts</td>
|
||
</tr>
|
||
<tr class="odd">
|
||
<td>9 dynamisch, Syncthing</td>
|
||
<td>dasselbe, über replizierte Verzeichnisse</td>
|
||
<td>der Konfigurator</td>
|
||
<td>nichts — nur Transportsprünge</td>
|
||
</tr>
|
||
<tr class="even">
|
||
<td>10 Verträge</td>
|
||
<td>kompatibel: direkt; inkompatibel: ein Transformator</td>
|
||
<td>der Konfigurator</td>
|
||
<td>ein Transformator, nur wo Verträge sich unterscheiden</td>
|
||
</tr>
|
||
<tr class="odd">
|
||
<td>11 MQTT</td>
|
||
<td>Topics auf einem Broker</td>
|
||
<td>der Konfigurator</td>
|
||
<td>nichts — der Broker ist Transport</td>
|
||
</tr>
|
||
</tbody>
|
||
</table>
|
||
<p>Die dritte Spalte von oben nach unten gelesen: die Topologie wandert nach aussen, Stufe um Stufe, bis keine Fähigkeit mehr etwas davon hält. Die letzte gelesen: der Preis dieser Wanderung fällt in Stufe 7 auf null und bleibt dort, während darunter dreimal der Transport wechselt. Dieselbe Architektur, besserer Transport.</p>
|
||
</section>
|
||
<section id="sec-sentences" class="level2" data-number="9.9">
|
||
<h2 data-number="9.9" class="anchored" data-anchor-id="sec-sentences"><span class="header-section-number">9.9</span> Die Sätze, die man behalten sollte</h2>
|
||
<ul>
|
||
<li><strong>„Event-driven” beschreibt, wie Information und Steuerung fliessen.</strong></li>
|
||
<li><strong>Lose Kopplung beschreibt, wie viel die Beteiligten voneinander wissen müssen.</strong></li>
|
||
<li><strong>Veröffentliche, was geschehen ist.</strong></li>
|
||
<li><strong>Erkläre, was du willst.</strong></li>
|
||
<li><strong>Veröffentliche deinen eigenen Zustand.</strong></li>
|
||
<li><strong>Halte Fähigkeiten egoistisch.</strong></li>
|
||
<li><strong>Halte die Topologie aus den Fähigkeiten heraus.</strong></li>
|
||
<li><strong>Bezahle keinen Vermittler, der nicht wirklich vermittelt.</strong></li>
|
||
</ul>
|
||
<p>Und wann immer eine Architektur verwirrend wird, zurück zur ersten Frage dieses Buches: <strong>wer kennt wen?</strong></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:
|
||
|
||
{#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 the extension's --calc-… tokens, the same ones
|
||
diagram.css uses, so the figure, the token and the bar stay in step in
|
||
light mode, in night mode and in high contrast. Nothing here keys off
|
||
prefers-color-scheme: the page's own toggle decides. -->
|
||
|
||
<style>
|
||
.flow-wrap { margin: 0; }
|
||
.flow-wrap svg { width: 100%; height: auto; display: block; }
|
||
|
||
.flow-token {
|
||
fill: var(--calc-accent-b, #D1541F);
|
||
stroke: var(--calc-surface, #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: var(--calc-accent-b, #D1541F); }
|
||
|
||
.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 var(--calc-grid, #dae0e8); border-radius: 999px;
|
||
background: var(--calc-surface, #fbfcfd); color: var(--calc-muted, #5a6879);
|
||
}
|
||
.flow-bar button:hover {
|
||
border-color: var(--calc-notecolor, #20666f);
|
||
color: var(--calc-notecolor, #20666f);
|
||
}
|
||
.flow-bar button[disabled] { opacity: .45; cursor: default; }
|
||
.flow-status { font-size: .8rem; color: var(--calc-muted, #5a6879); }
|
||
.flow-status b { color: var(--calc-notecolor, #20666f); font-weight: 600; }
|
||
</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) {
|
||
// Ensure there is a toggle, if there isn't float one in the top right
|
||
if (window.document.querySelector('.quarto-color-scheme-toggle') === null) {
|
||
const a = window.document.createElement('a');
|
||
a.classList.add('top-right');
|
||
a.classList.add('quarto-color-scheme-toggle');
|
||
a.href = "";
|
||
a.onclick = function() { try { window.quartoToggleColorScheme(); } catch {} return false; };
|
||
const i = window.document.createElement("i");
|
||
i.classList.add('bi');
|
||
a.appendChild(i);
|
||
window.document.body.appendChild(a);
|
||
}
|
||
setColorSchemeToggle(hasAlternateSentinel())
|
||
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", "Kopiert");
|
||
let tooltip;
|
||
if (window.bootstrap) {
|
||
button.setAttribute("data-bs-toggle", "tooltip");
|
||
button.setAttribute("data-bs-placement", "left");
|
||
button.setAttribute("data-bs-title", "Kopiert");
|
||
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="./07-part-vii-mediation.html" class="pagination-link" aria-label="[Part VII — Now merge the two architectural ideas]{.en}[Partie VII — Fusionner les deux idées architecturales]{.fr}[Teil VII — Die zwei architektonischen Ideen zusammenführen]{.de}">
|
||
<i class="bi bi-arrow-left-short"></i> <span class="nav-page-text"><span class="chapter-number">8</span> <span class="chapter-title">Teil VII — Die zwei architektonischen Ideen zusammenführen</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">Glossar</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> |