OSID - osid.voting.Candidate Service Interface Definition

Interface	osid.voting.Candidate
Implements	`osid.OsidRelationship`
Used By	`osid.voting.CandidateAdminSession`
	`osid.voting.CandidateList`
	`osid.voting.CandidateLookupSession`
	`osid.voting.RaceResult`
	`osid.voting.Vote`
Description	A `Candidate` represents a voting option in a race. A `Candidate` is a relationship between a `Resource` and a `Race`.
Method	getRaceId
Description	Gets the race `Id` of the candidate.
Return	`osid.id.Id`		the candidate `Id`
Compliance	`mandatory`		This method must be implemented.
Method	getRace
Description	Gets the race of the candidate.
Return	`osid.voting.Race`		the race
Errors	OPERATION_FAILED		unable to complete request
Compliance	`mandatory`		This method must be implemented.
Method	getResourceId
Description	Gets the resource `Id` related to the candidate.
Return	`osid.id.Id`		the resource `Id`
Compliance	`mandatory`		This method must be implemented.
Method	getResource
Description	Gets the resource related to the candidate.
Return	`osid.resource.Resource`		the resource
Errors	OPERATION_FAILED		unable to complete request
Compliance	`mandatory`		This method must be implemented.
Method	getCandidateRecord
Description	Gets the candidate record corresponding to the given `Candidate` record `Type`. This method is used to retrieve an object implementing the requested record. The `candidateRecordType` may be the `Type` returned in `getRecordTypes()` or any of its parents in a `Type` hierarchy where `hasRecordType(candidateRecordType)` is `true`.
Parameters	`osid.type.Type`	`candidateRecordType`	the candidate record type
Return	`osid.voting.records.CandidateRecord`		the candidate record
Errors	NULL_ARGUMENT		`candidateRecordType` is `null`
	OPERATION_FAILED		unable to complete request
	UNSUPPORTED		`hasRecordType(candidateRecordType)` is `false`
Compliance	`mandatory`		This method must be implemented.