STOMP协议概述

STOMP（Simple Text Oriented Messaging Protocol简单的面向文本消息传输的协议）最初是为脚本语言（例如：Ruby，Python和Perl）创建的，用于连接企业代理。它被设计来解决消息传递中的一些核心需求，而不是视图涵盖所有可能的复杂情况。STOMP可以在任何可靠的双向流式网络协议上使用，例如TCP和WweSocket。虽然STOMP是一个面向文本的协议，但消息内容可以是文本或二进制。

STOMP是一个基于帧的协议，它的帧的结构参考了HTTP协议的格式。下面这个列表展示了一个STOMP帧的结构：

COMMAND
header1:value1
header2:value2

Body^@

客户端可以使用SEND 或 SUBSCRIBE 命令来发送或订阅消息，同时携带一个destination 消息头，来描述消息内容和谁应该接收这条消息。这实现了简单的发布-订阅机制，你能用它来通过代理给其他连接的客户端发消息，或者给服务器发消息来执行某些任务。

当你使用Spring的STOMP的支持时，Spring WebSocket应用程序对客户端而言扮演了STOMP代理的角色。消息被路由到 @Controller 消息处理的方法上，或者路由到简单的内存消息代理，它持续跟踪订阅情况并将消息广播到订阅者。在实际广播消息的场景，你也能在Spring里配置一个专业的STOMP消息代理（例如：RabbitMQ，ActiveMQ等）。在这种情况下，Spring维护到代理的TCP连接，将消息中继（转发来自客户端的STOMP消息）给它，并将来自代理的消息下发给连接的WebSocket客户端。因此，Spring web应用程序可以依赖统一的基于HTTP的安全机制、通用的验证和熟悉的编程模型来处理消息。

下面这个例子展示一个客户端订阅接收股票报价，服务端会定期发送信息（例如，通过定时任务，用SimpMessagingTemplate 发送消息给代理）：

SUBSCRIBE
id:sub-1
destination:/topic/price.stock.*

^@

The following example shows a client that sends a trade request, which the server can handle through an @MessageMapping method:

下面这个例子展示了一个客户端发送了一条交易请求，服务端可以通过一个带有@MessageMapping 注解的方法来处理请求：

SEND
destination:/queue/trade
content-type:application/json
content-length:44

{"action":"BUY","ticker":"MMM","shares",44}^@

在执行完成后，服务端可以广播一条交易确认消息和详情给客户端。

在STOMP规范中，目的地（destination）的含义被有意设计得不那么透明。它可以是任意字符串，并且完全取决于STOMP服务器来定义他们支持的目的地的语义和语法。然而，非常常见的是，目的地是类似于路径的字符串，/topic/.. 表示发布-订阅模式（一对多），/queue/ 表示点对点（一堆一）消息交换。

STOMP服务器可以通过MESSAGE 命令来广播消息到所有的订阅者。下面这个例子展示服务器发送一条股票报价给已订阅的客户端：

MESSAGE
message-id:nxahklf6-1
subscription:sub-1
destination:/topic/price.stock.MMM

{"ticker":"MMM","price":129.45}^@

服务器不能发送未经请求的消息。服务器所有发送的消息都必须是对特定的客户端订阅的响应，并且服务端发送消息的subscription 消息头必须和客户端订阅的id 消息头相匹配。

前面的概述的目的是提供对STOMP协议最基本的理解。我们推荐完整查看协议规范。