OSID - osid.blogging.EntryQuery Service Interface Definition

Interface	osid.blogging.EntryQuery
Implements	`osid.OsidObjectQuery`
Implements	`osid.OsidSourceableQuery`
Used By	`osid.blogging.BlogQuery`
	`osid.blogging.EntryQuerySession`
	`osid.blogging.EntrySearchSession`
	`osid.blogging.EntrySmartBlogSession`
Description	This is the query for searching entries. Each method specifies an `AND` term while multiple invocations of the same method produce a nested `OR`.
Method	matchTimestamp
Description	Matches entries whose sent time is between the supplied range inclusive.
Parameters	`osid.calendaring.DateTime`	`startTime`	start time
	`osid.calendaring.DateTime`	`endTime`	end time
	`boolean`	`match`	`true` if for a positive match, `false` for a negative match
Errors	INVALID_ARGUMENT		`startTime` is greater than `endTime`
Errors	NULL_ARGUMENT		`startTime` or `endTime` is `null`
Compliance	`mandatory`		This method must be implemented.
Method	clearTimestampTerms
Description	Clears the timestamp terms.
Compliance	`mandatory`		This method must be implemented.
Method	matchPosterId
Description	Matches the poster of the entry.
Parameters	`osid.id.Id`	`resourceId`	`Id` of a `Resource` to match
Parameters	`boolean`	`match`	`true` if for a positive match, `false` for a negative match
Errors	NULL_ARGUMENT		`resourceId` is `null`
Compliance	`mandatory`		This method must be implemented.
Method	clearPosterIdTerms
Description	Clears the poster `Id` terms.
Compliance	`mandatory`		This method must be implemented.
Method	supportsPosterQuery
Description	Tests if a `ResourceQuery` is available for querying posters.
Return	`boolean`		`true` if a resource query is available, `false` otherwise
Compliance	`mandatory`		This method must be implemented.
Method	getPosterQuery
Description	Gets the query for a resource.
Return	`osid.resource.ResourceQuery`		the resource query
Errors	UNIMPLEMENTED		`supportsPosterQuery()` is `false`
Compliance	`optional`		This method must be implemented if `supportsPosterQuery()` is `true`.
Method	clearPosterTerms
Description	Clears the poster terms.
Compliance	`mandatory`		This method must be implemented.
Method	matchPostingAgentId
Description	Matches the posting agent of the entry.
Parameters	`osid.id.Id`	`agentId`	`Id` of an `Agent` to match
Parameters	`boolean`	`match`	`true` if for a positive match, `false` for a negative match
Errors	NULL_ARGUMENT		`agentId` is `null`
Compliance	`mandatory`		This method must be implemented.
Method	clearPostingAgentIdTerms
Description	Clears the posting agent `Id` terms.
Compliance	`mandatory`		This method must be implemented.
Method	supportsPostingAgentQuery
Description	Tests if an `AgentQuery` is available for querying senders.
Return	`boolean`		`true` if an agent query is available, `false` otherwise
Compliance	`mandatory`		This method must be implemented.
Method	getPostingAgentQuery
Description	Gets the query for an agent.
Return	`osid.authentication.AgentQuery`		the agent query
Errors	UNIMPLEMENTED		`supportsPostingAgentQuery()` is `false`
Compliance	`optional`		This method must be implemented if `supportsPostingAgentQuery()` is `true`.
Method	clearPostingAgentTerms
Description	Clears the posting agent terms.
Compliance	`mandatory`		This method must be implemented.
Method	matchSubjectLine
Description	Adds a subject line to match. Multiple subject line matches can be added to perform a boolean `OR` among them.
Parameters	`string`	`subject`	subject line to match
	`osid.type.Type`	`stringMatchType`	the string match type
	`boolean`	`match`	`true` for a positive match, `false` for a negative match
Errors	INVALID_ARGUMENT		`subject is` not of `stringMatchType`
	NULL_ARGUMENT		`subject` or `stringMatchType` is `null`
	UNSUPPORTED		`supportsStringMatchType(stringMatchType)` is `false`
Compliance	`mandatory`		This method must be implemented.
Method	matchAnySubjectLine
Description	Matches entries with any subject line.
Parameters	`boolean`	`match`	`true` to match entries with any subject line, `false` to match entries with no subject line
Compliance	`mandatory`		This method must be implemented.
Method	clearSubjectLineTerms
Description	Clears the subject line terms.
Compliance	`mandatory`		This method must be implemented.
Method	matchSummary
Description	Adds a summary to match. Multiple summaries matches can be added to perform a boolean `OR` among them.
Parameters	`string`	`summary`	summary to match
	`osid.type.Type`	`stringMatchType`	the string match type
	`boolean`	`match`	`true` for a positive match, `false` for a negative match
Errors	INVALID_ARGUMENT		`summary is` not of `stringMatchType`
	NULL_ARGUMENT		`summary` or `stringMatchType` is `null`
	UNSUPPORTED		`supportsStringMatchType(stringMatchType)` is `false`
Compliance	`mandatory`		This method must be implemented.
Method	matchAnySummary
Description	Matches entries with any summary.
Parameters	`boolean`	`match`	`true` to match entries with any summary, `false` to match entries with no summary
Compliance	`mandatory`		This method must be implemented.
Method	clearSummaryTerms
Description	Clears the summary terms.
Compliance	`mandatory`		This method must be implemented.
Method	matchText
Description	Adds text to match. Multiple text matches can be added to perform a boolean `OR` among them.
Parameters	`string`	`text`	text to match
	`osid.type.Type`	`stringMatchType`	the string match type
	`boolean`	`match`	`true` for a positive match, `false` for a negative match
Errors	INVALID_ARGUMENT		`text is` not of `stringMatchType`
	NULL_ARGUMENT		`text` or `stringMatchType` is `null`
	UNSUPPORTED		`supportsStringMatchType(stringMatchType)` is `false`
Compliance	`mandatory`		This method must be implemented.
Method	matchAnyText
Description	Matches entries with any text.
Parameters	`boolean`	`match`	`true` to match entries with any text, `false` to match entries with no text
Compliance	`mandatory`		This method must be implemented.
Method	clearTextTerms
Description	Clears the text terms.
Compliance	`mandatory`		This method must be implemented.
Method	matchBlogId
Description	Sets the blog `Id` for this query.
Parameters	`osid.id.Id`	`blogId`	the blog `Id`
Parameters	`boolean`	`match`	`true` for a positive match, `false` for a negative match
Errors	NULL_ARGUMENT		`blogId` is `null`
Compliance	`mandatory`		This method must be implemented.
Method	clearBlogIdTerms
Description	Clears the blog `Id` terms.
Compliance	`mandatory`		This method must be implemented.
Method	supportsBlogQuery
Description	Tests if a `BlogQuery` is available.
Return	`boolean`		`true` if a blog query is available, `false` otherwise
Compliance	`mandatory`		This method must be implemented.
Method	getBlogQuery
Description	Gets the query for a blog. Multiple retrievals produce a nested `OR` term.
Return	`osid.blogging.BlogQuery`		the blog query
Errors	UNIMPLEMENTED		`supportsBlogQuery()` is `false`
Compliance	`optional`		This method must be implemented if `supportsBlogQuery()` is `true`.
Method	clearBlogTerms
Description	Clears the blog terms.
Compliance	`mandatory`		This method must be implemented.
Method	getEntryQueryRecord
Description	Gets the query record corresponding to the given `Entry` record `Type`.Multiple retrievals produce a nested `OR` term.
Parameters	`osid.type.Type`	`entryRecordType`	an entry record type
Return	`osid.blogging.records.EntryQueryRecord`		the entry query record
Errors	NULL_ARGUMENT		`entryRecordType` is `null`
	OPERATION_FAILED		unable to complete request
	UNSUPPORTED		`hasRecordType(entryRecordType)` is `false`
Compliance	`mandatory`		This method must be implemented.