OSID - osid.repository.AssetContent Service Interface Definition

Interface	osid.repository.AssetContent
Implements	`osid.OsidObject`
Implements	`osid.Subjugateable`
Used By	`osid.repository.AssetAdminSession`
	`osid.repository.AssetContentAdminSession`
	`osid.repository.AssetContentList`
	`osid.repository.AssetContentLookupSession`
Description	`AssetContent` represents a version of content represented by an `Asset`. Although `AssetContent` is a separate `OsidObject` with its own `Id` to distuinguish it from other content inside an `Asset, AssetContent` can only be accessed through an `Asset`. Once an `Asset` is selected, multiple contents should be negotiated using the size, fidelity requirements, or application evnironment.
Method	getAssetId
Description	Gets the `Asset Id` corresponding to this content.
Return	`osid.id.Id`		the asset `Id`
Compliance	`mandatory`		This method must be implemented.
Method	getAsset
Description	Gets the `Asset` corresponding to this content.
Return	`osid.repository.Asset`		the asset
Compliance	`mandatory`		This method must be implemented.
Method	hasDataLength
Description	Tests if a data length is available.
Return	`boolean`		`true` if a length is available for this content, `false` otherwise.
Compliance	`mandatory`		This method must be implemented.
Method	getDataLength
Description	Gets the length of the data represented by this content in bytes.
Return	`cardinal`		the length of the data stream
Errors	ILLEGAL_STATE		`hasDataLength()` is `false`
Compliance	`mandatory`		This method must be implemented.
Method	getData
Description	Gets the asset content data.
Return	`osid.transport.DataInputStream`		the length of the content data
Errors	OPERATION_FAILED		unable to complete request
Compliance	`mandatory`		This method must be implemented.
Method	hasURL
Description	Tests if a URL is associated with this content.
Return	`boolean`		`true` if a URL is available, `false` otherwise
Compliance	`mandatory`		This method must be implemented.
Method	getURL
Description	Gets the URL associated with this content for web-based retrieval.
Return	`string`		the url for this data
Errors	ILLEGAL_STATE		`hasURL()` is `false`
Compliance	`mandatory`		This method must be implemented.
Method	getAssetContentRecord
Description	Gets the asset content record corresponding to the given `AssetContent` record `Type`. This method is used to retrieve an object implementing the requested record. The `assetRecordType` may be the `Type` returned in `getRecordTypes()` or any of its parents in a `Type` hierarchy where `hasRecordType(assetRecordType)` is `true`.
Parameters	`osid.type.Type`	`assetContentContentRecordType`	the type of the record to retrieve
Return	`osid.repository.records.AssetContentRecord`		the asset content record
Errors	NULL_ARGUMENT		`assetContentRecordType` is `null`
	OPERATION_FAILED		unable to complete request
	UNSUPPORTED		`hasRecordType(assetContentRecordType)` is `false`
Compliance	`mandatory`		This method must be implemented.