org.dvb.application.storage

Class StoredApplicationServiceFactory

java.lang.Object

org.dvb.application.storage.StoredApplicationServiceFactory

public abstract class StoredApplicationServiceFactory
extends Object

This factory creates new Service objects representing stand-alone stored application services. Services thus created shall appear in the list of services maintained by the SIManager until removed using StoredApplicationService.remove or some MHP terminal specific mechanism. i.e. they shall be returned by filterServices both when passed an instance of ServiceTypeFilter constructed with the type StoredApplicationServiceType.STORED_APPLICATION_SERVICE and when passed null to list all known services.

Since:

MHP1.1.2

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	StoredApplicationServiceFactory() This constructor is provided for the use of implementations and specifications which extend the present document.

Method Summary

Methods

Modifier and Type	Method and Description
abstract StoredApplicationService	createStoredApplicationService(int organisation_id, int service_id, String serviceName) Creates a new stored application service.
static StoredApplicationServiceFactory	getInstance() Get the singleton instance of this class, or null if and only if this MHP implementation does not support stand-alone stored applications.

Methods inherited from class java.lang.Object

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

Constructor Detail

StoredApplicationServiceFactory

protected StoredApplicationServiceFactory()

This constructor is provided for the use of implementations and specifications which extend the present document. Applications shall not define sub-classes of this class. Implementations are not required to behave correctly if any such application defined sub-classes are used.

Method Detail

getInstance

public static StoredApplicationServiceFactory getInstance()

Get the singleton instance of this class, or null if and only if this MHP implementation does not support stand-alone stored applications.

createStoredApplicationService

public abstract StoredApplicationService createStoredApplicationService(int organisation_id,
                                                      int service_id,
                                                      String serviceName)
                                                                 throws ServiceAlreadyExistsException

Creates a new stored application service.

Parameters:

organisation_id - the organisation_id of the organisation to whom this service belongs to

service_id - unique identifier for this service within the organisation

serviceName - a name for the service that can be displayed to the end user to identify this service

Returns:

the stored application service created

Throws:

ServiceAlreadyExistsException - thrown if a stored application service with the same organisation_id and service_id already exists in the terminal

SecurityException - thrown if the application calling this method does not have an ApplicationStoragePermission with action "createService" for the organisation_id passed in as the parameter.