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

Class AmqpSendHandler

java.lang.Object

org.apache.qpid.proton.engine.BaseHandler

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

All Implemented Interfaces:

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

public class AmqpSendHandler
extends org.apache.qpid.proton.engine.BaseHandler

Instance of the QPID-Proton-J BaseHandler class to override the events what are needed to handle the send operation Contains and sets connection parameters (path, port, endpoint) Maintains the layers of AMQP protocol (Link, Session, Connection, Transport) Creates and sets SASL authentication for transport

Field Summary

Fields

Modifier and Type	Field and Description
static String	DEVICE_PATH_FORMAT
static String	ENDPOINT
protected String	hostName
protected IotHubServiceClientProtocol	iotHubServiceClientProtocol
protected String	sasToken
static String	SEND_PORT_AMQPS
static String	SEND_PORT_AMQPS_WS
static String	SEND_TAG
protected String	userName
static String	WEBSOCKET_PATH
static String	WEBSOCKET_SUB_PROTOCOL
protected String	webSocketHostName

Constructor Summary

Constructors

Constructor and Description
AmqpSendHandler(String hostName, String userName, String sasToken, IotHubServiceClientProtocol iotHubServiceClientProtocol) Constructor to set up connection parameters and initialize handshaker for transport

Method Summary

Modifier and Type	Method and Description
void	createProtonMessage(String deviceId, Message message) Create Proton message from deviceId and content string
void	onConnectionBound(org.apache.qpid.proton.engine.Event event) Event handler for the connection bound event
void	onConnectionInit(org.apache.qpid.proton.engine.Event event) Event handler for the connection init event
void	onDelivery(org.apache.qpid.proton.engine.Event event)
void	onLinkFlow(org.apache.qpid.proton.engine.Event event) Event handler for the link flow event
void	onLinkInit(org.apache.qpid.proton.engine.Event event) Event handler for the link init event
void	onTransportError(org.apache.qpid.proton.engine.Event event) Event handler for the transport error event.
void	sendComplete()

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

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

Methods inherited from class java.lang.Object

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

Field Detail

SEND_TAG

public static final String SEND_TAG

See Also:

Constant Field Values

SEND_PORT_AMQPS

public static final String SEND_PORT_AMQPS

See Also:

Constant Field Values

SEND_PORT_AMQPS_WS

public static final String SEND_PORT_AMQPS_WS

See Also:

Constant Field Values

ENDPOINT

public static final String ENDPOINT

See Also:

Constant Field Values

DEVICE_PATH_FORMAT

public static final String DEVICE_PATH_FORMAT

See Also:

Constant Field Values

WEBSOCKET_PATH

public static final String WEBSOCKET_PATH

See Also:

Constant Field Values

WEBSOCKET_SUB_PROTOCOL

public static final String WEBSOCKET_SUB_PROTOCOL

See Also:

Constant Field Values

hostName

protected final String hostName

userName

protected final String userName

sasToken

protected final String sasToken

iotHubServiceClientProtocol

protected final IotHubServiceClientProtocol iotHubServiceClientProtocol

webSocketHostName

protected final String webSocketHostName

Constructor Detail

AmqpSendHandler

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

Constructor to set up connection parameters and initialize handshaker for transport

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

createProtonMessage

public void createProtonMessage(String deviceId,
                                Message message)

Create Proton message from deviceId and content string

Parameters:

deviceId - The device name string

message - The message to be sent

onConnectionBound

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

Event handler for the connection bound event

Specified by:

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

Overrides:

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

Parameters:

event - The proton event object

onConnectionInit

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

Event handler for the connection init event

Specified by:

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

Overrides:

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

Parameters:

event - The proton event object

onTransportError

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

Event handler for the transport error event. This triggers reconnection attempts until successful.

Specified by:

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

Overrides:

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

Parameters:

event - The Proton Event object.

onLinkInit

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

Event handler for the link init event

Specified by:

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

Overrides:

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

Parameters:

event - The proton event object

onLinkFlow

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

Event handler for the link flow event

Specified by:

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

Overrides:

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

Parameters:

event - The proton event object

onDelivery

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

Specified by:

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

Overrides:

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

sendComplete

public void sendComplete()
                  throws IotHubException,
                         IOException

Throws:

IotHubException

IOException