Package org.cometd.bayeux
Interface Message
-
- All Known Subinterfaces:
Message.Mutable
,ServerMessage
,ServerMessage.Mutable
- All Known Implementing Classes:
HashMapMessage
,ServerMessageImpl
public interface Message extends Map<String,Object>
The Bayeux protocol exchange information by means of messages.
This interface represents the API of a Bayeux message, and consists mainly of convenience methods to access the known fields of the message map.
This interface comes in both an immutable and
mutable
versions. Mutability may be deeply enforced by an implementation, so that it is not correct to cast a passed Message, to a Message.Mutable, even if the implementation allows this.
-
-
Field Summary
Fields Modifier and Type Field Description static String
ADVICE_FIELD
static String
CHANNEL_FIELD
static String
CLIENT_ID_FIELD
static String
CONNECTION_TYPE_FIELD
static String
DATA_FIELD
static String
ERROR_FIELD
static String
EXT_FIELD
static String
ID_FIELD
static String
INTERVAL_FIELD
static String
MAX_INTERVAL_FIELD
static String
MIN_VERSION_FIELD
static String
RECONNECT_FIELD
static String
RECONNECT_HANDSHAKE_VALUE
static String
RECONNECT_NONE_VALUE
static String
RECONNECT_RETRY_VALUE
static String
SUBSCRIPTION_FIELD
static String
SUCCESSFUL_FIELD
static String
SUPPORTED_CONNECTION_TYPES_FIELD
static String
TIMEOUT_FIELD
static String
TIMESTAMP_FIELD
static String
TRANSPORT_FIELD
static String
VERSION_FIELD
-
Method Summary
All Methods Instance Methods Abstract Methods Deprecated Methods Modifier and Type Method Description Map<String,Object>
getAdvice()
Convenience method to retrieve theADVICE_FIELD
String
getChannel()
Convenience method to retrieve theCHANNEL_FIELD
.ChannelId
getChannelId()
Convenience method to retrieve theCHANNEL_FIELD
.String
getClientId()
Convenience method to retrieve theCLIENT_ID_FIELD
Object
getData()
Convenience method to retrieve theDATA_FIELD
Map<String,Object>
getDataAsMap()
Map<String,Object>
getExt()
Convenience method to retrieve theEXT_FIELD
String
getId()
Convenience method to retrieve theID_FIELD
String
getJSON()
Deprecated.use JSONContext.Client.generate() instead.boolean
isMeta()
A messages that has a meta channel is dubbed a "meta message".boolean
isPublishReply()
Publish message replies contain the "successful" fieldboolean
isSuccessful()
Convenience method to retrieve theSUCCESSFUL_FIELD
-
Methods inherited from interface java.util.Map
clear, compute, computeIfAbsent, computeIfPresent, containsKey, containsValue, entrySet, equals, forEach, get, getOrDefault, hashCode, isEmpty, keySet, merge, put, putAll, putIfAbsent, remove, remove, replace, replace, replaceAll, size, values
-
-
-
-
Field Detail
-
CLIENT_ID_FIELD
static final String CLIENT_ID_FIELD
- See Also:
- Constant Field Values
-
DATA_FIELD
static final String DATA_FIELD
- See Also:
- Constant Field Values
-
CHANNEL_FIELD
static final String CHANNEL_FIELD
- See Also:
- Constant Field Values
-
ID_FIELD
static final String ID_FIELD
- See Also:
- Constant Field Values
-
ERROR_FIELD
static final String ERROR_FIELD
- See Also:
- Constant Field Values
-
TIMESTAMP_FIELD
static final String TIMESTAMP_FIELD
- See Also:
- Constant Field Values
-
TRANSPORT_FIELD
static final String TRANSPORT_FIELD
- See Also:
- Constant Field Values
-
ADVICE_FIELD
static final String ADVICE_FIELD
- See Also:
- Constant Field Values
-
SUCCESSFUL_FIELD
static final String SUCCESSFUL_FIELD
- See Also:
- Constant Field Values
-
SUBSCRIPTION_FIELD
static final String SUBSCRIPTION_FIELD
- See Also:
- Constant Field Values
-
EXT_FIELD
static final String EXT_FIELD
- See Also:
- Constant Field Values
-
CONNECTION_TYPE_FIELD
static final String CONNECTION_TYPE_FIELD
- See Also:
- Constant Field Values
-
VERSION_FIELD
static final String VERSION_FIELD
- See Also:
- Constant Field Values
-
MIN_VERSION_FIELD
static final String MIN_VERSION_FIELD
- See Also:
- Constant Field Values
-
SUPPORTED_CONNECTION_TYPES_FIELD
static final String SUPPORTED_CONNECTION_TYPES_FIELD
- See Also:
- Constant Field Values
-
RECONNECT_FIELD
static final String RECONNECT_FIELD
- See Also:
- Constant Field Values
-
INTERVAL_FIELD
static final String INTERVAL_FIELD
- See Also:
- Constant Field Values
-
MAX_INTERVAL_FIELD
static final String MAX_INTERVAL_FIELD
- See Also:
- Constant Field Values
-
TIMEOUT_FIELD
static final String TIMEOUT_FIELD
- See Also:
- Constant Field Values
-
RECONNECT_RETRY_VALUE
static final String RECONNECT_RETRY_VALUE
- See Also:
- Constant Field Values
-
RECONNECT_HANDSHAKE_VALUE
static final String RECONNECT_HANDSHAKE_VALUE
- See Also:
- Constant Field Values
-
RECONNECT_NONE_VALUE
static final String RECONNECT_NONE_VALUE
- See Also:
- Constant Field Values
-
-
Method Detail
-
getAdvice
Map<String,Object> getAdvice()
Convenience method to retrieve theADVICE_FIELD
- Returns:
- the advice of the message
-
getChannel
String getChannel()
Convenience method to retrieve theCHANNEL_FIELD
. Bayeux message always have a non null channel.- Returns:
- the channel of the message
-
getChannelId
ChannelId getChannelId()
Convenience method to retrieve theCHANNEL_FIELD
. Bayeux message always have a non null channel.- Returns:
- the channel of the message
-
getClientId
String getClientId()
Convenience method to retrieve theCLIENT_ID_FIELD
- Returns:
- the client id of the message
-
getData
Object getData()
Convenience method to retrieve theDATA_FIELD
- Returns:
- the data of the message
- See Also:
getDataAsMap()
-
isMeta
boolean isMeta()
A messages that has a meta channel is dubbed a "meta message".- Returns:
- whether the channel's message is a meta channel
-
isPublishReply
boolean isPublishReply()
Publish message replies contain the "successful" field- Returns:
- whether this message is a publish reply (as opposed to a published message)
-
isSuccessful
boolean isSuccessful()
Convenience method to retrieve theSUCCESSFUL_FIELD
- Returns:
- whether the message is successful
-
getDataAsMap
Map<String,Object> getDataAsMap()
- Returns:
- the data of the message as a map
- See Also:
getData()
-
getExt
Map<String,Object> getExt()
Convenience method to retrieve theEXT_FIELD
- Returns:
- the ext of the message
-
getJSON
@Deprecated String getJSON()
Deprecated.use JSONContext.Client.generate() instead.- Returns:
- this message as a JSON string
-
-