fixed Bug 58: turned RaceHandle into RacesHandle and adjusted getRace(...) to getRaces(...) accordingly

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

@@ -25,7 +25,7 @@ public interface RaceTracker {
     Set<RaceDefinition> getRaces();
 
     // TODO this is inconsistent with getRaces() which can return more than one race
-    RaceHandle getRaceHandle();
+    RacesHandle getRaceHandle();
 
     DynamicTrackedEvent getTrackedEvent();
     

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

@@ -1,25 +1,27 @@
 package com.sap.sailing.domain.tracking;
 
+import java.util.Set;
+
 import com.sap.sailing.domain.base.Event;
 import com.sap.sailing.domain.base.RaceDefinition;
 
 /**
- * Gives clients a way to refer to a specific race even though the {@link RaceDefinition} object may not have
- * been created yet, but without exposing the TracTrac internals. The {@link #getRace()} call will block
- * until the {@link RaceDefinition} has been created.
+ * Gives clients a way to refer to a specific set of races even though the {@link RaceDefinition} objects may not have
+ * been created yet, but without exposing the tracking provider's internals. The {@link #getRaces()} call will block
+ * until the {@link RaceDefinition}s have been created.
  * 
  * @author Axel Uhl (d043530)
  *
  */
-public interface RaceHandle {
+public interface RacesHandle {
 
     Event getEvent();
     
     /**
-     * Fetch the race definition. If the race definition represented by this handle hasn't been created yet, the call
+     * Fetch the race definitions. If the race definitions represented by this handle haven't been created yet, the call
      * blocks until such a definition is provided by another call, usually by the {@link RaceCourseReceiver}.
      */
-    RaceDefinition getRace();
+    Set<RaceDefinition> getRaces();
 
     /**
      * Fetch the race definition. If the race definition represented by this handle hasn't been created yet, the call
@@ -29,7 +31,7 @@ public interface RaceHandle {
      * <code>timeoutInMilliseconds</code> in case no modifications happen on the {@link DomainFactory}'s
      * set of races during that time.
      */
-    RaceDefinition getRace(long timeoutInMilliseconds);
+    Set<RaceDefinition> getRaces(long timeoutInMilliseconds);
 
     DynamicTrackedEvent getTrackedEvent();