OSID - osid.forum.PostQuery Service Interface Definition

Interface	osid.forum.PostQuery
Implements	`osid.OsidObjectQuery`
Used By	`osid.forum.ForumQuery`
	`osid.forum.PostQuerySession`
	`osid.forum.PostSearchSession`
	`osid.forum.PostSmartForumSession`
	`osid.forum.ReplyQuery`
Description	This is the query for searching for posts. 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` 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 senders.
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` 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 posters.
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`	display name 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	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	matchReplyId
Description	Sets the reply `Id` for this query to match replies assigned to posts.
Parameters	`osid.id.Id`	`replyId`	a reply `Id`
Parameters	`boolean`	`match`	`true` for a positive match, `false` for a negative match
Errors	NULL_ARGUMENT		`replyId` is `null`
Compliance	`mandatory`		This method must be implemented.
Method	clearReplyIdTerms
Description	Clears the reply `Id` terms.
Compliance	`mandatory`		This method must be implemented.
Method	supportsReplyQuery
Description	Tests if a reply query is available.
Return	`boolean`		`true` if a reply query is available, `false` otherwise
Compliance	`mandatory`		This method must be implemented.
Method	getReplyQuery
Description	Gets the query for a post.
Return	`osid.forum.ReplyQuery`		the reply query
Errors	UNIMPLEMENTED		`supportsReplyQuery()` is `false`
Compliance	`optional`		This method must be implemented if `supportsReplyQuery()` is `true`.
Method	matchAnyReply
Description	Matches posts with any reply.
Parameters	`boolean`	`match`	`true` to match posts with any reply, `false` to match posts with no replies
Compliance	`mandatory`		This method must be implemented.
Method	clearReplyTerms
Description	Clears the reply terms.
Compliance	`mandatory`		This method must be implemented.
Method	matchForumId
Description	Sets the post `Id` for this query to match replies assigned to forums.
Parameters	`osid.id.Id`	`forumId`	a forum `Id`
Parameters	`boolean`	`match`	`true` for a positive match, `false` for a negative match
Errors	NULL_ARGUMENT		`forumId` is `null`
Compliance	`mandatory`		This method must be implemented.
Method	clearForumIdTerms
Description	Clears the forum `Id` terms.
Compliance	`mandatory`		This method must be implemented.
Method	supportsForumQuery
Description	Tests if a `ForumQuery` is available.
Return	`boolean`		`true` if a forum query is available, `false` otherwise
Compliance	`mandatory`		This method must be implemented.
Method	getForumQuery
Description	Gets the query for a forum query. Multiple retrievals produce a nested `OR` term.
Return	`osid.forum.ForumQuery`		the forum query
Errors	UNIMPLEMENTED		`supportsForumQuery()` is `false`
Compliance	`optional`		This method must be implemented if `supportsForumQuery()` is `true`.
Method	clearForumTerms
Description	Clears the forum terms.
Compliance	`mandatory`		This method must be implemented.
Method	getPostQueryRecord
Description	Gets the post query record corresponding to the given `Post` record `Type`.Multiple record retrievals produce a nested boolean `OR` term.
Parameters	`osid.type.Type`	`postRecordType`	a post record type
Return	`osid.forum.records.PostQueryRecord`		the post query record
Errors	NULL_ARGUMENT		`postRecordType` is `null`
	OPERATION_FAILED		unable to complete request
	UNSUPPORTED		`hasRecordType(postRecordType)` is `false`
Compliance	`mandatory`		This method must be implemented.