OSID - osid.filing.allocation.FilingAllocationProxyManager Service Interface Definition

Interface	osid.filing.allocation.FilingAllocationProxyManager
Implements	`osid.OsidProxyManager`
Implements	`osid.filing.allocation.FilingAllocationProfile`
Description	The filing allocation manager provides access sessions to allocations. Methods in this manager support the passing of a `Proxy` to pass information from server environments. The sessions included in this manager are: `AllocationSession:` a session for accessing usage information and quotas for the current user `AllocationLookupSession:` a session for accessing usage information and quotas `AllocationAdminSession` a session for assigning quotas `AllocationNotificationSession:` a session for subscribing to usage warnings and quota changes
Method	getAllocationSession
Description	Gets the session for accessing usage and quotas.
Parameters	`osid.proxy.Proxy`	`proxy`	a proxy
Return	`osid.filing.allocation.AllocationSession`		an `AllocationSession`
Errors	NULL_ARGUMENT		`proxy` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsAllocation()` is `false`
Compliance	`optional`		This method must be implemented if `supportsAllocation()` is `true.`
Method	getAllocationSessionForDirectory
Description	Gets the session for accessing usage and quotas for a given directory. If the path is an alias, the target directory is used. The path indicates the file alias and the real path indicates the target directory.
Parameters	`string`	`directoryPath`	the pathname to the directory
Parameters	`osid.proxy.Proxy`	`proxy`	a proxy
Return	`osid.filing.allocation.AllocationSession`		an `AllocationSession`
Errors	INVALID_ARGUMENT		`directoryPath` is not a directory or an alias to a directory
	NOT_FOUND		`directoryPath` is not found
	NULL_ARGUMENT		`directoryPath` or `proxy` is null
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsAllocation()` is `false`
Compliance	`optional`		This method must be implemented if `supportsAllocation()` and `supportsVisibleFederation()` are `true.`
Method	getAllocationLookupSession
Description	Gets the session for accessing usage and quotas.
Parameters	`osid.proxy.Proxy`	`proxy`	a proxy
Return	`osid.filing.allocation.AllocationLookupSession`		an `AllocationLookupSession`
Errors	NULL_ARGUMENT		`proxy` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsAllocationLookup()` is `false`
Compliance	`optional`		This method must be implemented if `supportsAllocationLookup()` is `true.`
Method	getAllocationLookupSessionForDirectory
Description	Gets the session for accessing usage and quotas for a given directory. If the path is an alias, the target directory is used. The path indicates the file alias and the real path indicates the target directory.
Parameters	`string`	`directoryPath`	the pathname to the directory
Parameters	`osid.proxy.Proxy`	`proxy`	a proxy
Return	`osid.filing.allocation.AllocationLookupSession`		an `AllocationLookupSession`
Errors	INVALID_ARGUMENT		`directoryPath` is not a directory or an alias to a directory
	NOT_FOUND		`directoryPath` is not found
	NULL_ARGUMENT		`directoryPath` or `proxy` is null
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsAllocationLookup()` is `false`
Compliance	`optional`		This method must be implemented if `supportsAllocationLookup()` and `supportsVisibleFederation()` are `true.`
Method	getAllocationAdminSession
Description	Gets the session for assigning quotas.
Parameters	`osid.proxy.Proxy`	`proxy`	a proxy
Return	`osid.filing.allocation.AllocationAdminSession`		an `AllocationAdminSession`
Errors	NULL_ARGUMENT		`proxy` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsAllocationAdmin()` is `false`
Compliance	`optional`		This method must be implemented if `supportsAllocationAdmin()` is `true.`
Method	getAllocationAdminSessionForDirectory
Description	Gets the session for assigning quotas for the given directory. If the path is an alias, the target directory is used. The path indicates the file alias and the real path indicates the target directory.
Parameters	`string`	`directoryPath`	the pathname to the directory
Parameters	`osid.proxy.Proxy`	`proxy`	a proxy
Return	`osid.filing.allocation.AllocationAdminSession`		an `AllocationAdminSession`
Errors	INVALID_ARGUMENT		`directoryPath` is not a directory or an alias to a directory
	NOT_FOUND		`directoryPath` is not found
	NULL_ARGUMENT		`directoryPath` or `proxy` is null
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsAllocationAdmin()` is `false`
Compliance	`optional`		This method must be implemented if `supportsAllocationAdmin()` and `supportsVisibleFederation()` are `true.`
Method	getAllocationNotificationSession
Description	Gets the session for receiving messages about changes to directories.
Parameters	`osid.filing.allocation.AllocationReceiver`	`allocationReceiver`	the notification callback
Parameters	`osid.proxy.Proxy`	`proxy`	a proxy
Return	`osid.filing.allocation.AllocationNotificationSession`		an `AllocationNotificationSession`
Errors	NULL_ARGUMENT		`allocationReceiver` or `proxy` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsAllocationNotification()` is `false`
Compliance	`optional`		This method must be implemented if `supportsDirectoryNotification()` is `true.`
Method	getAllocationNotificationSessionForDirectory
Description	Gets the session for receiving messages about usage warnings and quota changes for the given directory. If the path is an alias, the target directory is used. The path indicates the file alias and the real path indicates the target directory.
Parameters	`osid.filing.allocation.AllocationReceiver`	`allocationReceiver`	the notification callback
	`string`	`directoryPath`	the pathname to the directory
	`osid.proxy.Proxy`	`proxy`	a proxy
Return	`osid.filing.allocation.AllocationNotificationSession`		an `AllocationNotificationSession`
Errors	INVALID_ARGUMENT		`directoryPath` is not a directory or an alias to a directory
	NOT_FOUND		`directoryPath` is not found
	NULL_ARGUMENT		`allocationReceiver, directoryPath` or `proxy` is null
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsAllocationNotification()` is `false`
Compliance	`optional`		This method must be implemented if `supportsAllocationNotification()` and `supportsVisibleFederation()` are `true.`