Interface AuctionProcessorEnablerQuerySession
- All Superinterfaces:
AutoCloseable, Closeable, OsidSession, OsidSession
- All Known Subinterfaces:
AuctionProcessorEnablerSearchSession
This session provides methods for searching among
AuctionProcessorEnabler objects. The search query is constructed using
the AuctionProcessorEnablerQuery .
This session defines views that offer differing behaviors for searching.
- federated auction house view: searches include auction processor enablers in auction houses of which this auction house is an ancestor in the auction house hierarchy
- isolated auction house view: searches are restricted to auction processor enablers in this auction house
Auction processor enablers may have a query record indicated by their
respective record types. The query record is accessed via the
AuctionProcessorEnablerQuery .
-
Method Summary
Modifier and TypeMethodDescriptionbooleanTests if this user can performAuctionProcessorEnablerlookups.Gets theAuctionHouseassociated with this session.Gets theAuctionHouseIdassociated with this session.Gets an auction processor enabler query.getAuctionProcessorEnablersByQuery(AuctionProcessorEnablerQuery auctionProcessorEnablerQuery) Gets a list ofAuctionProcessorEnablersmatching the given search.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
-
getAuctionHouseId
Id getAuctionHouseId()Gets theAuctionHouseIdassociated with this session.- Returns:
- the
AuctionHouse Idassociated with this session - Compliance:
mandatory- This method must be implemented.
-
getAuctionHouse
Gets theAuctionHouseassociated with this session.- Returns:
- the auction house
- Throws:
OperationFailedException- unable to complete requestPermissionDeniedException- authorization failure- Compliance:
mandatory- This method must be implemented.
-
canSearchAuctionProcessorEnablers
boolean canSearchAuctionProcessorEnablers()Tests if this user can performAuctionProcessorEnablerlookups. A return of true does not guarantee successful authorization. A return of false indicates that it is known all methods in this session will result in aPERMISSION_DENIED. This is intended as a hint to an application that may not offer lookup operations to unauthorized users.- Returns:
falseif search methods are not authorized,trueotherwise- Compliance:
mandatory- This method must be implemented.
-
useFederatedAuctionHouseView
void useFederatedAuctionHouseView()Federates the view for methods in this session. A federated view will include auction processor enablers in auction houses which are children of this broker in the auction house hierarchy.- Compliance:
mandatory- This method is must be implemented.
-
useIsolatedAuctionHouseView
void useIsolatedAuctionHouseView()Isolates the view for methods in this session. An isolated view restricts lookups to this auction house only.- Compliance:
mandatory- This method is must be implemented.
-
getAuctionProcessorEnablerQuery
AuctionProcessorEnablerQuery getAuctionProcessorEnablerQuery()Gets an auction processor enabler query.- Returns:
- the auction processor enabler query
- Compliance:
mandatory- This method must be implemented.
-
getAuctionProcessorEnablersByQuery
AuctionProcessorEnablerList getAuctionProcessorEnablersByQuery(AuctionProcessorEnablerQuery auctionProcessorEnablerQuery) throws OperationFailedException, PermissionDeniedException Gets a list ofAuctionProcessorEnablersmatching the given search.- Parameters:
auctionProcessorEnablerQuery- the auction processor enabler query- Returns:
- the returned
AuctionProcessorEnablerList - Throws:
NullArgumentException-auctionProcessorEnablerQueryisnullOperationFailedException- unable to complete requestPermissionDeniedException- authorization failureUnsupportedException-auctionProcessorEnablerQueryis not of this service- Compliance:
mandatory- This method must be implemented.
-