com.sun.identity.sm
Class ServiceManager

java.lang.Object
  |
  +--com.sun.identity.sm.ServiceManager

public class ServiceManager

extends java.lang.Object

The ServiceManager class provides methods to register/remove services and to list currently registered services. It also provides methods to obtain an instance of ServiceSchemaManager and an instance of ServiceConfigManager.

Constructor Summary

ServiceManager(SSOToken token)
Creates an instance of ServiceManager.

Method Summary

void	clearCache() Removes all the SMS cached entries.
ServiceConfigManager	getConfigManager(java.lang.String serviceName, java.lang.String version) Returns the ServiceConfigManager for the given service name and version.
ServiceSchemaManager	getSchemaManager(java.lang.String serviceName, java.lang.String version) Returns the ServiceSchemaManager for the given service name and version.
java.util.Set	getServiceNames() Returns all the service names that have been registered.
java.util.Set	getServiceVersions(java.lang.String serviceName) Returns all versions supported by the service.
void	registerServices(java.io.InputStream xmlServiceSchema) Registers one or more services, defined by the XML inputstream that follows the SMS DTD.
void	removeService(java.lang.String serviceName, java.lang.String version) Removes the service schema and configuration for the given service name.

Methods inherited from class java.lang.Object

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

Constructor Detail

ServiceManager

public ServiceManager(SSOToken token)
               throws SSOException,
                      SMSException

Creates an instance of ServiceManager. The SSOToken is used to identify the user performing service operations.

Parameters:

token - the authenticated SSOToken

Throws:

SSOException -

SMSException -

Method Detail

getSchemaManager

public ServiceSchemaManager getSchemaManager(java.lang.String serviceName,
                                             java.lang.String version)
                                      throws SMSException,
                                             SSOException

Returns the ServiceSchemaManager for the given service name and version.

Parameters:

serviceName - the name of the service

version - the version of the service

Returns:

the ServiceSchemaManager for the given service name and version

Throws:

SMSException -

getConfigManager

public ServiceConfigManager getConfigManager(java.lang.String serviceName,
                                             java.lang.String version)
                                      throws SMSException,
                                             SSOException

Returns the ServiceConfigManager for the given service name and version.

Parameters:

serviceName - the name of the service

version - the version of the service

Returns:

the ServiceConfigManager for the given service name and version

Throws:

SMSException -

getServiceNames

public java.util.Set getServiceNames()
                              throws SMSException

Returns all the service names that have been registered.

Returns:

the set of names of services that have been registered

Throws:

SMSException -

getServiceVersions

public java.util.Set getServiceVersions(java.lang.String serviceName)
                                 throws SMSException

Returns all versions supported by the service.

Returns:

the set of versions supported by the service

Throws:

SMSException -

registerServices

public void registerServices(java.io.InputStream xmlServiceSchema)
                      throws SMSException,
                             SSOException

Registers one or more services, defined by the XML inputstream that follows the SMS DTD.

Parameters:

xmlServicesSchema - the inputStream of service metadata in xml conforming to SMS DTD

Throws:

SMSException -

removeService

public void removeService(java.lang.String serviceName,
                          java.lang.String version)
                   throws SMSException,
                          SSOException

Removes the service schema and configuration for the given service name.

Parameters:

serviceName - the name of the service

version - the version of the service

Throws:

SMSException -

clearCache

public void clearCache()

Removes all the SMS cached entries. This method should be called to clear the cache for example, if ACIs for the SMS entries are changed in the directory. Also, this clears the SMS entries only in this JVM instance. If multiple instances (of JVM) are running this method must be called within each instance.