com.sun.tv

Class LocatorImpl

java.lang.Object

com.sun.tv.LocatorImpl

All Implemented Interfaces:

Locator

public class LocatorImpl
extends Object
implements Locator

Field Summary

Fields

Modifier and Type	Field and Description
static String	AlternateProtocol
static String	BouquetProtocol
static String	CarouselProtocol
static String	NetworkProtocol
static String	ProgramEventDescriptionProtocol
static String	ProgramEventProtocol
static String	ServiceComponentProtocol
static String	ServiceDescriptionProtocol
static String	ServiceProtocol The following are the forms of the various protocols, TBD yet to be implemented is a way of escaping the : and / characters which might be imbedded into some the protocol arguments.
static String	TransportProtocol
static String	TransportStreamProtocol

Constructor Summary

Constructors

Constructor and Description
LocatorImpl(String locatorStr)

Method Summary

Methods

Modifier and Type	Method and Description
static Locator	createProgramEventLocator(String serviceName, String programName)
static boolean	equals(Locator locator1, Locator locator2) Compare two locators for equality.
boolean	equals(Object o) Compares this Locator with the specified object for equality.
static String	getBouquetName(Locator locator)
static InetAddress	getLocalAddress(Locator locator) Reports the local IP address assigned to the given service component.
static String	getMediaFile(Locator locator)
static String	getMediaFile(String locatorStr)
static String	getNetworkName(Locator locator)
static String	getProgramEventName(Locator locator)
static String	getServiceComponentName(Locator locator)
static String	getServiceName(Locator locator)
static String	getTransportStreamID(Locator locator)
int	hashCode() Generates a hash code value for this Locator.
boolean	hasMultipleTransformations() Indicates whether this Locator has a mapping to multiple networks.
static boolean	isAlternate(Locator locator)
static boolean	isBouquet(Locator locator)
static boolean	isNetwork(Locator locator)
static boolean	isProgramEvent(Locator locator)
static boolean	isProgramEventDescription(Locator locator)
static boolean	isSameProtocol(Locator locator1, Locator locator2)
static boolean	isSelectable(Locator locator)
static boolean	isService(Locator locator)
static boolean	isServiceComponent(Locator locator)
static boolean	isServiceDescription(Locator locator)
static boolean	isSIElement(Locator locator) Indicates whether an locator can possible point to an SI Element, but does not indicate whether the corresponding si element exists.
static boolean	isTDService(Locator locator)
static boolean	isTIService(Locator locator)
static boolean	isTransportStream(Locator locator)
static void	setMediaFile(String locatorStr, String urlStr)
static void	setTransforms(Locator alias, Vector list) Setup the locator transform tables for a locator.
String	toExternalForm() Creates a string-based representation of this Locator.
String	toString() Returns the string used to create this locator.
static Locator[]	transformLocator(Locator source) Perform a transform on this locator.
static Locator	transformToAlternate(Locator locator)
static Locator	transformToProgramEvent(Locator locator)
static Locator	transformToProgramEventDescription(Locator locator)
static Locator	transformToService(Locator locator)
static Locator	transformToServiceDescription(Locator locator)
static Locator	transformToTransportStream(Locator locator)
static boolean	validLocator(Locator locator) Check for validity of a locator.

Methods inherited from class java.lang.Object

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

Field Detail

ServiceProtocol

public static final String ServiceProtocol

The following are the forms of the various protocols, TBD yet to be implemented is a way of escaping the : and / characters which might be imbedded into some the protocol arguments. Protocol Format ======== ====== ServiceProtocol service:/ AlternateProtocol alternate:/ ServiceDescriptionProtocol description:/ ServiceComponentProtocol component:/service:/ ServiceComponentProtocol component:/service:/ ProgramEventProtocol event:/service:/ AlternateEventProtocol alternate:/service:/ ProgramEventDescriptionProtocol eventdescription:/ TransportStreamProtocol transport:/ NetworkProtocol network:/ BouquetProtocol bouquet:/ TransportStreamProtocol transport:/* // All transports NetworkProtocol network:/* // All networks BouquetProtocol bouquet:/* // All bouquets CarouselProtocol carousel:/* // All carousel

See Also:

Constant Field Values

ServiceComponentProtocol

public static final String ServiceComponentProtocol

See Also:

Constant Field Values

ServiceDescriptionProtocol

public static final String ServiceDescriptionProtocol

See Also:

Constant Field Values

ProgramEventProtocol

public static final String ProgramEventProtocol

See Also:

Constant Field Values

ProgramEventDescriptionProtocol

public static final String ProgramEventDescriptionProtocol

See Also:

Constant Field Values

TransportStreamProtocol

public static final String TransportStreamProtocol

See Also:

Constant Field Values

NetworkProtocol

public static final String NetworkProtocol

See Also:

Constant Field Values

BouquetProtocol

public static final String BouquetProtocol

See Also:

Constant Field Values

CarouselProtocol

public static final String CarouselProtocol

See Also:

Constant Field Values

AlternateProtocol

public static final String AlternateProtocol

See Also:

Constant Field Values

TransportProtocol

public static final String TransportProtocol

See Also:

Constant Field Values

Constructor Detail

LocatorImpl

public LocatorImpl(String locatorStr)

Method Detail

toExternalForm

public String toExternalForm()

Creates a string-based representation of this Locator.

The result of this method may be used as an input to the constructor for the JMF MediaLocator.

Specified by:

toExternalForm in interface Locator

Returns:

a string that can be used to construct other forms of locators, including URLs. If the locator has no external form, an empty string is returned.

See Also:

MediaLocator.MediaLocator(String)

toString

public String toString()

Description copied from interface: Locator

Returns the string used to create this locator.

Specified by:

toString in interface Locator

Overrides:

toString in class Object

Returns:

The string used to create this locator.

See Also:

LocatorFactory.createLocator(java.lang.String)

hasMultipleTransformations

public boolean hasMultipleTransformations()

Indicates whether this Locator has a mapping to multiple networks.

Specified by:

hasMultipleTransformations in interface Locator

Returns:

true if multiple transformations exist for this Locator, false otherwise.

equals

public boolean equals(Object o)

Compares this Locator with the specified object for equality. The result is true if and only if the specified object is also a Locator and has an external form equivalent to the external form of this Locator. Two external forms are equivalent (and thus refer to the same resource) if (a) they are identical, i.e. via string comparison, or (b) they both can be transformed to canonical forms that are identical. The nature of canonicalized external forms is entirely implementation dependent.

Specified by:

equals in interface Locator

Overrides:

equals in class Object

Parameters:

o - The object to compare this Locator against.

Returns:

true if the specified object is equal to this Locator.

See Also:

String.equals(Object)

hashCode

public int hashCode()

Generates a hash code value for this Locator. Two Locator instances for which Locator.equals() is true will have identical hash code values.

Specified by:

hashCode in interface Locator

Overrides:

hashCode in class Object

Returns:

The hash code value for this Locator.

See Also:

equals(Object)

transformLocator

public static Locator[] transformLocator(Locator source)

Perform a transform on this locator. This implementation does nothing but return the locator this instance in an array of size 1.

Returns:

a transformed array of locators.

setTransforms

public static void setTransforms(Locator alias,
                 Vector list)

Setup the locator transform tables for a locator.

equals

public static boolean equals(Locator locator1,
             Locator locator2)

Compare two locators for equality. Both locators must be valid locator objects and there external forms must equal.

Parameters:

locator1 - one of two locators to test for equality

locator2 - the other of two locators to test for equality

Returns:

a boolean result indicating the equality of the two sepcified locators.

validLocator

public static boolean validLocator(Locator locator)

Check for validity of a locator. In particular, tha locators external form must be non-null.

Parameters:

the - locator on which validity is to be checked.

Returns:

a boolean result indicating the validity of the locator.

isSameProtocol

public static boolean isSameProtocol(Locator locator1,
                     Locator locator2)

isService

public static boolean isService(Locator locator)

isTIService

public static boolean isTIService(Locator locator)

isTDService

public static boolean isTDService(Locator locator)

isServiceComponent

public static boolean isServiceComponent(Locator locator)

isServiceDescription

public static boolean isServiceDescription(Locator locator)

isProgramEvent

public static boolean isProgramEvent(Locator locator)

isProgramEventDescription

public static boolean isProgramEventDescription(Locator locator)

isTransportStream

public static boolean isTransportStream(Locator locator)

isNetwork

public static boolean isNetwork(Locator locator)

isBouquet

public static boolean isBouquet(Locator locator)

isAlternate

public static boolean isAlternate(Locator locator)

isSelectable

public static boolean isSelectable(Locator locator)

isSIElement

public static boolean isSIElement(Locator locator)

Indicates whether an locator can possible point to an SI Element, but does not indicate whether the corresponding si element exists. Note: Since service and service details, then a service locator can point to ServiceDetails, which is an SIElement.

getServiceName

public static String getServiceName(Locator locator)

getProgramEventName

public static String getProgramEventName(Locator locator)

getServiceComponentName

public static String getServiceComponentName(Locator locator)

getTransportStreamID

public static String getTransportStreamID(Locator locator)

getBouquetName

public static String getBouquetName(Locator locator)

getNetworkName

public static String getNetworkName(Locator locator)

transformToService

public static Locator transformToService(Locator locator)

transformToProgramEvent

public static Locator transformToProgramEvent(Locator locator)

transformToServiceDescription

public static Locator transformToServiceDescription(Locator locator)

transformToProgramEventDescription

public static Locator transformToProgramEventDescription(Locator locator)

transformToTransportStream

public static Locator transformToTransportStream(Locator locator)

transformToAlternate

public static Locator transformToAlternate(Locator locator)

createProgramEventLocator

public static Locator createProgramEventLocator(String serviceName,
                                String programName)

setMediaFile

public static void setMediaFile(String locatorStr,
                String urlStr)

getMediaFile

public static String getMediaFile(Locator locator)

getMediaFile

public static String getMediaFile(String locatorStr)

getLocalAddress

public static InetAddress getLocalAddress(Locator locator)

Reports the local IP address assigned to the given service component.

Parameters:

locator - The service component for which the local IP address mapping is required.

Returns:

The IP address assigned to this service component.

Throws:

InvalidLocatorException - If the given locator does not refer to a valid source of IP data, or refers to a source of IP data whose reception is not supported on this system.

IOException - If a local IP address is not available to be assigned to the source of IP data.