OSID - osid.voting.Race Service Interface Definition

Interface	osid.voting.Race
Implements	`osid.OsidGovernator`
Implements	`osid.Subjugateable`
Used By	`osid.voting.Candidate`
	`osid.voting.RaceAdminSession`
	`osid.voting.RaceList`
	`osid.voting.RaceLookupSession`
	`osid.voting.RaceResult`
	`osid.voting.VoterAllocation`
	`osid.voting.VotingSession`
Description	An `Race` defines a competition among `Candidates`.
Method	getBallotId
Description	Gets the ballot `Id`.
Return	`osid.id.Id`		the ballot `Id`
Compliance	`mandatory`		This method must be implemented.
Method	getBallot
Description	Gets the ballot.
Return	`osid.voting.Ballot`		the ballot
Errors	OPERATION_FAILED		unable to complete request
Compliance	`mandatory`		This method must be implemented.
Method	getRaceRecord
Description	Gets the race record corresponding to the given `Pollstem` record `Type`.This method is used to retrieve an object implementing the requested record. The `raceRecordType` may be the `Type` returned in `getRecordTypes()` or any of its parents in a `Type` hierarchy where `hasRecordType(raceRecordType)` is `true`.
Parameters	`osid.type.Type`	`raceRecordType`	the race record type
Return	`osid.voting.records.RaceRecord`		the race record
Errors	NULL_ARGUMENT		`raceRecordType` is `null`
	OPERATION_FAILED		unable to complete request
	UNSUPPORTED		`hasRecordType(raceRecordType)` is `false`
Compliance	`mandatory`		This method must be implemented.