refactored to get rid of the "token" approach for updating / retrieving RaceDefinitions from tracker

java/com.sap.sailing.domain/src/com/sap/sailing/domain/tracking/DynamicRaceDefinitionSet.java

@@ -0,0 +1,20 @@
+package com.sap.sailing.domain.tracking;
+
+import com.sap.sailing.domain.base.RaceDefinition;
+
+/**
+ * Particularly the way the TracTrac connector was originally designed, the set of {@link RaceDefinition} objects
+ * received from connecting to a particular TracTrac event is not known up-front. We even wait (for historic reasons,
+ * because the course definition used to be immutable) for the course to be received before creating the
+ * {@link RaceDefinition} object. Therefore, a {@link RaceTracker#getRaces()} call needs to understand which
+ * {@link RaceDefinition} objects were created so far.<p>
+ * 
+ * This interface is used particularly by the race course receiver in the TracTrac case to update a tracker's set
+ * of {@link RaceDefinition}s.
+ * 
+ * @author Axel Uhl (d043530)
+ *
+ */
+public interface DynamicRaceDefinitionSet {
+    void addRaceDefinition(RaceDefinition race);
+}

java/com.sap.sailing.domain/src/com/sap/sailing/domain/tracking/RaceTracker.java

@@ -18,7 +18,7 @@ public interface RaceTracker {
     com.sap.sailing.domain.base.Event getEvent();
 
     /**
-     * Returns the races currently being tracked by this tracked. Non-blocking call that returns <code>null</code> if
+     * Returns the races currently being tracked by this tracker. Non-blocking call that returns <code>null</code> if
      * the {@link RaceDefinition} for a TracTrac Event hasn't been created yet, e.g., because the course definition
      * hasn't been received yet or the listener for receiving course information hasn't been registered (yet).
      */