Ergebnis dieses Guides
Ein kleiner Änderungsvorschlag mit überprüfbarem Verhalten
Arbeitsumgebung
Go mit go.mod, definierter Toolchain und dem vorgesehenen Zielsystem
Wann ist diese Entscheidung wichtig?
Qualität zeigt sich daran, wie leicht eine fachliche Änderung verstanden und geprüft werden kann. Zusätzliche Abstraktion ist nicht automatisch hilfreich.
Modellieren Sie Daten mit klaren Typen und geben Sie erwartete Fehler ausdrücklich zurück. Begrenzen Sie nebenläufige Arbeit und sorgen Sie bei Netzwerkzugriffen für einen nachvollziehbaren Abbruch über den zuständigen Kontext.
Codequalität: Schritt für Schritt.
- 01
Vorbereiten
Wählen Sie eine schwer verständliche Stelle und notieren Sie ihr beobachtbares Verhalten.
- 02
In Go umsetzen
Trennen Sie Verantwortlichkeiten, benennen Sie fachliche Begriffe und entfernen Sie echte Doppelarbeit. Prüfen Sie danach denselben Nutzerfall.
- 03
Im tatsächlichen Projekt prüfen
Führen Sie Build und Tests im Modul aus. Prüfen Sie Fehlerwerte und Aufräumen von Ressourcen; bei gemeinsam veränderlichen Daten gehört die Erkennung von Datenrennen zur passenden Prüfung.
Beispiel zur Überprüfung
So lässt sich das Ergebnis prüfen.
Als Projektkontext dient eine API für interne Integrationen. Der folgende Prüffall ist eine Vorlage für diese Aufgabe und kein Bericht über eine Kundenmessung.
- Eingabe / Auslöser
- Eine neue Variante einer bestehenden fachlichen Regel
- Erwartetes Ergebnis
- Die Änderung betrifft einen klaren Bereich und ihre Wirkung ist durch gezielte Prüfungen belegt.
- Fehler- oder Grenzfall
- Eine Umstrukturierung verändert weder Schnittstellen noch Fehlerverhalten unbeabsichtigt.
Abnahme und typische Fehler.
- Eine Änderung lässt sich ohne umfangreiche Seiteneffekte umsetzen.
- Eine Umstrukturierung verändert weder Schnittstellen noch Fehlerverhalten unbeabsichtigt.
- Nebenläufigkeit und Fehlerbehandlung sollen explizit bleiben statt durch Abstraktion verborgen zu werden.
Typischer Fehler
Abstraktion um ihrer selbst willen macht einfachen Code schwer.
Quellen und Versionshinweis
Die Anleitung beschreibt das Vorgehen; konkrete APIs, Produktfunktionen und Laufzeitgrenzen müssen zur eingesetzten Version passen. Halten Sie Version, Konfiguration und Prüfergebnis im Projekt fest und vergleichen Sie die verlinkte Dokumentation bei Änderungen.
