blob: c3190b3bb4e87f2e6c84a9aaf6a04df414442501 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
|
package ch.epfl.maze.simulation;
import java.util.List;
import java.util.Map;
import ch.epfl.maze.graphics.Animation;
import ch.epfl.maze.physical.Animal;
import ch.epfl.maze.physical.World;
/**
* The {@code Simulation} interface defines a set of rules that must be
* fulfilled in order to be displayed.
*
*/
public interface Simulation {
/**
* Asks the {@code Simulation} to compute the next move and, if specified,
* notifies the changes to the listener.
*
* @param listener
* The listener to which the function will notify the changes
* (can be null)
*/
public void move(Animation listener);
/**
* Determines if the simulation is over.
*
* @return <b>true</b> if no more moves can be made, <b>false</b> otherwise
*/
public boolean isOver();
/**
* Retrieves the current state of the simulated world.
*
* @return The {@code World} that is being simulated
*/
public World getWorld();
/**
* Retrieves the step counter of the {@code Simulation}.
*
* @return The current step counter
*/
public int getSteps();
/**
* Retrieves the mapping of the steps done by the animals that have finished
* the simulation.
*
* @return Map of steps done by animals which have accomplished the
* simulation
*/
public Map<Integer, List<Animal>> getArrivalTimes();
/**
* Retrieves the record table of the animals that have finished the
* simulation.
*
* @return A {@code String} containing the top 10 animals which have
* accomplished the simulation
*/
public String getRecordTable();
/**
* Restarts the simulation from the beginning.
*/
public void restart();
/**
* Stops abruptly the simulation.
*/
public void stop();
}
|