com.sun.dtv.locator
Class NetworkBoundLocator

java.lang.Object
  com.sun.dtv.locator.URLLocator
      com.sun.dtv.locator.EntityLocator
          com.sun.dtv.locator.NetworkBoundLocator

All Implemented Interfaces:

Locator, TransportDependentLocator

public abstract class NetworkBoundLocator

extends EntityLocator

implements TransportDependentLocator

Locator referring to entities that are network bound.

Constructor Summary

NetworkBoundLocator(String url)
Create a locator from the given url.

Method Summary

String

toExternalForm() Generates a canonical, string-based representation of this Locator. The string returned may be entirely platform-dependent. If two locators have identical external forms, they refer to the same resource. However, two locators that refer to the same resource may have different external forms. This method returns the canonical form of the string that was used to create the Locator (via LocatorFactory.createLocator()). In generating canonical external forms, the implementation will make its best effort at resolving locators to one-to-one relationships with the resources that they reference. The result of this method can be used to create new Locator instances as well as other types of locators, such as JMF MediaLocators and URLs.

Methods inherited from class com.sun.dtv.locator.EntityLocator

getContentId, getEventId, getMediaLocator, getOriginalNetworkId, getServiceId, getTransportStreamId

Methods inherited from class com.sun.dtv.locator.URLLocator

equals, hashCode, hasMultipleTransformations, toString

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface javax.tv.locator.Locator

equals, hashCode, hasMultipleTransformations, toString

Constructor Detail

NetworkBoundLocator

public NetworkBoundLocator(String url)
                    throws InvalidLocatorException

Create a locator from the given url.

Parameters:

url - the url string

Throws:

InvalidLocatorException - if the locator can not be created from the provided parameters.

Method Detail

toExternalForm

public String toExternalForm()

Generates a canonical, string-based representation of this Locator. The string returned may be entirely platform-dependent. If two locators have identical external forms, they refer to the same resource. However, two locators that refer to the same resource may have different external forms.

This method returns the canonical form of the string that was used to create the Locator (via LocatorFactory.createLocator()). In generating canonical external forms, the implementation will make its best effort at resolving locators to one-to-one relationships with the resources that they reference.

The result of this method can be used to create new Locator instances as well as other types of locators, such as JMF MediaLocators and URLs.

Specified by:

toExternalForm in interface Locator

Overrides:

toExternalForm in class EntityLocator