javax.tv.service.selection
Class ServiceContextFactory
java.lang.Object
|
+--javax.tv.service.selection.ServiceContextFactory
- public abstract class ServiceContextFactory
- extends java.lang.Object
This class serves as a factory for the creation of
ServiceContext
objects.
Methods inherited from class java.lang.Object |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
ServiceContextFactory
protected ServiceContextFactory()
- Creates a
ServiceContextFactory
.
getInstance
public static ServiceContextFactory getInstance()
- Provides an instance of
ServiceContextFactory
.
- Returns:
- An instance of
ServiceContextFactory
.
createServiceContext
public abstract ServiceContext createServiceContext()
throws InsufficientResourcesException,
java.lang.SecurityException
- Creates a
ServiceContext
object. The new
ServiceContext
is created in the not
presenting state.
Due to resource restrictions,
implementations may limit the total number of simultaneous
ServiceContext
objects. In such a case,
InsufficientResourcesException
is thrown.
- Returns:
- A new
ServiceContext
object. - Throws:
InsufficientResourcesException
- If the receiver lacks
the resources to create this ServiceContext
.java.lang.SecurityException
- if the caller doesn't have
ServiceContextPermission("create", "own")
.
getServiceContexts
public abstract ServiceContext[] getServiceContexts()
- Provides the
ServiceContext
instances to which the
caller of the method is permitted access. If the caller has
ServiceContextPermission("access","*")
, then all
current (i.e., undestroyed) ServiceContext
instances
are returned. If the application making this call is running in
a ServiceContext
and has
ServiceContextPermission("access","own")
, its own
ServiceContext
will be included in the returned
array. If no ServiceContext
instances are
accessible to the caller, a zero-length array is returned. No
ServiceContext
instances in the destroyed
state are returned by this method.
- Returns:
- An array of accessible
ServiceContext
objects. - See Also:
ServiceContextPermission
getServiceContext
public abstract ServiceContext getServiceContext(XletContext ctx)
throws java.lang.SecurityException,
ServiceContextException
- Reports the
ServiceContext
in which the
Xlet
corresponding to the specified
XletContext
is running. The returned
ServiceContext
is the one from which the
Service
carrying the Xlet
was selected.
- Parameters:
ctx
- The XletContext
of the Xlet
of interest.- Returns:
- The
ServiceContext
in which the Xlet
corresponding to ctx
is running. - Throws:
java.lang.SecurityException
- If the
Xlet
corresponding to ctx
does not have
ServiceContextPermission("access", "own")
.ServiceContextException
- If the
Xlet
corresponding to ctx
is not running
within a ServiceContext
.
Copyright © 1998 - 2000 Sun Microsystems, Inc.