org.apache.qpid.jms.transports

Interface Transport

All Known Subinterfaces:

SSLTransport

All Known Implementing Classes:

NettySslTransport, NettyTcpTransport

public interface Transport

Base class for all QpidJMS Transport instances.

Method Summary

Methods

Modifier and Type	Method and Description
io.netty.buffer.ByteBuf	allocateSendBuffer(int size) Request that the Transport provide an output buffer sized for the given value.
void	close() Close the Transport, no additional send operations are accepted.
void	connect() Performs the protocol connect operation for the implemented Transport type such as a TCP socket connection etc.
URI	getRemoteLocation()
TransportListener	getTransportListener() Gets the currently set TransportListener instance
TransportOptions	getTransportOptions()
boolean	isConnected()
void	send(io.netty.buffer.ByteBuf output) Sends a chunk of data over the Transport connection.
void	setTransportListener(TransportListener listener) Sets the Transport Listener instance that will be notified of incoming data or error events.

Method Detail

connect

void connect()
             throws IOException

Performs the protocol connect operation for the implemented Transport type such as a TCP socket connection etc.

Throws:

IOException - if an error occurs while attempting the connect.

isConnected

boolean isConnected()

Returns:

true if transport is connected or false if the connection is down.

close

void close()
           throws IOException

Close the Transport, no additional send operations are accepted.

Throws:

IOException - if an error occurs while closing the connection.

allocateSendBuffer

io.netty.buffer.ByteBuf allocateSendBuffer(int size)
                                           throws IOException

Request that the Transport provide an output buffer sized for the given value.

Parameters:

size - the size necessary to hold the outgoing bytes.

Returns:

a new ByteBuf allocated for sends operations.

Throws:

IOException - if an error occurs while allocating the send buffer.

send

void send(io.netty.buffer.ByteBuf output)
          throws IOException

Sends a chunk of data over the Transport connection.

Parameters:

output - The buffer of data that is to be transmitted.

Throws:

IOException - if an error occurs during the send operation.

getTransportListener

TransportListener getTransportListener()

Gets the currently set TransportListener instance

Returns:

the current TransportListener or null if none set.

setTransportListener

void setTransportListener(TransportListener listener)

Sets the Transport Listener instance that will be notified of incoming data or error events.

Parameters:

listener - The new TransportListener instance to use (cannot be null).

Throws:

IllegalArgumentException - if the given listener is null.

getTransportOptions

TransportOptions getTransportOptions()

Returns:

the TransportOptions instance that holds the configuration for this Transport.

getRemoteLocation

URI getRemoteLocation()

Returns:

the URI of the remote peer that this Transport connects to.