org.davic.net.dvb

Class DvbLocator

java.lang.Object

org.davic.net.Locator

org.davic.net.dvb.DvbLocator

All Implemented Interfaces:

Locator

Direct Known Subclasses:

DvbNetworkBoundLocator

public class DvbLocator
extends Locator

DVB Locator that encapsulates a DVB URL into an object

Constructor Summary

Constructors

Constructor and Description
DvbLocator(int onid, int tsid) Constructor for the DVB locator corresponding to the URL form "dvb://onid.tsid"
DvbLocator(int onid, int tsid, int serviceid) Constructor for the DVB locator corresponding to the URL form "dvb://onid.tsid.serviceid"
DvbLocator(int onid, int tsid, int serviceid, int eventid) Constructor for the DVB locator corresponding to the URL form "dvb://onid.tsid.serviceid;eventid"
DvbLocator(int onid, int tsid, int serviceid, int eventid, int componenttag) Constructor for the DVB locator corresponding to the URL form "dvb://onid.tsid.serviceid.componenttag;eventid" or "dvb://onid.tsid.serviceid.componenttag"
DvbLocator(int onid, int tsid, int serviceid, int eventid, int[] componenttags) Constructor for the DVB locator corresponding to the URL form "dvb://onid.tsid.serviceid.componenttag{&componenttag};eventid" or "dvb://onid.tsid.serviceid.componenttag{&componenttag}"
DvbLocator(int onid, int tsid, int serviceid, int eventid, int[] componenttags, String filePath) Constructor for the DVB locator corresponding to the URL form "dvb://onid.tsid.serviceid.componenttag{&componenttag};eventid/filepath" or "dvb://onid.tsid.serviceid.componenttag{&componenttag}/filepath"
DvbLocator(String url) Constructor for the DVB locator

Method Summary

Methods

Modifier and Type	Method and Description
int[]	getComponentTags() Returns an array of the component_tags
int	getEventId() Returns the event_id
String	getFilePath() Returns the file name path part of the locator
int	getOriginalNetworkId() Returns the original_network_id
int	getServiceId() Returns the service_id
String	getTextualServiceIdentifier() Returns the textual service identifier, if one was provided to the constructor.
int	getTransportStreamId() Returns the transport_stream_id

Methods inherited from class org.davic.net.Locator

hasMultipleTransformations, toExternalForm, toString

Methods inherited from class java.lang.Object

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

Methods inherited from interface javax.tv.locator.Locator

equals, hashCode

Constructor Detail

DvbLocator

public DvbLocator(String url)
           throws InvalidLocatorException

Constructor for the DVB locator

Parameters:

url - a URL string

Throws:

InvalidLocatorException - when the parameters to construct the locator wouldn't specify a valid locator (e.g. a numeric identifier out of range)

DvbLocator

public DvbLocator(int onid,
          int tsid)
           throws InvalidLocatorException

Constructor for the DVB locator corresponding to the URL form "dvb://onid.tsid"

Parameters:

onid - original network identifier

tsid - transport stream identifier

Throws:

InvalidLocatorException - when the parameters to construct the locator wouldn't specify a valid locator (e.g. a numeric identifier out of range)

DvbLocator

public DvbLocator(int onid,
          int tsid,
          int serviceid)
           throws InvalidLocatorException

Constructor for the DVB locator corresponding to the URL form "dvb://onid.tsid.serviceid"

Parameters:

onid - original network identifier

tsid - transport stream identifier (if -1, the locator does not include a transport_stream_id)

serviceid - service identifier

Throws:

InvalidLocatorException - when the parameters to construct the locator wouldn't specify a valid locator (e.g. a numeric identifier out of range)

DvbLocator

public DvbLocator(int onid,
          int tsid,
          int serviceid,
          int eventid)
           throws InvalidLocatorException

Constructor for the DVB locator corresponding to the URL form "dvb://onid.tsid.serviceid;eventid"

Parameters:

onid - original network identifier

tsid - transport stream identifier (if -1, the locator does not include a transport_stream_id)

serviceid - service identifier

eventid - event identifier

Throws:

InvalidLocatorException - when the parameters to construct the locator wouldn't specify a valid locator (e.g. a numeric identifier out of range)

DvbLocator

public DvbLocator(int onid,
          int tsid,
          int serviceid,
          int eventid,
          int componenttag)
           throws InvalidLocatorException

Constructor for the DVB locator corresponding to the URL form "dvb://onid.tsid.serviceid.componenttag;eventid" or "dvb://onid.tsid.serviceid.componenttag"

Parameters:

onid - original network identifier

tsid - transport stream identifier (if -1, the locator does not include a transport_stream_id)

serviceid - service identifier

eventid - event identifier (if -1, the locator does not include an event id)

componenttag - component tag

Throws:

InvalidLocatorException - when the parameters to construct the locator wouldn't specify a valid locator (e.g. a numeric identifier out of range)

DvbLocator

public DvbLocator(int onid,
          int tsid,
          int serviceid,
          int eventid,
          int[] componenttags)
           throws InvalidLocatorException

Constructor for the DVB locator corresponding to the URL form "dvb://onid.tsid.serviceid.componenttag{&componenttag};eventid" or "dvb://onid.tsid.serviceid.componenttag{&componenttag}"

Parameters:

onid - original network identifier

tsid - transport stream identifier (if -1, the locator does not include a transport_stream_id)

serviceid - service identifier

eventid - event identifier (if -1, the locator does not include an event id)

componenttags - an array of component tags

Throws:

InvalidLocatorException - when the parameters to construct the locator wouldn't specify a valid locator (e.g. a numeric identifier out of range)

DvbLocator

public DvbLocator(int onid,
          int tsid,
          int serviceid,
          int eventid,
          int[] componenttags,
          String filePath)
           throws InvalidLocatorException

Constructor for the DVB locator corresponding to the URL form "dvb://onid.tsid.serviceid.componenttag{&componenttag};eventid/filepath" or "dvb://onid.tsid.serviceid.componenttag{&componenttag}/filepath"

Parameters:

onid - original network identifier

tsid - transport stream identifier (if -1, the locator does not include a transport_stream_id)

serviceid - service identifier

eventid - event identifier (if -1, the locator does not include an event id)

componenttags - array of component tags (if null, the locator does not include any component tags)

filePath - the file path string including the slash character in the beginning

Throws:

InvalidLocatorException - when the parameters to construct the locator wouldn't specify a valid locator (e.g. a numeric identifier out of range)

Method Detail

getOriginalNetworkId

public int getOriginalNetworkId()

Returns the original_network_id

Returns:

original_network_id or -1 if not present

getTransportStreamId

public int getTransportStreamId()

Returns the transport_stream_id

Returns:

transport_stream_id, -1 if not present

getServiceId

public int getServiceId()

Returns the service_id

Returns:

service_id, -1 if not present

getComponentTags

public int[] getComponentTags()

Returns an array of the component_tags

Returns:

an array containing the component_tags, the length of the array will be zero if the locator does not identify component_tags

getEventId

public int getEventId()

Returns the event_id

Returns:

event_id, -1 if not present

getFilePath

public String getFilePath()

Returns the file name path part of the locator

Returns:

the path string, including the slash character in the beginning. If the locator does not include a path string, this method will return null.

getTextualServiceIdentifier

public String getTextualServiceIdentifier()

Returns the textual service identifier, if one was provided to the constructor.

Returns:

the textual service identifier, null if not present

Since:

MHP1.0.1