com.tractrac.subscription.lib.api

Interface ILocalDataserver

public interface ILocalDataserver

This class is a local dataserver. It is possible to add events and connect to it order to test the implementation of the subscription library.

Author:

Jorge Piera Llodrá

Method Summary

Methods

Modifier and Type	Method and Description
void	abandonRace(java.util.UUID raceId) Abandon a race from the event
void	addCompetitor(java.lang.String name, java.lang.String shortName, java.lang.String team, java.lang.String competitorClass) Add a new competitor to the event
void	addLivePosition(ICompetitor competitor, double lon, double lat, long timestamp) Adds a live position to the dataserver.
void	addMark(java.lang.String name, java.lang.String shortName, double lat, double lon, long timestamp) Add a new mark to the event
void	addRace(java.lang.String raceName, long trackingStartTime, long trackingEndTime, long raceStartTime, RaceStatusType status, java.net.URI parametersFile) Add a new race to the event
void	addRaceCompetitor(IRace race, IRoute route, ICompetitor competitor) Add a competitor to a race
void	addStoredPosition(ICompetitor competitor, double lon, double lat, long timestamp) Adds a stored position to the dataserver.
void	close() Closes the connections
void	deleteCompetitor(java.util.UUID competitorId) Delete a competitor from the event
void	deleteMark(java.util.UUID markId) Delete a mark from the event
void	deleteRace(java.util.UUID raceId) Delete a race from the event
int	getLivePort() Gets the port for the live connection
int	getStoredPort() Gets the port for the stored connection
void	reloadRace(java.util.UUID raceId) Reload a race from the event
void	removeRaceCompetitor(IRace race, java.util.UUID competitorId) Delete a race from the race
void	start() Create the threads that listen both the stored and live connections
void	updateCompetitor(java.util.UUID competitorId, java.lang.String name, java.lang.String shortName, java.lang.String team, java.lang.String competitorClass) Update a competitor
void	updateLiveDelay(int seconds) Update the live delay property
void	updateLiveDelay(java.util.UUID raceId, int seconds) Update the live delay property for a race
void	updateMark(java.util.UUID markId, java.lang.String name, java.lang.String shortName, double lat, double lon, long timestamp) Add a new mark to the event
void	updateRace(java.util.UUID raceId, java.lang.String raceName, long trackingStartTime, long trackingEndTime, long raceStartTime, RaceStatusType status, java.net.URI parametersFile) Update a race

Method Detail

getStoredPort

int getStoredPort()

Gets the port for the stored connection

Returns:

the stored port

getLivePort

int getLivePort()

Gets the port for the live connection

Returns:

the live port

start

void start()

Create the threads that listen both the stored and live connections

close

void close()
           throws java.io.IOException

Closes the connections

Throws:

java.io.IOException - if there is an error closing the sockets

addLivePosition

void addLivePosition(ICompetitor competitor,
                   double lon,
                   double lat,
                   long timestamp)

Adds a live position to the dataserver. This position will be sent if the application is subscribed to the competitor positions event using the live connection.

Parameters:

competitor - the competitor

lon - the longitude

lat - the latitude

timestamp - the time stamp when this position is valid

addStoredPosition

void addStoredPosition(ICompetitor competitor,
                     double lon,
                     double lat,
                     long timestamp)

Adds a stored position to the dataserver. This position will be sent if the application is subscribed to the competitor positions event using the stored connection.

Parameters:

competitor - the competitor

lon - the longitude

lat - the latitude

timestamp - the time stamp when this position is valid

addCompetitor

void addCompetitor(java.lang.String name,
                 java.lang.String shortName,
                 java.lang.String team,
                 java.lang.String competitorClass)

Add a new competitor to the event

Parameters:

name - the name of the competitor

shortName - the short name of the competitor

team - the team name

competitorClass - the competitor class

deleteCompetitor

void deleteCompetitor(java.util.UUID competitorId)

Delete a competitor from the event

Parameters:

competitorId - the competitor identifier

updateCompetitor

void updateCompetitor(java.util.UUID competitorId,
                    java.lang.String name,
                    java.lang.String shortName,
                    java.lang.String team,
                    java.lang.String competitorClass)

Update a competitor

Parameters:

competitorId - the competitor identifier

name - the name of the competitor

shortName - the short name of the competitor

team - the team name

competitorClass - the competitor class

addRace

void addRace(java.lang.String raceName,
           long trackingStartTime,
           long trackingEndTime,
           long raceStartTime,
           RaceStatusType status,
           java.net.URI parametersFile)

Add a new race to the event

Parameters:

raceName - the race name

trackingStartTime - the tracking start time

trackingEndTime - the tracking end time

raceStartTime - the race start time

status - the status of the race

parametersFile - the parameters file

updateRace

void updateRace(java.util.UUID raceId,
              java.lang.String raceName,
              long trackingStartTime,
              long trackingEndTime,
              long raceStartTime,
              RaceStatusType status,
              java.net.URI parametersFile)

Update a race

Parameters:

raceId - the race identifier

raceName - the race name

trackingStartTime - the tracking start time

trackingEndTime - the tracking end time

raceStartTime - the race start time

status - the status of the race

parametersFile - the parameters file

deleteRace

void deleteRace(java.util.UUID raceId)

Delete a race from the event

Parameters:

raceId - the race identifier

reloadRace

void reloadRace(java.util.UUID raceId)

Reload a race from the event

Parameters:

raceId - the race identifier

abandonRace

void abandonRace(java.util.UUID raceId)

Abandon a race from the event

Parameters:

raceId - the race identifier

addMark

void addMark(java.lang.String name,
           java.lang.String shortName,
           double lat,
           double lon,
           long timestamp)

Add a new mark to the event

Parameters:

name - the name of the mark

name - the name of the mark

lat - the latitude value of the mark

lon - the longitude value of the mark

timestamp - the timestamp of the mark

updateMark

void updateMark(java.util.UUID markId,
              java.lang.String name,
              java.lang.String shortName,
              double lat,
              double lon,
              long timestamp)

Add a new mark to the event

Parameters:

markId - the mark identifier

name - the name of the mark

shortName - the short name

lat - the latitude value of the mark

lon - the longitude value of the mark

timestamp - the timestamp of the mark

deleteMark

void deleteMark(java.util.UUID markId)

Delete a mark from the event

Parameters:

markId - the mark identifier

addRaceCompetitor

void addRaceCompetitor(IRace race,
                     IRoute route,
                     ICompetitor competitor)

Add a competitor to a race

Parameters:

race - the race

route - the route

competitor - the competitor to add

removeRaceCompetitor

void removeRaceCompetitor(IRace race,
                        java.util.UUID competitorId)

Delete a race from the race

Parameters:

race - the race

competitorId - the competitor identifier

updateLiveDelay

void updateLiveDelay(int seconds)

Update the live delay property

Parameters:

the - number of seconds for the new live delay

updateLiveDelay

void updateLiveDelay(java.util.UUID raceId,
                   int seconds)

Update the live delay property for a race

Parameters:

raceId - the race identifier

the - number of seconds for the new live delay