Class that tracks the progress of a series of Ordinals produced by invoking
next and nextNewOldPair on the current Ordinal.
Instances of this class are thread safe. Multiple threads can invoke nextOrdinal
and nextTracker concurrently. This facilitates multi-threaded tests that send
infoProvided reports concurrently. When using a Dispatcher to execute
suites in parallel, the intention is that each Tracker will only be used by one
thread. For example, if the optional Dispatcher passed to Suite's implementation
of <a href="Suite.html#lifecycle-methods"runNestedSuites is defined, that method will obtain a new Tracker by invoking
nextTracker for each nested suite it passes to the Dispatcher.
- Value parameters:
- firstOrdinal
the first
Ordinalin the series ofOrdinals tracked by thisTracker, which will be used to initialize thisTracker's currentOrdinal.
- Companion:
- object
Value members
Concrete methods
Returns the next Ordinal in the series tracked by this Tracker.
Returns the next Ordinal in the series tracked by this Tracker.
This method saves the current Ordinal in a local variable, reassigns the current Ordinal
with the value returned by invoking nextOrdinal on the saved Ordinal, then
returns the saved Ordinal. As a result, if this method is invoked immediately after construction,
this method will return the Ordinal passed as firstOrdinal.
- Returns:
the next
Ordinalin the series
Returns a Tracker initialized with the first element in the tuple returned by invoking
nextNewOldPair on the current Ordinal, and reassigns the current Ordinal
with the second element that was returned by the nextNewOldPair invocation.
Returns a Tracker initialized with the first element in the tuple returned by invoking
nextNewOldPair on the current Ordinal, and reassigns the current Ordinal
with the second element that was returned by the nextNewOldPair invocation.
The Ordinal series of the returned Tracker will be placed after all the
Ordinals previously returned by invoking nextOrdinal on this Tracker and
before all the Ordinals subsequently returned by invoking nextOrdinal on
this Tracker in the future. This method is intended to be used when executing nested suites
in parallel. Each nested suite passed to the Distributor will get its own Tracker
obtained by invoking nextTracker on the current thread's Tracker.
- Returns:
the next
Trackerin this series