Station (sdjson-api 0.20131021.1 API)

java.lang.Object
- org.schedulesdirect.api.Station

```
public class Station
extends Object
```
A Station represents a single station available on a lineup
Only EpgClient can instantiate instances of this class

When there's a discrepancy between the descriptions of data found in this source code and that found here then the latter web source will always take precedence!

Author:

Derek Battams <derek@battams.ca>

Nested Class Summary

Nested Classes
Modifier and Type Class and Description

class Station.Logo

Nested Classes
Modifier and Type	Class and Description
`class`	`Station.Logo`

Method Summary

Methods
Modifier and Type	Method and Description
`protected void`	`downloadProgramsAndAirings()` Downloads and builds the arrays of programs and airings as needed
`boolean`	`equals(Object obj)`
`String`	`getAffiliate()`
`Airing[]`	`getAirings()` Get all available future airings scheduled for this station
`int`	`getAtscMajorNumber()`
`int`	`getAtscMinorNumber()`
`String`	`getBroadcasterCity()`
`String`	`getBroadcasterCountry()`
`String`	`getBroadcasterState()`
`String`	`getBroadcasterZip()`
`String`	`getCallsign()`
`String`	`getId()`
`String`	`getLanguage()`
`String`	`getLogicalChannelNumber()`
`Station.Logo`	`getLogo()`
`String`	`getName()`
`String`	`getPhysicalChannelNumber()`
`Program[]`	`getPrograms()` Get all available programs scheduled to air on this station
`int`	`getUhfVhfNumber()`
`int`	`hashCode()`
`void`	`setAffiliate(String affiliate)`
`void`	`setAirings(Airing[] airings)` Set the Airings for this Station; all of the Airing's Station references will be changed to point to this Station instance
`void`	`setAtscMajorNumber(int atscMajorNumber)`
`void`	`setAtscMinorNumber(int atscMinorNumber)`
`void`	`setBroadcasterCity(String broadcasterCity)`
`void`	`setBroadcasterCountry(String broadcasterCountry)`
`void`	`setBroadcasterState(String broadcasterState)`
`void`	`setBroadcasterZip(String broadcasterZip)`
`void`	`setCallsign(String callsign)`
`void`	`setId(String id)`
`void`	`setLogo(Station.Logo logo)`
`void`	`setName(String name)`
`void`	`setUhfVhfNumber(int uhfVhfNumber)`
`String`	`toString()`

Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait

- Method Detail
  - getId
```
public String getId()
```
    Returns:
    The Station's unique id
  - getLanguage
```
public String getLanguage()
```
    Returns:
    The station's language or empty string if not provided (assume English in this case)
  - getCallsign
```
public String getCallsign()
```
    Returns:
    The station's unique callsign
  - getName
```
public String getName()
```
    Returns:
    The station's full name
  - getAffiliate
```
public String getAffiliate()
```
    Returns:
    The station's parent affiliate; may be empty; never null
  - getBroadcasterState
```
public String getBroadcasterState()
```
    Returns:
    The state/province from which this station broadcasts
  - getBroadcasterCity
```
public String getBroadcasterCity()
```
    Returns:
    The city from which this station broadcasts
  - getBroadcasterZip
```
public String getBroadcasterZip()
```
    Returns:
    The zip/postal code from which this station broadcasts
  - getBroadcasterCountry
```
public String getBroadcasterCountry()
```
    Returns:
    The country from which this station broadcasts
  - getUhfVhfNumber
```
public int getUhfVhfNumber()
```
    Returns:
    The physical UHF/VHF number this station broadcasts on; only for OTA stations; zero if not applicable
  - getAtscMajorNumber
```
public int getAtscMajorNumber()
```
    Returns:
    The ATSC major number this station broadcasts on; only for OTA stations; zero if not applicable
  - getAtscMinorNumber
```
public int getAtscMinorNumber()
```
    Returns:
    The ATSC minor number this station broadcasts on; only for OTA stations; zero if not applicable
  - getPhysicalChannelNumber
```
public String getPhysicalChannelNumber()
```
    Returns:
    A user friendly physical channel number for this station (i.e. 34-1-1); applicable only for OTA stations; null otherwise
  - getLogicalChannelNumber
```
public String getLogicalChannelNumber()
```
    Returns:
    A user friendly logical channel number for this station (i.e. 5-2); applicable only for OTA stations; null otherwise
  - getAirings
```
public Airing[] getAirings()
                    throws IOException
```
    Get all available future airings scheduled for this station
    The airings are only downloaded and built on the first access of this array; lazy initialization
    
    Returns:
    An array of Airing objects; never null; may be empty
    
    Throws:
    
    IOException - Thrown on any IO error accessing the upstream data feed
  - getPrograms
```
public Program[] getPrograms()
                      throws IOException
```
    Get all available programs scheduled to air on this station
    The programs are only downloaded and built on the first access of this array; lazy initialization
    
    Returns:
    An array of Program objects; never null; may be empty
    
    Throws:
    
    IOException - Thrown on any IO error accessing the upstream data feed
  - downloadProgramsAndAirings
```
protected void downloadProgramsAndAirings()
                                   throws IOException
```
    Downloads and builds the arrays of programs and airings as needed
    
    Throws:
    
    IOException - Thrown on any IO error accessing the upstream data feed
  - toString
```
public String toString()
```
    Overrides:
    
    toString in class Object
  - setId
```
public void setId(String id)
```
    Parameters:
    id - the id to set
  - setCallsign
```
public void setCallsign(String callsign)
```
    Parameters:
    callsign - the callsign to set
  - setName
```
public void setName(String name)
```
    Parameters:
    name - the name to set
  - setAffiliate
```
public void setAffiliate(String affiliate)
```
    Parameters:
    affiliate - the affiliate to set
  - setBroadcasterState
```
public void setBroadcasterState(String broadcasterState)
```
    Parameters:
    broadcasterState - the broadcasterState to set
  - setBroadcasterCity
```
public void setBroadcasterCity(String broadcasterCity)
```
    Parameters:
    broadcasterCity - the broadcasterCity to set
  - setBroadcasterZip
```
public void setBroadcasterZip(String broadcasterZip)
```
    Parameters:
    broadcasterZip - the broadcasterZip to set
  - setBroadcasterCountry
```
public void setBroadcasterCountry(String broadcasterCountry)
```
    Parameters:
    broadcasterCountry - the broadcasterCountry to set
  - setUhfVhfNumber
```
public void setUhfVhfNumber(int uhfVhfNumber)
```
    Parameters:
    uhfVhfNumber - the uhfVhfNumber to set
  - setAtscMajorNumber
```
public void setAtscMajorNumber(int atscMajorNumber)
```
    Parameters:
    atscMajorNumber - the atscMajorNumber to set
  - setAtscMinorNumber
```
public void setAtscMinorNumber(int atscMinorNumber)
```
    Parameters:
    atscMinorNumber - the atscMinorNumber to set
  - setAirings
```
public void setAirings(Airing[] airings)
```
    Set the Airings for this Station; all of the Airing's Station references will be changed to point to this Station instance
    
    Parameters:
    airings - the airings to set
  - getLogo
```
public Station.Logo getLogo()
```
    Returns:
    the logo
  - setLogo
```
public void setLogo(Station.Logo logo)
```
    Parameters:
    logo - the logo to set
  - hashCode
```
public int hashCode()
```
    Overrides:
    
    hashCode in class Object
  - equals
```
public boolean equals(Object obj)
```
    Overrides:
    
    equals in class Object

Class Station

Nested Class Summary

Method Summary

Methods inherited from class java.lang.Object

Method Detail

getId

getLanguage

getCallsign

getName

getAffiliate

getBroadcasterState

getBroadcasterCity

getBroadcasterZip

getBroadcasterCountry

getUhfVhfNumber

getAtscMajorNumber

getAtscMinorNumber

getPhysicalChannelNumber

getLogicalChannelNumber

getAirings

getPrograms

downloadProgramsAndAirings

toString

setId

setCallsign

setName

setAffiliate

setBroadcasterState

setBroadcasterCity

setBroadcasterZip

setBroadcasterCountry

setUhfVhfNumber

setAtscMajorNumber

setAtscMinorNumber

setAirings

getLogo

setLogo

hashCode

equals