OSID - osid.bidding.MyAuctionNotificationSession Service Interface Definition

Interface	osid.bidding.MyAuctionNotificationSession
Implements	`osid.OsidSession`
Description	This session defines methods to receive notifications on changes to an auction in progress.
Method	getAuctionHouseId
Description	Gets the `AuctionHouse` `Id` associated with this session.
Return	`osid.id.Id`		the `AuctionHouse Id` associated with this session
Compliance	`mandatory`		This method must be implemented.
Method	getAuctionHouse
Description	Gets the `AuctionHouse` associated with this session.
Return	`osid.bidding.AuctionHouse`		the auction house
Errors	OPERATION_FAILED		unable to complete request
Errors	PERMISSION_DENIED		authorization failure
Compliance	`mandatory`		This method must be implemented.
Method	canRegisterForMyAuctionNotifications
Description	Tests if this user can register for `Auction` notifications. 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 a `PERMISSION_DENIED.` This is intended as a hint to an application that may opt not to offer notification operations.
Return	`boolean`		`false` if notification methods are not authorized, `true` otherwise
Compliance	`mandatory`		This method must be implemented.
Method	reliableMyAuctionNotifications
Description	Reliable notifications are desired. In reliable mode, notifications are to be acknowledged using `acknowledgeMyAuctionNotification()` .
Compliance	`mandatory`		This method is must be implemented.
Method	unreliableMyAuctionNotifications
Description	Unreliable notifications are desired. In unreliable mode, notifications do not need to be acknowledged.
Compliance	`mandatory`		This method is must be implemented.
Method	acknowledgeMyAuctionNotification
Description	Acknowledge an auction notification.
Parameters	`osid.id.Id`	`notificationId`	the `Id` of the notification
Errors	OPERATION_FAILED		unable to complete request
Errors	PERMISSION_DENIED		authorization failure
Compliance	`mandatory`		This method must be implemented.
Method	registerForAuctionStart
Description	Register for a notification of the start of the auction. `MyAuctionReceiver.startAuctions()` is invoked when a the auction begins.
Errors	OPERATION_FAILED		unable to complete request
Errors	PERMISSION_DENIED		authorization failure
Compliance	`mandatory`		This method must be implemented.
Method	registerForNewBids
Description	Register for notifications of new bids. `MyAuctionReceiver.newBids()` is invoked when a new `Bid` is made in this auction.
Errors	OPERATION_FAILED		unable to complete request
Errors	PERMISSION_DENIED		authorization failure
Compliance	`mandatory`		This method must be implemented.
Method	registerForOutBids
Description	Register for notifications of bids that outbid that of the authenticated bidder. `MyAuctionReceiver.outBids()` is invoked when a new `Bid` is made in this auction.
Errors	OPERATION_FAILED		unable to complete request
Errors	PERMISSION_DENIED		authorization failure
Compliance	`mandatory`		This method must be implemented.
Method	registerForRequireBid
Description	Register for notifications of bids that are required at this time for the authenticated bidder. `MyAuctionReceiver.requireBid()` is invoked when it is time to ante up.
Errors	OPERATION_FAILED		unable to complete request
Errors	PERMISSION_DENIED		authorization failure
Compliance	`mandatory`		This method must be implemented.
Method	registerForAuctionEnd
Description	Register for a notification of the end of the auction. `MyAuctionReceiver.endAuctions()` is invoked when a the auction ends.
Errors	OPERATION_FAILED		unable to complete request
Errors	PERMISSION_DENIED		authorization failure
Compliance	`mandatory`		This method must be implemented.