org.transitime.core

Class ServiceUtils

java.lang.Object

org.transitime.core.ServiceUtils

public class ServiceUtils
extends java.lang.Object

For working with service types, such as determining serviceId or appropriate block to use for a given epoch time.

Author:

SkiBu Smith

Constructor Summary

Constructors

Constructor and Description
ServiceUtils(DbConfig dbConfig) ServiceUtils constructor.

Method Summary

Modifier and Type	Method and Description
java.util.List<Calendar>	getCurrentCalendars(long epochTime) Finds the calendars that are currently active.
int	getDayOfWeek(java.util.Date epochTime) Returns day of the week.
java.util.Collection<java.lang.String>	getServiceIds(java.util.Date epochTime) Determines list of current service IDs for the specified time.
java.util.Collection<java.lang.String>	getServiceIds(long epochTime) Determines list of current service IDs for the specified time.
java.util.List<java.lang.String>	getServiceIdsForDay(java.util.Date epochTime) Determines list of current service IDs for the specified time.
java.util.List<java.lang.String>	getServiceIdsForDay(long epochTime) Determines list of current service IDs for the specified time.

Methods inherited from class java.lang.Object

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

Constructor Detail

ServiceUtils

public ServiceUtils(DbConfig dbConfig)

ServiceUtils constructor. Creates reusable GregorianCalendar and sets the timezone so that the calendar can be reused.

Parameters:

timezoneName - See http://en.wikipedia.org/wiki/List_of_tz_zones

Method Detail

getDayOfWeek

public int getDayOfWeek(java.util.Date epochTime)

Returns day of the week. Value returned will be a constant from jvaa.util.Calendar such as Calendar.TUESDAY.

Parameters:

epochTime -

Returns:

Day of the week

getServiceIdsForDay

public java.util.List<java.lang.String> getServiceIdsForDay(java.util.Date epochTime)

Determines list of current service IDs for the specified time. These service IDs designate which block assignments are currently active.

Uses already read in calendars, but does a good number of calculations so still a bit expensive.

Parameters:

epochTime - The current time that determining service IDs for

Returns:

List of service IDs that are active for the specified time.

getServiceIdsForDay

public java.util.List<java.lang.String> getServiceIdsForDay(long epochTime)

Determines list of current service IDs for the specified time. These service IDs designate which block assignments are currently active.

Uses already read in calendars, but does a good number of calculations so still a bit expensive.

Parameters:

epochTime - The current time that determining service IDs for

Returns:

List of service IDs that are active for the specified time.

getServiceIds

public java.util.Collection<java.lang.String> getServiceIds(java.util.Date epochTime)

Determines list of current service IDs for the specified time. If it is before the java property minutesIntoMorningToIncludePreviousServiceIds then the service IDs for the previous day will also be included. This way will get the proper service IDs even for blocks that started the previous day. Important for late night service. These service IDs designate which block assignments are currently active.

Uses already read in calendars, but does a good number of calculations so still a bit expensive.

Parameters:

epochTime - The current time that determining service IDs for

Returns:

List of service IDs that are active for the specified time, includes ones for previous day if epochTime specifies it is early in the morning.

getServiceIds

public java.util.Collection<java.lang.String> getServiceIds(long epochTime)

Determines list of current service IDs for the specified time. If it is before the java property minutesIntoMorningToIncludePreviousServiceIds then the service IDs for the previous day will also be included. This way will get the proper service IDs even for blocks that started the previous day. Important for late night service. These service IDs designate which block assignments are currently active.

Uses already read in calendars, but does a good number of calculations so still a bit expensive.

Parameters:

epochTime - The current time that determining service IDs for

Returns:

List of service IDs that are active for the specified time, includes ones for previous day if epochTime specifies it is early in the morning.

getCurrentCalendars

public java.util.List<Calendar> getCurrentCalendars(long epochTime)

Finds the calendars that are currently active.

Parameters:

epochTime -

Returns:

List of calendars that are currently active.