com.sun.tv

Class ServiceContextFactoryImpl

java.lang.Object

javax.tv.service.selection.ServiceContextFactory

com.sun.tv.ServiceContextFactoryImpl

All Implemented Interfaces:

EventListener, ServiceContextListener

public class ServiceContextFactoryImpl
extends ServiceContextFactory
implements ServiceContextListener

This class serves as a factory for the creation of ServiceContext objects.

Constructor Summary

Constructors

Constructor and Description
ServiceContextFactoryImpl()

Method Summary

Methods

Modifier and Type	Method and Description
ServiceContext	createServiceContext() Creates a ServiceContext object.
ServiceContext	getServiceContext(XletContext ctx) Reports the ServiceContext in which the Xlet corresponding to the specified XletContext is running.
ServiceContext[]	getServiceContexts() Provides the ServiceContext instances to which the caller of the method is permitted access.
void	receiveServiceContextEvent(ServiceContextEvent sce) Removes a ServiceContext object.

Methods inherited from class javax.tv.service.selection.ServiceContextFactory

getInstance

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

ServiceContextFactoryImpl

public ServiceContextFactoryImpl()

Method Detail

createServiceContext

public ServiceContext createServiceContext()
                                    throws InsufficientResourcesException,
                                           SecurityException

Creates a ServiceContext object. The new ServiceContext is created in the not presenting state. Note that implementations may limit the number of ServiceContext objects to a very small number, perhaps even one.

Specified by:

createServiceContext in class ServiceContextFactory

Returns:

A new ServiceContext object.

Throws:

InsufficientResourcesException - If the receiver lacks the resources to create this ServiceContext.

SecurityException - if the caller doesn't have ServiceContextPermission("create")

getServiceContexts

public 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.

Specified by:

getServiceContexts in class ServiceContextFactory

Returns:

An array of accessible ServiceContext objects.

See Also:

ServiceContextPermission

getServiceContext

public ServiceContext getServiceContext(XletContext ctx)
                                 throws 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.

Specified by:

getServiceContext in class ServiceContextFactory

Parameters:

ctx - The XletContext of the Xlet of interest.

Returns:

The ServiceContext in which the Xlet corresponding to ctx is running.

Throws:

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.

receiveServiceContextEvent

public void receiveServiceContextEvent(ServiceContextEvent sce)

Removes a ServiceContext object. The old ServiceContext is removed from the factories list of services contexts. Removed service contexts are generally those which have been destroyed.

Specified by:

receiveServiceContextEvent in interface ServiceContextListener

Parameters:

sce - The generated event.