OSID - osid.voting.rules.RaceProcessor Service Interface Definition

Interface	osid.voting.rules.RaceProcessor
Implements	`osid.OsidProcessor`
Description	A `RaceProcessor` describes the rules for managing the behavior of a race.
Method	hasMaximumWinners
Description	Tests if there is a limit on the number of winners in a race.
Return	`boolean`		`true` if a limit on the number of winners, `false` if no limit exists
Compliance	`mandatory`		This method must be implemented.
Method	getMaximumWinners
Description	Gets the number of maximum winners in a race.
Return	`cardinal`		the maximum number of winners permitted
Errors	ILLEGAL_STATE		`hasMaximumWinners()` is `false`
Compliance	`mandatory`		This method must be implemented.
Method	getMinimumPercentageToWin
Description	Gets the minimum percentage (0-100) of total votes to be declared a winner in a race.
Return	`cardinal`		the minimum percentage
Compliance	`mandatory`		This method must be implemented.
Method	getMinimumVotesToWin
Description	Gets the minimum votesl votes to be declared a winner in a race.
Return	`cardinal`		the minimum votes
Compliance	`mandatory`		This method must be implemented.
Method	getRaceProcessorRecord
Description	Gets the race processor record corresponding to the given `RaceProcessor` record `Type.` This method is used to retrieve an object implementing the requested record. The `raceProcessorRecordType` may be the `Type` returned in `getRecordTypes()` or any of its parents in a `Type` hierarchy where `hasRecordType(raceProcessorRecordType)` is `true` .
Parameters	`osid.type.Type`	`raceProcessorRecordType`	the type of race processor record to retrieve
Return	`osid.voting.rules.records.RaceProcessorRecord`		the race processor record
Errors	NULL_ARGUMENT		`raceProcessorRecordType` is `null`
	OPERATION_FAILED		unable to complete request
	UNSUPPORTED		`hasRecordType(raceProcessorRecordType)` is `false`
Compliance	`mandatory`		This method must be implemented.