com.microsoft.azure.sdk.iot.deps.transport.amqp

Class AmqpsConnection

java.lang.Object

org.apache.qpid.proton.engine.BaseHandler

com.microsoft.azure.sdk.iot.deps.transport.amqp.AmqpsConnection

All Implemented Interfaces:

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

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

Constructor Summary

Constructors

Constructor and Description
AmqpsConnection(String hostName, AmqpDeviceOperations amqpDeviceOperations, SSLContext sslContext, SaslHandler saslHandler, boolean useWebSockets) Constructor for the Amqp library

Method Summary

Modifier and Type	Method and Description
void	close() Closes the connection
boolean	isConnected() Returns the status of the connection
void	onConnectionBound(org.apache.qpid.proton.engine.Event event)
void	onConnectionInit(org.apache.qpid.proton.engine.Event event) Event handler for the connection init event
void	onConnectionUnbound(org.apache.qpid.proton.engine.Event event)
void	onDelivery(org.apache.qpid.proton.engine.Event event) Event handler for the delivery 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	onLinkRemoteClose(org.apache.qpid.proton.engine.Event event) Event handler for the link remote close event.
void	onLinkRemoteOpen(org.apache.qpid.proton.engine.Event event) Event handler for the link remote open event.
void	onReactorFinal(org.apache.qpid.proton.engine.Event event)
void	onReactorInit(org.apache.qpid.proton.engine.Event event) Event handler for reactor init event.
void	onTransportError(org.apache.qpid.proton.engine.Event event) Event handler for the transport error event.
void	onTransportHeadClosed(org.apache.qpid.proton.engine.Event event)
void	open() Opens the connection.
void	openAmqpAsync() Spawns another thread that attempts to open the AMQP connection.
boolean	sendAmqpMessage(AmqpMessage message) Send message to the Amqp Endpoint
void	setListener(AmqpListener listener) Sets the listener for this connection.

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

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

Methods inherited from class java.lang.Object

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

Constructor Detail

AmqpsConnection

public AmqpsConnection(String hostName,
                       AmqpDeviceOperations amqpDeviceOperations,
                       SSLContext sslContext,
                       SaslHandler saslHandler,
                       boolean useWebSockets)
                throws IOException

Constructor for the Amqp library

Parameters:

hostName - Name of the AMQP Endpoint

amqpDeviceOperations - Object holding details of the links used in this connection

sslContext - SSL Context to be set over TLS.

saslHandler - The sasl frame handler. This may be null if no sasl frames will be exchanged (When using x509 authentication for example)

useWebSockets - WebSockets to be used or disabled.

Throws:

IOException - This exception is thrown if for any reason constructor cannot succeed.

Method Detail

setListener

public void setListener(AmqpListener listener)

Sets the listener for this connection.

Parameters:

listener - Listener to be used for this connection.

isConnected

public boolean isConnected()
                    throws Exception

Returns the status of the connection

Returns:

status of the connection

Throws:

Exception

open

public void open()
          throws IOException

Opens the connection.

Throws:

IOException - If connection could not be opened.

openAmqpAsync

public void openAmqpAsync()

Spawns another thread that attempts to open the AMQP connection. Use isConnected() to check when this operation has succeeded. Do not attempt to send messages before this connection has been opened

close

public void close()
           throws IOException

Closes the connection

Throws:

IOException - If connection could not be closed.

onReactorInit

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

Event handler for 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 - Proton Event object

onReactorFinal

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

Specified by:

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

Overrides:

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

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.

onConnectionBound

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

Specified by:

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

Overrides:

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

onConnectionUnbound

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

Specified by:

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

Overrides:

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

onLinkInit

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

Event handler for the link init event. Sets the proper target address on the link.

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.

onLinkRemoteOpen

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

Event handler for the link remote open event. This signifies that the Reactor is ready, so we set the connection to OPEN.

Specified by:

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

Overrides:

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

Parameters:

event - The Proton Event object.

sendAmqpMessage

public boolean sendAmqpMessage(AmqpMessage message)
                        throws Exception

Send message to the Amqp Endpoint

Parameters:

message - Message to be sent

Returns:

true if message was sent successfully, false other wise.

Throws:

IOException - If message could not be sent.

Exception

onDelivery

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

Event handler for the delivery event. This method handles both sending and receiving a message.

Specified by:

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

Overrides:

onDelivery 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. Handles sending a single message.

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.

onLinkRemoteClose

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

Event handler for the link remote close event. This triggers reconnection attempts until successful. Both sender and receiver links closing trigger this event, so we only handle one of them, since the other is redundant.

Specified by:

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

Overrides:

onLinkRemoteClose 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.

onTransportHeadClosed

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

Specified by:

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

Overrides:

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