OSID - osid.OsidManager Service Interface Definition

Interface	osid.OsidManager
Implements	`osid.OsidProfile`
Description	The `OsidManager` is the top level interface for all OSID managers. An OSID manager is instantiated through the `OsidRuntimeManager` and represents an instance of a service. An OSID manager is responsible for implementing a profile for a service and creating sessions that, in general, correspond to the profile. An application need only create a single `OsidManager` per service and implementors must ensure the `OsidManager` is thread-safe `.` The `OsidSessions` spawned from an OSID manager are dedicated to single processing threads. The `OsidManager` defines methods in common throughout all OSID managers which implement this interface.
Method	initialize
Description	Initializes this manager. A manager is initialized once at the time of creation.
Parameters	`osid.OsidRuntimeManager`	`runtime`	the runtime environment
Errors	CONFIGURATION_ERROR		an error with implementation configuration
	ILLEGAL_STATE		this manager has already been initialized by the `OsidRuntime`
	NULL_ARGUMENT		`runtime` is `null`
	OPERATION_FAILED		unable to complete request
Compliance	`mandatory`		This method must be implemented.
Provider Notes	In addition to loading its runtime configuration an implementation may create shared resources such as connection pools to be shared among all sessions of this service and released when this manager is closed. Providers must thread-protect any data stored in the manager. To maximize interoperability, providers should not honor a second call to `initialize()` and must set an `ILLEGAL_STATE` error.
Method	rollbackService
Description	Rolls back this service to a point in time.
Parameters	`timestamp`	`rollbackTime`	the requested time
Return	`osid.journaling.JournalEntry`		the journal entry corresponding to the actual state of this service
Errors	OPERATION_FAILED		unable to complete request
	PERMISSION_DENIED		authorization failure occurred
	UNIMPLEMENTED		`supportsJournalRollback()` is `false`
Compliance	`mandatory`		This method must be implemented.
Method	changeBranch
Description	Changes the service branch.
Parameters	`osid.id.Id`	`branchId`	the new service branch
Errors	NOT_FOUND		`branchId` not found
	NULL_ARGUMENT		`branchId` is `null`
	OPERATION_FAILED		unable to complete request
	PERMISSION_DENIED		authorization failure occurred
	UNIMPLEMENTED		`supportsJournalBranching()` is `false`
Compliance	`mandatory`		This method must be implemented.