Package org.onebusaway.gtfs.impl

Class GtfsDataServiceImpl

java.lang.Object

org.onebusaway.gtfs.impl.GtfsDataServiceImpl

All Implemented Interfaces:

CalendarService, GenericDao, GtfsDao, GtfsDataService, GtfsRelationalDao

public class GtfsDataServiceImpl
extends Object
implements GtfsDataService

Constructor Summary

Constructors

Constructor	Description
GtfsDataServiceImpl()

Method Summary

Modifier and Type	Method	Description
void	addMetadata(String filename, String content)
Agency	getAgencyForId(String id)
Collection<Agency>	getAllAgencies()	Agency Methods
Collection<AlternateStopNameException>	getAllAlternateStopNameExceptions()
Collection<Area>	getAllAreas()	Area Methods
Collection<Block>	getAllBlocks()
Collection<BookingRule>	getAllBookingRules()
Collection<ServiceCalendarDate>	getAllCalendarDates()	ServiceCalendarDate Methods
Collection<ServiceCalendar>	getAllCalendars()	ServiceCalendar Methods
Collection<DirectionEntry>	getAllDirectionEntries()
Collection<DirectionNameException>	getAllDirectionNameExceptions()
<T> Collection<T>	getAllEntitiesForType(Class<T> type)	Generic Methods
Collection<Facility>	getAllFacilities()
Collection<FacilityProperty>	getAllFacilityProperties()
Collection<FacilityPropertyDefinition>	getAllFacilityPropertyDefinitions()
Collection<FareAttribute>	getAllFareAttributes()	FareAttribute Methods
Collection<FareLegRule>	getAllFareLegRules()	FareLegRule Methods
Collection<FareMedium>	getAllFareMedia()	FareMedium Methods
Collection<FareProduct>	getAllFareProducts()	FareProduct Methods
Collection<FareRule>	getAllFareRules()	FareRule Methods
Collection<FareTransferRule>	getAllFareTransferRules()	FareTransferRule Methods
Collection<FeedInfo>	getAllFeedInfos()	FeedInfo Methods
Collection<Frequency>	getAllFrequencies()	Frequency Methods
Collection<Level>	getAllLevels()
Collection<LocationGroupElement>	getAllLocationGroupElements()
Collection<LocationGroup>	getAllLocationGroups()
Collection<Location>	getAllLocations()
Collection<Network>	getAllNetworks()	Network Methods
Collection<Pathway>	getAllPathways()	Pathway Methods
Collection<RiderCategory>	getAllRiderCategories()	RiderCategory Methods
Collection<Ridership>	getAllRiderships()
Collection<RouteNameException>	getAllRouteNameExceptions()
Collection<Route>	getAllRoutes()	Route Methods
Collection<RouteShape>	getAllRouteShapes()
Collection<RouteStop>	getAllRouteStops()
List<AgencyAndId>	getAllServiceIds()	ServiceCalendar Methods
List<AgencyAndId>	getAllShapeIds()	ShapePoint Methods
Collection<ShapePoint>	getAllShapePoints()	ShapePoint Methods
Collection<StopAreaElement>	getAllStopAreaElements()
Collection<StopArea>	getAllStopAreas()
Collection<Stop>	getAllStops()	Stop Methods
Collection<StopTime>	getAllStopTimes()	StopTime Methods
Collection<Transfer>	getAllTransfers()	Transfer Methods
Collection<Translation>	getAllTranslations()	Translation Methods
Collection<Trip>	getAllTrips()	Trip Methods
Collection<Vehicle>	getAllVehicles()	Vehicle Methods
Collection<WrongWayConcurrency>	getAllWrongWayConcurrencies()
AlternateStopNameException	getAlternateStopNameExceptionForId(AgencyAndId id)
Block	getBlockForId(int id)
ServiceCalendarDate	getCalendarDateForId(int id)
List<ServiceCalendarDate>	getCalendarDatesForServiceId(AgencyAndId serviceId)	ServiceCalendarDate Methods
ServiceCalendar	getCalendarForId(int id)
ServiceCalendar	getCalendarForServiceId(AgencyAndId serviceId)
List<Date>	getDatesForLocalizedServiceId(LocalizedServiceId localizedServiceId)
DirectionNameException	getDirectionNameExceptionForId(AgencyAndId id)
<T> T	getEntityForId(Class<T> type, Serializable id)
Facility	getFacilityForId(AgencyAndId id)
FacilityPropertyDefinition	getFacilityPropertiesDefinitionsForId(AgencyAndId id)
FacilityProperty	getFacilityPropertiesForId(AgencyAndId id)
FareAttribute	getFareAttributeForId(AgencyAndId id)
FareProduct	getFareProductForId(AgencyAndId id)
FareRule	getFareRuleForId(int id)
List<FareRule>	getFareRulesForFareAttribute(FareAttribute fareAttribute)	FareRule
List<FareRule>	getFareRulesForRoute(Route route)
List<FareRule>	getFareRulesForZoneId(String zoneId)
FeedInfo	getFeedInfoForId(String id)
List<Frequency>	getFrequenciesForTrip(Trip trip)	Frequency Methods
Frequency	getFrequencyForId(int id)
Level	getLevelForId(AgencyAndId id)
LocalizedServiceId	getLocalizedServiceIdForAgencyAndServiceId(String agencyId, AgencyAndId serviceId)	Given an agency id and a service id, we return a LocalizedServiceId which is just a service id with timezone information attached.
String	getMetadata(String filename)
List<Date>	getNextDepartureServiceDates(LocalizedServiceId serviceId, ServiceInterval interval, long targetTime)	Computes the list of service dates whose departure service interval (min to max departure time) overlaps the specified target time.
Map<LocalizedServiceId,List<Date>>	getNextDepartureServiceDates(ServiceIdIntervals serviceIdIntervals, long targetTime)	See the description for CalendarService.getNextDepartureServiceDates(LocalizedServiceId, ServiceInterval, long) .
List<String>	getOptionalMetadataFilenames()
Pathway	getPathwayForId(AgencyAndId id)
List<Date>	getPreviousArrivalServiceDates(LocalizedServiceId serviceId, ServiceInterval interval, long targetTime)	Computes the list of service dates whose arrival service interval (min to max departure time) overlaps the specified target time.
Map<LocalizedServiceId,List<Date>>	getPreviousArrivalServiceDates(ServiceIdIntervals serviceIdIntervals, long targetTime)	See the description for CalendarService.getPreviousArrivalServiceDates(LocalizedServiceId, ServiceInterval, long) .
List<Ridership>	getRidershipForTrip(AgencyAndId tripId)	Ridership
Route	getRouteForId(AgencyAndId id)
RouteNameException	getRouteNameExceptionForId(AgencyAndId id)
List<Route>	getRoutesForAgency(Agency agency)	Route Methods
List<Date>	getServiceDateArrivalsWithinRange(LocalizedServiceId serviceId, ServiceInterval interval, Date from, Date to)	See the description from CalendarService.getServiceDatesWithinRange(LocalizedServiceId, ServiceInterval, Date, Date) .
Map<LocalizedServiceId,List<Date>>	getServiceDateArrivalsWithinRange(ServiceIdIntervals serviceIdIntervals, Date from, Date to)	See the description from CalendarService.getServiceDateArrivalsWithinRange(LocalizedServiceId, ServiceInterval, Date, Date) .
List<Date>	getServiceDateDeparturesWithinRange(LocalizedServiceId serviceId, ServiceInterval interval, Date from, Date to)	See the description from CalendarService.getServiceDatesWithinRange(LocalizedServiceId, ServiceInterval, Date, Date) .
Map<LocalizedServiceId,List<Date>>	getServiceDateDeparturesWithinRange(ServiceIdIntervals serviceIdIntervals, Date from, Date to)	See the description from CalendarService.getServiceDateDeparturesWithinRange(LocalizedServiceId, ServiceInterval, Date, Date) .
Set<ServiceDate>	getServiceDatesForServiceId(AgencyAndId serviceId)
List<Date>	getServiceDatesWithinRange(LocalizedServiceId serviceId, ServiceInterval interval, Date from, Date to)	Given the specified localized service id, which has a corresponding set of localized service dates, determine the sublist of service dates that, when extended with the specified ServiceInterval, overlap with the specified from-to time range.
Map<LocalizedServiceId,List<Date>>	getServiceDatesWithinRange(ServiceIdIntervals serviceIdIntervals, Date from, Date to)	See the description from CalendarService.getServiceDatesWithinRange(LocalizedServiceId, ServiceInterval, Date, Date) .
Set<AgencyAndId>	getServiceIds()
Set<AgencyAndId>	getServiceIdsOnDate(ServiceDate date)	Determine the set of service ids that are active on the specified service date.
ShapePoint	getShapePointForId(int id)
List<ShapePoint>	getShapePointsForShapeId(AgencyAndId shapeId)
Stop	getStopForId(AgencyAndId id)
List<Stop>	getStopsForStation(Stop station)	Stop Methods
List<Stop>	getStopsForZoneId(String zoneId)
StopTime	getStopTimeForId(int id)
List<StopTime>	getStopTimesForStop(Stop stop)
List<StopTime>	getStopTimesForTrip(Trip trip)
TimeZone	getTimeZoneForAgencyId(String agencyId)	Returns the instantiated TimeZone for the specified agency id
Transfer	getTransferForId(int id)
List<String>	getTripAgencyIdsReferencingServiceId(AgencyAndId serviceId)	ServiceId Methods
Trip	getTripForId(AgencyAndId id)
List<Trip>	getTripsForBlockId(AgencyAndId blockId)
List<Trip>	getTripsForRoute(Route route)	Trip Methods
List<Trip>	getTripsForServiceId(AgencyAndId serviceId)
List<Trip>	getTripsForShapeId(AgencyAndId shapeId)
Vehicle	getVehicleForId(AgencyAndId id)	Vehicle Methods
boolean	hasMetadata(String filename)
boolean	isLocalizedServiceIdActiveInRange(LocalizedServiceId serviceId, ServiceInterval scheduledService, AgencyServiceInterval serviceInterval)
boolean	isLocalizedServiceIdActiveOnDate(LocalizedServiceId localizedServiceId, Date serviceDate)
void	setData(CalendarServiceData data)	Update the underlying data structures.
void	setGtfsDao(GtfsRelationalDao dao)

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.onebusaway.gtfs.services.GtfsDao

hasFaresV1, hasFaresV2

Constructor Details

GtfsDataServiceImpl

public GtfsDataServiceImpl()

Method Details

setGtfsDao

public void setGtfsDao(GtfsRelationalDao dao)

getAllEntitiesForType

public <T> Collection<T> getAllEntitiesForType(Class<T> type)

Description copied from interface: GenericDao

Generic Methods

Specified by:

getAllEntitiesForType in interface GenericDao

getEntityForId

public <T> T getEntityForId(Class<T> type,
 Serializable id)

Specified by:

getEntityForId in interface GenericDao

getAllAgencies

public Collection<Agency> getAllAgencies()

Description copied from interface: GtfsDao

Agency Methods

Specified by:

getAllAgencies in interface GtfsDao

getAgencyForId

public Agency getAgencyForId(String id)

Specified by:

getAgencyForId in interface GtfsDao

getAllCalendars

public Collection<ServiceCalendar> getAllCalendars()

Description copied from interface: GtfsDao

ServiceCalendar Methods

Specified by:

getAllCalendars in interface GtfsDao

getCalendarForId

public ServiceCalendar getCalendarForId(int id)

Specified by:

getCalendarForId in interface GtfsDao

getAllCalendarDates

public Collection<ServiceCalendarDate> getAllCalendarDates()

Description copied from interface: GtfsDao

ServiceCalendarDate Methods

Specified by:

getAllCalendarDates in interface GtfsDao

getCalendarDateForId

public ServiceCalendarDate getCalendarDateForId(int id)

Specified by:

getCalendarDateForId in interface GtfsDao

getTripAgencyIdsReferencingServiceId

public List<String> getTripAgencyIdsReferencingServiceId(AgencyAndId serviceId)

Description copied from interface: GtfsRelationalDao

ServiceId Methods

Specified by:

getTripAgencyIdsReferencingServiceId in interface GtfsRelationalDao

getAllFareAttributes

public Collection<FareAttribute> getAllFareAttributes()

Description copied from interface: GtfsDao

FareAttribute Methods

Specified by:

getAllFareAttributes in interface GtfsDao

getAllFareProducts

public Collection<FareProduct> getAllFareProducts()

Description copied from interface: GtfsDao

FareProduct Methods

Specified by:

getAllFareProducts in interface GtfsDao

Specified by:

getAllFareProducts in interface GtfsDataService

getFareProductForId

public FareProduct getFareProductForId(AgencyAndId id)

Specified by:

getFareProductForId in interface GtfsDao

getAllFareMedia

public Collection<FareMedium> getAllFareMedia()

Description copied from interface: GtfsDao

FareMedium Methods

Specified by:

getAllFareMedia in interface GtfsDao

getAllRiderCategories

public Collection<RiderCategory> getAllRiderCategories()

Description copied from interface: GtfsDao

RiderCategory Methods

Specified by:

getAllRiderCategories in interface GtfsDao

getFareAttributeForId

public FareAttribute getFareAttributeForId(AgencyAndId id)

Specified by:

getFareAttributeForId in interface GtfsDao

getAllFareLegRules

public Collection<FareLegRule> getAllFareLegRules()

Description copied from interface: GtfsDao

FareLegRule Methods

Specified by:

getAllFareLegRules in interface GtfsDao

getRoutesForAgency

public List<Route> getRoutesForAgency(Agency agency)

Description copied from interface: GtfsRelationalDao

Route Methods

Specified by:

getRoutesForAgency in interface GtfsRelationalDao

getAllFareRules

public Collection<FareRule> getAllFareRules()

Description copied from interface: GtfsDao

FareRule Methods

Specified by:

getAllFareRules in interface GtfsDao

getStopsForStation

public List<Stop> getStopsForStation(Stop station)

Description copied from interface: GtfsRelationalDao

Stop Methods

Specified by:

getStopsForStation in interface GtfsRelationalDao

getStopsForZoneId

public List<Stop> getStopsForZoneId(String zoneId)

Specified by:

getStopsForZoneId in interface GtfsRelationalDao

getFareRuleForId

public FareRule getFareRuleForId(int id)

Specified by:

getFareRuleForId in interface GtfsDao

getAllFareTransferRules

public Collection<FareTransferRule> getAllFareTransferRules()

Description copied from interface: GtfsDao

FareTransferRule Methods

Specified by:

getAllFareTransferRules in interface GtfsDao

getTripsForRoute

public List<Trip> getTripsForRoute(Route route)

Description copied from interface: GtfsRelationalDao

Trip Methods

Specified by:

getTripsForRoute in interface GtfsRelationalDao

getAllFeedInfos

public Collection<FeedInfo> getAllFeedInfos()

Description copied from interface: GtfsDao

FeedInfo Methods

Specified by:

getAllFeedInfos in interface GtfsDao

getTripsForShapeId

public List<Trip> getTripsForShapeId(AgencyAndId shapeId)

Specified by:

getTripsForShapeId in interface GtfsRelationalDao

getFeedInfoForId

public FeedInfo getFeedInfoForId(String id)

Specified by:

getFeedInfoForId in interface GtfsDao

getTripsForServiceId

public List<Trip> getTripsForServiceId(AgencyAndId serviceId)

Specified by:

getTripsForServiceId in interface GtfsRelationalDao

getTripsForBlockId

public List<Trip> getTripsForBlockId(AgencyAndId blockId)

Specified by:

getTripsForBlockId in interface GtfsRelationalDao

getAllFrequencies

public Collection<Frequency> getAllFrequencies()

Description copied from interface: GtfsDao

Frequency Methods

Specified by:

getAllFrequencies in interface GtfsDao

getFrequencyForId

public Frequency getFrequencyForId(int id)

Specified by:

getFrequencyForId in interface GtfsDao

getAllPathways

public Collection<Pathway> getAllPathways()

Description copied from interface: GtfsDao

Pathway Methods

Specified by:

getAllPathways in interface GtfsDao

getPathwayForId

public Pathway getPathwayForId(AgencyAndId id)

Specified by:

getPathwayForId in interface GtfsDao

getAllLevels

public Collection<Level> getAllLevels()

Specified by:

getAllLevels in interface GtfsDao

getLevelForId

public Level getLevelForId(AgencyAndId id)

Specified by:

getLevelForId in interface GtfsDao

getStopTimesForTrip

public List<StopTime> getStopTimesForTrip(Trip trip)

Specified by:

getStopTimesForTrip in interface GtfsRelationalDao

Returns:

the list of StopTime objects associated with the trip, sorted by StopTime.getStopSequence()

getAllRoutes

public Collection<Route> getAllRoutes()

Description copied from interface: GtfsDao

Route Methods

Specified by:

getAllRoutes in interface GtfsDao

getAllRouteStops

public Collection<RouteStop> getAllRouteStops()

Specified by:

getAllRouteStops in interface GtfsDao

getAllRouteShapes

public Collection<RouteShape> getAllRouteShapes()

Specified by:

getAllRouteShapes in interface GtfsDao

getRouteForId

public Route getRouteForId(AgencyAndId id)

Specified by:

getRouteForId in interface GtfsDao

getAllShapePoints

public Collection<ShapePoint> getAllShapePoints()

Description copied from interface: GtfsDao

ShapePoint Methods

Specified by:

getAllShapePoints in interface GtfsDao

getStopTimesForStop

public List<StopTime> getStopTimesForStop(Stop stop)

Specified by:

getStopTimesForStop in interface GtfsRelationalDao

Returns:

the list of StopTime objects associated with the specified Stop, in no particular order

getShapePointForId

public ShapePoint getShapePointForId(int id)

Specified by:

getShapePointForId in interface GtfsDao

getAllShapeIds

public List<AgencyAndId> getAllShapeIds()

Description copied from interface: GtfsRelationalDao

ShapePoint Methods

Specified by:

getAllShapeIds in interface GtfsRelationalDao

getAllStops

public Collection<Stop> getAllStops()

Description copied from interface: GtfsDao

Stop Methods

Specified by:

getAllStops in interface GtfsDao

getShapePointsForShapeId

public List<ShapePoint> getShapePointsForShapeId(AgencyAndId shapeId)

Specified by:

getShapePointsForShapeId in interface GtfsRelationalDao

getStopForId

public Stop getStopForId(AgencyAndId id)

Specified by:

getStopForId in interface GtfsDao

getAllStopTimes

public Collection<StopTime> getAllStopTimes()

Description copied from interface: GtfsDao

StopTime Methods

Specified by:

getAllStopTimes in interface GtfsDao

getFrequenciesForTrip

public List<Frequency> getFrequenciesForTrip(Trip trip)

Description copied from interface: GtfsRelationalDao

Frequency Methods

Specified by:

getFrequenciesForTrip in interface GtfsRelationalDao

getStopTimeForId

public StopTime getStopTimeForId(int id)

Specified by:

getStopTimeForId in interface GtfsDao

getAllServiceIds

public List<AgencyAndId> getAllServiceIds()

Description copied from interface: GtfsRelationalDao

ServiceCalendar Methods

Specified by:

getAllServiceIds in interface GtfsRelationalDao

getAllTransfers

public Collection<Transfer> getAllTransfers()

Description copied from interface: GtfsDao

Transfer Methods

Specified by:

getAllTransfers in interface GtfsDao

getCalendarForServiceId

public ServiceCalendar getCalendarForServiceId(AgencyAndId serviceId)

Specified by:

getCalendarForServiceId in interface GtfsRelationalDao

getTransferForId

public Transfer getTransferForId(int id)

Specified by:

getTransferForId in interface GtfsDao

getAllTrips

public Collection<Trip> getAllTrips()

Description copied from interface: GtfsDao

Trip Methods

Specified by:

getAllTrips in interface GtfsDao

getTripForId

public Trip getTripForId(AgencyAndId id)

Specified by:

getTripForId in interface GtfsDao

getCalendarDatesForServiceId

public List<ServiceCalendarDate> getCalendarDatesForServiceId(AgencyAndId serviceId)

Description copied from interface: GtfsRelationalDao

ServiceCalendarDate Methods

Specified by:

getCalendarDatesForServiceId in interface GtfsRelationalDao

getAllBlocks

public Collection<Block> getAllBlocks()

Specified by:

getAllBlocks in interface GtfsDao

getBlockForId

public Block getBlockForId(int id)

Specified by:

getBlockForId in interface GtfsDao

getFareRulesForFareAttribute

public List<FareRule> getFareRulesForFareAttribute(FareAttribute fareAttribute)

Description copied from interface: GtfsRelationalDao

FareRule

Specified by:

getFareRulesForFareAttribute in interface GtfsRelationalDao

getFareRulesForRoute

public List<FareRule> getFareRulesForRoute(Route route)

Specified by:

getFareRulesForRoute in interface GtfsRelationalDao

getFareRulesForZoneId

public List<FareRule> getFareRulesForZoneId(String zoneId)

Specified by:

getFareRulesForZoneId in interface GtfsRelationalDao

getAllRiderships

public Collection<Ridership> getAllRiderships()

Specified by:

getAllRiderships in interface GtfsDao

getAllVehicles

public Collection<Vehicle> getAllVehicles()

Description copied from interface: GtfsDao

Vehicle Methods

Specified by:

getAllVehicles in interface GtfsDao

getVehicleForId

public Vehicle getVehicleForId(AgencyAndId id)

Description copied from interface: GtfsDao

Vehicle Methods

Specified by:

getVehicleForId in interface GtfsDao

getAllAreas

public Collection<Area> getAllAreas()

Description copied from interface: GtfsDao

Area Methods

Specified by:

getAllAreas in interface GtfsDao

getAllLocationGroupElements

public Collection<LocationGroupElement> getAllLocationGroupElements()

Specified by:

getAllLocationGroupElements in interface GtfsDao

getAllStopAreaElements

public Collection<StopAreaElement> getAllStopAreaElements()

Specified by:

getAllStopAreaElements in interface GtfsDao

getAllStopAreas

public Collection<StopArea> getAllStopAreas()

Specified by:

getAllStopAreas in interface GtfsDao

getAllLocationGroups

public Collection<LocationGroup> getAllLocationGroups()

Specified by:

getAllLocationGroups in interface GtfsDao

getAllLocations

public Collection<Location> getAllLocations()

Specified by:

getAllLocations in interface GtfsDao

getAllBookingRules

public Collection<BookingRule> getAllBookingRules()

Specified by:

getAllBookingRules in interface GtfsDao

getAllTranslations

public Collection<Translation> getAllTranslations()

Description copied from interface: GtfsDao

Translation Methods

Specified by:

getAllTranslations in interface GtfsDao

getAllNetworks

public Collection<Network> getAllNetworks()

Description copied from interface: GtfsDao

Network Methods

Specified by:

getAllNetworks in interface GtfsDao

getOptionalMetadataFilenames

public List<String> getOptionalMetadataFilenames()

Specified by:

getOptionalMetadataFilenames in interface GtfsDao

hasMetadata

public boolean hasMetadata(String filename)

Specified by:

hasMetadata in interface GtfsDao

getMetadata

public String getMetadata(String filename)

Specified by:

getMetadata in interface GtfsDao

addMetadata

public void addMetadata(String filename,
 String content)

Specified by:

addMetadata in interface GtfsDao

getRidershipForTrip

public List<Ridership> getRidershipForTrip(AgencyAndId tripId)

Description copied from interface: GtfsRelationalDao

Ridership

Specified by:

getRidershipForTrip in interface GtfsRelationalDao

getServiceIds

public Set<AgencyAndId> getServiceIds()

Specified by:

getServiceIds in interface CalendarService

Returns:

the set of all service ids used in the data set

getServiceDatesForServiceId

public Set<ServiceDate> getServiceDatesForServiceId(AgencyAndId serviceId)

Specified by:

getServiceDatesForServiceId in interface CalendarService

Parameters:

serviceId - the target service id

Returns:

the set of all service dates for which the specified service id is active

getServiceIdsOnDate

public Set<AgencyAndId> getServiceIdsOnDate(ServiceDate date)

Description copied from interface: CalendarService

Determine the set of service ids that are active on the specified service date.

Specified by:

getServiceIdsOnDate in interface CalendarService

Parameters:

date - the target service date

Returns:

the set of service ids that are active on the specified service date

getTimeZoneForAgencyId

public TimeZone getTimeZoneForAgencyId(String agencyId)

Description copied from interface: CalendarService

Returns the instantiated TimeZone for the specified agency id

Specified by:

getTimeZoneForAgencyId in interface CalendarService

Parameters:

agencyId - Agency.getId()

Returns:

the time zone for the specified agency, or null if the agency was not found

getLocalizedServiceIdForAgencyAndServiceId

public LocalizedServiceId getLocalizedServiceIdForAgencyAndServiceId(String agencyId,
 AgencyAndId serviceId)

Description copied from interface: CalendarService

Given an agency id and a service id, we return a LocalizedServiceId which is just a service id with timezone information attached. We use the agencyId argument of the method call to lookup the timezone for requested agency. Note that the service id itself has an agencyId component as well, but we don't use that for the timezone lookup. The service id's agencyId is more of a prefix to guarantee dataset uniqueness. For example, multiple Trip objects, representing different agencies, can all reference the same service id. Its important that we look up agency timezone information using the trip's agencyId and not the serviceId's agencyId.

Specified by:

getLocalizedServiceIdForAgencyAndServiceId in interface CalendarService

Parameters:

agencyId - the id of the Agency whose timezone info we will use

serviceId - the service id to use

Returns:

a localized service id with timezone info attached, or nul if the specified agency could not be found

getDatesForLocalizedServiceId

public List<Date> getDatesForLocalizedServiceId(LocalizedServiceId localizedServiceId)

Specified by:

getDatesForLocalizedServiceId in interface CalendarService

isLocalizedServiceIdActiveOnDate

public boolean isLocalizedServiceIdActiveOnDate(LocalizedServiceId localizedServiceId,
 Date serviceDate)

Specified by:

isLocalizedServiceIdActiveOnDate in interface CalendarService

getServiceDatesWithinRange

public List<Date> getServiceDatesWithinRange(LocalizedServiceId serviceId,
 ServiceInterval interval,
 Date from,
 Date to)

Description copied from interface: CalendarService

Given the specified localized service id, which has a corresponding set of localized service dates, determine the sublist of service dates that, when extended with the specified ServiceInterval, overlap with the specified from-to time range. Let's consider a few concrete examples to describe what this method does. Consider a single StopTime with an arrival and departure time. That StopTime is part of a Trip, which means it has a service id attached to it. We wish to answer the question, What service dates would make the specified StopTime active in a particular time range? To answer that question, we'd need to consider each of the localized service dates for which the specified service id is active, add the StopTime arrival and departure offset to each, and see if the resulting time falls within the target range. This method can perform that comparison. By specifying the target service id, a ServiceInterval whose min and max arrival and departure times are set to the arrival and departure time of the StopTime, and the target from-to time interval, the method will return the set of localized service dates that would make the StopTime arrival or departure times active in the specified target time range. As slightly different example, consider answering that same question for multiple StopTime objects, such as all the StopTimes for a particular trip or all the StopTimes for a particular stop. The question is the same, but the difference is now there are multiple arrival and departure times. Here, an appropriate ServiceInterval can be constructed that includes the min and max arrival and departure times for the set of StopTime objects and the calculation will be done looking for service dates that cause any part of the service interval to overlap with the target from-to range. Note that this method considers both the arrival and departure times when looking for overlaps. To consider only arrival times, check out CalendarService.getServiceDateArrivalsWithinRange(LocalizedServiceId, ServiceInterval, Date, Date) and for departures, check out CalendarService.getServiceDateDeparturesWithinRange(LocalizedServiceId, ServiceInterval, Date, Date)

Specified by:

getServiceDatesWithinRange in interface CalendarService

Parameters:

serviceId - the localized service id whose service dates we'll consider

interval - a range of arrival and departure times to consider

from - - the min portion of the target time interval

to - - the max portion of the target time interval

Returns:

the list of localized service dates that would make the specified service interval overlap with the specified from-to time range

getServiceDatesWithinRange

public Map<LocalizedServiceId,List<Date>> getServiceDatesWithinRange(ServiceIdIntervals serviceIdIntervals,
 Date from,
 Date to)

Description copied from interface: CalendarService

See the description from CalendarService.getServiceDatesWithinRange(LocalizedServiceId, ServiceInterval, Date, Date) . This method does the same thing, except that it works with multiple service ids and intervals at the same time.

Specified by:

getServiceDatesWithinRange in interface CalendarService

Parameters:

serviceIdIntervals - - a set of service ids and service intervals

from - - time interval min

to - - time interval max

Returns:

the list of active service dates, keyed by service id

getServiceDateDeparturesWithinRange

public List<Date> getServiceDateDeparturesWithinRange(LocalizedServiceId serviceId,
 ServiceInterval interval,
 Date from,
 Date to)

Description copied from interface: CalendarService

See the description from CalendarService.getServiceDatesWithinRange(LocalizedServiceId, ServiceInterval, Date, Date) . This method does the same thing, except that it only considers departure times.

Specified by:

getServiceDateDeparturesWithinRange in interface CalendarService

Parameters:

serviceId - the localized service id whose service dates we'll consider

interval - a range of departure times to consider

from - - the min portion of the target time interval

to - - the max portion of the target time interval

Returns:

the list of active service dates

getServiceDateDeparturesWithinRange

public Map<LocalizedServiceId,List<Date>> getServiceDateDeparturesWithinRange(ServiceIdIntervals serviceIdIntervals,
 Date from,
 Date to)

Description copied from interface: CalendarService

See the description from CalendarService.getServiceDateDeparturesWithinRange(LocalizedServiceId, ServiceInterval, Date, Date) . This method does the same thing, except that it works with multiple service ids and intervals at the same time.

Specified by:

getServiceDateDeparturesWithinRange in interface CalendarService

Parameters:

serviceIdIntervals - - a set of service ids and service intervals

from - - time interval min

to - - time interval max

Returns:

the list of active service dates, keyed by service id

getServiceDateArrivalsWithinRange

public List<Date> getServiceDateArrivalsWithinRange(LocalizedServiceId serviceId,
 ServiceInterval interval,
 Date from,
 Date to)

Description copied from interface: CalendarService

See the description from CalendarService.getServiceDatesWithinRange(LocalizedServiceId, ServiceInterval, Date, Date) . This method does the same thing, except that it only considers arrival times.

Specified by:

getServiceDateArrivalsWithinRange in interface CalendarService

Parameters:

serviceId - the localized service id whose service dates we'll consider

interval - a range of arrival times to consider

from - - the min portion of the target time interval

to - - the max portion of the target time interval

Returns:

the list of active service dates

isLocalizedServiceIdActiveInRange

public boolean isLocalizedServiceIdActiveInRange(LocalizedServiceId serviceId,
 ServiceInterval scheduledService,
 AgencyServiceInterval serviceInterval)

Specified by:

isLocalizedServiceIdActiveInRange in interface CalendarService

getServiceDateArrivalsWithinRange

public Map<LocalizedServiceId,List<Date>> getServiceDateArrivalsWithinRange(ServiceIdIntervals serviceIdIntervals,
 Date from,
 Date to)

Description copied from interface: CalendarService

See the description from CalendarService.getServiceDateArrivalsWithinRange(LocalizedServiceId, ServiceInterval, Date, Date) . This method does the same thing, except that it works with multiple service ids and intervals at the same time.

Specified by:

getServiceDateArrivalsWithinRange in interface CalendarService

Parameters:

serviceIdIntervals - - a set of service ids and service intervals

from - - time interval min

to - - time interval max

Returns:

the list of active service dates, keyed by service id

getNextDepartureServiceDates

public List<Date> getNextDepartureServiceDates(LocalizedServiceId serviceId,
 ServiceInterval interval,
 long targetTime)

Description copied from interface: CalendarService

Computes the list of service dates whose departure service interval (min to max departure time) overlaps the specified target time. If no intervals overlaps, then the next service date whose full service interval comes immediately after (but does overlap) the target time is returned. This method is useful for finding the next scheduled StopTime after the target time at a particular stop . By calling this method with the serviceId and service interval for the specified stop, we return the set of service dates that overlap or the next service date if none do, guaranteeing that at least one service date instantiates a StopTime that occurs after the target time.

Specified by:

getNextDepartureServiceDates in interface CalendarService

Parameters:

serviceId - the localized service id whose service dates we'll consider

interval - a range of departure times to consider

targetTime - - time in UTC

Returns:

the set of overlapping and next service dates

getNextDepartureServiceDates

public Map<LocalizedServiceId,List<Date>> getNextDepartureServiceDates(ServiceIdIntervals serviceIdIntervals,
 long targetTime)

Description copied from interface: CalendarService

See the description for CalendarService.getNextDepartureServiceDates(LocalizedServiceId, ServiceInterval, long) . This method does the same thing, except that it works with multiple service ids and intervals at the same time.

Specified by:

getNextDepartureServiceDates in interface CalendarService

Parameters:

serviceIdIntervals - - set of service ids and service intervals

targetTime -

Returns:

the set of overlapping and next service dates

getPreviousArrivalServiceDates

public List<Date> getPreviousArrivalServiceDates(LocalizedServiceId serviceId,
 ServiceInterval interval,
 long targetTime)

Description copied from interface: CalendarService

Computes the list of service dates whose arrival service interval (min to max departure time) overlaps the specified target time. If not intervals overlap, then the previous service date whose full service interval comes immediately before (but does overlap) the target time is returned. This method is useful for finding the previous scheduled StopTime before the target time at a particular stop . By calling this method with the serviceId and service interval for the specified stop, we return the set of service dates that potentially overlap or the previous service date if none do, guaranteeing that at least one service date instantiates a StopTime that occurs before the target time.

Specified by:

getPreviousArrivalServiceDates in interface CalendarService

Parameters:

serviceId - the localized service id whose service dates we'll consider

interval - a range of arrival times to consider

targetTime - - time in UTC

Returns:

the set of overlapping and previous service dates

getPreviousArrivalServiceDates

public Map<LocalizedServiceId,List<Date>> getPreviousArrivalServiceDates(ServiceIdIntervals serviceIdIntervals,
 long targetTime)

Description copied from interface: CalendarService

See the description for CalendarService.getPreviousArrivalServiceDates(LocalizedServiceId, ServiceInterval, long) . This method does the same thing, except that it works with multiple service ids and intervals at the same time.

Specified by:

getPreviousArrivalServiceDates in interface CalendarService

Parameters:

serviceIdIntervals - - set of service ids and service intervals

targetTime -

Returns:

the set of overlapping and previous service dates

setData

public void setData(CalendarServiceData data)

Description copied from interface: CalendarService

Update the underlying data structures.

Specified by:

setData in interface CalendarService

Parameters:

data -

getFacilityForId

public Facility getFacilityForId(AgencyAndId id)

getFacilityPropertiesForId

public FacilityProperty getFacilityPropertiesForId(AgencyAndId id)

getFacilityPropertiesDefinitionsForId

public FacilityPropertyDefinition getFacilityPropertiesDefinitionsForId(AgencyAndId id)

getRouteNameExceptionForId

public RouteNameException getRouteNameExceptionForId(AgencyAndId id)

getDirectionNameExceptionForId

public DirectionNameException getDirectionNameExceptionForId(AgencyAndId id)

getAlternateStopNameExceptionForId

public AlternateStopNameException getAlternateStopNameExceptionForId(AgencyAndId id)

getAllFacilities

public Collection<Facility> getAllFacilities()

getAllFacilityProperties

public Collection<FacilityProperty> getAllFacilityProperties()

getAllFacilityPropertyDefinitions

public Collection<FacilityPropertyDefinition> getAllFacilityPropertyDefinitions()

getAllRouteNameExceptions

public Collection<RouteNameException> getAllRouteNameExceptions()

getAllDirectionNameExceptions

public Collection<DirectionNameException> getAllDirectionNameExceptions()

getAllAlternateStopNameExceptions

public Collection<AlternateStopNameException> getAllAlternateStopNameExceptions()

getAllDirectionEntries

public Collection<DirectionEntry> getAllDirectionEntries()

Specified by:

getAllDirectionEntries in interface GtfsDao

getAllWrongWayConcurrencies

public Collection<WrongWayConcurrency> getAllWrongWayConcurrencies()

Specified by:

getAllWrongWayConcurrencies in interface GtfsDao