Criteria Sequentiediagram

Programmeerbaarheid

Een object kan niet uit zichzelf wat gaan doen, dus er moet altijd een inkomende pijl naar object zijn voordat dit object zelf een pijl naar een ander object kan hebben.
Een object kan alleen aangeroepen als het bekend is bij de aanroeper:
- via een associatie (uit domeinmodel/klassendiagram)
- via een argument uit een eerdere methode-aanroep
- via een returnwaarde van een eerdere methode-aanroep
Je moet de argumenten bij methode-aanroepen noteren
- Datatypes hoeven daar niet bij te staan.
Argumenten voor methodes moeten ergens vandaan komen en mogen niet zomaar uit het niets ontstaan (behalve bij een Actor, zie onder).

Actor

Een actor mag wel 'uit zichzelf wat gaan doen' en start meestal het sequentiediagram.
Een actor communiceert met een applicatie-object via een methode die waarschijnlijk niet letterlijk wordt geimplementeerd, maar wel goed weergeeft wat de intentie is.

Returnwaarde

Een returnwaarde kan op twee manier worden getekend:

Met een =-teken: returnwaarde = methode-aanroep(). Meestal gebruik je deze variant als je na één methode-aanroep de waarde direct teruggeeft.
Met een gestippelde pijl terug naar de aanroeper met de returnwaarde erop. Meestal gebruik je deze als de returnwaarde pas beschikbaar is na de aanroep van een aantal andere methoden.
Een actor mag zelfgekozen argumenten meegeven aan het applicatie-object.

Objectnamen en participants

Participants moeten een object-naam en een klassennaam hebben (tenzij je een statische methode aanroept, dan hoef je alleen de klassennaam te geven).
Namen van de objecten in de participants-blokjes moeten overeen komen met de namen van dezelfde objecten op de pijlen
Als er geen methoden worden aangeroepen op een participant, dan hoeft er geen participant-blokje getekend te worden.

Objecten verkrijgen

Een Applicatie-object mag objecten uit een niet nader gespecificeerde datastore komen aan de hand van de generieke methode find(id van het object dat je zoekt). Hierbij is id een unieke identifier van het object dat je zoekt.
Als het object een collectie bijhoudt van een ander object, dan kan een instantie gevonden worden met een message naar zichzelf die geannoteerd is met find
Meestal zie je de naam van het type dat je zoekt achter find staan. Dit is niet verplicht, maar wel handig voor de lezer.

Objecten aanmaken

Een object kan worden aangemaakt door het objectblokje te laten beginnen aan het eind van een pijl met de methode die het object aanmaakt. Meestal is dit de constructor.

Objecten toevoegen

Als een object een collectie bijhoudt van een ander object dan kan een instantie daaraan worden toegevoegd met een aanroep van de methode add(het nieuwe object).
Meestal zie je de naam van het type dat je zoekt achter add staan. Dit is niet verplicht, maar wel handig voor de lezer.

Lagen

Een actor mag alleen methoden aanroepen van het applicatie-object.
Het applicatie-object mag als enige een find aanroepen op de store.
Domeinklassen mogen geen methoden aanroepen van het applicatie-object
App moet geen domeinlogica implementeren

Klassendiagram

Methodes uit het sequentiediagram en klassendiagram moeten overeenkomen
Voor properties uit het klassendiagram mag je getters en setters introduceren die zelf niet in het klassendiagram opgenomen hoeven te worden.
Pre- en postcondities en invarianten worden gehonoreerd.

Hoeft niet

Je hoeft geen lifelines op te nemen.
Het onderscheid tussen Alt en Opt is niet zo belangrijk.

Voorbeeld

Hieronder zie je een voorbeeld van een sequentiediagram waarin de meeste regels zijn toegepast. Deze hoort bij het klassendiagram uit de voorbereiding.1

Ga zelf na welke van bovenstaande criteria je op welke manier in dit sequentiediagram ziet terugkomen.

eee0de9f5dd1249e9243a5e9536332ae

PlantUML broncode voor "Voorbeeld Criteria"

autonumber

actor Bezoeker
participant "app:\nCinemaApp" as app
participant "vertoning:\nVertoning" as vertoning
participant "stoel:\nStoel" as stoel
participant "kaartje:\nKaartje" as kaartje
database Store

Bezoeker -> app : reserveerStoel(vertoningId, \n\
                                stoelId)

app -> Store : vertoning = findVertoning(vertoningId)

app -> vertoning: reserveerStoel(stoelId)
vertoning -> vertoning: stoel = findStoel(stoelId)

vertoning -> stoel : reserveer()

stoel -> stoel: setIsBeschikbaar(false)

app -> vertoning : genereerKaartje(stoelId)
create kaartje
vertoning -> kaartje : kaartje =  new Kaartje(\n\
    stoelId, titel, datum, tijd)
app <-- vertoning: kaartje
Bezoeker <-- app : kaartje

Voorbeeld​

Voorbeeld