Page History

...

Del 1: Implementasjon av ObservableList og ObservableHighscoreList

class ObservableList {
}

class ObservableHighscoreList {
	int maxSize
	Collection<Integer> results
	ObservableHighscoreList(int)
	int size()
	int getElement(int)
	void addResult(int)
	addObservableListListener(ListListener)
	removeObservableListListener(ListListener)
}

ObservableList <|-- ObservableHighscoreList

interface ObservableListListener {
	listChanged(ObservableList, int)
}
ObservableHighscoreList -right-> "*" ObservableListListener: observableListListeners

Klassediagram for HighscoreList, ListListener og ObservableList.

En ObservableHighscoreList skal holde styr på heltallsresultater (av typen int/Integer). Lista skal være observerbar ved at den kan registrere lyttere (ObservableListListener-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 ObservableHighscoreList(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. NB: Lavest verdi er best, f.eks. antall sekunder på en oppgave eller antall flytt i Sokoban.

ObservableListListener-grensesnittet er vist i klassediagrammet til venstre og må implementers av alle klasser som ønsker å fungere som lyttere for ObservableHighscoreList-instanser. Lyttere registrerer seg med ObservableHighscoreList sin addObservableListListener-metode og vil siden få beskjed om nye resultater ved at listChanged-metoden kalles. Argumentene som tas inn er ObservableHighscoreList-objektet som ble endret og posisjonen i lista der endringen skjedde.

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

Her er en oversikt over metoden som må implementeres:

• ObservableHighscoreList(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.
• addObservableListListener(ObservableListListener) - registrerer en ny lytter
• removeObservableListListener(ObservableListListener) - fjerner en tidligere registrert lytter

Klassediagram for HighscoreList, ListListener og ObservableList.

class ObservableList {
}

class ObservableHighscoreList {
	int maxSize
	Collection<Integer> results
	ObservableHighscoreList(int)
	int size()
	int getElement(int)
	void addResult(int)
	addObservableListListener(ListListener)
	removeObservableListListener(ListListener)
}

ObservableList <|-- ObservableHighscoreList

interface ObservableListListener {
	listChanged(ObservableList, int)
}
ObservableHighscoreList -right-> "*" ObservableListListener: observableListListeners

Testkode for denne oppgaven finner du her: patterns/observable/ObservableHighscoreListTest.java. Original-koden (jextest) finner du her: patterns/observable/ObservableHighscoreList.jextest.

...