Interface RecurringEventEnablerSearchSession
- All Superinterfaces:
AutoCloseable, Closeable, OsidSession, OsidSession, RecurringEventEnablerQuerySession
This session provides methods for searching among
RecurringEventEnabler objects. The search query is constructed using the
RecurringEventEnablerQuery .
getRecurringEventEnablersByQuery() is the basic search method and
returns a list of RecurringEventEnablers . A more advanced search
may be performed with getRecurringEventEnablerBySearch() . It
accepts a RecurringEventEnabler in addition to the query for the
purpose of specifying additional options affecting the entire search, such
as calendaring. geRecurringEventEnablersBySearch() returns a
RecurringEventEnablerSearchResults that can be used to access the
resulting RecurringEventEnablerList or be used to perform a search
within the result set through RecurringEventEnablerSearch .
This session defines views that offer differing behaviors for searching.
- federated calendar view: searches include recurring event enablers in calendars of which this calendar is an ancestor in the calendar hierarchy
- isolated calendar view: searches are restricted to recurring event enablers in this calendar
RecurringEventEnablers may have a query record indicated by their
respective record types. The query record is accessed via the
RecurringEventEnablerQuery .-
Method Summary
Modifier and TypeMethodDescriptiongetRecurringEventEnablerQueryFromInspector(RecurringEventEnablerQueryInspector recurringEventEnablerQueryInspector) Gets a recurring event enabler query from an inspector.getRecurringEventEnablersBySearch(RecurringEventEnablerQuery recurringEventEnablerQuery, RecurringEventEnablerSearch recurringEventEnablerSearch) Gets the search results matching the given search query using the given search.Gets a recurring event enabler search.Gets a recurring event enabler search order.Methods inherited from interface OsidSession
closeMethods inherited from interface OsidSession
getAuthenticatedAgent, getAuthenticatedAgentId, getClockRate, getDate, getEffectiveAgent, getEffectiveAgentId, getFormatType, getLocale, isAuthenticated, startTransaction, supportsTransactionsModifier and TypeMethodDescriptionGets the agent authenticated to this session.Gets theIdof the agent authenticated to this session.Gets the rate of the service clock.getDate()Gets the service date which may be the current date or the effective date in which this session exists.Gets the effective agent in use by this session.Gets theIdof the effective agent in use by this session.Gets theDisplayTextformatTypepreference in effect for this session.Gets the locale indicating the localization preferences in effect for this session.booleanTests if an agent is authenticated to this session.Starts a new transaction for this sesson.booleanTests for the availability of transactions.Methods inherited from interface RecurringEventEnablerQuerySession
canSearchRecurringEventEnablers, getCalendar, getCalendarId, getRecurringEventEnablerQuery, getRecurringEventEnablersByQuery, useFederatedCalendarView, useIsolatedCalendarViewModifier and TypeMethodDescriptionbooleanTests if this user can performRecurringEventEnablerlookups.Gets theCalendarassociated with this session.Gets theCalendarIdassociated with this session.Gets a recurring event enabler query.getRecurringEventEnablersByQuery(RecurringEventEnablerQuery recurringEventEnablerQuery) Gets a list ofRecurringEventEnablersmatching the given recurring event enabler query.voidFederates the view for methods in this session.voidIsolates the view for methods in this session.
-
Method Details
-
getRecurringEventEnablerSearch
RecurringEventEnablerSearch getRecurringEventEnablerSearch()Gets a recurring event enabler search.- Returns:
- the recurring event enabler search
- Compliance:
mandatory- This method must be implemented.
-
getRecurringEventEnablerSearchOrder
RecurringEventEnablerSearchOrder getRecurringEventEnablerSearchOrder()Gets a recurring event enabler search order. TheRecurringEventEnablerSearchOrderis supplied to aRecurringEventEnablerSearchto specify the ordering of results.- Returns:
- the recurring event enabler search order
- Compliance:
mandatory- This method must be implemented.
-
getRecurringEventEnablersBySearch
RecurringEventEnablerSearchResults getRecurringEventEnablersBySearch(RecurringEventEnablerQuery recurringEventEnablerQuery, RecurringEventEnablerSearch recurringEventEnablerSearch) throws OperationFailedException, PermissionDeniedException Gets the search results matching the given search query using the given search.- Parameters:
recurringEventEnablerQuery- the recurring event enabler queryrecurringEventEnablerSearch- the recurring event enabler search- Returns:
- the returned search results
- Throws:
NullArgumentException-recurringEventEnablerQueryorrecurringEventEnablerSearchisnullOperationFailedException- unable to complete requestPermissionDeniedException- authorization failureUnsupportedException-recurringEventEnablerQueryorrecurringEventEnablerSearchis not of this service- Compliance:
mandatory- This method must be implemented.
-
getRecurringEventEnablerQueryFromInspector
RecurringEventEnablerQuery getRecurringEventEnablerQueryFromInspector(RecurringEventEnablerQueryInspector recurringEventEnablerQueryInspector) Gets a recurring event enabler query from an inspector. The inspector is available from aRecurringEventEnablerSearchResults.- Parameters:
recurringEventEnablerQueryInspector- a recurring event enabler query inspector- Returns:
- the recurring event enabler query
- Throws:
NullArgumentException-recurringEventEnablerQueryInspectorisnullUnsupportedException-recurringEventEnablerQueryInspectoris not of this service- Compliance:
mandatory- This method must be implemented.
-