org.dvb.application.storage
Class StoredApplicationServiceFactory

java.lang.Object
  extended by org.dvb.application.storage.StoredApplicationServiceFactory

public abstract class StoredApplicationServiceFactory
extends java.lang.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 GEM 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

Method Summary
abstract  StoredApplicationService createStoredApplicationService(int organisation_id, int service_id, java.lang.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 GEM implementation does not support stand-alone stored applications.
 
Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Method Detail

getInstance

public static StoredApplicationServiceFactory getInstance()
Get the singleton instance of this class, or null if and only if this GEM implementation does not support stand-alone stored applications.

Returns:
a factory

createStoredApplicationService

public abstract StoredApplicationService createStoredApplicationService(int organisation_id,
                                                                        int service_id,
                                                                        java.lang.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
java.lang.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.