com.microsoft.azure.sdk.iot.service.transport.amqps

Class AmqpReceive

java.lang.Object

org.apache.qpid.proton.engine.BaseHandler

com.microsoft.azure.sdk.iot.service.transport.amqps.AmqpReceive

All Implemented Interfaces:

AmqpFeedbackReceivedEvent, org.apache.qpid.proton.engine.CoreHandler, org.apache.qpid.proton.engine.Handler

public class AmqpReceive
extends org.apache.qpid.proton.engine.BaseHandler
implements AmqpFeedbackReceivedEvent

Instance of the QPID-Proton-J BaseHandler class overriding the events what are needed to handle high level open, close methods and feedback received event.

Constructor Summary

Constructors

Constructor and Description
AmqpReceive(String hostName, String userName, String sasToken, IotHubServiceClientProtocol iotHubServiceClientProtocol) Constructor to set up connection parameters

Method Summary

Modifier and Type	Method and Description
void	close() Invalidate AmqpsReceiveHandler member variable
void	onFeedbackReceived(String feedbackJson) Handle on feedback received Proton event Parse received json and save result to a member variable Release semaphore for wait function
void	onReactorInit(org.apache.qpid.proton.engine.Event event) Event handler for the reactor init event
void	open() Create AmqpsReceiveHandler and store it in a member variable
FeedbackBatch	receive(long timeoutMs) Synchronized call to receive feedback batch Hide the event based receiving mechanism from the user API

Methods inherited from class org.apache.qpid.proton.engine.BaseHandler

add, children, getHandler, getHandler, handle, onConnectionBound, onConnectionFinal, onConnectionInit, onConnectionLocalClose, onConnectionLocalOpen, onConnectionRemoteClose, onConnectionRemoteOpen, onConnectionUnbound, onDelivery, onLinkFinal, onLinkFlow, onLinkInit, onLinkLocalClose, onLinkLocalDetach, onLinkLocalOpen, onLinkRemoteClose, onLinkRemoteDetach, onLinkRemoteOpen, onReactorFinal, onReactorQuiesced, onSelectableError, onSelectableExpired, onSelectableFinal, onSelectableInit, onSelectableReadable, onSelectableUpdated, onSelectableWritable, onSessionFinal, onSessionInit, onSessionLocalClose, onSessionLocalOpen, onSessionRemoteClose, onSessionRemoteOpen, onTimerTask, onTransport, onTransportClosed, onTransportError, onTransportHeadClosed, onTransportTailClosed, onUnhandled, setHandler, setHandler

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

AmqpReceive

public AmqpReceive(String hostName,
                   String userName,
                   String sasToken,
                   IotHubServiceClientProtocol iotHubServiceClientProtocol)

Constructor to set up connection parameters

Parameters:

hostName - The address string of the service (example: AAA.BBB.CCC)

userName - The username string to use SASL authentication (example: user@sas.service)

sasToken - The SAS token string

iotHubServiceClientProtocol - protocol to use

Method Detail

onReactorInit

public void onReactorInit(org.apache.qpid.proton.engine.Event event)

Event handler for the reactor init event

Specified by:

onReactorInit in interface org.apache.qpid.proton.engine.CoreHandler

Overrides:

onReactorInit in class org.apache.qpid.proton.engine.BaseHandler

Parameters:

event - The proton event object

open

public void open()

Create AmqpsReceiveHandler and store it in a member variable

close

public void close()

Invalidate AmqpsReceiveHandler member variable

receive

public FeedbackBatch receive(long timeoutMs)
                      throws IOException,
                             InterruptedException

Synchronized call to receive feedback batch Hide the event based receiving mechanism from the user API

Parameters:

timeoutMs - The timeout in milliseconds to wait for the feedback

Returns:

The received feedback batch

Throws:

IOException - This exception is thrown if the input AmqpReceive object is null

InterruptedException - This exception is thrown if the receive process has been interrupted

onFeedbackReceived

public void onFeedbackReceived(String feedbackJson)

Handle on feedback received Proton event Parse received json and save result to a member variable Release semaphore for wait function

Specified by:

onFeedbackReceived in interface AmqpFeedbackReceivedEvent

Parameters:

feedbackJson - Received Json string to process