+ /**\r
+ * Executes all events up to a given simulation timestamp. The simulation process can be constrained by a real world timestamp.\r
+ * \r
+ * @param timestamp the simulation timestamp up to which the events will be processed\r
+ * @param stopMillis the System.currentTimeMillis() when simulation definitely needs to stop.\r
+ * @return if it was possible to fulfil the goal in the given real world time.\r
+ * @author Christian Femers\r
+ */\r
+ public ExecutionResult executeUpTo(long timestamp, long stopMillis)\r
+ {\r
+ if (events.isEmpty())\r
+ {\r
+ currentTime = timestamp;\r
+ return ExecutionResult.NOTHING_DONE;\r
+ }\r
+ int checkStop = 0;\r
+ InnerEvent first = events.peek();\r
+ while (first != null && first.getTiming() <= timestamp)\r
+ {\r
+ events.remove();\r
+ currentTime = first.getTiming();\r
+ first.run();\r
+ // Don't check after every run\r
+ checkStop = (checkStop + 1) % 10;\r
+ if (checkStop == 0 && System.currentTimeMillis() >= stopMillis)\r
+ return ExecutionResult.RAN_OUT_OF_TIME;\r
+ first = events.peek();\r
+ }\r
+ currentTime = timestamp;\r
+ return ExecutionResult.DONE_IN_TIME;\r
+ }\r
+\r