Proton Receiver link implementation which manages the receipt of new deliveries and credit associated with the link. Delivery outcomes and settlement states can also be managed from the receiver link. More...

Inheritance diagram for Apache.Qpid.Proton.Engine.Implementation.ProtonReceiver:

Public Member Functions
	ProtonReceiver (ProtonSession session, string name, ProtonLinkCreditState creditState)

IReceiver	AddCredit (uint amount)
	Adds the given amount of credit to the receiver's already existing credit if any.

bool	Drain ()
	Initiate a drain of all remaining credit of this link, the remote sender will then either send enough deliveries to fulfill the drain request or report that it cannot and all remaining link credit will be consumed.

bool	Drain (uint credits)
	Initiate a drain of the given credit from this this receiver} link. If the credit given is greater than the current link credit the current credit is increased, however if the amount of credit given is less that the current amount of link credit an exception is thrown.

IReceiver	Settle (Predicate< IIncomingDelivery > filter)
	For each unsettled outgoing delivery that is pending in the receiver apply the given predicate and if it matches then settle the delivery.

IReceiver	Disposition (Predicate< IIncomingDelivery > filter, IDeliveryState state, bool settle)
	For each unsettled outgoing delivery that is pending in the receiver apply the given predicate and if it matches then apply the given delivery state and settled value to it.

IReceiver	DeliveryAbortedHandler (Action< IIncomingDelivery > handler)
	Handler for aborted deliveries that is called for each aborted in-progress delivery. This handler is an optional convenience handler that supplements the standard delivery read event handler in cases where the users wishes to break out the processing of inbound delivery data from abort processing. If this handler is not set the receiver will call the registered delivery read handler if one is set.

IReceiver	DeliveryReadHandler (Action< IIncomingDelivery > handler)
	Handler for incoming deliveries that is called for each incoming transfer frame that comprises either one complete delivery or a chunk of a split framed transfer. The handler should check that the delivery being read is partial or not and act accordingly, as partial deliveries expect additional updates as more frames comprising that delivery arrive or the remote aborts the transfer.

IReceiver	DeliveryStateUpdatedHandler (Action< IIncomingDelivery > handler)
	Handler for updates to the remote state of incoming deliveries that have previously been received. Remote state updates for an previously received delivery can happen when the remote settles a complete delivery or otherwise modifies the delivery outcome and the user needs to act on those changes such as a spontaneous update to the delivery state.

Public Member Functions inherited from Apache.Qpid.Proton.Engine.Implementation.ProtonLink< IReceiver >
override T	Open ()
	Open the end point locally, sending the Open performative immediately if possible or holding it until SASL negotiations or the AMQP header exchange and other required performative exchanges has completed. The endpoint will signal any registered handler of the remote opening the endpoint once the remote performative that signals open completion arrives.

T	Detach ()
	Detaches the local end of the link if not already closed or detached.

override T	Close ()
	Close the end point locally and send the closing performative immediately if possible or holds it until the Connection / Engine state allows it. If the engine encounters an error writing the performative or the engine is in a failed state from a previous error then this method will throw an exception. If the engine has been shutdown then this method will close out the local end of the endpoint and clean up any local resources before returning normally.

T	DetachHandler (Action< T > handler)
	Sets a EventHandler for when an AMQP detach frame is received from the remote peer. This is a convenience event that supplements the normal link closed event point if set. If no detached event handler is set the endpoint will route the detached event to the closed event handler if set and allow it to process the event in one location.

T	LocalDetachHandler (Action< T > handler)
	Sets a Action for when an this endpoint is closed locally via a call to Close. This is a convenience event that supplements the normal locally closed event point if set. If no local detached event handler is set the endpoint will route the detached event to the local closed event handler if set and allow it to process the event in one location. Typically used by clients for logging or other state update event processing. Clients should not perform any blocking calls within this context. It is an error for the handler to throw an exception and the outcome of doing so is undefined.

T	ParentEndpointClosedHandler (Action< T > handler)
	Sets a Action delegate for when the parent Session or Connection of this link is locally closed. Typically used by clients for logging or other state update event processing. Clients should not perform any blocking calls within this context. It is an error for the handler to throw an exception and the outcome of doing so is undefined.

T	CreditStateUpdateHandler (Action< T > handler)
	Handler for link credit updates that occur after a remote flow frame arrives.

Public Member Functions inherited from Apache.Qpid.Proton.Engine.ILink< T >
T	Detach ()
	Detaches the local end of the link if not already closed or detached.

T	LocalDetachHandler (Action< T > localDetachHandler)
	Sets a Action for when an this endpoint is closed locally via a call to Close. This is a convenience event that supplements the normal locally closed event point if set. If no local detached event handler is set the endpoint will route the detached event to the local closed event handler if set and allow it to process the event in one location. Typically used by clients for logging or other state update event processing. Clients should not perform any blocking calls within this context. It is an error for the handler to throw an exception and the outcome of doing so is undefined.

T	DetachHandler (Action< T > detachHandler)
	Sets a EventHandler for when an AMQP detach frame is received from the remote peer. This is a convenience event that supplements the normal link closed event point if set. If no detached event handler is set the endpoint will route the detached event to the closed event handler if set and allow it to process the event in one location.

T	CreditStateUpdateHandler (Action< T > handler)
	Handler for link credit updates that occur after a remote flow frame arrives.

T	ParentEndpointClosedHandler (Action< T > handler)
	Sets a Action delegate for when the parent Session or Connection of this link is locally closed. Typically used by clients for logging or other state update event processing. Clients should not perform any blocking calls within this context. It is an error for the handler to throw an exception and the outcome of doing so is undefined.

Public Member Functions inherited from Apache.Qpid.Proton.Engine.IEndpoint< T >
T	Open ()
	Open the end point locally, sending the Open performative immediately if possible or holding it until SASL negotiations or the AMQP header exchange and other required performative exchanges has completed. The endpoint will signal any registered handler of the remote opening the endpoint once the remote performative that signals open completion arrives.

T	Close ()
	Close the end point locally and send the closing performative immediately if possible or holds it until the Connection / Engine state allows it. If the engine encounters an error writing the performative or the engine is in a failed state from a previous error then this method will throw an exception. If the engine has been shutdown then this method will close out the local end of the endpoint and clean up any local resources before returning normally.

T	LocalOpenHandler (Action< T > localOpenHandler)
	Sets a Action for when an this endpoint is opened locally via a call to Open. Typically used by clients for logging or other state update event processing. Clients should not perform any blocking calls within this context. It is an error for the handler to throw an exception and the outcome of doing so is undefined. Typically used by clients as servers will typically listen to some parent resource event handler to determine if the remote is initiating a resource open.

T	LocalCloseHandler (Action< T > localCloseHandler)
	Sets a Action for when an this endpoint is closed locally via a call to Close. Typically used by clients for logging or other state update event processing. Clients should not perform any blocking calls within this context. It is an error for the handler to throw an exception and the outcome of doing so is undefined.

T	OpenHandler (Action< T > localOpenHandler)
	Sets a Action for when an AMQP Open frame is received from the remote peer. Used to process remotely initiated Connections. Locally initiated sessions have their own Action invoked instead. This method is typically used by servers to listen for the remote peer to open its endpoint, while a client would listen for the server to open its end of the endpoint once a local open has been performed. Typically used by clients as servers will typically listen to some parent resource event handler to determine if the remote is initiating a resource open.

T	CloseHandler (Action< T > localCloseHandler)
	Sets a EventHandler for when an AMQP closing frame is received from the remote peer.

T	EngineShutdownHandler (Action< IEngine > shutdownHandler)
	Sets an Action that is invoked when the engine that supports this endpoint is shutdown which indicates a desire to terminate all engine operations. Any endpoint that has been both locally and remotely closed will not receive this event as it will no longer be tracked by the parent its parent endpoint. A typical use of this event would be from a locally closed endpoint that is awaiting response from the remote. If this event fires then there will never be a remote response to any pending operations and the client or server instance should react accordingly to clean up any related resources etc.

Protected Member Functions
override void	HandleRemoteAttach (Attach attach)

override void	HandleRemoteDetach (Detach detach)

override void	HandleRemoteFlow (Flow flow)

override void	HandleRemoteDisposition (Disposition disposition, ProtonOutgoingDelivery delivery)

override void	HandleRemoteDisposition (Disposition disposition, ProtonIncomingDelivery delivery)

override void	HandleRemoteTransfer (Transfer transfer, IProtonBuffer payload, out ProtonIncomingDelivery delivery)

override void	HandleDecorateOfOutgoingFlow (Flow flow)

override void	HandleSessionCreditStateUpdates (in ProtonSessionOutgoingWindow window)

override void	HandleSessionCreditStateUpdates (in ProtonSessionIncomingWindow window)

Protected Member Functions inherited from Apache.Qpid.Proton.Engine.Implementation.ProtonLink< IReceiver >
	ProtonLink (ProtonSession session, string name, ProtonLinkCreditState creditState)

void	HandleRemoteAttach (Attach attach)

void	HandleRemoteDetach (Detach detach)

void	HandleRemoteFlow (Flow flow)

void	HandleRemoteDisposition (Disposition disposition, ProtonOutgoingDelivery delivery)

void	HandleRemoteDisposition (Disposition disposition, ProtonIncomingDelivery delivery)

void	HandleRemoteTransfer (Transfer transfer, IProtonBuffer payload, out ProtonIncomingDelivery delivery)

void	HandleDecorateOfOutgoingFlow (Flow flow)

void	HandleSessionCreditStateUpdates (in ProtonSessionOutgoingWindow window)

void	HandleSessionCreditStateUpdates (in ProtonSessionIncomingWindow window)

virtual void	TransitionedToLocallyOpened ()

virtual void	TransitionedToLocallyDetached ()

virtual void	TransitionedToLocallyClosed ()

virtual void	TransitionToRemotelyOpenedState ()

virtual void	TransitionToRemotelyDetached ()

virtual void	TransitionToRemotelyClosed ()

virtual void	TransitionToParentLocallyClosed ()

virtual void	TransitionToParentRemotelyClosed ()

void	CheckLinkOperable (string failurePrefix)

bool	AreDeliveriesStillActive ()

void	CheckNotOpened (string errorMessage)

void	CheckNotClosed (string errorMessage)

void	TrySyncLocalStateWithRemote ()

Properties
override uint	Credit `[get]`
	Reads the credit that is currently available on or assigned to this link object.

override bool	IsDraining `[get]`
	Indicates if the link is draining. For a sender link this indicates that the remote has requested that the sender transmit deliveries up to the currently available credit or indicate that it has no more to send. For a receiver this indicates that the Receiver has requested that the remote sender consume its outstanding credit.

override Role	Role `[get]`
	Reads the role assigned to the local end of the link.

IDeliveryState	DefaultDeliveryState `[get, set]`
	Configures a default DeliveryState to be used if a received delivery is settled/freed without any disposition state having been previously applied.

bool	HasUnsettled `[get]`
	Returns true if the receiver link is tracking any unsettled sent deliveries.

IReadOnlyCollection< IIncomingDelivery >	Unsettled `[get]`
	Retrieves the list of unsettled deliveries sent from this receiver. The deliveries in the enumerator cannot be written to but can have their settled state and disposition updated. Only when this receiver settles on its end are the outgoing delivery instances removed from the unsettled tracking.

Properties inherited from Apache.Qpid.Proton.Engine.Implementation.ProtonLink< IReceiver >
virtual IConnection	Connection `[get]`
	Provides access to the connection that owns this sender endpoint.

virtual ISession	Session `[get]`
	Provides access to the session that owns this sender endpoint.

bool	IsSender `[get]`
	Returns if this link is a sender link.

bool	IsReceiver `[get]`
	Returns if this link is a receiver link.

uint	Handle `[get]`

string	Name `[get]`
	Access the name that was given to the link on creation.

LinkState	LinkState `[get]`
	Gets the current state of the local end of the link object.

LinkState	RemoteState `[get]`
	Gets the current remote link state.

SenderSettleMode	SenderSettleMode `[get, set]`
	Access the sender settle mode. Should only be called during link set-up, i.e. before calling open. If this endpoint is the initiator of the link, this method can be used to set a value other than the default. If this endpoint is not the initiator, this method should be used to set a local value. According to the AMQP spec, the application may choose to accept the sender's suggestion (accessed by calling the remote sender settle mode API) or choose another value. The value has no effect on Proton, but may be useful to the application at a later point. In order to be AMQP compliant the application is responsible for honoring the settlement mode.

SenderSettleMode	RemoteSenderSettleMode `[get]`
	Gets the remote link sender settlement mode, as conveyed from the peer via the Attach frame when attaching the link to the session.

ReceiverSettleMode	ReceiverSettleMode `[get, set]`
	Access the receiver settle mode. Should only be called during link set-up, i.e. before calling open. If this endpoint is the initiator of the link, this method can be used to set a value other than the default.

ReceiverSettleMode	RemoteReceiverSettleMode `[get]`
	Gets the remote link receiver settlement mode, as conveyed from the peer via the Attach frame when attaching the link to the session.

Source	Source `[get, set]`
	Sets the Source value to assign to the local end of this link. Must be called during link setup, i.e. before calling the open method.

Source	RemoteSource `[get]`
	Gets the Source value that was assigned by the remote end of the link.

ITerminus	Terminus `[get, set]`
	Gets the local Target terminus value as a generic terminus instance which the user can then interrogate to determine if it is a Target or a Coordinator instance. When set the value must be one of Target or Coordinator.

Coordinator	Coordinator `[get, set]`
	Attempt to access the local target terminus value as a Coordinator value. When reading if the target terminus is not a Coordinator the result is null. Must be called during link setup, i.e. before calling the open method.

Target	Target `[get, set]`
	Attempt to access the local target terminus value as a Target value. When reading if the target terminus is not a Target the result is null. Must be called during link setup, i.e. before calling the open method.

ITerminus	RemoteTerminus `[get]`
	Get the remote set Terminus either Target or Coordinator that is set once the remote sends its attach frame.

override Symbol[]	OfferedCapabilities `[get, set]`
	Access the capabilities to be offered on to the remote when this endpoint is opened. The offered capabilities value can only be modified prior to a call to open, once the endpoint has been opened locally an error will be thrown if this method is called.

override Symbol[]	DesiredCapabilities `[get, set]`
	Access the capabilities that are desired on to the remote when this endpoint is opened. The desired capabilities value can only be modified prior to a call to open, once the endpoint has been opened locally an error will be thrown if this method is called.

override Symbol[]	RemoteOfferedCapabilities `[get]`
	The capabilities offered by the remote when it opened its end of the endpoint.

override Symbol[]	RemoteDesiredCapabilities `[get]`
	The capabilities desired by the remote when it opened its end of the endpoint.

override IReadOnlyDictionary< Symbol, object >	Properties `[get, set]`
	Access the properties that are conveyed to the remote when this endpoint is opened. The properties value can only be modified prior to a call to open, once the endpoint has been opened locally an error will be thrown if this method is called.

override IReadOnlyDictionary< Symbol, object >	RemoteProperties `[get]`
	The properties sent by the remote when it opened its end of this endpoint.

ulong	MaxMessageSize `[get, set]`
	Sets the local link max message size, to be conveyed to the peer via the Attach frame when attaching the link to the session. Null or 0 means no limit. Must be called during link setup, i.e. before calling the open method.

override bool	IsLocallyOpen `[get]`
	Returns true if the endpoint open was previously called and the close method has not yet been invoked. This only reflects the state on the local end and the user should also check the remote state.

override bool	IsLocallyClosed `[get]`
	Returns true if the endpoint having been previously locally opened is now closed due to a call the the close method. This does not reflect the state of the remote endpoint and that should be checked separately.

override bool	IsRemotelyOpen `[get]`
	Returns true if this endpoint is currently remotely open meaning that the AMQP performative that completes the open phase of this endpoint's lifetime has arrived but the performative that closes it has not.

override bool	IsRemotelyClosed `[get]`
	Returns true if this endpoint is currently remotely closed meaning that the AMQP performative that completes the close phase of this endpoint's lifetime has arrived.

bool	IsLocallyDetached `[get]`
	Returns true if the endpoint having been previously locally opened is now detached due to a call the the detach method. This does not reflect the state of the remote endpoint and that should be checked separately.

bool	IsLocallyClosedOrDetached `[get]`
	Returns true if the endpoint having been previously locally opened is now detached or closed due to a call to either the close method or the detach method. This does not reflect the state of the remote endpoint and that should be checked separately.

bool	IsRemotelyDetached `[get]`
	Returns true if this link is currently remotely detached meaning the state returned from the remote state accessor is equal to detached. A link is remotely detached after an Detach performative has been received from the remote with the close flag equal to false.

bool	IsRemotelyClosedOrDetached `[get]`
	Returns true if this link is currently remotely detached or closed meaning the state returned from the remote state accessor is equal to detached or to closed. A link is remotely detached after an Detach performative has been received from the remote with the close flag equal to false otherwise is considered closed..

uint	Credit `[get]`
	Reads the credit that is currently available on or assigned to this link object.

bool	IsDraining `[get]`
	Indicates if the link is draining. For a sender link this indicates that the remote has requested that the sender transmit deliveries up to the currently available credit or indicate that it has no more to send. For a receiver this indicates that the Receiver has requested that the remote sender consume its outstanding credit.

Role	Role `[get]`
	Reads the role assigned to the local end of the link.

ProtonLinkCreditState	CreditState `[get]`

bool	WasLocalAttachSent `[get]`

bool	WasLocalDetachSent `[get]`

Properties inherited from Apache.Qpid.Proton.Engine.IReceiver
Properties inherited from Apache.Qpid.Proton.Engine.ILink< T >
bool	IsLocallyDetached `[get]`
	Returns true if the endpoint having been previously locally opened is now detached due to a call the the detach method. This does not reflect the state of the remote endpoint and that should be checked separately.

bool	IsLocallyClosedOrDetached `[get]`
	Returns true if the endpoint having been previously locally opened is now detached or closed due to a call to either the close method or the detach method. This does not reflect the state of the remote endpoint and that should be checked separately.

LinkState	LinkState `[get]`
	Gets the current state of the local end of the link object.

bool	IsSender `[get]`
	Returns if this link is a sender link.

bool	IsReceiver `[get]`
	Returns if this link is a receiver link.

IConnection	Connection `[get]`
	Provides access to the connection that owns this sender endpoint.

ISession	Session `[get]`
	Provides access to the session that owns this sender endpoint.

string	Name `[get]`
	Access the name that was given to the link on creation.

SenderSettleMode	SenderSettleMode `[get, set]`
	Access the sender settle mode. Should only be called during link set-up, i.e. before calling open. If this endpoint is the initiator of the link, this method can be used to set a value other than the default. If this endpoint is not the initiator, this method should be used to set a local value. According to the AMQP spec, the application may choose to accept the sender's suggestion (accessed by calling the remote sender settle mode API) or choose another value. The value has no effect on Proton, but may be useful to the application at a later point. In order to be AMQP compliant the application is responsible for honoring the settlement mode.

ReceiverSettleMode	ReceiverSettleMode `[get, set]`
	Access the receiver settle mode. Should only be called during link set-up, i.e. before calling open. If this endpoint is the initiator of the link, this method can be used to set a value other than the default.

Source	Source `[get, set]`
	Sets the Source value to assign to the local end of this link. Must be called during link setup, i.e. before calling the open method.

Source	RemoteSource `[get]`
	Gets the Source value that was assigned by the remote end of the link.

ITerminus	Terminus `[get, set]`
	Gets the local Target terminus value as a generic terminus instance which the user can then interrogate to determine if it is a Target or a Coordinator instance. When set the value must be one of Target or Coordinator.

ITerminus	RemoteTerminus `[get]`
	Get the remote set Terminus either Target or Coordinator that is set once the remote sends its attach frame.

Coordinator	Coordinator `[get, set]`
	Attempt to access the local target terminus value as a Coordinator value. When reading if the target terminus is not a Coordinator the result is null. Must be called during link setup, i.e. before calling the open method.

Target	Target `[get, set]`
	Attempt to access the local target terminus value as a Target value. When reading if the target terminus is not a Target the result is null. Must be called during link setup, i.e. before calling the open method.

ulong	MaxMessageSize `[get, set]`
	Sets the local link max message size, to be conveyed to the peer via the Attach frame when attaching the link to the session. Null or 0 means no limit. Must be called during link setup, i.e. before calling the open method.

bool	IsRemotelyDetached `[get]`
	Returns true if this link is currently remotely detached meaning the state returned from the remote state accessor is equal to detached. A link is remotely detached after an Detach performative has been received from the remote with the close flag equal to false.

bool	IsRemotelyClosedOrDetached `[get]`
	Returns true if this link is currently remotely detached or closed meaning the state returned from the remote state accessor is equal to detached or to closed. A link is remotely detached after an Detach performative has been received from the remote with the close flag equal to false otherwise is considered closed..

SenderSettleMode	RemoteSenderSettleMode `[get]`
	Gets the remote link sender settlement mode, as conveyed from the peer via the Attach frame when attaching the link to the session.

ReceiverSettleMode	RemoteReceiverSettleMode `[get]`
	Gets the remote link receiver settlement mode, as conveyed from the peer via the Attach frame when attaching the link to the session.

LinkState	RemoteState `[get]`
	Gets the current remote link state.

Properties inherited from Apache.Qpid.Proton.Engine.IEndpoint< T >
IEngine	Engine `[get]`
	Provides access to the engine instance that owns the resources of this endpoint and its parent.

IAttachments	Attachments `[get]`
	Access the attachments instance that is associated with this resource where the application can store data relevant to the endpoint for later use.

object	LinkedResource `[get, set]`
	Allows the endpoint to have some user defined resource linked to it which can be used to store application state data or other associated object instances with this endpoint.

ErrorCondition	ErrorCondition `[get, set]`
	Provides access to the error condition that should be applied to the AMQP frame that closes or ends this endpoint when the close method is called be the user. Setting this value after closing the endpoint has no effect.

ErrorCondition	RemoteErrorCondition `[get]`
	If the remote has closed this endpoint and provided an ErrorCondition as part of the closing AMQP performative then this method will return it.

bool	IsLocallyOpen `[get]`
	Returns true if the endpoint open was previously called and the close method has not yet been invoked. This only reflects the state on the local end and the user should also check the remote state.

bool	IsLocallyClosed `[get]`
	Returns true if the endpoint having been previously locally opened is now closed due to a call the the close method. This does not reflect the state of the remote endpoint and that should be checked separately.

bool	IsRemotelyOpen `[get]`
	Returns true if this endpoint is currently remotely open meaning that the AMQP performative that completes the open phase of this endpoint's lifetime has arrived but the performative that closes it has not.

bool	IsRemotelyClosed `[get]`
	Returns true if this endpoint is currently remotely closed meaning that the AMQP performative that completes the close phase of this endpoint's lifetime has arrived.

Symbol[]	OfferedCapabilities `[get, set]`
	Access the capabilities to be offered on to the remote when this endpoint is opened. The offered capabilities value can only be modified prior to a call to open, once the endpoint has been opened locally an error will be thrown if this method is called.

Symbol[]	DesiredCapabilities `[get, set]`
	Access the capabilities that are desired on to the remote when this endpoint is opened. The desired capabilities value can only be modified prior to a call to open, once the endpoint has been opened locally an error will be thrown if this method is called.

IReadOnlyDictionary< Symbol, object >	Properties `[get, set]`
	Access the properties that are conveyed to the remote when this endpoint is opened. The properties value can only be modified prior to a call to open, once the endpoint has been opened locally an error will be thrown if this method is called.

Symbol[]	RemoteOfferedCapabilities `[get]`
	The capabilities offered by the remote when it opened its end of the endpoint.

Symbol[]	RemoteDesiredCapabilities `[get]`
	The capabilities desired by the remote when it opened its end of the endpoint.

IReadOnlyDictionary< Symbol, object >	RemoteProperties `[get]`
	The properties sent by the remote when it opened its end of this endpoint.

Additional Inherited Members
Protected Attributes inherited from Apache.Qpid.Proton.Engine.Implementation.ProtonLink< IReceiver >
readonly ProtonConnection	connection

readonly ProtonSession	session

readonly Attach	localAttach

Attach	remoteAttach

Detailed Description

Proton Receiver link implementation which manages the receipt of new deliveries and credit associated with the link. Delivery outcomes and settlement states can also be managed from the receiver link.

Member Function Documentation

◆ AddCredit()

IReceiver Apache.Qpid.Proton.Engine.Implementation.ProtonReceiver.AddCredit ( uint amount )

inline

Adds the given amount of credit to the receiver's already existing credit if any.

Parameters

amount The amount of credit to add to the existing credit

Returns: This receiver instance

Implements Apache.Qpid.Proton.Engine.IReceiver.

◆ DeliveryAbortedHandler()

IReceiver Apache.Qpid.Proton.Engine.Implementation.ProtonReceiver.DeliveryAbortedHandler ( Action< IIncomingDelivery > handler )

inline

Handler for aborted deliveries that is called for each aborted in-progress delivery. This handler is an optional convenience handler that supplements the standard delivery read event handler in cases where the users wishes to break out the processing of inbound delivery data from abort processing. If this handler is not set the receiver will call the registered delivery read handler if one is set.

Parameters

handler A delegate that will handle this event

Returns: This receiver instance

Implements Apache.Qpid.Proton.Engine.IReceiver.

◆ DeliveryReadHandler()

IReceiver Apache.Qpid.Proton.Engine.Implementation.ProtonReceiver.DeliveryReadHandler ( Action< IIncomingDelivery > handler )

inline

Handler for incoming deliveries that is called for each incoming transfer frame that comprises either one complete delivery or a chunk of a split framed transfer. The handler should check that the delivery being read is partial or not and act accordingly, as partial deliveries expect additional updates as more frames comprising that delivery arrive or the remote aborts the transfer.

Parameters

handler A delegate that will handle this event

Returns: This receiver instance

Implements Apache.Qpid.Proton.Engine.IReceiver.

◆ DeliveryStateUpdatedHandler()

IReceiver Apache.Qpid.Proton.Engine.Implementation.ProtonReceiver.DeliveryStateUpdatedHandler ( Action< IIncomingDelivery > handler )

inline

Handler for updates to the remote state of incoming deliveries that have previously been received. Remote state updates for an previously received delivery can happen when the remote settles a complete delivery or otherwise modifies the delivery outcome and the user needs to act on those changes such as a spontaneous update to the delivery state.

Parameters

handler A delegate that will handle this event

Returns: This receiver instance

Implements Apache.Qpid.Proton.Engine.IReceiver.

◆ Disposition()

IReceiver Apache.Qpid.Proton.Engine.Implementation.ProtonReceiver.Disposition	(	Predicate< IIncomingDelivery >	filter,
		IDeliveryState	state,
		bool	settle
	)

inline

For each unsettled outgoing delivery that is pending in the receiver apply the given predicate and if it matches then apply the given delivery state and settled value to it.

Parameters

filter	The filter predicate that controls when disposition is applied
state	The delivery state to apply when the predicate matches
settle	Should the delivery be settled when the predicate matches.

Returns: This receiver instance

Implements Apache.Qpid.Proton.Engine.IReceiver.

◆ Drain() [1/2]

bool Apache.Qpid.Proton.Engine.Implementation.ProtonReceiver.Drain ( )

inline

Initiate a drain of all remaining credit of this link, the remote sender will then either send enough deliveries to fulfill the drain request or report that it cannot and all remaining link credit will be consumed.

Returns: True if a drain request was started or false if no credit exists

Exceptions

InvalidOperationException If a drain is already in progress

Implements Apache.Qpid.Proton.Engine.IReceiver.

◆ Drain() [2/2]

bool Apache.Qpid.Proton.Engine.Implementation.ProtonReceiver.Drain ( uint credit )

inline

Initiate a drain of the given credit from this this receiver} link. If the credit given is greater than the current link credit the current credit is increased, however if the amount of credit given is less that the current amount of link credit an exception is thrown.

Parameters

credit The amount of credit to drain

Returns: True if a drain request was started or false if no credit exists

Exceptions

InvalidOperationException If a drain is already in progress

Implements Apache.Qpid.Proton.Engine.IReceiver.

◆ Settle()

IReceiver Apache.Qpid.Proton.Engine.Implementation.ProtonReceiver.Settle ( Predicate< IIncomingDelivery > filter )

inline

For each unsettled outgoing delivery that is pending in the receiver apply the given predicate and if it matches then settle the delivery.

Parameters

filter

Returns: This receiver instance

Implements Apache.Qpid.Proton.Engine.IReceiver.

Property Documentation

◆ Credit

override uint Apache.Qpid.Proton.Engine.Implementation.ProtonReceiver.Credit

get

Reads the credit that is currently available on or assigned to this link object.

Implements Apache.Qpid.Proton.Engine.ILink< T >.

◆ DefaultDeliveryState

IDeliveryState Apache.Qpid.Proton.Engine.Implementation.ProtonReceiver.DefaultDeliveryState

getset

Configures a default DeliveryState to be used if a received delivery is settled/freed without any disposition state having been previously applied.

Implements Apache.Qpid.Proton.Engine.IReceiver.

◆ HasUnsettled

bool Apache.Qpid.Proton.Engine.Implementation.ProtonReceiver.HasUnsettled

get

Returns true if the receiver link is tracking any unsettled sent deliveries.

Implements Apache.Qpid.Proton.Engine.IReceiver.

◆ IsDraining

override bool Apache.Qpid.Proton.Engine.Implementation.ProtonReceiver.IsDraining

get

Indicates if the link is draining. For a sender link this indicates that the remote has requested that the sender transmit deliveries up to the currently available credit or indicate that it has no more to send. For a receiver this indicates that the Receiver has requested that the remote sender consume its outstanding credit.

Implements Apache.Qpid.Proton.Engine.ILink< T >.

◆ Role

override Role Apache.Qpid.Proton.Engine.Implementation.ProtonReceiver.Role

get

Reads the role assigned to the local end of the link.

Implements Apache.Qpid.Proton.Engine.ILink< T >.

◆ Unsettled

IReadOnlyCollection<IIncomingDelivery> Apache.Qpid.Proton.Engine.Implementation.ProtonReceiver.Unsettled

get

Retrieves the list of unsettled deliveries sent from this receiver. The deliveries in the enumerator cannot be written to but can have their settled state and disposition updated. Only when this receiver settles on its end are the outgoing delivery instances removed from the unsettled tracking.

Implements Apache.Qpid.Proton.Engine.IReceiver.

The documentation for this class was generated from the following file:

src/Proton/Engine/Implementation/ProtonReceiver.cs

Public Member Functions

Protected Member Functions

Properties

Additional Inherited Members

Detailed Description

Member Function Documentation

◆ AddCredit()

◆ DeliveryAbortedHandler()

◆ DeliveryReadHandler()

◆ DeliveryStateUpdatedHandler()

◆ Disposition()

◆ Drain() [1/2]

◆ Drain() [2/2]

◆ Settle()

Property Documentation

◆ Credit

◆ DefaultDeliveryState

◆ HasUnsettled

◆ IsDraining

◆ Role

◆ Unsettled