com.tractrac.subscription.lib.api

Interface IRaceSubscriber

All Superinterfaces:

ISubscriber

public interface IRaceSubscriber
extends ISubscriber

This interface is used to add subscriptions for a IRace object.

Author:

Jorge Piera Llodrá

Method Summary

Methods

Modifier and Type	Method and Description
void	subscribeControlPassings(IControlPassingsListener listener) Subscribes to control passing data for the specified race.
void	subscribeControlPositions(IControlPointPositionListener listener) Subscribes to control positions for the race.
void	subscribeControlPositions(IControlPointPositionListener listener, long fromTime, long toTime) Subscribes to control positions for the race, also retrieving historic data.
void	subscribePositions(IPositionListener listener) Subscribes to competitor positions for a given Race.
void	subscribePositions(IPositionListener listener, long fromTime, long toTime) Subscribes to competitor positions for a given Race.
void	subscribePositionsOffset(IPositionOffsetListener listener) Subscribes to offset competitor positions for a given Race.
void	subscribePositionsOffset(IPositionOffsetListener listener, long fromTime, long toTime) Subscribes to offset competitor positions for a given Race, including historic data.
void	subscribePositionsSnapped(IPositionSnappedListener listener) Subscribes to snapped competitor positions for a given Race.
void	subscribePositionsSnapped(IPositionSnappedListener listener, long fromTime, long toTime) Subscribes to snapped competitor positions for a given Race, including historic data.
void	subscribeRaceCompetitor(IRaceCompetitorListener listener) Subscribes to race competitor for a given Race.
void	subscribeRaceMessages(IRaceMessageListener listener) Subscribe to messages for a race.
void	subscribeRaceTimesChanges(IRaceStartStopTimesChangeListener listener) Subscribes to changes in race start and stop times.
void	subscribeRouteChanges(IControlRouteChangeListener listener) Subscribes to route changes for a given Race.
void	unsubscribeControlPassings(IControlPassingsListener listener) Unsubscribes to control passing data for the specified race.
void	unsubscribeControlPositions(IControlPointPositionListener listener) Unsubscribes to control positions.
void	unsubscribePositions(IPositionListener listener) Unsubscribes to competitor positions for a given Race.
void	unsubscribePositionsOffset(IPositionOffsetListener listener) Unsubscribes to competitor positions for a given Race.
void	unsubscribePositionsSnapped(IPositionSnappedListener listener) Unsubscribes to competitor positions for a given Race.
void	unsubscribeRaceCompetitor(IRaceCompetitorListener listener) Unsubscribes to race competitor
void	unsubscribeRaceMessages(IRaceMessageListener listener) Unsubscribes to race messages
void	unsubscribeRaceTimesChanges(IRaceStartStopTimesChangeListener listener) Unsubscribes to changes in race start and stop times.
void	unsubscribeRouteChanges(IControlRouteChangeListener listener) Unsubscribes to route changes for a given Race.

Methods inherited from interface com.tractrac.subscription.lib.api.ISubscriber

start, stop, subscribeConnectionStatus, unsubscribeConnectionStatus

Method Detail

subscribePositions

void subscribePositions(IPositionListener listener)

Subscribes to competitor positions for a given Race. It uses the tracking start time and the tracking end time as time interval to receive positions.

The method returns immediately and the positions are subsequently sent to the given listener, as they are received.

Parameters:

listener - the listener to receive the positions.

subscribePositions

void subscribePositions(IPositionListener listener,
                      long fromTime,
                      long toTime)

Subscribes to competitor positions for a given Race.

The method returns immediately and the positions are subsequently sent to the given listener, as they are received.

Parameters:

listener - the listener to receive the positions.

fromTime - stored positions (if supported) will be requested from this time and forward. The value 0 is allowed and means all historic data.

toTime - The value Long.MAXVALUE means all data in the future

unsubscribePositions

void unsubscribePositions(IPositionListener listener)

Unsubscribes to competitor positions for a given Race.

Parameters:

listener - the listener used in the subscribe method

subscribePositionsSnapped

void subscribePositionsSnapped(IPositionSnappedListener listener)

Subscribes to snapped competitor positions for a given Race. It uses the tracking start time and the tracking end time as time interval to receive positions.

The method returns immediately and the positions are subsequently sent to the given listener, as they are received.

Parameters:

listener - the listener to receive the positions.

subscribePositionsSnapped

void subscribePositionsSnapped(IPositionSnappedListener listener,
                             long fromTime,
                             long toTime)

Subscribes to snapped competitor positions for a given Race, including historic data.

The method returns immediately and the positions are subsequently sent to the given listener, as they are received.

Parameters:

listener - the listener to receive the positions.

fromTime - stored positions (if supported) will be requested from this time and forward. The value 0 is allowed and means all historic data.

toTime - The value Long.MAXVALUE means all data in the future

unsubscribePositionsSnapped

void unsubscribePositionsSnapped(IPositionSnappedListener listener)

Unsubscribes to competitor positions for a given Race.

Parameters:

listener - the listener used in the subscribe method

subscribePositionsOffset

void subscribePositionsOffset(IPositionOffsetListener listener)

Subscribes to offset competitor positions for a given Race. It uses the tracking start time and the tracking end time as time interval to receive positions.

The method returns immediately and the positions are subsequently sent to the given listener, as they are received.

Parameters:

listener - the listener to receive the positions.

subscribePositionsOffset

void subscribePositionsOffset(IPositionOffsetListener listener,
                            long fromTime,
                            long toTime)

Subscribes to offset competitor positions for a given Race, including historic data.

The method returns immediately and the positions are subsequently sent to the given listener, as they are received.

Parameters:

listener - the listener to receive the positions.

fromTime - stored positions (if supported) will be requested from this time and forward. The value 0 is allowed and means all historic data.

toTime - The value Long.MAXVALUE means all data in the future

unsubscribePositionsOffset

void unsubscribePositionsOffset(IPositionOffsetListener listener)

Unsubscribes to competitor positions for a given Race.

Parameters:

listener - the listener used in the subscribe method

subscribeControlPositions

void subscribeControlPositions(IControlPointPositionListener listener)

Subscribes to control positions for the race.

The method returns immediately and the positions are subsequently sent to the given listener, as they are received.

It also returns the static positions using the IRace.getTrackingStartTime() as the value for the position time. These positions are sent before to start to send the dynamic positions.

Parameters:

listener - the listener to receive the positions.

subscribeControlPositions

void subscribeControlPositions(IControlPointPositionListener listener,
                             long fromTime,
                             long toTime)

Subscribes to control positions for the race, also retrieving historic data.

The method returns immediately and the positions are subsequently sent to the given listener, as they are received.

It also returns the static positions using the IRace.getTrackingStartTime() as the value for the position time. These positions are sent before to start to send the dynamic positions.

Parameters:

listener - the listener to receive the positions.

fromTime - stored positions (if supported) will be requested from this time and forward. The value 0 is allowed and means all historic data.

toTime - The value Long.MAXVALUE means all data in the future

unsubscribeControlPositions

void unsubscribeControlPositions(IControlPointPositionListener listener)

Unsubscribes to control positions.

Parameters:

listener - the listener used in the subscribe method

subscribeControlPassings

void subscribeControlPassings(IControlPassingsListener listener)

Subscribes to control passing data for the specified race.

The method returns immediately and the positions are subsequently sent to the given listener, as they are received.

Parameters:

listener - the listener to receive the control passings.

unsubscribeControlPassings

void unsubscribeControlPassings(IControlPassingsListener listener)

Unsubscribes to control passing data for the specified race.

Parameters:

listener - the listener used in the subscribe method

subscribeRaceTimesChanges

void subscribeRaceTimesChanges(IRaceStartStopTimesChangeListener listener)

Subscribes to changes in race start and stop times.

The method returns immediately and the changes are subsequently sent to the given listener, as they are received.

Parameters:

listener - the listener to receive the changes.

unsubscribeRaceTimesChanges

void unsubscribeRaceTimesChanges(IRaceStartStopTimesChangeListener listener)

Unsubscribes to changes in race start and stop times.

Parameters:

listener - the listener used in the subscribe method

subscribeRouteChanges

void subscribeRouteChanges(IControlRouteChangeListener listener)

Subscribes to route changes for a given Race.

The method returns immediately and the positions are subsequently sent to the given listener, as they are received.

Parameters:

listener - the listener to receive the positions.

unsubscribeRouteChanges

void unsubscribeRouteChanges(IControlRouteChangeListener listener)

Unsubscribes to route changes for a given Race.

Parameters:

listener - the listener used in the subscribe method

subscribeRaceCompetitor

void subscribeRaceCompetitor(IRaceCompetitorListener listener)

Subscribes to race competitor for a given Race.

Parameters:

listener - the listener to receive the new race competitor.

unsubscribeRaceCompetitor

void unsubscribeRaceCompetitor(IRaceCompetitorListener listener)

Unsubscribes to race competitor

Parameters:

listener - the listener used in the subscribe method

subscribeRaceMessages

void subscribeRaceMessages(IRaceMessageListener listener)

Subscribe to messages for a race.

Parameters:

listener - Listener the listener to receive the messages

unsubscribeRaceMessages

void unsubscribeRaceMessages(IRaceMessageListener listener)

Unsubscribes to race messages

Parameters:

listener - the listener used in the subscribe method.