public interface PostQuery extends OsidObjectQuery
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.
Modifier and Type | Method and Description |
---|---|
void |
clearForumIdTerms()
Clears the forum
Id terms. |
void |
clearForumTerms()
Clears the forum terms.
|
void |
clearPosterIdTerms()
Clears the poster
Id terms. |
void |
clearPosterTerms()
Clears the poster terms.
|
void |
clearPostingAgentIdTerms()
Clears the posting agent
Id terms. |
void |
clearPostingAgentTerms()
Clears the posting agent terms.
|
void |
clearReplyIdTerms()
Clears the reply
Id terms. |
void |
clearReplyTerms()
Clears the reply terms.
|
void |
clearSubjectLineTerms()
Clears the subject line terms.
|
void |
clearTextTerms()
Clears the text terms.
|
void |
clearTimestampTerms()
Clears the timestamp terms.
|
ForumQuery |
getForumQuery()
Gets the query for a forum query.
|
ResourceQuery |
getPosterQuery()
Gets the query for a resource.
|
AgentQuery |
getPostingAgentQuery()
Gets the query for an agent.
|
PostQueryRecord |
getPostQueryRecord(Type postRecordType)
Gets the post query record corresponding to the given
Post
record Type. |
ReplyQuery |
getReplyQuery()
Gets the query for a post.
|
void |
matchAnyReply(boolean match)
Matches posts with any reply.
|
void |
matchAnySubjectLine(boolean match)
Matches entries with any subject line.
|
void |
matchAnyText(boolean match)
Matches entries with any text.
|
void |
matchForumId(Id forumId,
boolean match)
Sets the post
Id for this query to match replies
assigned to forums. |
void |
matchPosterId(Id resourceId,
boolean match)
Matches the poster of the entry.
|
void |
matchPostingAgentId(Id agentId,
boolean match)
Matches the posting agent of the entry.
|
void |
matchReplyId(Id replyId,
boolean match)
Sets the reply
Id for this query to match replies
assigned to posts. |
void |
matchSubjectLine(java.lang.String subject,
Type stringMatchType,
boolean match)
Adds a subject line to match.
|
void |
matchText(java.lang.String text,
Type stringMatchType,
boolean match)
Adds text to match.
|
void |
matchTimestamp(DateTime startTime,
DateTime endTime,
boolean match)
Matches entries whose sent time is between the supplied range
inclusive.
|
boolean |
supportsForumQuery()
Tests if a
ForumQuery is available. |
boolean |
supportsPosterQuery()
Tests if a
ResourceQuery is available for querying
senders. |
boolean |
supportsPostingAgentQuery()
Tests if an
AgentQuery is available for querying
posters. |
boolean |
supportsReplyQuery()
Tests if a reply query is available.
|
clearCommentIdTerms, clearCommentTerms, clearCreditIdTerms, clearCreditTerms, clearDescriptionTerms, clearDisplayNameTerms, clearGenusTypeTerms, clearJournalEntryIdTerms, clearJournalEntryTerms, clearParentGenusTypeTerms, clearRelationshipIdTerms, clearRelationshipPeerIdTerms, clearRelationshipTerms, clearStateIdTerms, clearStateTerms, clearStatisticTerms, clearSubjectIdTerms, clearSubjectRelevancyTerms, clearSubjectTerms, getCommentQuery, getCreditQuery, getJournalEntryQuery, getRelationshipQuery, getStateQuery, getStatisticQuery, getSubjectQuery, getSubjectRelevancyQuery, matchAnyComment, matchAnyCredit, matchAnyDescription, matchAnyDisplayName, matchAnyGenusType, matchAnyJournalEntry, matchAnyRelationship, matchAnyState, matchAnyStatistic, matchAnySubject, matchCommentId, matchCreditId, matchDescription, matchDisplayName, matchGenusType, matchJournalEntryId, matchParentGenusType, matchRelationshipId, matchRelationshipPeerId, matchStateId, matchSubjectId, supportsCommentQuery, supportsCreditQuery, supportsJournalEntryQuery, supportsRelationshipQuery, supportsStateQuery, supportsStatisticQuery, supportsSubjectQuery, supportsSubjectRelevancyQuery
clearIdTerms, matchId
clearRecordTerms, matchAnyRecord, matchRecordType
getRecordTypes, hasRecordType
clearAnyTerms, clearKeywordTerms, getStringMatchTypes, matchAny, matchKeyword, supportsStringMatchType
void matchTimestamp(DateTime startTime, DateTime endTime, boolean match)
startTime
- start timeendTime
- end timematch
- true
if for a positive match,
false
for a negative matchInvalidArgumentException
- startTime
is
greater than endTime
NullArgumentException
- startTime
or
endTime
is null
mandatory
- This method must be implemented. void clearTimestampTerms()
mandatory
- This method must be implemented. void matchPosterId(Id resourceId, boolean match)
resourceId
- Id
to matchmatch
- true
if for a positive match,
false
for a negative matchNullArgumentException
- resourceId
is
null
mandatory
- This method must be implemented. void clearPosterIdTerms()
Id
terms.mandatory
- This method must be implemented. boolean supportsPosterQuery()
ResourceQuery
is available for querying
senders. true
if a resource query is available,
false
otherwisemandatory
- This method must be implemented. ResourceQuery getPosterQuery()
UnimplementedException
- supportsPosterQuery()
is false
optional
- This method must be implemented if
supportsPosterQuery()
is true.
void clearPosterTerms()
mandatory
- This method must be implemented. void matchPostingAgentId(Id agentId, boolean match)
agentId
- Id
to matchmatch
- true
if for a positive match,
false
for a negative matchNullArgumentException
- agentId
is
null
mandatory
- This method must be implemented. void clearPostingAgentIdTerms()
Id
terms.mandatory
- This method must be implemented. boolean supportsPostingAgentQuery()
AgentQuery
is available for querying
posters. true
if an agent query is available,
false
otherwisemandatory
- This method must be implemented. AgentQuery getPostingAgentQuery()
UnimplementedException
-
supportsPostingAgentQuery()
is false
optional
- This method must be implemented if
supportsPostingAgentQuery()
is true.
void clearPostingAgentTerms()
mandatory
- This method must be implemented. void matchSubjectLine(java.lang.String subject, Type stringMatchType, boolean match)
OR
among them.subject
- display name to matchstringMatchType
- the string match typematch
- true
for a positive match, false
for a negative matchInvalidArgumentException
- subject is
not of stringMatchType
NullArgumentException
- subject
or
stringMatchType
is null
UnsupportedException
-
supportsStringMatchType(stringMatchType)
is
false
mandatory
- This method must be implemented. void matchAnySubjectLine(boolean match)
match
- true
to match entries with any subject
line, false
to match entries with no subject
linemandatory
- This method must be implemented. void clearSubjectLineTerms()
mandatory
- This method must be implemented. void matchText(java.lang.String text, Type stringMatchType, boolean match)
OR
among them.text
- text to matchstringMatchType
- the string match typematch
- true
for a positive match, false
for a negative matchInvalidArgumentException
- text is
not
of stringMatchType
NullArgumentException
- text
or
stringMatchType
is null
UnsupportedException
-
supportsStringMatchType(stringMatchType)
is
false
mandatory
- This method must be implemented. void matchAnyText(boolean match)
match
- true
to match entries with any text,
false
to match entries with no textmandatory
- This method must be implemented. void clearTextTerms()
mandatory
- This method must be implemented. void matchReplyId(Id replyId, boolean match)
Id
for this query to match replies
assigned to posts.replyId
- a reply Id
match
- true
for a positive match, false
for a negative matchNullArgumentException
- replyId
is
null
mandatory
- This method must be implemented. void clearReplyIdTerms()
Id
terms.mandatory
- This method must be implemented. boolean supportsReplyQuery()
true
if a reply query is available,
false
otherwisemandatory
- This method must be implemented. ReplyQuery getReplyQuery()
UnimplementedException
- supportsReplyQuery()
is false
optional
- This method must be implemented if
supportsReplyQuery()
is true.
void matchAnyReply(boolean match)
match
- true
to match posts with any reply,
false
to match posts with no repliesmandatory
- This method must be implemented. void clearReplyTerms()
mandatory
- This method must be implemented. void matchForumId(Id forumId, boolean match)
Id
for this query to match replies
assigned to forums.forumId
- a forum Id
match
- true
for a positive match, false
for a negative matchNullArgumentException
- forumId
is
null
mandatory
- This method must be implemented. void clearForumIdTerms()
Id
terms.mandatory
- This method must be implemented. boolean supportsForumQuery()
ForumQuery
is available. true
if a forum query is available,
false
otherwisemandatory
- This method must be implemented. ForumQuery getForumQuery()
OR
term.UnimplementedException
- supportsForumQuery()
is false
optional
- This method must be implemented if
supportsForumQuery()
is true.
void clearForumTerms()
mandatory
- This method must be implemented. PostQueryRecord getPostQueryRecord(Type postRecordType) throws OperationFailedException
Post
record Type.
Multiple record retrievals produce
a nested boolean OR
term.postRecordType
- a post record typeNullArgumentException
- postRecordType
is null
OperationFailedException
- unable to complete requestUnsupportedException
-
hasRecordType(postRecordType)
is false
mandatory
- This method must be implemented.