Anforderungen an Applikationen und Schnittstellen
Funktionale vs. nichtfunktionale Anforderungen
Bei der Entwicklung einer Applikation werden Kundenbedürfnisse in zwei grundlegende Kategorien von Anforderungen übersetzt:
- Funktionale Anforderungen beschreiben, WAS ein System fachlich leisten muss — z. B. "Das System berechnet die Mehrwertsteuer auf eine Bestellung" oder "Benutzer können ihr Passwort zurücksetzen".
- Nichtfunktionale Anforderungen beschreiben Qualitätseigenschaften — WIE gut das System diese Funktionen erbringen muss, etwa Performance ("Antwortzeit unter 2 Sekunden"), Sicherheit, Verfügbarkeit, Usability, Skalierbarkeit oder Wartbarkeit.
Eine Anforderung wie "Die Suche muss bei 100'000 Datensätzen innert 2 Sekunden antworten" ist trotz konkreter Zahl eine nichtfunktionale Anforderung, da sie eine Qualitätseigenschaft (Performance) beschreibt, nicht die fachliche Funktion selbst.
Dokumentation von Anforderungen
Anforderungen werden strukturiert festgehalten, häufig als:
- User Stories ("Als [Rolle] möchte ich [Ziel], damit [Nutzen]")
- Use Cases (Anwendungsfälle mit Akteuren, Vorbedingungen, Ablauf, Ergebnis)
- Akzeptanzkriterien (messbare Bedingungen, wann eine Anforderung als erfüllt gilt)
Jede Anforderung erhält eine eindeutige Bezeichnung (Identifizierung), damit sie im Projektverlauf rückverfolgbar bleibt (Traceability).
Anforderungen erfassen und prüfen
- Lösungsneutral: Anforderungen legen fest, was das System leisten soll, ohne eine bestimmte Technologie oder Umsetzung vorzuschreiben; sie bleiben abgegrenzt und prüfbar.
- Prüfbar und aktuell: Bei Bedarf werden Anforderungen mit Beispielen oder Akzeptanzkriterien (Abnahmekriterien) ergänzt, damit eindeutig ist, wann sie erfüllt sind. Die Anforderungsdokumentation bleibt aktuell und enthält alle Änderungen während der Entwicklung; einheitliche Begriffsdefinitionen und eine klare Struktur sorgen dafür, dass alle Stakeholder dieselben Begriffe gleich verstehen.
- Eindeutige, unveränderliche Bezeichnung: Realisierungskonzept, Programmcode und Testfälle lassen sich damit der Anforderung zuordnen (Traceability), und bei Änderungen sind die nachzuführenden Teile sofort erkennbar. Die Bezeichnung verhindert Änderungen nicht und ersetzt weder Schätzung noch Priorisierung.
- Validierung: Die Anforderungen werden mit allen relevanten Stakeholdern abgestimmt, auch den späteren Endnutzern; Rückmeldungen werden aufgenommen und dokumentiert.
- Persona: Fiktive, konkret ausgearbeitete Beispielperson (Name, Alter, Ziele, Bedürfnisse), die eine typische Nutzergruppe repräsentiert; das Team richtet Anforderungen und Gestaltung daran aus.
- Systemanforderungen in HERMES: Gegliedert nach Anforderungskategorien (zum Beispiel Betriebs- und Sicherheitsanforderungen) und nach Wichtigkeit; sie reichen von Grobanforderungen mit Art, Wichtigkeit und Dringlichkeit bis zu Detailanforderungen (funktionale und Qualitätsanforderungen, Anforderungen aus dem ISDS-Konzept).
- Aufwand und Dauer: Der Aufwand bleibt gleich, die Dauer hängt von der eingesetzten Kapazität ab: 90 Stunden bei drei Entwicklern mit je 6 effektiven Stunden pro Tag ergeben $90 / 18 = 5$ Arbeitstage (effektive Stunden liegen unter der Anwesenheitszeit). Drei-Werte-Schätzung:
$$\text{erwartet} = \frac{\text{optimistisch} + 4 \cdot \text{wahrscheinlich} + \text{pessimistisch}}{6}$$
Beispiel: $(4 + 4 \cdot 7 + 16) / 6 = 8$ Stunden.
REST-Schnittstellen — Grundgedanke
REST (Representational State Transfer) ist ein weit verbreitetes Architekturprinzip für Programmierschnittstellen (APIs). Zentrale Konzepte:
- Ressourcen: Alles, worauf zugegriffen wird (z. B. ein Kunde, eine Bestellung), wird über eine eindeutige URI adressiert (z. B. /kunden/42).
- HTTP-Methoden: GET liest eine Ressource, POST erstellt eine neue Ressource, PUT ersetzt/aktualisiert eine bestehende Ressource vollständig, DELETE löscht eine Ressource.
- Statuscodes: Die Antwort enthält einen HTTP-Statuscode, der das Ergebnis klassifiziert — z. B. 200 (OK), 201 (Created), 400 (Bad Request), 401 (Unauthorized), 404 (Not Found), 500 (interner Serverfehler).
- Statelessness (Zustandslosigkeit): Jede Anfrage muss alle notwendigen Informationen enthalten (z. B. ein Auth-Token); der Server hält zwischen zwei Anfragen keinen Sitzungszustand. Das erleichtert Skalierbarkeit, da beliebige Serverinstanzen eine Anfrage bearbeiten können.
- Datenformat: Nutzdaten werden meist als JSON übertragen (schlankes, textbasiertes Format aus Schlüssel-Wert-Paaren).
HTTP-Methoden im Detail
| Methode | Eigenschaft |
|---|---|
| GET | Ruft Daten ab, ohne Anfrageinhalt; sicher und idempotent, kann zwischengespeichert und beliebig wiederholt werden. Zustandsändernde Aktionen gehören nicht dorthin. |
| HEAD | Liefert dieselben Kopfzeilen wie GET, aber ohne Nachrichteninhalt (zum Beispiel Grösse oder Änderungsdatum prüfen). |
| OPTIONS | Fragt die unterstützten Methoden bzw. Kommunikationsoptionen ab. |
| POST | Erstellt eine neue Ressource, deren Identität (ID) der Server vergibt; nicht idempotent, doppelt gesendet können zwei Datensätze entstehen. |
| PUT | Ersetzt eine bestehende Ressource vollständig; idempotent, aber nicht sicher. |
| PATCH | Ändert einzelne Teile einer Ressource; wird als nicht idempotent eingestuft. |
| DELETE | Löscht eine Ressource; idempotent. |
Idempotent heisst: Mehrmaliges identisches Ausführen ergibt denselben Serverzustand wie einmaliges. Sicher sind GET, HEAD und OPTIONS, weil sie nichts verändern. Ein Cookie ist ein kleiner, vom Server gesetzter Datensatz, den der Browser bei weiteren Anfragen mitsendet; so bleibt trotz zustandslosem HTTP eine Sitzung nachvollziehbar.
Statuscodes im Detail
Die Klassen: 2xx Erfolg, 3xx Umleitung, 4xx Fehler auf Seite des Clients (Anfrage prüfen), 5xx Fehler auf Seite des Servers.
| Code | Bedeutung |
|---|---|
| 201 Created | Neue Ressource erfolgreich angelegt |
| 301 / 302 | Dauerhafte bzw. vorübergehende Änderung der Adresse; Clients dürfen die Methode ändern |
| 307 / 308 | Vorübergehende bzw. dauerhafte Weiterleitung, die Methode bleibt erhalten (eine POST-Anfrage wird mit POST wiederholt) |
| 304 Not Modified | Zwischengespeicherte Antwort unverändert (Validierung mit If-None-Match oder If-Modified-Since) |
| 401 | Nicht authentifiziert (Authentifizierung fehlt oder ungültig) |
| 403 | Client bekannt, aber nicht berechtigt; ein Server darf stattdessen 404 senden, um die Existenz einer geschützten Ressource zu verbergen |
| 404 Not Found | Ressource nicht gefunden |
| 405 Method Not Allowed | Methode bekannt, von der Ressource aber nicht unterstützt (unbekannte Methoden führen zu 501) |
| 409 Conflict | Anfrage widerspricht dem aktuellen Zustand der Ressource (zum Beispiel konkurrierende Bearbeitung) |
| 429 Too Many Requests | Rate Limiting |
| 500 / 502 | Interner Serverfehler / ein Proxy oder Gateway erhielt vom dahinterliegenden Server eine ungültige Antwort |
Eine paginierte API mit 25 Einträgen pro Seite braucht für 238 Datensätze $\lceil 238/25 \rceil = 10$ Aufrufe.
Häufige Fehler
- Nichtfunktionale Anforderungen (z. B. Performance-Vorgaben) als funktionale Anforderungen einstufen, nur weil eine Zahl genannt wird.
- POST und PUT verwechseln — POST erstellt Neues, PUT ersetzt eine bekannte, bestehende Ressource.
- Annehmen, REST benötige serverseitige Sessions — das widerspricht dem Statelessness-Prinzip.
- HTTP-Statuscodes ignorieren und nur den Rückgabewert (Payload) prüfen, statt auch den Code auszuwerten.