| Excerpt |
|---|
Denne oppgaven er en videreføring av de tidligere spilloppgavene TicTacToe, Sokoban, Sudoku og Battleship, hvor en skal gjøre rutenettet observerbart og implementere et par grensesnitt, så spillogikken kan kobles til et ferdig skrevet grafisk brukergrensesnitt. I tillegg skal spillet utvides med ekstra funksjonalitet. |
I denne oppgaven skal spillogikken og (det innkapslede) rutenettet fra tidligere spill kobles til et ferdig skrevet grafisk brukergrensesnitt (GUI). Det samme GUI-et skal kunne fungere mot mange spill og realiseringsteknikker, og den beste måten å gjøre det på er å definere spesifikke grensesnitt som brukergrensesnittet kan forutsette er implementert. De ulike grensesnittene svarer til ulik type funksjonalitet som finnes i rutenettbaserte spill for å kunne kobles til et GUIDette er en videreføring av de samme brukergrensesnittene som ble utdelt i tidligere utgaver av spilloppgavene. Nytt for brukergrensesnittet utdelt i denne oppgaven er at de nå også skal ha mulighet for å registrere seg som lyttere på spillklassen, for å legge til rette for oppdatering av skjermbildet når det skjer endringer i tilstanden.
ObservableGrid- og GridListener-grensesnittene
Det første grensesnittet er knyttet til rutenettdata og heter ObservableGrid. Tanken er at GUI-et må kunne spørre rutenettet om dimensjoner og innhold og kunne registrere seg som lytter, slik at det holdes oppdatert når rutenettet endres. Dette er observert-delen av observatør-observert-teknikken. Observatør-delen av observatør-observert-teknikken utgjøres av GridListener-grensesnittet, og siden det er GUI-et som skal holdes oppdatert, så er det den ferdigimplementerte GUI-klassen som må implementere GridListener.
| PlantUML Macro |
|---|
interface ObservableGrid {
+intvoid getGridWidthaddGridListener(GridListener gridListener)
+intvoid getGridHeightremoveGridListener(GridListener gridListener)
}
interface GridListener {
+Object getGridElement(int x, int y)
+void addGridListener(GridListener gridListener)
+void removeGridListener(GridListener gridListener)
}
interface GridListener {
+void gridChanged(ObservableGrid grid, int x, int y, int w, int h)
}
class DinRutenettklasse {
}
ObservableGrid <|.. DinRutenettklasse
DinRutenettklasse --> "*" GridListener: gridListeners |
| Code Block |
|---|
| language | java |
|---|
| title | GridProvider- og GridListener-grensesnittene |
|---|
| collapse | true |
|---|
| public interface ObservableGrid {
/**
* Gets the width (number of columns) of the grid
* @return the width of the grid
*/
public int getGridWidth();
/**
* Gets the height (number of rows) of the grid
* @return the height of the grid
*/
public int getGridHeight();
/**
* Gets the element at the specified x (column) and y (row) position
* @param x the x-coordinate of the element
* @param y the y-coordinate of the element
* @return the object at the specified position
*/
public Object getGridElement(int x, int y);
/**
* Adds the listener, so it will be notified when the grid changes
* @param gridListener the listener to add
*/
public void addGridListener(GridListener gridListener);
/**
* Removes the listener, so it no longer will be notified when the grid changes
* @param gridListener the listener to remove
*/
public void removeGridListener(GridListener gridListener);
}
public interface GridListener {
/**
* Notifies the listener that the grid has changed. The changed region is a rectangle at x,y with dimensions w,h.
* @param grid the grid that has changed
* @param x the x coordinate of the changed rectangle
* @param y the y coordinate of the changed rectangle
* @param w the width of the changed rectangle
* @param h the height of the changed rectangle
*/
public void gridChanged(ObservableGrid grid, int x, int y, int w, int h);
} |
ObservableGrid har følgende metoder for rutenettets dimensjoner og innhold: - int getGridWidth() - returnerer bredden eller antall kolonner i rutenettet, f.eks. 3 for standard Tic Tac Toe
- int getGridHeight() - returnerer høyden eller antall rader i rutenettet, f.eks. 3 for standard Tic Tac Toe
- Object getGridElement(int x, int y) - returnerer objektet som er lagret i en bestemt rute angitt med x,y-koordinater (altså kolonne,rad). Dette kan være noe så enkelt som et tegn, f.eks. 'x', 'o' eller ' ' for Tic Tac Toe, eller noe mer komplisert for Sudoku. Object brukes som returtype, for å kunne håndtere alle type spill og implementasjoner.
For å gå gjennom alle elementene i rutenettet vil en typisk lage en dobbel løkke: | Code Block |
|---|
ObservableGrid grid = ...
for (int row = 0; row < grid.getGridHeight(); row++) {
for (int column = 0; column < grid.getGridWidth(); column++) {
Object element = grid.getGridElement(column, row);
// gjør noe med element her
}
} DinRutenettklasse {
}
ObservableGrid <|.. DinRutenettklasse
DinRutenettklasse --> "*" GridListener: gridListeners |
| ObservableGrid har følgende metoder for lytterhåndtering: - void addGridListener(GridListener) - registrerer en lytter skal skal ha beskjed hver gang rutenettet endres
- void removeGridListener(GridListener) - avregistrere en lytter som tidligere er registrert med addGridListener
Lytterne må implementere GridListener og dermed følgende metode: - gridChanged(ObservableGrid grid, int x, int y, int w, int h) - metoden kalles for å gi beskjed om at en eller flere ruter i rutenettet (grid) innenfor det angitte rektanglet er endret. Rektanglet er angitt med posisjon x, y og dimensjonene w, h (bredde, høyde).
Hvis f.eks. metoden kalles med x=1, y=2, w=2 og h=1, så angir det at rutene 1,2 og 2,2 er endret. Det er opp til rutenett-klassen å avgjøre om endringer av flere ruter rapporteres med ett eller flere kall til gridChanged-metoden. Så endringer i rutene 1,2 og 2,2 kan også rapporteres med to kall, ett hvor x=1, y=2 og ett hvor x=2, y=2, med w=1 og h=1 for begge. Så selv om en kaller denne metoden, så er det ikke dermed sagt at alle rutene i det angitte rektangelet er endret (strengt tatt trenger ingen å være det). |
For denne delen av oppgaven trenger du følgende filer: imagegrid/GridListener.java og imagegrid/ObservableGrid.java
GridGame- og GridOutput-grensesnittene
...
