org.apache.qpid.client.protocol

Class AMQProtocolSession

java.lang.Object

org.apache.qpid.client.protocol.AMQProtocolSession

All Implemented Interfaces:

AMQProtocolWriter, AMQVersionAwareProtocolSession, ProtocolVersionAware

public class AMQProtocolSession
extends Object
implements AMQVersionAwareProtocolSession

Wrapper for protocol session that provides type-safe access to session attributes.

The underlying protocol session is still available but clients should not use it to obtain session attributes.

Field Summary

Fields

Modifier and Type	Field and Description
protected static org.slf4j.Logger	_logger
static int	MAX_CHANNEL_MAX
static int	MIN_USABLE_CHANNEL_NUM

Constructor Summary

Constructors

Constructor and Description
AMQProtocolSession(AMQProtocolHandler protocolHandler, AMQConnection connection)

Method Summary

Methods

Modifier and Type	Method and Description
boolean	channelClosed(int channelId, AMQConstant code, String text) Called from the ChannelClose handler when a channel close frame is received.
void	closeProtocolSession()
void	closeSession(AMQSession session) Starts the process of closing a session
void	confirmConsumerCancelled(int channelId, AMQShortString consumerTag)
void	contentBodyReceived(int channelId, ContentBody contentBody)
void	contentHeaderReceived(int channelId, ContentHeaderBody contentHeader)
void	failover(String host, int port)
protected AMQShortString	generateQueueName()
AMQConnection	getAMQConnection()
protected ConcurrentMap<Integer,AMQSession>	getChannelId2SessionMap() Maps from the channel id to the AMQSession that it represents.
String	getClientID()
protected ConcurrentMap	getClosingChannels()
protected AMQConnection	getConnection()
FieldTable	getConnectionStartServerProperties()
ConnectionTuneParameters	getConnectionTuneParameters()
MethodDispatcher	getMethodDispatcher()
FrameCreatingMethodProcessor	getMethodProcessor()
MethodRegistry	getMethodRegistry()
protected AMQProtocolHandler	getProtocolHandler() The handler from which this session was created and which is used to handle protocol events.
byte	getProtocolMajorVersion()
byte	getProtocolMinorVersion()
ProtocolVersion	getProtocolVersion()
protected int	getQueueId() Counter to ensure unique queue names
protected Object	getQueueIdLock()
SaslClient	getSaslClient()
Sender<ByteBuffer>	getSender()
protected AMQSession	getSession(int channelId)
AMQStateManager	getStateManager()
String	getVirtualHost()
void	heartbeatBodyReceived(int channelId, HeartbeatBody body)
void	init(ConnectionSettings settings)
void	methodFrameReceived(int channel, AMQMethodBody amqMethodBody)
void	notifyError(Exception error)
protected void	setChannelId2SessionMap(ConcurrentMap<Integer,AMQSession> channelId2SessionMap)
void	setClientID(String clientID)
protected void	setClosingChannels(ConcurrentMap closingChannels)
void	setConnectionStartServerProperties(FieldTable serverProperties)
void	setFlowControl(int channelId, boolean active)
void	setMaxFrameSize(long frameMax)
void	setMethodDispatcher(MethodDispatcher methodDispatcher)
void	setProtocolVersion(ProtocolVersion pv)
protected void	setQueueId(int queueId)
void	setSaslClient(SaslClient client) Store the SASL client currently being used for the authentication handshake
void	setSender(Sender<ByteBuffer> sender)
void	setTicket(int ticket, int channelId)
String	toString()
void	tuneConnection(ConnectionTuneParameters params)
void	unprocessedMessageReceived(int channelId, UnprocessedMessage message) Callback invoked from the BasicDeliverMethodHandler when a message has been received.
void	writeFrame(AMQDataBlock frame)

Methods inherited from class java.lang.Object

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

Field Detail

_logger

protected static final org.slf4j.Logger _logger

MAX_CHANNEL_MAX

public static final int MAX_CHANNEL_MAX

See Also:

Constant Field Values

MIN_USABLE_CHANNEL_NUM

public static final int MIN_USABLE_CHANNEL_NUM

See Also:

Constant Field Values

Constructor Detail

AMQProtocolSession

public AMQProtocolSession(AMQProtocolHandler protocolHandler,
                  AMQConnection connection)

Method Detail

init

public void init(ConnectionSettings settings)

getConnectionTuneParameters

public ConnectionTuneParameters getConnectionTuneParameters()

tuneConnection

public void tuneConnection(ConnectionTuneParameters params)

getClientID

public String getClientID()

setClientID

public void setClientID(String clientID)
                 throws javax.jms.JMSException

Throws:

javax.jms.JMSException

getStateManager

public AMQStateManager getStateManager()

getVirtualHost

public String getVirtualHost()

getSaslClient

public SaslClient getSaslClient()

setSaslClient

public void setSaslClient(SaslClient client)

Store the SASL client currently being used for the authentication handshake

Parameters:

client - if non-null, stores this in the session. if null clears any existing client being stored

unprocessedMessageReceived

public void unprocessedMessageReceived(int channelId,
                              UnprocessedMessage message)
                                throws AMQException

Callback invoked from the BasicDeliverMethodHandler when a message has been received.

Parameters:

message -

Throws:

AMQException - if this was not expected

contentHeaderReceived

public void contentHeaderReceived(int channelId,
                         ContentHeaderBody contentHeader)
                           throws AMQException

Specified by:

contentHeaderReceived in interface AMQVersionAwareProtocolSession

Throws:

AMQException

contentBodyReceived

public void contentBodyReceived(int channelId,
                       ContentBody contentBody)
                         throws AMQException

Specified by:

contentBodyReceived in interface AMQVersionAwareProtocolSession

Throws:

AMQException

heartbeatBodyReceived

public void heartbeatBodyReceived(int channelId,
                         HeartbeatBody body)
                           throws AMQException

Specified by:

heartbeatBodyReceived in interface AMQVersionAwareProtocolSession

Throws:

AMQException

getSession

protected AMQSession getSession(int channelId)

writeFrame

public void writeFrame(AMQDataBlock frame)

Specified by:

writeFrame in interface AMQProtocolWriter

closeSession

public void closeSession(AMQSession session)

Starts the process of closing a session

Parameters:

session - the AMQSession being closed

channelClosed

public boolean channelClosed(int channelId,
                    AMQConstant code,
                    String text)
                      throws AMQException

Called from the ChannelClose handler when a channel close frame is received. This method decides whether this is a response or an initiation. The latter case causes the AMQSession to be closed and an exception to be thrown if appropriate.

Parameters:

channelId - the id of the channel (session)

Returns:

true if the client must respond to the server, i.e. if the server initiated the channel close, false if the channel close is just the server responding to the client's earlier request to close the channel.

Throws:

AMQException

getAMQConnection

public AMQConnection getAMQConnection()

closeProtocolSession

public void closeProtocolSession()
                          throws AMQException

Throws:

AMQException

getSender

public Sender<ByteBuffer> getSender()

failover

public void failover(String host,
            int port)

generateQueueName

protected AMQShortString generateQueueName()

confirmConsumerCancelled

public void confirmConsumerCancelled(int channelId,
                            AMQShortString consumerTag)

setProtocolVersion

public void setProtocolVersion(ProtocolVersion pv)

getProtocolMinorVersion

public byte getProtocolMinorVersion()

Specified by:

getProtocolMinorVersion in interface ProtocolVersionAware

getProtocolMajorVersion

public byte getProtocolMajorVersion()

Specified by:

getProtocolMajorVersion in interface ProtocolVersionAware

getProtocolVersion

public ProtocolVersion getProtocolVersion()

Specified by:

getProtocolVersion in interface ProtocolVersionAware

getMethodRegistry

public MethodRegistry getMethodRegistry()

Specified by:

getMethodRegistry in interface AMQVersionAwareProtocolSession

getMethodDispatcher

public MethodDispatcher getMethodDispatcher()

setTicket

public void setTicket(int ticket,
             int channelId)

setMethodDispatcher

public void setMethodDispatcher(MethodDispatcher methodDispatcher)

setFlowControl

public void setFlowControl(int channelId,
                  boolean active)

methodFrameReceived

public void methodFrameReceived(int channel,
                       AMQMethodBody amqMethodBody)
                         throws AMQException

Specified by:

methodFrameReceived in interface AMQVersionAwareProtocolSession

Throws:

AMQException

notifyError

public void notifyError(Exception error)

setSender

public void setSender(Sender<ByteBuffer> sender)

Specified by:

setSender in interface AMQVersionAwareProtocolSession

toString

public String toString()

Overrides:

toString in class Object

getProtocolHandler

protected AMQProtocolHandler getProtocolHandler()

The handler from which this session was created and which is used to handle protocol events. We send failover events to the handler.

getChannelId2SessionMap

protected ConcurrentMap<Integer,AMQSession> getChannelId2SessionMap()

Maps from the channel id to the AMQSession that it represents.

setChannelId2SessionMap

protected void setChannelId2SessionMap(ConcurrentMap<Integer,AMQSession> channelId2SessionMap)

getClosingChannels

protected ConcurrentMap getClosingChannels()

setClosingChannels

protected void setClosingChannels(ConcurrentMap closingChannels)

getQueueId

protected int getQueueId()

Counter to ensure unique queue names

setQueueId

protected void setQueueId(int queueId)

getQueueIdLock

protected Object getQueueIdLock()

getConnection

protected AMQConnection getConnection()

setConnectionStartServerProperties

public void setConnectionStartServerProperties(FieldTable serverProperties)

getConnectionStartServerProperties

public FieldTable getConnectionStartServerProperties()

setMaxFrameSize

public void setMaxFrameSize(long frameMax)

getMethodProcessor

public FrameCreatingMethodProcessor getMethodProcessor()