Interface LessonQuery
- All Superinterfaces:
Extensible, OsidBrowsableQuery, OsidExtensibleQuery, OsidIdentifiableQuery, OsidObjectQuery, OsidQuery, OsidRelationshipQuery, OsidTemporalQuery, Suppliable
This is the query for searching for lessons. Each method specifies an
AND term while multiple invocations of the same method produce a
nested OR .
-
Method Summary
Modifier and TypeMethodDescriptionvoidClears the activityIdterms.voidClears the activity terms.voidClears the ending activityIdterms.voidClears the ending activity terms.voidClears the actual end time terms.voidClears the starting activityIdterms.voidClears the starting activity terms.voidClears the actual start time terms.voidClears the actual time spent terms.voidClears the complete terms.voidClears the course catalogIdterms.voidClears the course catalog terms.voidClears the docetIdterms.voidClears the docet terms.voidClears the planIdtems.voidClears the planned start time terms.voidClears the plan terms.voidClears the skipped terms.Gets the query for an activity.Gets the query for an ending activity.Gets the query for a starting activity.Gets the query for a course catalog query.Gets the query for a docet.getLessonQueryRecord(Type lessonRecordType) Gets the lesson query record corresponding to the givenLessonrecordType.Multiple record retrievals produce a nested booleanORterm.Gets the query for a plan.voidmatchActivityId(Id activitytId, boolean match) Sets the activityIdfor this query.voidmatchActualEndingActivityId(Id activitytId, boolean match) Sets the ending activityIdfor this query.voidmatchActualEndTime(Duration from, Duration to, boolean match) Matches an actual ending time within the given date range inclusive.voidmatchActualStartingActivityId(Id activitytId, boolean match) Sets the starting activityIdfor this query.voidmatchActualStartTime(Duration from, Duration to, boolean match) Matches an actual start time within the given date range inclusive.voidmatchActualTimeSpent(Duration from, Duration to, boolean match) Matches an actual time spent within the given duration range inclusive.voidmatchAnyActivity(boolean match) Matches a lesson that has any activity.voidmatchAnyActualEndingActivity(boolean match) Matches a lesson that has any ending activity.voidmatchAnyActualEndTime(boolean match) Matches a lesson that has any actual end time.voidmatchAnyActualStartingActivity(boolean match) Matches a lesson that has any starting activity.voidmatchAnyActualStartTime(boolean match) Matches a lesson that has begun.voidmatchAnyActualTimeSpent(boolean match) Matches a lesson that has any actual time spent.voidmatchAnyDocet(boolean match) Matches a lesson that has any docet.voidmatchAnyPlannedStartTime(boolean match) Matches a lesson that has any planned start time.voidmatchComplete(boolean match) Matches a lesson that has been completed.voidmatchCourseCatalogId(Id courseCatalogId, boolean match) Sets the lessonIdfor this query to match syllabi assigned to course catalogs.voidmatchDocetId(Id docetId, boolean match) Sets the docetIdfor this query.voidmatchPlanId(Id planId, boolean match) Sets the planIdfor this query.voidmatchPlannedStartTime(Duration from, Duration to, boolean match) Matches a planned start time within the given duration range inclusive.voidmatchSkipped(boolean match) Matches a lesson that has been skipped.booleanTests if an activity query is available.booleanTests if an ending activity query is available.booleanTests if a starting activity query is available.booleanTests if anCourseCatalogQueryis available.booleanTests if a docet query is available.booleanTests if a plan query is available.Methods inherited from interface Extensible
getRecordTypes, hasRecordTypeModifier and TypeMethodDescriptionGets the record types available in this object.booleanhasRecordType(Type recordType) Tests if this object supports the given recordType.Methods inherited from interface OsidExtensibleQuery
clearRecordTerms, matchAnyRecord, matchRecordTypeModifier and TypeMethodDescriptionvoidClears all recordTypeterms.voidmatchAnyRecord(boolean match) Matches an object that has any record.voidmatchRecordType(Type recordType, boolean match) Sets aTypefor querying objects having records implementing a given record type.Methods inherited from interface OsidIdentifiableQuery
clearIdTerms, matchIdModifier and TypeMethodDescriptionvoidClears allIdterms.voidAdds anIdto match.Methods inherited from interface OsidObjectQuery
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, supportsSubjectRelevancyQueryModifier and TypeMethodDescriptionvoidClears all commentIdterms.voidClears all comment terms.voidClears all creditIdterms.voidClears all credit terms.voidClears all description terms.voidClears all display name terms.voidClears all genus type terms.voidClears all journal entryIdterms.voidClears all journal entry terms.voidClears all genus type terms.voidClears all relationshipIdterms.voidClears all relationshipIdterms.voidClears all relationship terms.voidClears all stateIdterms.voidClears all state terms.voidClears all statistic terms.voidClears all subjectIdterms.voidClears all subject relevancy terms.voidClears all subject terms.Gets the query for a comment.Gets the query for an ackowledgement credit.Gets the query for a journal entry.Gets the query for relationship.Gets the query for a state.Gets the query for a statistic.Gets the query for a subject.Gets the query for a subject relevancy.voidmatchAnyComment(boolean match) Matches an object that has anyCommentin the givenBook.voidmatchAnyCredit(boolean match) Matches an object that has anyCredit.voidmatchAnyDescription(boolean match) Matches a description that has any value.voidmatchAnyDisplayName(boolean match) Matches any object with a display name.voidmatchAnyGenusType(boolean match) Matches an object that has any genus type.voidmatchAnyJournalEntry(boolean match) Matches an object that has anyJournalEntryin the givenJournal.voidmatchAnyRelationship(boolean match) Matches an object that has anyRelationship.voidmatchAnyState(boolean match) Matches an object that has any mapping to aStatein the givenProcess.voidmatchAnyStatistic(boolean match) Matches an object that has anyStatistic.voidmatchAnySubject(boolean match) Matches an object that has any relationship to aSubject.voidmatchCommentId(Id commentId, boolean match) Matches an object that has the given comment.voidmatchCreditId(Id creditId, boolean match) Matches an object that has the given credit.voidmatchDescription(String description, Type stringMatchType, boolean match) Adds a description name to match.voidmatchDisplayName(String displayName, Type stringMatchType, boolean match) Adds a display name to match.voidmatchGenusType(Type genusType, boolean match) Sets aTypefor querying objects of a given genus.voidmatchJournalEntryId(Id journalEntryId, boolean match) Matches an object that has the given journal entry.voidmatchParentGenusType(Type genusType, boolean match) Sets aTypefor querying objects of a given genus.voidmatchRelationshipId(Id relationshipId, boolean match) Matches an object that has the given relationship.voidmatchRelationshipPeerId(Id peerId, boolean match) Matches an object that has a relationship to the given peerId.voidmatchStateId(Id stateId, boolean match) Matches an object mapped to the given state.voidmatchSubjectId(Id subjectId, boolean match) Matches an object with a relationship to the given subject.booleanTests if aCommentQueryis available.booleanTests if aCreditQueryis available to provide queries of related acknowledgements.booleanTests if aJournalEntryis available to provide queries of journaledOsidObjects.booleanTests if aRelationshipQueryis available.booleanTests if aStateQueryis available to provide queries of processed objects.booleanTests if aStatisticQueryis available to provide statistical queries.booleanTests if aSubjectQueryis available.booleanTests if aRelevancyQueryis available to provide queries about the relationships toSubjects.Methods inherited from interface OsidQuery
clearAnyTerms, clearKeywordTerms, getStringMatchTypes, matchAny, matchKeyword, supportsStringMatchTypeModifier and TypeMethodDescriptionvoidClears the match any terms.voidClears all keyword terms.Gets the string matching types supported.voidmatchAny(boolean match) Matches any object.voidmatchKeyword(String keyword, Type stringMatchType, boolean match) Adds a keyword to match.booleansupportsStringMatchType(Type stringMatchType) Tests if the given string matching type is supported.Methods inherited from interface OsidRelationshipQuery
clearEndReasonIdTerms, clearEndReasonTerms, getEndReasonQuery, matchAnyEndReason, matchEndReasonId, supportsEndReasonQueryModifier and TypeMethodDescriptionvoidClears all stateIdterms.voidClears all end reason state terms.getEndReasonQuery(boolean match) Gets the query for the end reason state.voidmatchAnyEndReason(boolean match) Match any end reason state.voidmatchEndReasonId(Id stateId, boolean match) Match theIdof the end reason state.booleanTests if aStateQueryfor the end reason is available.Methods inherited from interface OsidTemporalQuery
clearDateTerms, clearEffectiveTerms, clearEndDateTerms, clearStartDateTerms, matchAnyEndDate, matchAnyStartDate, matchDate, matchEffective, matchEndDate, matchStartDateModifier and TypeMethodDescriptionvoidClears the date query terms.voidClears the effective query terms.voidClears the end date query terms.voidClears the start date query terms.voidmatchAnyEndDate(boolean match) Matches temporals with any end date set.voidmatchAnyStartDate(boolean match) Matches temporals with any start date set.voidMatches temporals where the given date range falls entirely between the start and end dates inclusive.voidmatchEffective(boolean match) Match effective objects where the current date falls within the start and end dates inclusive.voidmatchEndDate(DateTime start, DateTime end, boolean match) Matches temporals whose effective end date falls in between the given dates inclusive.voidmatchStartDate(DateTime start, DateTime end, boolean match) Matches temporals whose start date falls in between the given dates inclusive.
-
Method Details
-
matchPlanId
Sets the planIdfor this query.- Parameters:
planId- a planIdmatch-truefor a positive match,falsefor a negative match- Throws:
NullArgumentException-planIdisnull- Compliance:
mandatory- This method must be implemented.
-
clearPlanIdTerms
void clearPlanIdTerms()Clears the planIdtems.- Compliance:
mandatory- This method must be implemented.
-
supportsPlanQuery
boolean supportsPlanQuery()Tests if a plan query is available.- Returns:
trueif a plan query is available,falseotherwise- Compliance:
mandatory- This method must be implemented.
-
getPlanQuery
PlanQuery getPlanQuery()Gets the query for a plan.- Returns:
- the plan query
- Throws:
UnimplementedException-supportsPlanQuery()isfalse- Compliance:
optional- This method must be implemented if {@code supportsPlanQuery()} is {@code true} .
-
clearPlanTerms
void clearPlanTerms()Clears the plan terms.- Compliance:
mandatory- This method must be implemented.
-
matchDocetId
Sets the docetIdfor this query.- Parameters:
docetId- a docetIdmatch-truefor a positive match,falsefor a negative match- Throws:
NullArgumentException-docetIdisnull- Compliance:
mandatory- This method must be implemented.
-
clearDocetIdTerms
void clearDocetIdTerms()Clears the docetIdterms.- Compliance:
mandatory- This method must be implemented.
-
supportsDocetQuery
boolean supportsDocetQuery()Tests if a docet query is available.- Returns:
trueif a docet query is available,falseotherwise- Compliance:
mandatory- This method must be implemented.
-
getDocetQuery
DocetQuery getDocetQuery()Gets the query for a docet.- Returns:
- the docet query
- Throws:
UnimplementedException-supportsDocetQuery()isfalse- Compliance:
optional- This method must be implemented if {@code supportsDocetQuery()} is {@code true} .
-
matchAnyDocet
void matchAnyDocet(boolean match) Matches a lesson that has any docet.- Parameters:
match-trueto match lessons with any docet,falseto match lessons with no docet- Compliance:
mandatory- This method must be implemented.
-
clearDocetTerms
void clearDocetTerms()Clears the docet terms.- Compliance:
mandatory- This method must be implemented.
-
matchActivityId
Sets the activityIdfor this query.- Parameters:
activitytId- an activityIdmatch-truefor a positive match,falsefor a negative match- Throws:
NullArgumentException-activityIdisnull- Compliance:
mandatory- This method must be implemented.
-
clearActivityIdTerms
void clearActivityIdTerms()Clears the activityIdterms.- Compliance:
mandatory- This method must be implemented.
-
supportsActivityQuery
boolean supportsActivityQuery()Tests if an activity query is available.- Returns:
trueif an activity query is available,falseotherwise- Compliance:
mandatory- This method must be implemented.
-
getActivityQuery
ActivityQuery getActivityQuery()Gets the query for an activity.- Returns:
- the activity query
- Throws:
UnimplementedException-supportsActivityQuery()isfalse- Compliance:
optional- This method must be implemented if {@code supportsActivityQuery()} is {@code true} .
-
matchAnyActivity
void matchAnyActivity(boolean match) Matches a lesson that has any activity.- Parameters:
match-trueto match lessons with any activity,falseto match lessons with no activities- Compliance:
mandatory- This method must be implemented.
-
clearActivityTerms
void clearActivityTerms()Clears the activity terms.- Compliance:
mandatory- This method must be implemented.
-
matchPlannedStartTime
Matches a planned start time within the given duration range inclusive.- Parameters:
from- a starting dateto- an ending datematch-truefor a positive match,falsefor a negative match- Throws:
InvalidArgumentException-fromis greater thantoNullArgumentException-fromortoisnull- Compliance:
mandatory- This method must be implemented.
-
matchAnyPlannedStartTime
void matchAnyPlannedStartTime(boolean match) Matches a lesson that has any planned start time.- Parameters:
match-trueto match lessons with any planned start time,falseto match lessons with no planned start time- Compliance:
mandatory- This method must be implemented.
-
clearPlannedStartTimeTerms
void clearPlannedStartTimeTerms()Clears the planned start time terms.- Compliance:
mandatory- This method must be implemented.
-
matchActualStartTime
Matches an actual start time within the given date range inclusive.- Parameters:
from- a starting dateto- an ending datematch-truefor a positive match,falsefor a negative match- Throws:
InvalidArgumentException-fromis greater thantoNullArgumentException-fromortoisnull- Compliance:
mandatory- This method must be implemented.
-
matchAnyActualStartTime
void matchAnyActualStartTime(boolean match) Matches a lesson that has begun.- Parameters:
match-trueto match lessons with any actual start time,falseto match lessons with no actual start time- Compliance:
mandatory- This method must be implemented.
-
clearActualStartTimeTerms
void clearActualStartTimeTerms()Clears the actual start time terms.- Compliance:
mandatory- This method must be implemented.
-
matchActualStartingActivityId
Sets the starting activityIdfor this query.- Parameters:
activitytId- an activityIdmatch-truefor a positive match,falsefor a negative match- Throws:
NullArgumentException-activityIdisnull- Compliance:
mandatory- This method must be implemented.
-
clearActualStartingActivityIdTerms
void clearActualStartingActivityIdTerms()Clears the starting activityIdterms.- Compliance:
mandatory- This method must be implemented.
-
supportsActualStartingActivityQuery
boolean supportsActualStartingActivityQuery()Tests if a starting activity query is available.- Returns:
trueif a starting activity query is available,falseotherwise- Compliance:
mandatory- This method must be implemented.
-
getActualStartingActivityQuery
ActivityQuery getActualStartingActivityQuery()Gets the query for a starting activity.- Returns:
- the activity query
- Throws:
UnimplementedException-supportsActualStartingActivityQuery()isfalse- Compliance:
optional- This method must be implemented if {@code supportsActualStartingActivityQuery()} is {@code true} .
-
matchAnyActualStartingActivity
void matchAnyActualStartingActivity(boolean match) Matches a lesson that has any starting activity.- Parameters:
match-trueto match lessons with any starting activity,falseto match lessons with no starting activity- Compliance:
mandatory- This method must be implemented.
-
clearActualStartingActivityTerms
void clearActualStartingActivityTerms()Clears the starting activity terms.- Compliance:
mandatory- This method must be implemented.
-
matchComplete
void matchComplete(boolean match) Matches a lesson that has been completed.- Parameters:
match-trueto match lessons that have been completed,falseto match lessons that have not been completed- Compliance:
mandatory- This method must be implemented.
-
clearCompleteTerms
void clearCompleteTerms()Clears the complete terms.- Compliance:
mandatory- This method must be implemented.
-
matchSkipped
void matchSkipped(boolean match) Matches a lesson that has been skipped.- Parameters:
match-trueto match lessons that have been skipped,falseto match lessons that have not been skipped- Compliance:
mandatory- This method must be implemented.
-
clearSkippedTerms
void clearSkippedTerms()Clears the skipped terms.- Compliance:
mandatory- This method must be implemented.
-
matchActualEndTime
Matches an actual ending time within the given date range inclusive.- Parameters:
from- a starting dateto- an ending datematch-truefor a positive match,falsefor a negative match- Throws:
InvalidArgumentException-fromis greater thantoNullArgumentException-fromortoisnull- Compliance:
mandatory- This method must be implemented.
-
matchAnyActualEndTime
void matchAnyActualEndTime(boolean match) Matches a lesson that has any actual end time.- Parameters:
match-trueto match lessons with any actual end time,falseto match lessons with no actual end time- Compliance:
mandatory- This method must be implemented.
-
clearActualEndTimeTerms
void clearActualEndTimeTerms()Clears the actual end time terms.- Compliance:
mandatory- This method must be implemented.
-
matchActualEndingActivityId
Sets the ending activityIdfor this query.- Parameters:
activitytId- an activityIdmatch-truefor a positive match,falsefor a negative match- Throws:
NullArgumentException-activityIdisnull- Compliance:
mandatory- This method must be implemented.
-
clearActualEndingActivityIdTerms
void clearActualEndingActivityIdTerms()Clears the ending activityIdterms.- Compliance:
mandatory- This method must be implemented.
-
supportsActualEndingActivityQuery
boolean supportsActualEndingActivityQuery()Tests if an ending activity query is available.- Returns:
trueif an ending activity query is available,falseotherwise- Compliance:
mandatory- This method must be implemented.
-
getActualEndingActivityQuery
ActivityQuery getActualEndingActivityQuery()Gets the query for an ending activity.- Returns:
- the activity query
- Throws:
UnimplementedException-supportsEndingActivityQuery()isfalse- Compliance:
optional- This method must be implemented if {@code supportsEndingActivityQuery()} is {@code true} .
-
matchAnyActualEndingActivity
void matchAnyActualEndingActivity(boolean match) Matches a lesson that has any ending activity.- Parameters:
match-trueto match lessons with any ending activity,falseto match lessons with no ending activity- Compliance:
mandatory- This method must be implemented.
-
clearActualEndingActivityTerms
void clearActualEndingActivityTerms()Clears the ending activity terms.- Compliance:
mandatory- This method must be implemented.
-
matchActualTimeSpent
Matches an actual time spent within the given duration range inclusive.- Parameters:
from- a starting dateto- an ending datematch-truefor a positive match,falsefor a negative match- Throws:
InvalidArgumentException-fromis greater thantoNullArgumentException-fromortoisnull- Compliance:
mandatory- This method must be implemented.
-
matchAnyActualTimeSpent
void matchAnyActualTimeSpent(boolean match) Matches a lesson that has any actual time spent.- Parameters:
match-trueto match lessons with any actual time spent,falseto match lessons with no time spent- Compliance:
mandatory- This method must be implemented.
-
clearActualTimeSpentTerms
void clearActualTimeSpentTerms()Clears the actual time spent terms.- Compliance:
mandatory- This method must be implemented.
-
matchCourseCatalogId
Sets the lessonIdfor this query to match syllabi assigned to course catalogs.- Parameters:
courseCatalogId- a course catalogIdmatch-truefor a positive match,falsefor a negative match- Throws:
NullArgumentException-courseCatalogIdisnull- Compliance:
mandatory- This method must be implemented.
-
clearCourseCatalogIdTerms
void clearCourseCatalogIdTerms()Clears the course catalogIdterms.- Compliance:
mandatory- This method must be implemented.
-
supportsCourseCatalogQuery
boolean supportsCourseCatalogQuery()Tests if anCourseCatalogQueryis available.- Returns:
trueif a course catalog query is available,falseotherwise- Compliance:
mandatory- This method must be implemented.
-
getCourseCatalogQuery
CourseCatalogQuery getCourseCatalogQuery()Gets the query for a course catalog query. Multiple retrievals produce a nestedORterm.- Returns:
- the course catalog query
- Throws:
UnimplementedException-supportsCourseCatalogQuery()isfalse- Compliance:
optional- This method must be implemented if {@code supportsCourseCatalogQuery()} is {@code true} .
-
clearCourseCatalogTerms
void clearCourseCatalogTerms()Clears the course catalog terms.- Compliance:
mandatory- This method must be implemented.
-
getLessonQueryRecord
Gets the lesson query record corresponding to the givenLessonrecordType.Multiple record retrievals produce a nested booleanORterm.- Parameters:
lessonRecordType- a lesson record type- Returns:
- the lesson query record
- Throws:
NullArgumentException-lessonRecordTypeisnullOperationFailedException- unable to complete requestUnsupportedException-hasRecordType(lessonRecordType)isfalse- Compliance:
mandatory- This method must be implemented.
-