Skip to content

1. Einführung

Das PDF des Dokuments finden Sie |HIER|.

Den Code des Dokuments finden Sie |HIER|.

Dieses Dokument ist ein Produkt der KI Claude von Anthropic. Es folgt auf das Dokument „Schritt-für-Schritt-Einführung in das Web-Framework [Spring MVC]“ (2026), das seinerseits auf die Dokumente „Schritt-für-Schritt-Einführung in das Web-Framework [ASP.NET Core MVC]“ und „Schritt-für-Schritt-Einführung in das Web-Framework [NestJS]“ (2026) folgte. Dieses Dokument überträgt den Kurs [Spring MVC] auf die Umgebung [Python]:

  • Das Framework [Spring MVC] und die Sprache [Java] werden durch das Framework [Flask] 3.1 und die Sprache [Python] (Version 3.12 oder höher) ersetzt;
  • Die [Thymeleaf]-Views werden durch [Jinja2]-Views ersetzt, die View-Engine von [Flask];
  • Die Validierung mit [Bean Validation] wird durch die Bibliothek [Pydantic] (Aktionsparameter) und durch die Bibliothek [WTForms] (HTML-Formulare) ersetzt;
  • [Spring Security] wird durch einige Dutzend Zeilen [Python]-Code ersetzt, die eigens dafür geschrieben wurden und auf den Bibliotheken [PyJWT] (die JWT-Token) und [bcrypt] (Passwort-Hashing) beruhen;
  • ORM, [Hibernate], und [Spring Data JPA] werden durch ORM und [SQLAlchemy] ersetzt, weiterhin auf Basis von [MySQL].

Das Dokument folgt eng der Struktur des Kurses [Spring MVC]: Zuerst kommen zahlreiche kleine Projekte, die jeweils ein bestimmtes Konzept behandeln, danach eine umfassende Fallstudie – eine Webanwendung zur Terminverwaltung einer Arztpraxis – mit vollständig kommentierten Dateien. Die Beispiele tragen dieselben Nummern und behandeln dieselben Themen wie in den Kursen [Spring MVC] und [ASP.NET Core MVC]: Wer einen dieser Kurse kennt, kann die Frameworks Beispiel für Beispiel vergleichen. Das ist jedoch nicht nötig: Dieses Dokument ist in sich abgeschlossen und setzt keine Vorkenntnisse in [Spring] oder [ASP.NET] voraus. Vorausgesetzt werden lediglich Grundkenntnisse der Webprogrammierung (das HTTP-Protokoll, die Sprache HTML) und der Sprache [Python] (Funktionen, Klassen, Dictionaries, Module). Ein früherer Kurs des Autors, Einführung in die Sprache Python und das Web-Framework Flask anhand von Beispielen (2020), führt in die Sprache [Python] selbst ein, für alle, die sie zuerst erlernen müssen.

1.1. Die Rolle von Flask in einer Webanwendung

Eine Webanwendung wird häufig in Schichten aufgebaut, wobei jede Schicht nur mit den benachbarten Schichten kommuniziert:

Image

  • Die Web-Schicht empfängt die HTTP-Anfragen des Browsers und liefert ihm HTML-Seiten zurück. Dies ist die Schicht, bei deren Programmierung [Flask] uns hilft;
  • Die Geschäftsschicht enthält die Geschäftsregeln der Anwendung (z. B. „Ein Patient kann nur einen bevorstehenden Termin haben“). Sie weiß nichts über das Web: Sie könnte ebenso gut eine Kommandozeilenanwendung bedienen;
  • Die Datenzugriffsschicht (DAO-Schicht, [DAO] für [Data Access Object]) liest aus der Datenbank und schreibt in sie. Wir verwenden [SQLAlchemy], einen ORM ([Object Relational Mapper]), der die Zeilen der Tabellen auf [Python]-Objekte abbildet.

Die Web-Schicht selbst folgt dem Modell [MVC] ([Model – View – Controller]):

  • Der Controller (C) ist eine Menge von [Python]-Funktionen, die als Aktionen bezeichnet werden und von denen jede einen Anfragetyp verarbeitet (zum Beispiel [GET /schedule]). Eine Aktion liest die Anfrageparameter, ruft die Geschäftsschicht auf und wählt dann die anzuzeigende View aus;
  • Das Modell (M) ist die Menge der Daten, die die Aktion an die View übergibt;
  • die View (V) ist eine [Jinja2]-Datei (Erweiterung [.html]): eine HTML-Seite, die Ausdrücke [{{ ... }}] und Anweisungen [{% ... %}] ([{% if %}], [{% for %}] ...) enthält, die die [Jinja2]-Engine durch Daten aus dem Modell ersetzt.

Ein Hinweis zur Terminologie, um Verwirrung zu vermeiden: Die Dokumentation von [Flask] bezeichnet die Funktion, die eine Anfrage verarbeitet, als eine „View-Funktion“ und die [Jinja2]-Datei als „Template“. Dieses Dokument verwendet die Terminologie des Modells [MVC] sowie die der Kurse [Spring MVC] und [ASP.NET Core MVC] : Die Funktion, die eine Anfrage verarbeitet, ist eine Aktion, die [Jinja2]-Datei, die die Seite erzeugt, ist eine View, und der Begriff „Template“ bezeichnet die gemeinsame View, von der andere Seiten erben (Kapitel 4).

Die Verarbeitung einer Anfrage folgt den nummerierten Schritten im Diagramm:

  • 1: Der Browser sendet eine Anfrage, etwa HTTP oder [GET /schedule?doctorId=1&day=2026-09-26];
  • 2: Der Webserver empfängt die Anfrage und übergibt sie an die [Flask]-Anwendung. Während der Entwicklung ist dieser Server [Werkzeug], die Bibliothek, auf der [Flask] aufbaut; in der Produktion wird es ein Server wie [Waitress] oder [Gunicorn] sein. [Werkzeug] vergleicht den angeforderten Pfad mit den Routen der Anwendung und wählt die Aktion aus, die für diese Anfrage zuständig ist: Das ist das Routing. Bevor die Anfrage die Aktion erreicht, kann sie noch Funktionen durchlaufen, die für alle Anfragen ausgeführt werden ([before_request]), die wir in späteren Kapiteln untersuchen werden;
  • 3: Die Aktion fordert die benötigten Daten bei der Geschäftsschicht an; falls nötig, wendet sich die Geschäftsschicht an die [DAO]-Schicht, die die Datenbank [MySQL] per SQL abfragt;
  • 4: Die Aktion erstellt das Modell M der View und weist die [Jinja2]-Engine an, die Seite zu erzeugen (Funktion [render_template]);
  • 5: Die von der View erzeugte HTML-Seite ist die Antwort der Aktion, die [Flask] an den Browser zurückgibt.

[Flask] ist eines der beiden am häufigsten verwendeten Web-Frameworks der [Python]-Welt, neben [Django]. Frei und quelloffen, läuft es überall dort, wo [Python] läuft ([Windows], [Linux], [macOS]). Es ist ein Micro-Framework: Sein Kern ist bewusst klein gehalten (Routing, Anfragen und Antworten, Sitzungen, [Jinja2]-Views), und alles Übrige (Formularvalidierung, Datenbankzugriff, Authentifizierung usw.) übernehmen Bibliotheken, die der Entwickler auswählt. Während [Spring Boot] von sich aus einen kohärenten Satz von Komponenten konfiguriert, [Flask] überlässt es dem Entwickler, seine eigenen zusammenzustellen: Die Anwendung ist transparenter, und man sieht alles, was in ihr vorgeht. Gerade das macht es zu einem guten Werkzeug zum Lernen: Fast nichts ist verborgen. [Flask] kann sowohl Server erstellen, die JSON an einen [JavaScript]-Client ([Angular], [React], [Flutter] ...) zurückgeben, als auch herkömmliche Webanwendungen, bei denen der Server die HTML-Seiten erzeugt und der Browser sie nur anzeigt. Dieses Dokument behandelt diesen zweiten Anwendungsfall. Zwei Konzepte von [Python] kehren auf jeder Seite wieder: Dekoratoren ([@app.get("/")], [@app.before_request] ...), die eine Funktion mit einer Aufgabe verknüpfen, und die explizite Übergabe der Objekte, die jede Funktion benötigt, während [Spring] sie automatisch injiziert.

1.2. Verwendete Werkzeuge

Die Beispiele wurden mit den folgenden Werkzeugen geschrieben und getestet (ihre Installation wird im Anhang beschrieben):

  • [Python] 3.13 (jede Version ab 3.12 ist geeignet). Das [Python]-Installationsprogramm liefert außerdem das Werkzeug [pip], das die Bibliotheken herunterlädt und installiert, sowie das Modul [venv], das virtuelle Umgebungen erstellt (was das ist, besprechen wir später);
  • der Editor [Visual Studio Code] mit der [Python]-Erweiterung von Microsoft (die auch die Erweiterung [Pylance] installiert, die den Code analysiert);
  • ein aktueller Browser ([Chrome], [Firefox], [Edge]);
  • das Kommandozeilenwerkzeug [curl], das die rohen HTTP-Antworten anzeigt (es ist in [Windows] 10 und 11 enthalten);
  • das DBMS [MySQL] (oder [MariaDB]), zum Beispiel das von [Laragon] unter [Windows], ab dem Kapitel über den Datenzugriff und für die Fallstudie.

Anders als das [JDK], das [Spring] nicht enthält, [Python] wird mit einer sehr umfangreichen Standardbibliothek geliefert; aber [Flask] und die übrigen Bibliotheken des Dokuments sind nicht enthalten: [pip] lädt sie bei der Installation aus dem Repository [PyPI] ([Python Package Index]) herunter (an diesem Tag muss also eine Internetverbindung bestehen). Jedes Projekt beschreibt seine Bibliotheken in einer Datei [requirements.txt]. Die folgende Tabelle listet sie mit den verwendeten Versionen auf:

Bibliothek
Rolle
Version
[Flask]
das Web-Framework: Routing, Anfragen, Antworten, Sitzungen, Views; es enthält [Werkzeug] (HTTP-Anfragen, Entwicklungsserver), [Jinja2] (Views) und [itsdangerous] (Signaturen)
3.1.3
[asgiref]
asynchrone Aktionen ([async def]), installiert durch [Flask[async]] (Beispiel 03)
3.12.1
[Pydantic]
Binding und Validierung der Aktionsparameter (Kapitel 3)
2.13.5
[email-validator]
Validierung von E-Mail-Adressen, für [Pydantic] und [WTForms]
2.3.0
[Flask-WTF]
die HTML-Formulare ([WTForms]) und der Anti-CSRF-Schutz (Kapitel 4)
1.3.0
[Babel]
Sprachspezifische Formatierung von Datumsangaben und Beträgen (Kapitel 3 und 4)
2.18.0
[PyJWT]
JWT-Token (Kapitel 8)
2.15.0
[bcrypt]
Passwort-Hashes (Kapitel 8)
5.0.0
[SQLAlchemy]
ORM, Datenbankzugriff (Kapitel 9)
2.1.1
[PyMySQL]
Der [MySQL]-Treiber, geschrieben in [Python] (Kapitel 9)
1.2.3
[Waitress]
Ein Produktions-Webserver (Fallstudie)
3.0.2

1.3. Die Fallstudie ausführen

Anmerkung des Prüfers: Ich rate dem Leser, die Fallstudie sofort wie unten beschrieben auszuführen. Sobald Sie die Rolle dieser Terminanwendung vollständig verstanden haben, bitten Sie Ihre bevorzugte KI, die Anwendung wie folgt zu ändern: Künftig kann jeder Arzt:

  • seine eigenen Terminfenster zwischen zwei Daten festlegen. So kann er seinen Terminkalender nach Bedarf anpassen;
  • bestimmte Zeitfenster für einen bestimmten Tag aus dem Kalender entfernen – zum Beispiel, wenn er aus persönlichen Gründen nicht verfügbar ist;

Die Änderung ist nicht trivial, da sie eine Änderung der Datenbankstruktur erfordert. Bitten Sie die KI, Ihnen den neuen Anwendungscode und das SQL-Skript zum Erstellen der neuen Datenbank zu liefern. Dazu müssen Sie ihr die ZIP-Datei mit dem vollständigen Projekt sowie das SQL-Skript der alten Datenbank zur Verfügung stellen.

Außerdem habe ich den von Claude erstellten Kurs nicht durchgesehen. Er hatte bereits die perfekten Kurse [NestJS], [ASP.NET Core MVC] und [Spring MVC] erstellt. Ich bin davon ausgegangen, dass dies auch für diesen Kurs gilt. Wenn Sie beim Verständnis von etwas auf ein Problem stoßen, ist die Lösung immer dieselbe: Bitten Sie Ihre bevorzugte KI, Ihnen zu erklären, was Sie nicht verstehen. Claude zum Beispiel ist darin sehr gut. Möglicherweise müssen Sie das Beispiel, das Sie nicht verstehen, zu ihm „hochladen“.

Ende der Anmerkung.

Die Fallstudie am Ende dieses Dokuments ist eine vollständige Anwendung. Leser werden sie wahrscheinlich in Aktion sehen wollen, bevor sie sich in die Details des Frameworks vertiefen: Hier erfahren Sie, wie Sie sie ausführen. Sie befindet sich im Ordner [rdvmedecins2-flask], neben dem Ordner [examples]:

1
2
3
flask-sept-2026/
├── examples/
└── rdvmedecins2-flask/

Sie müssen [Python] (Version 3.12 oder höher), [Visual Studio Code] und [MySQL] installiert haben (siehe Anhänge). Dann:

  • Erstellen Sie die [dbrdvmedecins2]-Datenbank, indem Sie das Skript [rdvmedecins2-flask/database/dbrdvmedecins2.sql] ausführen. Mit [Laragon] öffnen Sie das Werkzeug [HeidiSQL] (Schaltfläche „Datenbank“) und führen das Skript dann über das Menü Datei / SQL ausführen aus. In der Kommandozeile, aus dem Ordner [rdvmedecins2-flask]:
mysql -u root < database/dbrdvmedecins2.sql
  • Öffnen Sie den [rdvmedecins2-flask]-Ordner in [Visual Studio Code] (Menü Datei / Ordner öffnen) und öffnen Sie dann ein Terminal (Menü Terminal / Neues Terminal);
  • Erstellen Sie die virtuelle Umgebung der Anwendung und aktivieren Sie sie. Eine virtuelle Umgebung ist ein Ordner (hier [.venv]), der eine Kopie des [Python]-Interpreters und der Bibliotheken für ein bestimmtes Projekt enthält – und nur dieser Bibliotheken: Jedes Projekt hat seine eigenen, in den Versionen, die zu ihm passen, ohne andere Projekte auf dem Rechner zu stören. Unter [Windows] (Eingabeaufforderung oder Terminal von [Visual Studio Code]):
python -m venv .venv
.venv\Scripts\activate

und unter [Linux] und [macOS]:

python3 -m venv .venv
source .venv/bin/activate
  • Sobald die Umgebung aktiviert ist, beginnt die Eingabeaufforderung des Terminals mit [(.venv)], und die Befehle [python] und [pip] sind die der Umgebung. Unter [Windows] weigert sich das [PowerShell]-Terminal manchmal, das Aktivierungsskript auszuführen (Meldung: „Die Skriptausführung ist auf diesem System deaktiviert“): Der Befehl [Set-ExecutionPolicy -Scope CurrentUser RemoteSigned], einmalig eingegeben, erlaubt sie. [Visual Studio Code] erkennt die Umgebung und bietet an, sie für das Projekt zu verwenden: Sie müssen dies akzeptieren (Sie können sie auch über den Python-Befehl „Select Interpreter“ auswählen, Strg+Umschalt+P); danach geöffnete Terminals aktivieren sie automatisch;
  • Installieren Sie die Bibliotheken der Anwendung in der virtuellen Umgebung:
pip install -r requirements.txt
  • Überprüfen Sie die Verbindung zur Datenbank. Die Anwendung verbindet sich mit [MySQL] auf [localhost], Port 3306, mit dem Benutzer [root] ohne Passwort (die Standardeinstellungen von [Laragon]). Wenn Ihr Konto [root] ein Passwort hat, tragen Sie es in der Datei [config.py] der Anwendung in der Zeile [DB_PASSWORD = ""] ein (zum Beispiel [DB_PASSWORD = "myPassword"]). Um zu vermeiden, ein Passwort in eine Projektdatei zu schreiben, können Sie es auch in der Umgebungsvariablen [FLASK_DB_PASSWORD] angeben, die Vorrang vor der Datei hat: [set FLASK_DB_PASSWORD=myPassword] unter [Windows] (Eingabeaufforderung), [$env:FLASK_DB_PASSWORD="myPassword"] unter [PowerShell], [export FLASK_DB_PASSWORD=myPassword] unter [Linux] und [macOS];
  • Starten Sie die Anwendung (unter [Linux] und [macOS] mit [python3] , falls [python] nicht existiert):
python app.py
  • Die Anwendung liest die Datenbank und startet dann den [Flask]-Entwicklungsserver. Die Konsole zeigt die an die Datenbank gesendeten SQL-Befehle (hier sind nur die wichtigsten wiedergegeben), gefolgt von den Servermeldungen:
... INFO sqlalchemy.engine.Engine BEGIN (implicit)
... INFO sqlalchemy.engine.Engine SELECT doctors.title, doctors.last_name, doctors.first_name, ... FROM doctors LEFT OUTER JOIN users AS users_1 ON users_1.id = doctors.user ORDER BY doctors.last_name, doctors.first_name
... INFO sqlalchemy.engine.Engine ROLLBACK
... INFO sqlalchemy.engine.Engine BEGIN (implicit)
... INFO sqlalchemy.engine.Engine SELECT clients.title, clients.last_name, clients.first_name, ... FROM clients LEFT OUTER JOIN users AS users_1 ON users_1.id = clients.user ORDER BY clients.last_name, clients.first_name
... INFO sqlalchemy.engine.Engine ROLLBACK
 * Serving Flask app 'rdvmedecins'
 * Debug mode: on
WARNING: This is a development server. Do not use it in a production deployment. Use a production WSGI server instead.
 * Running on http://127.0.0.1:8081
Press CTRL+C to quit
 * Restarting with stat
 ... (the same SQL commands)
 * Debugger is active!
 * Debugger PIN: 332-612-699

Jede Zeile von [SQLAlchemy] beginnt mit Datum und Uhrzeit (hier ersetzt durch [...]). Sie zeigt, dass die Anwendung die Liste der Ärzte und Kunden gelesen hat (die beiden SQL-Abfragen), dass der Server auf Port 8081 an der Adresse [127.0.0.1] lauscht (also [localhost]) und dass er im Debug-Modus läuft: Die Anwendung startet automatisch neu, sobald eine [Python]-Datei geändert wird ([Restarting with stat]: Der Prozess, der die Dateien überwacht, startet die Anwendung neu, die dann die Datenbank erneut liest), und ein unerwarteter Fehler zeigt eine Debug-Seite an (die „PIN“ schützt diese Seite vor der Konsole). Die Warnung erinnert daran, dass dieser Server für die Entwicklung gedacht ist, nicht für die Produktion (die Fallstudie erklärt, wie man einen Produktionsserver verwendet);

  • Öffnen Sie die URL [http://localhost:8081] in einem Browser:

Image

  • Melden Sie sich mit einem der Demokonten an, bei denen jeweils der Benutzername als Passwort dient: [admin] (Administrator), [pelissier], [tatou], [dupont] (Ärzte), [martin], [durand], [bistrou], [german] (Patienten). Außerdem müssen Sie die Zeichen aus dem Bild eingeben, in Groß- oder Kleinschreibung.

Beim Start liest die Anwendung die Datenbank: Wenn [MySQL] nicht erreichbar ist, bricht sie sofort ab, und die Konsole zeigt den Grund am Ende einer langen Fehlermeldung an (vor der Zeile „Background on this error“). Lautet die Meldung [Can't connect to MySQL server on 'localhost' ([Errno 111] Connection refused)] (oder [[WinError 10061]] unter [Windows]), bedeutet das, dass [MySQL] nicht gestartet wurde; bei [Access denied for user 'root'@'localhost'] ist das Passwort falsch; bei [Unknown database 'dbrdvmedecins2'] wurde das SQL-Skript nicht ausgeführt; bei [ModuleNotFoundError: No module named 'flask'] ist die virtuelle Umgebung nicht aktiviert (oder die Bibliotheken wurden nicht darin installiert); bei [Address already in use] (oder [Port 8081 is in use by another program]) ist Port 8081 bereits belegt (zum Beispiel durch die Version [Spring MVC] der Anwendung). Die Datei [README.md] der Anwendung beschreibt weitere Szenarien. Beenden Sie die Anwendung mit [Ctrl-C] im Terminal.

Die Fallstudie am Ende des Dokuments zeigt, wie die Anwendung verwendet wird, und erklärt anschließend jede ihrer Dateien.

1.4. Beispiele

Die Beispiele liegen im Ordner [examples], mit einem Unterordner pro Beispiel:

1
2
3
4
5
6
7
8
examples/
├── 01-structure/
├── 02-routing/
├── ...
├── 28-layers/
├── common/
│   └── bootstrap/
└── requirements.txt

Jedes Beispiel ist eine kleine ([Flask]-)Anwendung, die für sich allein läuft. Alle Beispiele verwenden dieselben Bibliotheken, die in der Datei [examples/requirements.txt] beschrieben sind:

# die Bibliotheken der Beispiele: pip install -r requirements.txt
# (die Versionen, mit denen die Beispiele geschrieben und getestet wurden)
Flask[async]==3.1.3
Flask-WTF==1.3.0
email-validator==2.3.0
pydantic==2.13.5
Babel==2.18.0
PyJWT==2.15.0
bcrypt==5.0.0
SQLAlchemy==2.1.1
PyMySQL[rsa]==1.2.3
  • Zeile 3: [Flask] und das, was zum Schreiben asynchroner Aktionen nötig ist (das Zusatzpaket [[async]], das die Bibliothek [asgiref] hinzufügt; siehe Beispiel 03);
  • Zeilen 4–7: Formulare, Validierung und sprachspezifische Formatierung;
  • Zeilen 8–9: Authentifizierung (Kapitel 8);
  • Zeilen 10–11: Datenbankzugriff (Kapitel 9). Das Zusatzpaket [[rsa]] zu [PyMySQL] fügt die Bibliothek [cryptography] hinzu, die erforderlich ist, um sich mit einem passwortgeschützten Konto mit einem [MySQL]-8-Server zu verbinden.

Jede Zeile hat die Form [name==version]: Der Operator [==] verlangt genau diese Version, mit der die Beispiele getestet wurden. Man könnte weniger streng sein ([Flask>=3.1]: Version 3.1 oder höher); eine künftige Version einer Bibliothek kann jedoch ihr Verhalten ändern, und ein Kurs muss exakt wie geschrieben reproduzierbar sein. Zeilen, die mit [#] beginnen, sind Kommentare.

Um die Beispiele auszuführen, erstellen Sie zunächst einmalig die virtuelle Umgebung für die Beispiele im Ordner [examples] (Details siehe Fallstudie):

1
2
3
python -m venv .venv
.venv\Scripts\activate
pip install -r requirements.txt

([source .venv/bin/activate] unter [Linux] und [macOS]). Der Ordner [common/bootstrap] enthält das CSS und das Framework [Bootstrap], die von den Beispielen gemeinsam genutzt werden, die ihre Seiten formatieren (ab Beispiel 15).

Fast alle Beispiele haben denselben Aufbau. Hier zum Beispiel der von Beispiel 13:

13-first-view/
├── controllers/
│   ├── __init__.py
│   └── views.py
├── models/
│   ├── __init__.py
│   └── page.py
├── templates/
│   └── views/
│       ├── index.html
│       └── unknown.html
└── app.py
  • [app.py]: die Startdatei der Anwendung, die ausgeführt wird; sie baut die Anwendung auf und startet den Server (siehe Beispiel 01);
  • [controllers]: die Controller, d. h. die Dateien, die die Aktionen enthalten. Dies ist ein Paket [Python]: ein Ordner mit Modulen ([.py]-Dateien), die importiert werden können ([from controllers.views import views]). Die Datei [__init__.py], die hier leer ist, macht den Ordner zu einem Paket (sie wird beim ersten Import des Pakets ausgeführt);
  • [models]: die Klassen, die die Modelle beschreiben (Aktionen und Views);
  • [templates]: die [Jinja2] -Views (ab Kapitel 4). [Flask] sucht sie in diesem Ordner, neben der Anwendungsdatei;
  • [static] (ab Beispiel 15): Dateien, die unverändert an den Browser gesendet werden (Stylesheets, Bilder, [JavaScript]-Skripte).

Um ein Beispiel auszuführen, öffnen Sie ein Terminal in seinem Ordner (in [Visual Studio Code]: Rechtsklick auf den Beispielordner, dann „In integriertem Terminal öffnen“ wählen), aktivieren Sie die virtuelle Umgebung des Beispiels, falls sie nicht bereits aktiv ist ([..\.venv\Scripts\activate] unter [Windows], [source ../.venv/bin/activate] unter [Linux], und [macOS]: Die Umgebung befindet sich im Ordner [examples], dem übergeordneten Ordner des Beispielordners), und geben Sie ein:

python app.py

Alle Beispiele lauschen auf Port 5000: Es kann nur eines gleichzeitig ausgeführt werden. Beenden Sie den Server mit [Ctrl-C] im Terminal. Unter [macOS] ist Port 5000 manchmal schon vom „AirPlay-Empfänger“ des Systems belegt (Meldung [Address already in use]): Sie können ihn unter Systemeinstellungen / Allgemein / AirDrop und Handoff deaktivieren oder den Port in der Datei [app.py] des Beispiels ändern ([port=5001]).

Wenn Sie den Ordner [examples] in [Visual Studio Code] öffnen, schlägt die [Python]-Erweiterung vor, die Umgebung [.venv] zu verwenden: So profitieren Sie in jeder Datei von Syntaxhervorhebung, Codevervollständigung und Fehlermeldungen. Jedes Beispiel wird aus seinem eigenen Ordner gestartet; deshalb beginnen die Importe eines Beispiels ([from controllers.views import views]) in diesem Ordner. [Pylance], das den Code ausgehend vom geöffneten Ordner ([examples]) analysiert, kann diese Importe dann als fehlend markieren: Das hat keine Auswirkung auf die Ausführung. Damit [Pylance] sie findet, öffnen Sie einfach den Ordner des Beispiels selbst (Menü Datei / Ordner öffnen). Schließlich laufen alle Beispiele im Debug-Modus (siehe Beispiel 01): Eine laufende Anwendung startet automatisch neu, nach etwa einer Sekunde, sobald eine ihrer [Python]-Dateien geändert und gespeichert wird.

Beispiele, die [Bootstrap] verwenden, finden es im Ordner [common/bootstrap] und nicht in ihrem eigenen Ordner: So ist sichergestellt, dass nur eine Kopie der Datei existiert. Jedes dieser Beispiele ruft es über die URL [/bootstrap/...] auf, mit ein paar Zeilen in seiner Datei [app.py]. Zum Beispiel [15-layout/app.py]:

# app.py: die Anwendung von Beispiel 15
from datetime import date
from pathlib import Path

from flask import Blueprint, Flask, request

from controllers.pages import pages

# Bootstrap, von den Beispielen gemeinsam genutzt: der Ordner examples/common/bootstrap,
# ausgehend vom Speicherort DIESER Datei bestimmt (und nicht vom aktuellen Ordner)
BOOTSTRAP = Path(__file__).resolve().parent.parent / "common" / "bootstrap"


def create_app():
    app = Flask(__name__)
    app.jinja_env.trim_blocks = True
    app.jinja_env.lstrip_blocks = True
    # ein Blueprint ohne Routen, der nur statische Dateien ausliefert: der
    # Ordner BOOTSTRAP, unter der URL /bootstrap/...
    app.register_blueprint(Blueprint("bootstrap", __name__, static_folder=BOOTSTRAP,
                                     static_url_path="/bootstrap"))
    app.register_blueprint(pages)
  • Zeile 11: der Pfad zum Ordner [common/bootstrap]. [__file__] ist der Pfad zur aktuell ausgeführten Datei ([app.py]); [Path(...).resolve()] macht daraus einen absoluten Pfad; [.parent] bezeichnet den Ordner, der sie enthält ([15-layout]), und [.parent.parent] bezeichnet den übergeordneten Ordner ([examples]). Der Operator [/] eines [Path] -Objekts fügt dem Pfad ein Element hinzu, und zwar mit dem richtigen Trennzeichen ([\] unter [Windows], [/] sonst). Der Pfad hängt also nicht vom aktuellen Ordner ab: Das Beispiel findet [Bootstrap] unabhängig davon, von wo aus es gestartet wird;
  • Zeilen 20–21: Ein Blueprint ist eine in der Anwendung registrierte Gruppe von Routen (siehe Beispiel 02). Dieser Blueprint hat keine Routen: Er dient ausschließlich dazu, den Ordner [common/bootstrap] (Parameter [static_folder]) unter der URL [/bootstrap] (Parameter [static_url_path]) bereitzustellen. Eine Seite kann so das Stylesheet [/bootstrap/css/bootstrap.min.css] verwenden.

Die übrigen Zeilen dieser Datei werden in Beispiel 15 erklärt.

1.5. Inhalt des Dokuments

Das Dokument ist wie folgt aufgebaut:

Kapitel
Inhalt
Beispiele
Aktionen, Routing, Antworten
Von der Anfrage zur Aktion: Routen, Blueprints, Antworten, Weiterleitungen, gemeinsame Services
01 bis 06
Das Modell einer Aktion
Anfrageparameter: Binding, Konvertierung, Validierung mit [Pydantic], POST-Formulare
07 bis 12
Die View und ihr Template
[Jinja2], Template, Makros, [WTForms]-Formulare, Validierung, PRG, Anti-CSRF-Schutz
13 bis 21
Internationalisierung
Eine Anwendung auf Französisch und Englisch
22
Datenbereiche (Scopes)
Anwendung, Anfrage, Sitzung, Client
23
Der Lebenszyklus einer Anfrage
WSGI-Middleware, [before_request], [after_request], [teardown_request], Konverter, Fehlerbehandlung
24
Authentifizierung und Autorisierung
JWT in einem Cookie, Dekoratoren, Rollen, CAPTCHA, Versuchsbegrenzung
25–27
Schichtenarchitektur
Web / Geschäftslogik / DAO mit [SQLAlchemy] und [MySQL]
28
Fallstudie
Die Anwendung RdvMedecins, Datei für Datei erklärt
-

Jedes Beispiel führt nur wenige neue Konzepte ein, und die Kapitel bauen aufeinander auf: Am besten lesen Sie sie der Reihe nach. Die Fallstudie dagegen greift auf alle Konzepte der vorherigen Kapitel zurück: Wo es sinnvoll ist, verweist ihr Kommentar auf das Beispiel, in dem das Konzept eingeführt wurde. Die Anhänge beschreiben die Installation der Werkzeuge: [Python], [Visual Studio Code] und seine Erweiterung [Python], [MySQL] mit [Laragon] und [curl].