OSID - osid.contact.Contact Service Interface Definition

Interface	osid.contact.Contact
Implements	`osid.OsidRelationship`
Description	A `Contact` relates a reference `Id` to an address and addresse. The contact addressee is expressed as a `Resource.` For example, a contact for a `Repository` would have the repository `Id` as the reference, and the person to contact as the addressee. When specifying `Contacts` for external `Resources,` the reference `Id` and the addressee may be the same. Multiple contacts may be related to an `Id` sorted by priority. A `Contact` is available for use on the specified weekdays and within a time of day. The genus `Type` of the `Contact` may be used to provide further detail on how the context or usage of this `Contact.`
Method	getReferenceId
Description	Gets the `Id` of the reference.
Return	`osid.id.Id`		the reference `Id`
Compliance	`mandatory`		This method must be implemented.
Method	getAddresseeId
Description	Gets the `Id` of the addressee.
Return	`osid.id.Id`		the resource `Id`
Compliance	`mandatory`		This method must be implemented.
Method	getAddressee
Description	Gets the addressee.
Return	`osid.resource.Resource`		the resource
Errors	OPERATION_FAILED		unable to complete request
Compliance	`mandatory`		This method must be implemented.
Method	getAddressId
Description	Gets the `Id` of the subscriber's address.
Return	`osid.id.Id`		the subscriber `Id`
Compliance	`mandatory`		This method must be implemented.
Method	getAddress
Description	Gets the subscriber's address.
Return	`osid.contact.Address`		the subscriber's address.
Errors	OPERATION_FAILED		unable to complete request
Compliance	`mandatory`		This method must be implemented.
Method	getContactRecord
Description	Gets the contact record corresponding to the given `Contact` record `Type.` This method is used to retrieve an object implementing the requested record. The `contactRecordType` may be the `Type` returned in `getRecordTypes()` or any of its parents in a `Type` hierarchy where `hasRecordType(contactRecordType)` is `true` .
Parameters	`osid.type.Type`	`contactRecordType`	the type of contact record to retrieve
Return	`osid.contact.records.ContactRecord`		the contact record
Errors	NULL_ARGUMENT		`contactRecordType` is `null`
	OPERATION_FAILED		unable to complete request
	UNSUPPORTED		`hasRecordType(contactRecordType)` is `false`
Compliance	`mandatory`		This method must be implemented.