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.
-
Nested Class Summary
Nested Classes Modifier and Type Interface Description static interface
Message.Mutable
The mutable version of aMessage
-
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
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()
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 Details
-
CLIENT_ID_FIELD
- See Also:
- Constant Field Values
-
DATA_FIELD
- See Also:
- Constant Field Values
-
CHANNEL_FIELD
- See Also:
- Constant Field Values
-
ID_FIELD
- See Also:
- Constant Field Values
-
ERROR_FIELD
- See Also:
- Constant Field Values
-
TIMESTAMP_FIELD
- See Also:
- Constant Field Values
-
TRANSPORT_FIELD
- See Also:
- Constant Field Values
-
ADVICE_FIELD
- See Also:
- Constant Field Values
-
SUCCESSFUL_FIELD
- See Also:
- Constant Field Values
-
SUBSCRIPTION_FIELD
- See Also:
- Constant Field Values
-
EXT_FIELD
- See Also:
- Constant Field Values
-
CONNECTION_TYPE_FIELD
- See Also:
- Constant Field Values
-
VERSION_FIELD
- See Also:
- Constant Field Values
-
MIN_VERSION_FIELD
- See Also:
- Constant Field Values
-
SUPPORTED_CONNECTION_TYPES_FIELD
- See Also:
- Constant Field Values
-
RECONNECT_FIELD
- See Also:
- Constant Field Values
-
INTERVAL_FIELD
- See Also:
- Constant Field Values
-
MAX_INTERVAL_FIELD
- See Also:
- Constant Field Values
-
TIMEOUT_FIELD
- See Also:
- Constant Field Values
-
RECONNECT_RETRY_VALUE
- See Also:
- Constant Field Values
-
RECONNECT_HANDSHAKE_VALUE
- See Also:
- Constant Field Values
-
RECONNECT_NONE_VALUE
- See Also:
- Constant Field Values
-
-
Method Details
-
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
- Returns:
- the data of the message as a map
- See Also:
getData()
-
getExt
Convenience method to retrieve theEXT_FIELD
- Returns:
- the ext of the message
-
getId
String getId()Convenience method to retrieve theID_FIELD
- Returns:
- the id of the message
-
getJSON
String getJSON()- Returns:
- this message as a JSON string
-