Package org.jgroups.protocols
Class STOMP
- java.lang.Object
-
- org.jgroups.stack.Protocol
-
- org.jgroups.protocols.STOMP
-
- All Implemented Interfaces:
java.lang.Runnable
,Lifecycle
public class STOMP extends Protocol implements java.lang.Runnable
Protocol which provides STOMP (https://stomp.github.io/) support. Very simple implementation, with a one-thread-per-connection model. Use for a few hundred clients max. The intended use for this protocol is pub-sub with clients which handle text messages, e.g. stock updates, SMS messages to mobile clients, SNMP traps etc. Note that the full STOMP protocol has not yet been implemented, e.g. transactions are not supported. todo: use a thread pool to handle incoming frames and to send messages to clients todo: add PING to test health of client connections- Since:
- 2.11
- Author:
- Bela Ban
-
-
Nested Class Summary
Nested Classes Modifier and Type Class Description static class
STOMP.ClientVerb
class
STOMP.Connection
Class which handles a connection to a clientstatic class
STOMP.Frame
static class
STOMP.ServerVerb
static class
STOMP.StompHeader
-
Field Summary
Fields Modifier and Type Field Description protected java.lang.Thread
acceptor
protected java.net.InetAddress
bind_addr
protected java.util.List<STOMP.Connection>
connections
protected java.lang.String
endpoint
protected java.lang.String
endpoint_addr
protected java.util.Map<Address,java.lang.String>
endpoints
protected boolean
exact_destination_match
protected boolean
forward_non_client_generated_msgs
static byte
NULL_BYTE
protected int
port
protected boolean
send_info
protected java.net.ServerSocket
srv_sock
protected java.util.concurrent.ConcurrentMap<java.lang.String,java.util.Set<STOMP.Connection>>
subscriptions
protected View
view
-
Fields inherited from class org.jgroups.stack.Protocol
after_creation_hook, down_prot, ergonomics, id, local_addr, log, policies, stack, stats, up_prot
-
-
Constructor Summary
Constructors Constructor Description STOMP()
-
Method Summary
All Methods Static Methods Instance Methods Concrete Methods Modifier and Type Method Description protected void
broadcastEndpoint()
java.lang.Object
down(Event evt)
An event is to be sent down the stack.protected java.lang.String
getAllEndpoints()
java.lang.String
getEndpoints()
int
getNumConnections()
int
getNumSubscriptions()
java.lang.String
getSubscriptions()
protected void
handleView(View view)
static STOMP.Frame
readFrame(java.io.DataInputStream in)
void
run()
void
start()
This method is called on aJChannel.connect(String)
; starts work.void
stop()
Called on aJChannel.disconnect()
; stops work (e.g.java.lang.Object
up(Event evt)
An event was received from the protocol below.java.lang.Object
up(Message msg)
A single message was received.void
up(MessageBatch batch)
Sends up a multiple messages in aMessageBatch
.-
Methods inherited from class org.jgroups.stack.Protocol
accept, addPolicy, addr, addr, afterCreationHook, destroy, down, down, enableStats, getAddress, getComponents, getDownProtocol, getDownServices, getId, getIdsAbove, getLevel, getLog, getName, getPolicies, getProtocolStack, getSocketFactory, getThreadFactory, getTransport, getUpProtocol, getUpServices, getValue, init, isErgonomics, level, parse, policies, providedDownServices, providedUpServices, removePolicy, requiredDownServices, requiredUpServices, resetStatistics, resetStats, setAddress, setDownProtocol, setErgonomics, setId, setLevel, setPolicies, setProtocolStack, setSocketFactory, setUpProtocol, setValue, statsEnabled, toString
-
-
-
-
Field Detail
-
bind_addr
protected java.net.InetAddress bind_addr
-
endpoint_addr
protected java.lang.String endpoint_addr
-
port
protected int port
-
exact_destination_match
protected boolean exact_destination_match
-
send_info
protected boolean send_info
-
forward_non_client_generated_msgs
protected boolean forward_non_client_generated_msgs
-
srv_sock
protected java.net.ServerSocket srv_sock
-
endpoint
protected java.lang.String endpoint
-
acceptor
protected java.lang.Thread acceptor
-
connections
protected final java.util.List<STOMP.Connection> connections
-
endpoints
protected final java.util.Map<Address,java.lang.String> endpoints
-
view
protected View view
-
subscriptions
protected final java.util.concurrent.ConcurrentMap<java.lang.String,java.util.Set<STOMP.Connection>> subscriptions
-
NULL_BYTE
public static final byte NULL_BYTE
- See Also:
- Constant Field Values
-
-
Method Detail
-
getNumConnections
public int getNumConnections()
-
getNumSubscriptions
public int getNumSubscriptions()
-
getSubscriptions
public java.lang.String getSubscriptions()
-
getEndpoints
public java.lang.String getEndpoints()
-
start
public void start() throws java.lang.Exception
Description copied from class:Protocol
This method is called on aJChannel.connect(String)
; starts work. Protocols are connected ready to receive events. Will be called from bottom to top.- Specified by:
start
in interfaceLifecycle
- Overrides:
start
in classProtocol
- Throws:
java.lang.Exception
- Thrown if protocol cannot be started successfully. This will cause the ProtocolStack to fail, soJChannel.connect(String)
will throw an exception
-
stop
public void stop()
Description copied from class:Protocol
Called on aJChannel.disconnect()
; stops work (e.g. by closing multicast socket). Will be called from top to bottom.
-
run
public void run()
- Specified by:
run
in interfacejava.lang.Runnable
-
down
public java.lang.Object down(Event evt)
Description copied from class:Protocol
An event is to be sent down the stack. A protocol may want to examine its type and perform some action on it, depending on the event's type. If the event is a message MSG, then the protocol may need to add a header to it (or do nothing at all) before sending it down the stack usingdown_prot.down()
.
-
up
public java.lang.Object up(Event evt)
Description copied from class:Protocol
An event was received from the protocol below. Usually the current protocol will want to examine the event type and - depending on its type - perform some computation (e.g. removing headers from a MSG event type, or updating the internal membership list when receiving a VIEW_CHANGE event). Finally, the event is either a) discarded, or b) an event is sent down the stack usingdown_prot.down()
or c) the event (or another event) is sent up the stack usingup_prot.up()
.
-
up
public java.lang.Object up(Message msg)
Description copied from class:Protocol
A single message was received. Protocols may examine the message and do something (e.g. add a header) with it before passing it up.
-
up
public void up(MessageBatch batch)
Description copied from class:Protocol
Sends up a multiple messages in aMessageBatch
. The sender of the batch is always the same, and so is the destination (null == multicast messages). Messages in a batch can be OOB messages, regular messages, or mixed messages, although the transport itself will create initial MessageBatches that contain only either OOB or regular messages. The default processing below sends messages up the stack individually, based on a matching criteria (callingProtocol.accept(Message)
), and - if true - callsProtocol.up(org.jgroups.Event)
for that message and removes the message. If the batch is not empty, it is passed up, or else it is dropped. Subclasses should check if there are any messages destined for them (e.g. usingMessageBatch.iterator(Predicate)
), then possibly remove and process them and finally pass the batch up to the next protocol. Protocols can also modify messages in place, e.g. ENCRYPT could decrypt all encrypted messages in the batch, not remove them, and pass the batch up when done.
-
readFrame
public static STOMP.Frame readFrame(java.io.DataInputStream in) throws java.io.IOException
- Throws:
java.io.IOException
-
handleView
protected void handleView(View view)
-
getAllEndpoints
protected java.lang.String getAllEndpoints()
-
broadcastEndpoint
protected void broadcastEndpoint()
-
-