Ergebnis dieses Guides
Eine kleine öffentliche Schnittstelle
Arbeitsumgebung
Go mit go.mod, definierter Toolchain und dem vorgesehenen Zielsystem
Wann ist diese Entscheidung wichtig?
Module begrenzen Zuständigkeiten und Abhängigkeiten. Ihre öffentliche Schnittstelle sollte kleiner sein als ihre interne Umsetzung.
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.
Module: Schritt für Schritt.
- 01
Vorbereiten
Listen Sie benötigte Exporte und deren Verbraucher auf. Trennen Sie Bibliothekslogik von ausführbarem Startcode.
- 02
In Go umsetzen
Importieren Sie nur die ausdrücklich freigegebenen Funktionen. Vermeiden Sie Kreisabhängigkeiten und Seiteneffekte beim Laden eines Moduls.
- 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 Funktion wird aus einem zweiten Modul aufgerufen
- Erwartetes Ergebnis
- Der Import funktioniert mit der vorgesehenen Laufzeit und dem Projekt-Build.
- Fehler- oder Grenzfall
- Ein bloßer Import öffnet keine Datenbankverbindung und startet keine unerwartete Hintergrundarbeit.
Abnahme und typische Fehler.
- Eine Änderung hat einen überschaubaren Wirkungsbereich.
- Ein bloßer Import öffnet keine Datenbankverbindung und startet keine unerwartete Hintergrundarbeit.
- Nebenläufigkeit und Fehlerbehandlung sollen explizit bleiben statt durch Abstraktion verborgen zu werden.
Typischer Fehler
Zirkuläre Importe und riesige Sammelmodule verwischen Grenzen.
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.
