OSID - osid.provisioning.rules.PoolProcessor Service Interface Definition

Interface	osid.provisioning.rules.PoolProcessor
Implements	`osid.OsidProcessor`
Description	A `PoolProcessor` describes the rules for managing resource allocations out of a pool.
Method	allocatesByLeastUse
Description	Tests if allocations balance the usage by preferring the least used provisionables in the pool.
Return	`boolean`		`true` if the least used provisionables are preferred, `false` otherwise
Compliance	`mandatory`		This method must be implemented.
Method	allocatesByMostUse
Description	Tests if allocations prefer the most used provisionables in the pool.
Return	`boolean`		`true` if the most used provisionables are preferred, `false` otherwise
Compliance	`mandatory`		This method must be implemented.
Method	allocatesByLeastCost
Description	Tests if allocations prefer the cheapest provisionables.
Return	`boolean`		`true` if the cheapest provisionables are preferred, `false` otherwise
Compliance	`mandatory`		This method must be implemented.
Method	allocatesByMostCost
Description	Tests if allocations prefer the most expensive provisionables.
Return	`boolean`		`true` if the most expensive provisionables are prefsrred, `false` otherwise
Compliance	`mandatory`		This method must be implemented.
Method	getPoolProcessorRecord
Description	Gets the pool processor record corresponding to the given `PoolProcessor` record `Type.` This method is used to retrieve an object implementing the requested record. The `poolProcessorRecordType` may be the `Type` returned in `getRecordTypes()` or any of its parents in a `Type` hierarchy where `hasRecordType(poolProcessorRecordType)` is `true` .
Parameters	`osid.type.Type`	`poolProcessorRecordType`	the type of pool processor record to retrieve
Return	`osid.provisioning.rules.records.PoolProcessorRecord`		the pool processor record
Errors	NULL_ARGUMENT		`poolProcessorRecordType` is `null`
	OPERATION_FAILED		unable to complete request
	UNSUPPORTED		`hasRecordType(poolProcessorRecordType)` is `false`
Compliance	`mandatory`		This method must be implemented.