OSID - osid.contact.Address Service Interface Definition

Interface	osid.contact.Address
Implements	`osid.OsidObject`
Description	An `Address` for a `Resource.` The detailed components of the `Address` are maintained in the `AddressRecord` while `getAddressText()` supplies a usable form of the address. The genus `Type` of the `Address` indicates the kind of address such as email or phone number.
Method	getResourceId
Description	Gets the resource `Id` to which this address belongs. All addresses belong to one resource but may be used for contacts among multiple other resources.
Return	`osid.id.Id`		a resource `Id`
Compliance	`mandatory`		This method must be implemented.
Method	getResource
Description	Gets the resource to which this address belongs. All addresses belong to one resource but may be used for contacts among multiple other resources.
Return	`osid.resource.Resource`		a resource
Errors	OPERATION_FAILED		unable to complete request
Compliance	`mandatory`		This method must be implemented.
Method	getAddressText
Description	Gets the textual representation of this address.
Return	`osid.locale.DisplayText`		the address
Compliance	`mandatory`		This method must be implemented.
Method	getAddressRecord
Description	Gets the address record corresponding to the given `Address` record `Type.` This method must be used to retrieve an object implementing the requested record. The `addressRecordType` may be the `Type` returned in `getRecordTypes()` or any of its parents in a `Type` hierarchy where `hasRecordType(addressRecordType)` is `true` .
Parameters	`osid.type.Type`	`addressRecordType`	the type of address record to retrieve
Return	`osid.contact.records.AddressRecord`		the address record
Errors	NULL_ARGUMENT		`addressRecordType` is `null`
	OPERATION_FAILED		unable to complete request
	UNSUPPORTED		`hasRecordType(addressRecordType)` is `false`
Compliance	`mandatory`		This method must be implemented.