public interface OsidRuntimeManager extends OsidManager, OsidRuntimeProfile
The OsidRuntimeManager
represents and OSID platform and
contains the information required for running OSID implementations such as
search paths and configurations.
The OsidRuntimeManager
is defined as an interface to
provide flexibility for managing an OSID environment. The instantiation of
a OsidRuntimeManager
implementation is defined by the OSID
platform.
The OsidRuntimeManager
should be instantiated with a
string that identifies the application or environment current at the time
of instantiation. This key is used soley for the purpose of seeding the
configuration service as a means to enable lower level OSIDs to tune their
configuration in response to this key, or, it can be used by the
application to retrieve configuration data for itself.
Modifier and Type | Method and Description |
---|---|
ValueLookupSession |
getConfiguration()
Gets the current configuration in the runtime environment.
|
OsidManager |
getManager(OSID osid,
java.lang.String implClassName,
Version version)
Finds, loads and instantiates providers of OSID managers.
|
OsidProxyManager |
getProxyManager(OSID osid,
java.lang.String implementation,
Version version)
Finds, loads and instantiates providers of OSID managers.
|
changeBranch, initialize, rollbackService
close
supportsConfiguration
getBranch, getBranchId, getDescription, getDisplayName, getId, getLocales, getProxyRecordTypes, getReleaseDate, getVersion, supportsJournalBranching, supportsJournalRollback, supportsOSIDVersion, supportsProxyRecordType
getBranding, getBrandingIds, getLicense, getProvider, getProviderId
OsidManager getManager(OSID osid, java.lang.String implClassName, Version version) throws ConfigurationErrorException, NotFoundException, OperationFailedException
OsidManager
that implements the OsidManager
interface is returned. In bindings where permitted, this can be safely
cast into the requested manager.osid
- represents the OSIDimplClassName
- the name of the implementationversion
- the minimum required OSID specification versionConfigurationErrorException
- an error in configuring
the implementationNotFoundException
- the implementation class was not
foundNullArgumentException
- implClassName
or
version
is null
OperationFailedException
- unable to complete requestUnsupportedException
- implClassName
does not support the requested OSIDmandatory
- This method must be implemented. After
- finding and instantiating the requested
OsidManager,
providers must invoke
OsidManager.initialize(OsidRuntimeManager)
where the
environment is an instance of the current environment that
includes the configuration for the service being initialized.
The OsidRuntimeManager
passed may include
information useful for the configuration such as the identity
of the service being instantiated. OsidProxyManager getProxyManager(OSID osid, java.lang.String implementation, Version version) throws ConfigurationErrorException, NotFoundException, OperationFailedException
OsidManager
interface. The
interfaces are defined in the OSID enumeration. For all OSID requests,
an instance of OsidManager
that implements the
OsidManager
interface is returned. In bindings where
permitted, this can be safely cast into the requested manager.osid
- represents the OSIDimplementation
- the name of the implementationversion
- the minimum required OSID specification versionConfigurationErrorException
- an error in configuring
the implementationNotFoundException
- the implementation class was not
foundNullArgumentException
- implementation
or version
is null
OperationFailedException
- unable to complete requestUnsupportedException
- implementation
does not support the requested OSIDmandatory
- This method must be implemented. After
- finding and instantiating the requested
OsidManager,
providers must invoke
OsidManager.initialize(OsidRuntimeManager)
where the
environment is an instance of the current environment that
includes the configuration for the service being initialized.
The OsidRuntimeManager
passed may include
information useful for the configuration such as the identity
of the service being instantiated. ValueLookupSession getConfiguration() throws OperationFailedException, PermissionDeniedException
OperationFailedException
- unable to complete requestPermissionDeniedException
- an authorization failure
occuredUnimplementedException
- a configuration service is not
supportedoptional
- This method must be implemented if
supportsConfiguration()
is true.