Tilstand og oppførsel - Stopwatch-oppgave

Klassen skal implementere logikken ofte funnet på stoppeklokker på smarttelefoner.

For å holde styr på tiden som går vil StopWatch-klassen bli kalt utenfra (altså noe du slipper å implementere i denne oppgaven) på en tick(int)-metode. I dataverdenen er et tick (tikk på norsk) minste målbare diskret tidsenhet. I denne oppgaven er 1 tikk = 1 millisekund. F.eks. vil et kall tick(3) fortelle en StopWatch-instans at 3 tikk har gått siden sist gang tick() ble kalt. StopWatch skal fungere på følgende måte: Klokken startes når man ønsker å starte tidtakningen. Alle tikk etter at klokken har blitt startet skal medregnes i tidtakningen. Klokken stoppes når man ønsker å stoppe tidtakningen. Da er tidtakningen helt ferdig. Det er ikke en pause i tidtakningen - klokken skal ikke startes igjen. Det skal være mulig å ta rundetider. Første rundetid startes når klokken starter. Under tidtakningen kan man starte en ny rundetid, og dermed implisitt avslutte den nåværende. Siste rundetid avsluttes når klokken stoppes.

StopWatch-klassen må ha metoder for å spørre om tilstanden og metoder for å endre tilstanden.

Klassen skal ha følgende spørremetoder:

• boolean isStarted() - returner true om klokken har blitt startet eller false om den ikke har blitt startet
• boolean isStopped() - returner true om klokken har blitt stoppet eller false om den ikke har blitt stoppet. Merk at her snakker vi om at klokken har blitt stoppet, ikke om klokken går eller ikke.
• int getTicks() - returnerer det totale antall tikk (millisekunder) som har gått i levetiden til klokken uavhengig om klokken har vært startet eller stoppet.
• int getTime() - returnerer antall tikk som har gått under tidtakningen. Hvis tidtakningen ikke har startet returner -1. Merk at hvis klokken er startet, men ikke stoppet, skal metoden returnere antall tikk som har gått siden klokken ble startet til nå. Hvis klokken er stoppet skal metoden returnere antall tikk som har gått fra klokken ble startet til klokken ble stoppet.
• int getLapTime() - returnerer antall tikk som har gått under nåværende rundetid til nå. Hvis tidtakningen ikke har startet returner -1.
• int getLastLapTime() - returnerer lengden på forrige avsluttede rundetid. Hvis det ikke er noen tidligere rundetider returner -1.

Klassen skal ha følgende metoder for å endre tilstanden:

• void tick(int ticks) - forteller klokken at ticks antall tikk har gått.
• void start() - starter klokken.
• void lap() - avslutter nåværende rundetid og starter en ny.
• void stop() - stopper klokken.

Del 1 - tilstandsdiagram

Tegn et objekttilstandsdiagram for en tenkt bruk av StopWatch-klassen. Velg en sekvens av kall som både starter klokken, tar rundetider og stopper klokken.

Del 2 - Java-kode

Skriv Java-kode for StopWatch-klassen med oppførsel som er beskrevet over.

Lag en passende toString()-metode og en main-metode, slik at du kan sjekke at oppførselen stemmer med tilstandsdiagrammet (bruk samme sekvens av kall).

Del 3 - JavaFX

Dersom Eclipse har blitt installert som forklart på installasjon av eclipse har du mulighet til å høyreklikke på prosjektmappen (ovinger) -> Team -> Pull for å laste nødvendige filer for denne øvingen. Da skal det ligge StopWatchController.java og StopWatch.fxml i prosjektmappen din, i pakken "stateandbehavior". Disse utgjør en JavaFX-applikasjon, og bruker StopWatch-klassen du har laget. Kjør applikasjonen ved å høyreklikke på StopWatch.fxml -> Run As -> FXML application, og observer hva som skjer.

Åpne StopWatchController og finn ut hvor StopWatch-klassen din blir brukt, og kommenter kort hva som skjer med den. Det er ikke et krav at du forstår resten av koden i StopWatchController, du skal kun forklare hvordan klassen din blir brukt.

JExercise-testkode for denne oppgaven finner du her: stateandbehavior/StopWatchTest.java. Original-koden (jextest) finner du her: stateandbehavior/StopWatch.jextest.