Package org.onebusaway.gtfs_merge.strategies

Class ServiceCalendarMergeStrategy

java.lang.Object

org.onebusaway.gtfs_merge.strategies.AbstractEntityMergeStrategy

org.onebusaway.gtfs_merge.strategies.AbstractCollectionEntityMergeStrategy<AgencyAndId>

org.onebusaway.gtfs_merge.strategies.ServiceCalendarMergeStrategy

All Implemented Interfaces:

EntityMergeStrategy

public class ServiceCalendarMergeStrategy
extends AbstractCollectionEntityMergeStrategy<AgencyAndId>

Entity merge strategy for handling ServiceCalendar and ServiceCalendarDate entities. We merge them at the same time since they are both part of a larger entity collection identified by a single service_id identifier.

Author:

bdferris

Field Summary

Fields inherited from class org.onebusaway.gtfs_merge.strategies.AbstractEntityMergeStrategy

_duplicateDetectionStrategy, _logDuplicatesStrategy, _minElementDuplicateScoreForFuzzyMatch, _minElementsDuplicateScoreForAutoDetect, _minElementsInCommonScoreForAutoDetect

Constructor Summary

Constructors

Constructor	Description
ServiceCalendarMergeStrategy()

Method Summary

Modifier and Type	Method	Description
void	getEntityTypes(Collection<Class<?>> entityTypes)	Determine the list of entity types handled by this merge strategy.
protected Collection<AgencyAndId>	getKeys(GtfsRelationalDao dao)	An entity-specific method to determine the set of unique identifiers used by collection entities in the specified GTFS feed.
protected void	renameKey(GtfsMergeContext context, AgencyAndId oldId, AgencyAndId newId)	Replaces all references to the specified old service_id with the new service_id for all ServiceCalendar, ServiceCalendarDate, and Trip entities in the source feed.
protected void	saveElementsForKey(GtfsMergeContext context, AgencyAndId serviceId)	Writes all ServiceCalendar and ServiceCalendarDate entities with the specified service_id to the merged output feed.
protected double	scoreDuplicateKey(GtfsMergeContext context, AgencyAndId key)	We consider two service calendars to be duplicates if they share a lot of dates in common.

Methods inherited from class org.onebusaway.gtfs_merge.strategies.AbstractCollectionEntityMergeStrategy

getDescription, getRawKey, merge, pickBestDuplicateDetectionStrategy

Methods inherited from class org.onebusaway.gtfs_merge.strategies.AbstractEntityMergeStrategy

determineDuplicateDetectionStrategy, getDuplicateRenamingStrategy, setDuplicateDetectionStrategy, setDuplicateRenamingStrategy, setLogDuplicatesStrategy

Methods inherited from class java.lang.Object

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

Constructor Details

ServiceCalendarMergeStrategy

public ServiceCalendarMergeStrategy()

Method Details

getEntityTypes

public void getEntityTypes(Collection<Class<?>> entityTypes)

Description copied from interface: EntityMergeStrategy

Determine the list of entity types handled by this merge strategy.

Parameters:

entityTypes - the handled types should be added to this output collection.

getKeys

protected Collection<AgencyAndId> getKeys(GtfsRelationalDao dao)

Description copied from class: AbstractCollectionEntityMergeStrategy

An entity-specific method to determine the set of unique identifiers used by collection entities in the specified GTFS feed.

Specified by:

getKeys in class AbstractCollectionEntityMergeStrategy<AgencyAndId>

Parameters:

dao -

Returns:

the set of unique identifiers

scoreDuplicateKey

protected double scoreDuplicateKey(GtfsMergeContext context,
 AgencyAndId key)

We consider two service calendars to be duplicates if they share a lot of dates in common. This doesn't actually do so well when merging two feeds with different service calendars (eg. before and after a schedule shakeup), which is a trickier problem to solve.

Specified by:

scoreDuplicateKey in class AbstractCollectionEntityMergeStrategy<AgencyAndId>

Parameters:

context -

key -

Returns:

renameKey

protected void renameKey(GtfsMergeContext context,
 AgencyAndId oldId,
 AgencyAndId newId)

Replaces all references to the specified old service_id with the new service_id for all ServiceCalendar, ServiceCalendarDate, and Trip entities in the source feed.

Specified by:

renameKey in class AbstractCollectionEntityMergeStrategy<AgencyAndId>

Parameters:

context -

oldId - the original id in the source input feed

newId - the new id, which replaces the old in the source input feed

saveElementsForKey

protected void saveElementsForKey(GtfsMergeContext context,
 AgencyAndId serviceId)

Writes all ServiceCalendar and ServiceCalendarDate entities with the specified service_id to the merged output feed.

Specified by:

saveElementsForKey in class AbstractCollectionEntityMergeStrategy<AgencyAndId>

Parameters:

context -

serviceId - the identifier for the entity collection to save