blob: 402ebc329dbb46f469dacd38770b3f153a22fce9 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
|
/*
*
* Copyright (c) 2006 The Apache Software Foundation
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*
*/
package org.apache.qpid.server.protocol;
import org.apache.qpid.framing.AMQDataBlock;
import org.apache.qpid.server.AMQChannel;
import org.apache.qpid.AMQException;
import javax.security.sasl.SaslServer;
public interface AMQProtocolSession
{
/**
* Called when a protocol data block is received
* @param message the data block that has been received
* @throws Exception if processing the datablock fails
*/
void dataBlockReceived(AMQDataBlock message) throws Exception;
/**
* Write a datablock, encoding where necessary (e.g. into a sequence of bytes)
* @param frame the frame to be encoded and written
*/
void writeFrame(AMQDataBlock frame);
/**
* Get the context key associated with this session. Context key is described
* in the AMQ protocol specification (RFC 6).
* @return the context key
*/
String getContextKey();
/**
* Set the context key associated with this session. Context key is described
* in the AMQ protocol specification (RFC 6).
* @param contextKey the context key
*/
void setContextKey(String contextKey);
/**
* Get the channel for this session associated with the specified id. A channel
* id is unique per connection (i.e. per session).
* @param channelId the channel id which must be valid
* @return null if no channel exists, the channel otherwise
*/
AMQChannel getChannel(int channelId) throws AMQException;
/**
* Associate a channel with this session.
* @param channel the channel to associate with this session. It is an error to
* associate the same channel with more than one session but this is not validated.
*/
void addChannel(AMQChannel channel);
/**
* Close a specific channel. This will remove any resources used by the channel, including:
* <ul><li>any queue subscriptions (this may in turn remove queues if they are auto delete</li>
* </ul>
* @param channelId id of the channel to close
* @throws org.apache.qpid.AMQException if an error occurs closing the channel
* @throws IllegalArgumentException if the channel id is not valid
*/
void closeChannel(int channelId) throws AMQException;
/**
* Remove a channel from the session but do not close it.
* @param channelId
*/
void removeChannel(int channelId);
/**
* Initialise heartbeats on the session.
* @param delay delay in seconds (not ms)
*/
void initHeartbeats(int delay);
/**
* This must be called when the session is _closed in order to free up any resources
* managed by the session.
*/
void closeSession() throws AMQException;
/**
* @return a key that uniquely identifies this session
*/
Object getKey();
/**
* Get the fully qualified domain name of the local address to which this session is bound. Since some servers
* may be bound to multiple addresses this could vary depending on the acceptor this session was created from.
*
* @return a String FQDN
*/
String getLocalFQDN();
/**
* @return the sasl server that can perform authentication for this session.
*/
SaslServer getSaslServer();
/**
* Set the sasl server that is to perform authentication for this session.
* @param saslServer
*/
void setSaslServer(SaslServer saslServer);
}
|