OSID - osid.OsidRuntimeManager Service Interface Definition

Interface	osid.OsidRuntimeManager
Implements	`osid.OsidManager`
Implements	`osid.OsidRuntimeProfile`
Description	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.
Method	getManager
Description	Finds, loads and instantiates providers of OSID managers. Providers must conform to an 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.
Parameters	`osid.OSID`	`osid`	represents the OSID
	`string`	`implClassName`	the name of the implementation
	`osid.installation.Version`	`version`	the minimum required OSID specification version
Return	`osid.OsidManager`		the manager of the service
Errors	CONFIGURATION_ERROR		an error in configuring the implementation
	NOT_FOUND		the implementation class was not found
	NULL_ARGUMENT		`implClassName` or `version` is `null`
	OPERATION_FAILED		unable to complete request
	UNSUPPORTED		`implClassName` does not support the requested OSID
Compliance	`mandatory`		This method must be implemented.
Provider Notes	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.
Method	getProxyManager
Description	Finds, loads and instantiates providers of OSID managers. Providers must conform to an `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.
Parameters	`osid.OSID`	`osid`	represents the OSID
	`string`	`implementation`	the name of the implementation
	`osid.installation.Version`	`version`	the minimum required OSID specification version
Return	`osid.OsidProxyManager`		the manager of the service
Errors	CONFIGURATION_ERROR		an error in configuring the implementation
	NOT_FOUND		the implementation class was not found
	NULL_ARGUMENT		`implementation` or `version` is `null`
	OPERATION_FAILED		unable to complete request
	UNSUPPORTED		`implementation` does not support the requested OSID
Compliance	`mandatory`		This method must be implemented.
Provider Notes	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.
Method	getConfiguration
Description	Gets the current configuration in the runtime environment.
Return	`osid.configuration.ValueLookupSession`		a configuration
Errors	OPERATION_FAILED		unable to complete request
	PERMISSION_DENIED		an authorization failure occured
	UNIMPLEMENTED		a configuration service is not supported
Compliance	`optional`		This method must be implemented if `supportsConfiguration()` is `true.`