Sequentiediagram: Bestelling in een Café

Dit voorbeeld toont hoe een sequentiediagram de interactie tussen objecten weergeeft als methode-aanroepen.

Alice bestelt een drankje bij Bob

PlantUML broncode voor "Café bestelling"

@startuml
autonumber

actor "Alice\n(klant)" as Alice
participant "Bob\n(ober)" as Bob
participant "wallet:\nWallet" as Wallet

Alice -> Bob: bestelDrankje("appelsap")
Bob --> Alice: betaal(2.00)

Alice -> Wallet: betaal(2.00)
Wallet --> Alice: bevestiging(walletId="ere-34-23")

Alice --> Bob: betaald(2.00, walletId="ere-34-23")
Bob --> Alice: geefDrankje("appelsap")
Bob -> Alice: "Enjoy!"

@enduml

Zie toelichting onder dit diagram voor beschrijving van de interactie.

Toelichting bij het diagram

Het sequentiediagram hierboven toont de volgende interactie:

1. Alice bestelt - Alice roept de methode bestelDrankje("appelsap") aan bij Bob
2. Bob vraagt betaling - Bob retourneert een verzoek betaal(2.00) aan Alice
3. Alice betaalt - Alice roept betaal(2.00) aan op haar Wallet object
4. Wallet bevestigt - De Wallet retourneert een bevestiging met wallet ID "ere-34-23"
5. Alice bevestigt aan Bob - Alice stuurt de betaalbevestiging door naar Bob
6. Bob geeft drankje - Bob roept geefDrankje("appelsap") aan en zegt "Enjoy!"

Waarom a11yDescriptionOverride?

Dit diagram gebruikt a11yDescriptionOverride omdat:

• Sequentiediagrammen nog niet automatisch worden geparsed
• De toelichting in de tekst een betere context geeft dan een automatisch gegenereerde beschrijving zou kunnen

---

Zonder a11yDescriptionOverride: "niet ondersteund" melding

Hieronder hetzelfde diagram, maar zonder a11yDescriptionOverride. De plugin toont dan automatisch een melding dat sequentiediagrammen nog niet ondersteund worden:

PlantUML broncode voor "Café bestelling (zonder override)"

@startuml
autonumber
actor "Alice\n(klant)" as Alice
participant "Bob\n(ober)" as Bob

Alice -> Bob: bestelDrankje("appelsap")
Bob --> Alice: betaal(2.00)
Bob --> Alice: geefDrankje("appelsap")
@enduml

Sequentiediagram met 2 deelnemers: Alice (klant) en Bob (ober).

Interacties:

1. Alice (klant) roept Bob (ober).bestelDrankje("appelsap") aan
2. Bob (ober) antwoordt Alice (klant): betaal(2.00)
3. Bob (ober) antwoordt Alice (klant): geefDrankje("appelsap")

---

Vergelijk met het klassieke Alice & Bob voorbeeld

Het simpele "Hello World" voorbeeld toont alleen berichten, geen methode-semantiek:

PlantUML source for "Klassiek Alice & Bob"

@startuml
Alice -> Bob: Hello Bob!
Bob --> Alice: Hi Alice!
@enduml

Sequence diagram with 2 participants: Alice and Bob.

Interactions:

• Alice calls Bob.Hello Bob!()
• Bob responds to Alice: 'Hi Alice!'

Het café-voorbeeld hierboven is realistischer voor software design omdat:

• De berichten lijken op methode-aanroepen met parameters
• Er is een return value (bevestiging)
• Er is een derde object (Wallet) dat Alice gebruikt