org.opentripplanner.updater.stoptime

Class TimetableSnapshotSource

java.lang.Object

org.opentripplanner.updater.stoptime.TimetableSnapshotSource

public class TimetableSnapshotSource
extends Object

This class should be used to create snapshots of lookup tables of realtime data. This is necessary to provide planning threads a consistent constant view of a graph with realtime data at a specific point in time.

Field Summary

Fields

Modifier and Type	Field and Description
GtfsRealtimeFuzzyTripMatcher	fuzzyTripMatcher
protected ServiceDate	lastPurgeDate
protected long	lastSnapshotTime
int	logFrequency
int	maxSnapshotFrequency If a timetable snapshot is requested less than this number of milliseconds after the previous snapshot, just return the same one.
boolean	purgeExpiredData Should expired realtime data be purged from the graph.

Constructor Summary

Constructors

Constructor and Description
TimetableSnapshotSource(Graph graph)

Method Summary

Modifier and Type	Method and Description
void	applyTripUpdates(Graph graph, boolean fullDataset, List<GtfsRealtime.TripUpdate> updates, String feedId) Method to apply a trip update list to the most recent version of the timetable snapshot.
TimetableSnapshot	getTimetableSnapshot()

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

logFrequency

public int logFrequency

maxSnapshotFrequency

public int maxSnapshotFrequency

If a timetable snapshot is requested less than this number of milliseconds after the previous snapshot, just return the same one. Throttles the potentially resource-consuming task of duplicating a TripPattern -> Timetable map and indexing the new Timetables.

purgeExpiredData

public boolean purgeExpiredData

Should expired realtime data be purged from the graph.

lastPurgeDate

protected ServiceDate lastPurgeDate

lastSnapshotTime

protected long lastSnapshotTime

fuzzyTripMatcher

public GtfsRealtimeFuzzyTripMatcher fuzzyTripMatcher

Constructor Detail

TimetableSnapshotSource

public TimetableSnapshotSource(Graph graph)

Method Detail

getTimetableSnapshot

public TimetableSnapshot getTimetableSnapshot()

Returns:

an up-to-date snapshot mapping TripPatterns to Timetables. This snapshot and the timetable objects it references are guaranteed to never change, so the requesting thread is provided a consistent view of all TripTimes. The routing thread need only release its reference to the snapshot to release resources.

applyTripUpdates

public void applyTripUpdates(Graph graph,
                             boolean fullDataset,
                             List<GtfsRealtime.TripUpdate> updates,
                             String feedId)

Method to apply a trip update list to the most recent version of the timetable snapshot. A GTFS-RT feed is always applied against a single static feed (indicated by feedId). <<<<<<< HEAD ======= However, multi-feed support is not completed and we currently assume there is only one static feed when matching IDs. >>>>>>> 7296be8ffd532a13afb0bec263a9f436ab787022

Parameters:

graph - graph to update (needed for adding/changing stop patterns)

fullDataset - true iff the list with updates represent all updates that are active right now, i.e. all previous updates should be disregarded

updates - GTFS-RT TripUpdate's that should be applied atomically

feedId -