|
JSR-927 (Maintenance Release) | ||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object javax.tv.service.selection.ServiceContextFactory
This class serves as a factory for the creation of
ServiceContext
objects.
Constructor Summary | |
protected |
ServiceContextFactory()
Creates a ServiceContextFactory . |
Method Summary | |
abstract ServiceContext |
createServiceContext()
Creates a ServiceContext object. |
static ServiceContextFactory |
getInstance()
Provides an instance of ServiceContextFactory . |
abstract ServiceContext |
getServiceContext(XletContext ctx)
Reports the ServiceContext in which the
Xlet corresponding to the specified
XletContext is running. |
abstract ServiceContext[] |
getServiceContexts()
Provides the ServiceContext instances to which the
caller of the method is permitted access. |
Methods inherited from class java.lang.Object |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Constructor Detail |
protected ServiceContextFactory()
ServiceContextFactory
.
Method Detail |
public static ServiceContextFactory getInstance()
ServiceContextFactory
.
ServiceContextFactory
.public abstract ServiceContext createServiceContext() throws InsufficientResourcesException, java.lang.SecurityException
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.
ServiceContext
object.
InsufficientResourcesException
- If the receiver lacks
the resources to create this ServiceContext
.
java.lang.SecurityException
- if the caller doesn't have
ServiceContextPermission("create", "own")
.ServiceContextPermission
public abstract ServiceContext[] getServiceContexts()
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.
ServiceContext
objects.ServiceContextPermission
public abstract ServiceContext getServiceContext(XletContext ctx) throws java.lang.SecurityException, ServiceContextException
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.
ctx
- The XletContext
of the Xlet
of interest.
ServiceContext
in which the Xlet
corresponding to ctx
is running.
java.lang.SecurityException
- If the caller does not have
ServiceContextPermission("access", "own")
.
ServiceContextException
- If the
Xlet
corresponding to ctx
is not running
within a ServiceContext
.ServiceContextPermission
|
JSR-927 (Maintenance Release) | ||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |