org.davic.net.dvb
Class DvbLocator

java.lang.Object
  extended byorg.davic.net.Locator
      extended byorg.davic.net.dvb.DvbLocator
All Implemented Interfaces:
javax.tv.locator.Locator
Direct Known Subclasses:
DvbNetworkBoundLocator

public class DvbLocator
extends Locator

DVB Locator that encapsulates a DVB URL into an object


Constructor Summary
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, java.lang.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(java.lang.String url)
          Constructor for the DVB locator
 
Method Summary
 int[] getComponentTags()
          Returns an array of the component_tags
 int getEventId()
          Returns the event_id
 java.lang.String getFilePath()
          Returns the file name path part of the locator
 int getOriginalNetworkId()
          Returns the original_network_id
 int getServiceId()
          Returns the service_id
 java.lang.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(java.lang.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,
                  java.lang.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 java.lang.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 java.lang.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