javax.tv.locator
Class LocatorFactory
java.lang.Object
|
+--javax.tv.locator.LocatorFactory
- public abstract class LocatorFactory
- extends java.lang.Object
This class defines a factory for the creation of
Locator
objects.
- See Also:
Locator
Constructor Summary |
protected |
LocatorFactory()
Creates the LocatorFactory instance. |
Methods inherited from class java.lang.Object |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
LocatorFactory
protected LocatorFactory()
- Creates the
LocatorFactory
instance.
getInstance
public static LocatorFactory getInstance()
- Provides an instance of
LocatorFactory
.
- Returns:
- A
LocatorFactory
instance.
createLocator
public abstract Locator createLocator(java.lang.String locatorString)
throws MalformedLocatorException
- Creates a
Locator
object from the specified locator
string. The format of the locator string may be entirely
implementation-specific.
- Parameters:
locatorString
- The string form of the Locator
to be created.- Returns:
- A
Locator
object representing the resource
referenced by the given locator string. - Throws:
MalformedLocatorException
- If an incorrectly formatted
locator string is detected.- See Also:
Locator.toExternalForm()
transformLocator
public abstract Locator[] transformLocator(Locator source)
throws InvalidLocatorException
- Transforms a
Locator
into its respective collection
of transport dependent Locator
objects. A
transformation on a transport dependent Locator
results in an identity transformation, i.e. the same locator is
returned in a single-element array.
- Parameters:
source
- The Locator
to transform.- Returns:
- An array of transport dependent
Locator
objects for the given Locator
. - Throws:
InvalidLocatorException
- If source
is not a valid
Locator.
Copyright © 1998 - 2000 Sun Microsystems, Inc.