Interface CommissionEnablerSearchSession
- All Superinterfaces:
AutoCloseable, Closeable, CommissionEnablerQuerySession, OsidSession, OsidSession
This session provides methods for searching among
CommissionEnabler objects. The search query is constructed using the
CommissionEnableryQuery .
getCommissionEnablersByQuery() is the basic search method and
returns a list of CommissionEnablers . A more advanced search may
be performed with getCommissionEnablersBySearch() . It accepts a
CommissionEnablerSearch in addition to the query for the purpose
of specifying additional options affecting the entire search, such as
resourcing. getCommissionEnablersBySearch() returns a
CommissionEnablerSearchResults that can be used to access the resulting
CommissionEnablerList or be used to perform a search within the
result set through CommissionEnablerSearch .
This session defines views that offer differing behaviors for searching.
- federated foundry view: searches include commission enabler in foundries of which this foundry is an ancestor in the foundry hierarchy
- isolated foundry view: searches are restricted to commission enabler in this foundry
CommissionEnablers may have a commission enabler query record
indicated by their respective record types. The commission enabler query
record is accessed via the CommissionEnablerQuery .-
Method Summary
Modifier and TypeMethodDescriptiongetCommissionEnablerQueryFromInspector(CommissionEnablerQueryInspector ccommissionEnablerQueryInspector) Gets a commission enabler query from an inspector.getCommissionEnablersBySearch(CommissionEnablerQuery commissionEnablerQuery, CommissionEnablerSearch commissionEnablerSearch) Gets the search results matching the given search query using the given search.Gets a commission enabler search.Gets a commission enabler search order.Methods inherited from interface CommissionEnablerQuerySession
canSearchCommissionEnablers, getCommissionEnablerQuery, getCommissionEnablersByQuery, getFoundry, getFoundryId, useFederatedFoundryView, useIsolatedFoundryViewModifier and TypeMethodDescriptionbooleanTests if this user can performCommissionEnablerlookups.Gets a commission enabler query.getCommissionEnablersByQuery(CommissionEnablerQuery commissionEnablerQuery) Gets a list ofCommissionEnablersmatching the given commission enabler query.Gets theFoundryassociated with this session.Gets theFoundryIdassociated with this session.voidFederates the view for methods in this session.voidIsolates the view for methods in this session.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.
-
Method Details
-
getCommissionEnablerSearch
CommissionEnablerSearch getCommissionEnablerSearch()Gets a commission enabler search.- Returns:
- the commission enabler search
- Compliance:
mandatory- This method must be implemented.
-
getCommissionEnablerSearchOrder
CommissionEnablerSearchOrder getCommissionEnablerSearchOrder()Gets a commission enabler search order. TheCommissionEnablerSearchOrderis supplied to aCommissionEnablerSearchto specify the ordering of results.- Returns:
- the commission enabler search order
- Compliance:
mandatory- This method must be implemented.
-
getCommissionEnablersBySearch
CommissionEnablerSearchResults getCommissionEnablersBySearch(CommissionEnablerQuery commissionEnablerQuery, CommissionEnablerSearch commissionEnablerSearch) throws OperationFailedException, PermissionDeniedException Gets the search results matching the given search query using the given search.- Parameters:
commissionEnablerQuery- the commission enabler querycommissionEnablerSearch- the commission enabler search- Returns:
- the returned search results
- Throws:
NullArgumentException-commissionEnablerQueryorcommissionEnablerSearchisnullOperationFailedException- unable to complete requestPermissionDeniedException- authorization failureUnsupportedException-commissionEnablerQueryorcommissionEnablerSearchis not of this service- Compliance:
mandatory- This method must be implemented.
-
getCommissionEnablerQueryFromInspector
CommissionEnablerQuery getCommissionEnablerQueryFromInspector(CommissionEnablerQueryInspector ccommissionEnablerQueryInspector) Gets a commission enabler query from an inspector. The inspector is available from aCommissionEnablerSearchResults.- Parameters:
ccommissionEnablerQueryInspector- a commission enabler query inspector- Returns:
- the commission enabler query
- Throws:
NullArgumentException-commissionEnablerQueryInspectorisnullUnsupportedException-commissionEnablerQueryInspectoris not of this service- Compliance:
mandatory- This method must be implemented.
-