Tilstandsmaskiner og navigationsdiagrammer
Mange ting i et system opfører sig forskelligt afhængigt af, hvad der er sket tidligere. En ordre kan ikke afsendes, før den er betalt. En bruger kan ikke se sin profil, før hun er logget ind. En billetautomat reagerer forskelligt på et tryk på knappen, alt efter om der er puttet penge i.
En tilstandsmaskine er en måde at beskrive netop det: Hvilke tilstande kan noget være i, og hvad får det til at skifte fra én tilstand til en anden?
Et navigationsdiagram er en tilstandsmaskine, hvor “noget” er brugergrænsefladen. Mere om det nedenfor.
En tilstandsmaskine (på engelsk state machine, i UML state machine diagram) beskriver livsforløbet for én ting: et objekt, en proces, en ordre, en maskine.
Diagrammet svarer på tre spørgsmål:
- Hvilke tilstande kan tingen være i?
- Hvilke hændelser får den til at skifte tilstand?
- Hvad sker der undervejs i skiftet?
Tingen er altid i præcis én tilstand ad gangen (med mindre vi bruger parallelle tilstande, se nedenfor). Den bliver i tilstanden, indtil der sker noget, der flytter den.
stateDiagram-v2
[*] --> Oprettet
Oprettet --> Betalt : betaling modtaget
Oprettet --> Annulleret : kunde annullerer
Betalt --> Afsendt : pakke afleveret til fragt
Betalt --> Annulleret : kunde annullerer / refunder beløb
Afsendt --> Leveret : kvittering fra fragtfirma
Leveret --> [*]
Annulleret --> [*]Læg mærke til, hvad diagrammet ikke tillader: En ordre kan ikke gå direkte fra Oprettet til Afsendt, og en afsendt ordre kan ikke annulleres. Det er netop styrken ved diagrammet: Det gør reglerne synlige, så man kan diskutere dem, før man koder dem.
| Element | Tegnes som | Betydning |
|---|---|---|
| Tilstand | Rektangel med runde hjørner | En situation, tingen befinder sig i, f.eks. Betalt |
| Transition (overgang) | Pil fra én tilstand til en anden | Et skift fra én tilstand til en anden |
| Starttilstand | Udfyldt sort cirkel | Hvor livsforløbet begynder. Der er altid præcis én |
| Sluttilstand | Udfyldt cirkel inde i en ring | Hvor livsforløbet slutter. Der kan være flere eller ingen |
| Hændelse | Tekst på pilen | Det, der udløser skiftet, f.eks. betaling modtaget |
| Guard (betingelse) | Tekst i firkantede parenteser på pilen | Skiftet sker kun, hvis betingelsen er sand, f.eks. [beløb >= pris] |
| Handling | Tekst efter / på pilen | Noget der udføres, når skiftet sker, f.eks. / refunder beløb |
Den fulde form er:
hændelse [guard] / handling
Eksempel: indsæt mønt [beløb >= pris] / udlever billet
Læses: Når der indsættes en mønt, og beløbet er mindst prisen, så udleveres en billet, og vi skifter tilstand.
Alle tre dele er valgfrie. Ofte står der kun en hændelse.
En tilstand kan også selv have handlinger knyttet til sig:
entry / ...udføres, når man går ind i tilstandenexit / ...udføres, når man går ud af tilstandendo / ...udføres løbende, mens man er i tilstanden
Eksempel: Tilstanden Opvarmer kan have entry / tænd varmelegeme og exit / sluk varmelegeme.
- Sammensat tilstand (composite state): En tilstand, der selv indeholder en lille tilstandsmaskine. Bruges til at holde store diagrammer overskuelige. Eksempel: Tilstanden Kører i et varmeanlæg kan indeholde undertilstandene Opvarmer og Køler.
- Parallelle tilstande (concurrent states): En sammensat tilstand, der er delt op i områder med stiplede linjer. Tingen er så i én tilstand i hvert område på samme tid. Eksempel: En musikafspiller kan samtidig være i Afspiller og Shuffle til.
En tilstandsmaskine er nyttig, når en ting:
- har et tydeligt livsforløb med faser (ordre, sag, booking, ansøgning)
- reagerer forskelligt på den samme hændelse afhængigt af, hvilken tilstand den er i
- har regler om, hvad der må ske hvornår
Den hjælper jer med at:
- få styr på reglerne, før I koder
- opdage huller, f.eks. “Hvad sker der, hvis kunden annullerer, efter pakken er sendt?”
- tale med kunden og hinanden om, hvordan systemet skal opføre sig
Og når I koder, ender en tilstandsmaskine ofte som noget meget konkret: et enum med tilstandene og nogle metoder, der kun tillader de lovlige skift.
public enum OrderStatus { OPRETTET, BETALT, AFSENDT, LEVERET, ANNULLERET }
- En billetautomat / tælleapparat: låst, ulåst
- Et varmeanlæg: slukket, venter, opvarmer, køler
- En ordre: oprettet, betalt, afsendt, leveret
- En tråd i et program: ny, kører, venter, afsluttet

En tælleapparat (turnstile): Låst indtil der indsættes en mønt, ulåst indtil nogen går igennem.

Et varmeanlæg. Læg mærke til den sammensatte tilstand med undertilstanden for køling.
Et navigationsdiagram er en tilstandsmaskine for brugergrænsefladen. Det viser, hvilke skærmbilleder eller sider brugeren kan befinde sig på, og hvordan hun kommer fra den ene til den anden.
Det er altså ikke en ny slags diagram. Det er den samme notation, brugt på en bestemt ting:
| Tilstandsmaskine (generelt) | Navigationsdiagram | |
|---|---|---|
| Hvad beskrives? | Livsforløbet for én ting, f.eks. en ordre | Brugerens vej gennem systemets skærmbilleder |
| Tilstande er… | Faser eller situationer, f.eks. Betalt | Sider, skærmbilleder eller dialogbokse, f.eks. Kurv |
| Hændelser er… | Alt, der kan ske: betaling, tid, signaler fra andre systemer | Typisk brugerens handlinger: klik, valg, indtastning |
| Guards er… | Forretningsregler, f.eks. [beløb >= pris] | Ofte adgangsregler, f.eks. [logget ind], [admin] |
| Sluttilstand | Er ofte vigtig: hvornår er ordren færdig? | Er der tit ingen af. Brugeren kan bare lukke browseren |
| Hvem har gavn af det? | Udviklere, der skal implementere reglerne | Udviklere, designere og kunden, der skal forstå flowet |
stateDiagram-v2
[*] --> Forside
Forside --> Login : klik "Log ind"
Login --> Login : forkert kode / vis fejlbesked
Login --> MinSide : korrekt kode
Forside --> Produktliste : vælg kategori
Produktliste --> Produkt : klik på produkt
Produkt --> Kurv : læg i kurv
Kurv --> Betaling : gå til betaling [logget ind]
Kurv --> Login : gå til betaling [ikke logget ind]
Betaling --> Kvittering : betaling godkendt
Kvittering --> Forside : klik "Fortsæt"Her er hver tilstand et skærmbillede, og hver pil er noget, brugeren gør. Guarden [logget ind] viser en regel om adgang: Man kan ikke komme til betalingssiden uden at være logget ind.


- At få overblik over alle sider i systemet, så ingen bliver glemt
- At sikre, at brugeren altid kan komme videre og tilbage, og at ingen side er en blindgyde
- At gøre adgangsregler synlige: Hvilke sider kræver login? Hvilke er kun for administratorer?
- At have et fælles billede at tale ud fra med kunden, før der bygges noget
- At danne grundlag for, hvilke sider, controllere og routes I skal lave i koden
En tilstandsmaskine beskriver, hvilke tilstande én ting kan være i, og hvad der får den til at skifte.
Et navigationsdiagram er en tilstandsmaskine, hvor tilstandene er skærmbilleder, og skiftene er brugerens handlinger.
I jeres projekt kan I få brug for begge:
- Et navigationsdiagram for hele systemets brugergrænseflade: Hvordan bevæger brugeren sig rundt?
- En eller flere tilstandsmaskiner for de vigtigste ting i jeres domæne: Hvilke faser gennemgår f.eks. en ordre, en booking eller en sag?
- Hvor starter vi?
- Kan man komme fra hver tilstand videre, eller sidder man fast et sted?
- Er der tilstande, man aldrig kan nå?
- Hvad sker der, hvis brugeren gør noget uventet, f.eks. trykker tilbage eller annullerer?
- Hvilke skift må kun ske under bestemte betingelser?