Interface RegistrationRequestSearchSession
- All Superinterfaces:
AutoCloseable, Closeable, OsidSession, OsidSession, RegistrationRequestQuerySession
This session provides methods for searching among
RegistrationRequests . The search query is constructed using the
RegistrationRequestQuery .
getRegistrationRequestsByQuery() is the basic search method and
returns a list of RegistrationRequests . A more advanced search
may be performed with getRegistrationRequestsBySearch() . It
accepts a RegistrationRequestSearch in addition to the query for
the purpose of specifying additional options affecting the entire search,
such as ordering. getRegistrationRequestsBySearch() returns a
RegistrationRequestSearchResults that can be used to access the
resulting RegistrationRequestList or be used to perform a search
within the result set through RegistrationRequestSearch .
This session defines views that offer differing behaviors for searching.
- federated course catalog view: searches include registration requests 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 requests in this course catalog
Registration Requests may have a query record indicated by their
respective record types. The query record is acc essed via the
RegistrationRequestQuery .
-
Method Summary
Modifier and TypeMethodDescriptiongetRegistrationRequestQueryFromInspector(RegistrationRequestQueryInspector registrationRequestQueryInspector) Gets a registration request query from an inspector.getRegistrationRequestsBySearch(RegistrationRequestQuery registrationRequestQuery, RegistrationRequestSearch registrationRequestSearch) Gets the search results matching the given search query using the given search.Gets a registration request search.Gets a registration request 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 RegistrationRequestQuerySession
canSearchRegistrationRequests, getCourseCatalog, getCourseCatalogId, getRegistrationRequestQuery, getRegistrationRequestsByQuery, useFederatedCourseCatalogView, useIsolatedCourseCatalogViewModifier and TypeMethodDescriptionbooleanTests if this user can performRegistrationRequest lookups.Gets theCourseCatalogassociated with this session.Gets theCourseCatalogIdassociated with this session.Gets a registration request query.getRegistrationRequestsByQuery(RegistrationRequestQuery registrationRequestQuery) Gets a list ofRegistrationRequestsmatching the given search.voidFederates the view for methods in this session.voidIsolates the view for methods in this session.
-
Method Details
-
getRegistrationRequestSearch
RegistrationRequestSearch getRegistrationRequestSearch()Gets a registration request search.- Returns:
- the registration request search
- Compliance:
mandatory- This method must be implemented.
-
getRegistrationRequestSearchOrder
RegistrationRequestSearchOrder getRegistrationRequestSearchOrder()Gets a registration request search order. TheRegistrationRequestSearchOrderis supplied to aRegistrationRequestSearchto specify the ordering of results.- Returns:
- the registration request search order
- Compliance:
mandatory- This method must be implemented.
-
getRegistrationRequestsBySearch
RegistrationRequestSearchResults getRegistrationRequestsBySearch(RegistrationRequestQuery registrationRequestQuery, RegistrationRequestSearch registrationRequestSearch) throws OperationFailedException, PermissionDeniedException Gets the search results matching the given search query using the given search.- Parameters:
registrationRequestQuery- the registration request queryregistrationRequestSearch- the registration request search- Returns:
- the returned search results
- Throws:
NullArgumentException-registrationRequestQueryorregistrationRequestSearchisnullOperationFailedException- unable to complete requestPermissionDeniedException- authorization failureUnsupportedException-registrationRequestQueryorregistrationRequestSearchis not of this service- Compliance:
mandatory- This method must be implemented.
-
getRegistrationRequestQueryFromInspector
RegistrationRequestQuery getRegistrationRequestQueryFromInspector(RegistrationRequestQueryInspector registrationRequestQueryInspector) Gets a registration request query from an inspector. The inspector is available from aRegistrationRequestSearchResults.- Parameters:
registrationRequestQueryInspector- a registration request query inspector- Returns:
- the registration request query
- Throws:
NullArgumentException-registrationRequestQueryInspectorisnullUnsupportedException-registrationRequestQueryInspectoris not of this service- Compliance:
mandatory- This method must be implemented.
-