Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

PlantUML Macro
class ObservableList {
}

class HighscoreList {
	int maxSize
	Collection<Integer> results
	HighscoreList(int)
	int size()
	int getElement(int)
	void addResult(int)
	addListListener(ListListener)
	removeListListener(ListListener)
}

ObservableList <|-- HighscoreList

interface ListListener {
	listChanged(ObservableList, int)
}
ObservableList -right-> "*" ListListener: listListeners

En HighscoreList skal holde styr på heltallsresultater (av typen int/Integer). Lista skal være observerbar ved at den kan registrere lyttere (ListListener-instanser) og si fra til dem når lista blir endret. Lista skal ha en maksimal lengde, som settes i konstruktøren, f.eks. skal en topp 10-liste kunne opprettes med new HighscoreList(10). Nye resultater registreres med metoden addResult(int), som skal finne riktig posisjon og legge resultatet inn (dersom det er godt nok). Dersom lista er for lang, så skal det dårligste resultatet fjernes.

Merk at første argument til listChanged-metoden er av typen ObservableList. Dette er en abstrakt superklasse for HighscoreList kalt ObservableList, som innføres i del 3 og som da skal holde orden på lista. ObservableList vil ha en del generelle metoder som HighscoreList arver og kan bruke. For å kunne kjøre testene for HighscoreList allerede i del 1, så må ObservableList være definert fra starten. Lag derfor en tom ObservableList-klasse og bruk denne som superklasse for HighscoreList.

Klassediagrammet for HighscoreList, ListListener og ObservableList er vist til venstre. Her er en oversikt over metoden som må implementeres:

  • HighscoreList(int maxSize) - konstruktøren tar inn maks antall resultater som lista skal kunne holde. Denne verdien må brukes av addResult, slik at resultater som er for dårlige kastes.
  • size() - returnerer antall elementer i lista, som altså aldri skal overstige maks-antallet
  • int getElement(int) - returnerer resultatet i posisjonen angitt av argumentet
  • void addResult(int) - registrere et nytt resultat, og dersom resultatet er godt nok til å komme med på lista, så legges det inn på riktig plass. Dersom lista blir for lang, så må dårligste resultat kastes. Alle registrerte lyttere må få beskjed om en evt. endring av lista, inkludert på hvilken posisjon som ble endret.
  • addListListener(ListListener) - registrerer en ny lytter
  • removeListListener(ListListener) - fjerner en tidligere registrert lytter

 

 

 

JExercise-testkode for denne oppgaven finner du her: inheritancepatterns/observable/HighscoreListTest.java (legg til inheritance/TestListener.java i samme package som HighscoreList. Husk å legge inn ListListener-grensesnittet under før du kjører testen). Original-koden (jextest) finner du her: inheritancepatterns/observable/HighscoreList.jextest.

Del 2: Hovedprogram HighscoreProgram

Et HighscoreProgram inneholder en HighscoreList med én ListListenerHighscoreProgram. Klassen må derfor implementere grensesnittet ListListener:

Code Block
languagejava
public interface ListListener {
    public void listChanged(AbstractObservableList list, int start, int end);
}

...

PlantUML Macro
class ObservableList {
}

class HighscoreList {
	int maxSize
	Collection<Integer> results
	HighscoreList(int)
	int size()
	int getElement(int)
	void addResult(int)
	addListListener(ListListener)
	removeListListener(ListListener)
}

ObservableList <|-- HighscoreList

interface ListListener {
	listChanged(ObservableList, int)
}
ObservableList -right-> "*" ListListener: listListeners

class HighscoreProgram {
	HighscoreList highscoreList
	void init()
	void run()
}
ListListener <|.. HighscoreProgram

Lag en hovedprogramklasse kalt HighscoreProgram, som tester at HighscoreList-klassen din virker som den skal. La den opprette en HighscoreList-instans, lese inn tall fra konsollet (f.eks. med en Scanner og nextInt-metoden) og legge disse inn i lista. Sørg for at HighscoreProgram implementerer ListListener-grensesnittet og registrerer seg som lytter på HighscoreList-instansen. La lyttermetoden listChanged skrive ut informasjon og resultatene i HighscoreList-instansen og posisjonsargumentet, slik at du ser at alt virker som det skal.

Vi foreslår følgende metoder og oppførsel:

  • void init() - oppretter en ny HighscoreList og

...

  • registrerer seg selv

...

  • (altså HighscoreProgram-instansen) som lytter
  • void run() - leser inn tall (resultater) fra

...

  • konsollet og legger dem til i listen

...

  • void listChanged(

...

  • ObservableList, int) - observerer

...

  • endringer i HighscoreList-instansen og skriver ut

...

  • posisjonsargumentet, samt selve listen, til konsollet

Klassediagrammet til venstre viser hvordan klassene henger sammen, og vårt forslag til

...

metoder.

Del 3: AbstractObservableList

...