public interface TimePeriodQuery extends OsidObjectQuery
This is the query for searching time periods. Each method match request
produces an AND
term while multiple invocations of a method
produces a nested OR.
Modifier and Type | Method and Description |
---|---|
void |
clearCalendarIdTerms()
Clears the calendar
Id terms. |
void |
clearCalendarTerms()
Clears the calendar terms.
|
void |
clearDurationTerms()
Clears the duration terms.
|
void |
clearEndTerms()
Clears the time period end terms.
|
void |
clearEventIdTerms()
Clears the event
Id terms. |
void |
clearEventTerms()
Clears the event terms.
|
void |
clearExceptionIdTerms()
Clears the exception event
Id terms. |
void |
clearExceptionTerms()
Clears the exception event terms.
|
void |
clearStartTerms()
Clears the time period start terms.
|
void |
clearTimeInclusiveTerms()
Clears the time inclusive terms.
|
void |
clearTimeTerms()
Clears the time terms.
|
CalendarQuery |
getCalendarQuery()
Gets the query for a calendar.
|
EventQuery |
getEventQuery()
Gets the query for an event or recurring event.
|
EventQuery |
getExceptionQuery()
Gets the query for an exception event.
|
TimePeriodQueryRecord |
getTimePeriodQueryRecord(Type timePeriodRecordType)
Gets the time period query record corresponding to the given
TimePeriod record Type. |
void |
matchAnyEnd(boolean match)
Matches a time period that has any end time assigned.
|
void |
matchAnyEvent(boolean match)
Matches a time period that has any event assigned.
|
void |
matchAnyException(boolean match)
Matches a time period that has any exception event assigned.
|
void |
matchAnyStart(boolean match)
Matches a time period that has any start time assigned.
|
void |
matchAnyTime(boolean match)
Matches a time period that has any time assigned.
|
void |
matchCalendarId(Id calendarId,
boolean match)
Sets the calendar
Id for this query. |
void |
matchDuration(Duration low,
Duration high,
boolean match)
Matches the time period duration between the given range inclusive.
|
void |
matchEnd(DateTime low,
DateTime high,
boolean match)
Matches the time period end time between the given range inclusive.
|
void |
matchEventId(Id eventId,
boolean match)
Sets the event
Id for this query. |
void |
matchExceptionId(Id eventId,
boolean match)
Sets the event
Id for this query to match exceptions. |
void |
matchStart(DateTime low,
DateTime high,
boolean match)
Matches the time period start time between the given range inclusive.
|
void |
matchTime(DateTime time,
boolean match)
Matches time periods that include the given time.
|
void |
matchTimeInclusive(DateTime start,
DateTime end,
boolean match)
Matches time periods with start and end times between the given range
inclusive.
|
boolean |
supportsCalendarQuery()
Tests if a
CalendarQuery is available for querying
resources. |
boolean |
supportsEventQuery()
Tests if an
EventQuery is available for querying
events. |
boolean |
supportsExceptionQuery()
Tests if an
EventQuery is available for querying
exception events. |
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 matchStart(DateTime low, DateTime high, boolean match)
low
- low time rangehigh
- high time rangematch
- true
for a positive match, false
for a negative matchInvalidArgumentException
- high
is less
than low
NullArgumentException
- high
or
low
is zero
mandatory
- This method must be implemented. void matchAnyStart(boolean match)
match
- true
to match time periods with any start
time, false
to match time periods with no start
timemandatory
- This method must be implemented. void clearStartTerms()
mandatory
- This method must be implemented. void matchEnd(DateTime low, DateTime high, boolean match)
low
- low time rangehigh
- high time rangematch
- true
for a positive match, false
for a negative matchInvalidArgumentException
- high
is less
than low
NullArgumentException
- high
or
low
is zero
mandatory
- This method must be implemented. void matchAnyEnd(boolean match)
match
- true
to match time periods with any end
time, false
to match time periods with no end
timemandatory
- This method must be implemented. void clearEndTerms()
mandatory
- This method must be implemented. void matchTime(DateTime time, boolean match)
time
- datematch
- true
for a positive match, false
for a negative matchmandatory
- This method must be implemented. void matchAnyTime(boolean match)
match
- true
to match time periods with any time,
false
to match time periods with no timemandatory
- This method must be implemented. void clearTimeTerms()
mandatory
- This method must be implemented. void matchTimeInclusive(DateTime start, DateTime end, boolean match)
start
- start dateend
- end datematch
- true
for a positive match, false
for a negative matchInvalidArgumentException
- end
is less
than start
NullArgumentException
- start
or
end
is zero
mandatory
- This method must be implemented. void clearTimeInclusiveTerms()
mandatory
- This method must be implemented. void matchDuration(Duration low, Duration high, boolean match)
low
- low duration rangehigh
- high duration rangematch
- true
for a positive match, false
for a negative matchInvalidArgumentException
- high
is less
than low
NullArgumentException
- high
or
low
is null
mandatory
- This method must be implemented. void clearDurationTerms()
mandatory
- This method must be implemented. void matchExceptionId(Id eventId, boolean match)
Id
for this query to match exceptions.eventId
- an exception event Id
match
- true
for a positive match, false
for a negative matchNullArgumentException
- eventId
is
null
mandatory
- This method must be implemented. void clearExceptionIdTerms()
Id
terms.mandatory
- This method must be implemented. boolean supportsExceptionQuery()
EventQuery
is available for querying
exception events. true
if a exception query is available,
false
otherwisemandatory
- This method must be implemented. EventQuery getExceptionQuery()
OR
term.UnimplementedException
-
supportsExceptionQuery()
is false
optional
- This method must be implemented if
supportsExceptionQuery()
is true.
void matchAnyException(boolean match)
match
- true
to match time periods with any
exception, false
to match time periods with no
exceptionmandatory
- This method must be implemented. void clearExceptionTerms()
mandatory
- This method must be implemented. void matchEventId(Id eventId, boolean match)
Id
for this query.eventId
- an event or recurring event Id
match
- true
for a positive match, false
for a negative matchNullArgumentException
- eventId
is
null
mandatory
- This method must be implemented. void clearEventIdTerms()
Id
terms.mandatory
- This method must be implemented. boolean supportsEventQuery()
EventQuery
is available for querying
events. true
if an event query is available,
false
otherwisemandatory
- This method must be implemented. EventQuery getEventQuery()
OR
term.UnimplementedException
- supportsEventQuery()
is false
optional
- This method must be implemented if
supportsEventQuery()
is true.
void matchAnyEvent(boolean match)
match
- true
to match time periods with any
event, false
to match time periods with no
eventsmandatory
- This method must be implemented. void clearEventTerms()
mandatory
- This method must be implemented. void matchCalendarId(Id calendarId, boolean match)
Id
for this query.calendarId
- a calendar Id
match
- true
for a positive match, false
for a negative matchNullArgumentException
- calendarId
is
null
mandatory
- This method must be implemented. void clearCalendarIdTerms()
Id
terms.mandatory
- This method must be implemented. boolean supportsCalendarQuery()
CalendarQuery
is available for querying
resources. true
if a calendar query is available,
false
otherwisemandatory
- This method must be implemented. CalendarQuery getCalendarQuery()
OR
term.UnimplementedException
- supportsCalendarQuery()
is false
optional
- This method must be implemented if
supportsCalendarQuery()
is true.
void clearCalendarTerms()
mandatory
- This method must be implemented. TimePeriodQueryRecord getTimePeriodQueryRecord(Type timePeriodRecordType) throws OperationFailedException
TimePeriod
record Type.
Multiple retrievals
produce a nested OR
term.timePeriodRecordType
- a time period query record typeNullArgumentException
- timePeriodRecordType
is null
OperationFailedException
- unable to complete requestUnsupportedException
-
hasRecordType(timePeriodRecordType)
is false
mandatory
- This method must be implemented.