Use is subject to License Terms. Your use of this web site or any of its content or software indicates your agreement to be bound by these License Terms.

Copyright © 2006 Sun Microsystems, Inc. All rights reserved.

Package javax.tv.locator

Provides a means for referencing data and resources accessible via the Java TV APIs.

See:
Description

Interface Summary

Locator

The Locator interface provides an opaque reference to the location information of objects which are addressable within the Java TV API.

Class Summary

LocatorFactory

This class defines a factory for the creation of Locator objects.

Exception Summary

InvalidLocatorException	This exception is thrown when a Locator is not valid in a particular context.
MalformedLocatorException	This exception is thrown to indicate that a malformed locator string has been used.

Package javax.tv.locator Description

Provides a means for referencing data and resources accessible via the Java TV APIs. The Locator interface serves as an opaque reference to the location information of entities which are addressable within a television receiver. For example, locators can reference broadcast filesystems, portions of service information, sources of audio/video content, and interactive applications.

A given locator may represent transport-independent data and have multiple mappings to transport-dependent locators. Methods are provided for discovery of such circumstances and for transformation to transport-dependent locators.

An instance of Locator that references a Service or ServiceComponent can be converted to a javax.media.MediaLocator instance through use of the method Locator.toExternalForm().