Interface RegistrationRequestItemSearchSession
- All Superinterfaces:
AutoCloseable, Closeable, OsidSession, OsidSession, RegistrationRequestItemQuerySession
This session provides methods for searching among
RegistrationRequestItems . The search query is constructed using the
RegistrationRequestItemQuery .
getRegistrationRequestItemsByQuery() is the basic search method
and returns a list of RegistrationRequestItems . A more advanced
search may be performed with getRegistrationRequestItemsBySearch()
.It accepts a RegistrationRequestItemSearch in addition to the
query for the purpose of specifying additional options affecting the
entire search, such as ordering.
getRegistrationRequestItemsBySearch() returns a
RegistrationRequestItemSearchResults that can be used to access the
resulting RegistrationRequestItemList or be used to perform a
search within the result set through RegistrationRequestItemSearch
.
This session defines views that offer differing behaviors for searching.
- federated course catalog view: searches include registration request items in course catalogs of which this course catalog is an ancestor in the course catalog hierarchy
- isolated course catalog view: searches are restricted to registration request items in this course catalog
Registration Request Items may have a query record indicated by their
respective record types. The quer y record is accessed via the
RegistrationRequestItemQuery .
-
Method Summary
Modifier and TypeMethodDescriptiongetRegistrationRequestItemQueryFromInspector(RegistrationRequestItemQueryInspector registrationRequestItemQueryInspector) Gets a registration request item query from an inspector.getRegistrationRequestItemsBySearch(RegistrationRequestItemQuery registrationRequestItemQuery, RegistrationRequestItemSearch registrationRequestItemSearch) Gets the search results matching the given search query using the given search.Gets a registration request item search.Gets a registration request item 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 RegistrationRequestItemQuerySession
canSearchRegistrationRequestItems, getCourseCatalog, getCourseCatalogId, getRegistrationRequestItemQuery, getRegistrationRequestItemsByQuery, useFederatedCourseCatalogView, useIsolatedCourseCatalogViewModifier and TypeMethodDescriptionbooleanTests if this user can performRegistrationRequestItem lookups.Gets theCourseCatalogassociated with this session.Gets theCourseCatalogIdassociated with this session.Gets a registration request item query.getRegistrationRequestItemsByQuery(RegistrationRequestItemQuery registrationRequestItemQuery) Gets a list ofRegistrationRequestItemsmatching the given search.voidFederates the view for methods in this session.voidIsolates the view for methods in this session.
-
Method Details
-
getRegistrationRequestItemSearch
RegistrationRequestItemSearch getRegistrationRequestItemSearch()Gets a registration request item search.- Returns:
- the registration request item search
- Compliance:
mandatory- This method must be implemented.
-
getRegistrationRequestItemSearchOrder
RegistrationRequestItemSearchOrder getRegistrationRequestItemSearchOrder()Gets a registration request item search order. TheRegistrationRequestItemSearchOrderis supplied to aRegistrationRequestItemSearchto specify the ordering of results.- Returns:
- the registration request item search order
- Compliance:
mandatory- This method must be implemented.
-
getRegistrationRequestItemsBySearch
RegistrationRequestItemSearchResults getRegistrationRequestItemsBySearch(RegistrationRequestItemQuery registrationRequestItemQuery, RegistrationRequestItemSearch registrationRequestItemSearch) throws OperationFailedException, PermissionDeniedException Gets the search results matching the given search query using the given search.- Parameters:
registrationRequestItemQuery- the registration request item queryregistrationRequestItemSearch- the registration request item search- Returns:
- the returned search results
- Throws:
NullArgumentException-registrationRequestItemQueryorregistrationRequestItemSearchisnullOperationFailedException- unable to complete requestPermissionDeniedException- authorization failureUnsupportedException-registrationRequestItemQueryorregistrationRequestItemSearchis not of this service- Compliance:
mandatory- This method must be implemented.
-
getRegistrationRequestItemQueryFromInspector
RegistrationRequestItemQuery getRegistrationRequestItemQueryFromInspector(RegistrationRequestItemQueryInspector registrationRequestItemQueryInspector) Gets a registration request item query from an inspector. The inspector is available from aRegistrationRequestItemSearchResults.- Parameters:
registrationRequestItemQueryInspector- a registration request item query inspector- Returns:
- the registration request item query
- Throws:
NullArgumentException-registrationRequestItemQueryInspectorisnullUnsupportedException-registrationRequestItemQueryInspectoris not of this service- Compliance:
mandatory- This method must be implemented.
-