io.xiaper.mq.stomp

类 StompController

java.lang.Object

io.xiaper.mq.stomp.StompController

@Controller
public class StompController
extends Object

https://docs.spring.io/spring/docs/current/spring-framework-reference/web.html#websocket-stomp

作者:

xiaper.io

构造器概要

构造器

构造器和说明
StompController()

方法概要

限定符和类型	方法和说明
String	handleException(Throwable exception) 异常信息推送 broadcast=false 说明： If the user has more than one session, by default all of the sessions subscribed to the given destination are targeted.
void	message(Principal principal, io.xiaper.jpa.model.Message message) 一对一聊天 https://docs.spring.io/spring/docs/current/spring-framework-reference/web.html#websocket-stomp-handle-annotations
void	message(Principal principal, String sessionType, String tid) protobuf 消息体:
void	message(Principal principal, String sessionType, String tid, io.xiaper.jpa.model.Message message) 会话消息 stomp和mqtt客户端均能够收到消息: stomp端需要订阅,格式如：/topic/thread.123456 , 注意添加前缀 '/topic/' stomp服务器发送消息： String stompDestination = "/topic/"+ messageSessionType + "." + tid; mqtt端需要订阅，格式如：thread/123456, 注意无前缀 '/topic/' ，同时 '.'
String	speak(String text, String sessionId) 点对点推送
List<io.xiaper.jpa.model.User>	subscribeThread(Principal principal, String threadId) 订阅会话id，返回会话中的用户 注意: 不能监听订阅 /topic/ https://docs.spring.io/spring/docs/current/spring-framework-reference/web.html#websocket-stomp-subscribe-mapping

从类继承的方法 java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

构造器详细资料

StompController

public StompController()

方法详细资料

message

@MessageMapping(value="/message")
public void message(Principal principal,
                                                      io.xiaper.jpa.model.Message message)

一对一聊天 https://docs.spring.io/spring/docs/current/spring-framework-reference/web.html#websocket-stomp-handle-annotations

参数:

principal - principal

message - msg

message

@MessageMapping(value="/{sessionType}.{tid}")
public void message(Principal principal,
                                                                  @DestinationVariable(value="sessionType")
                                                                  String sessionType,
                                                                  @DestinationVariable(value="tid")
                                                                  String tid,
                                                                  io.xiaper.jpa.model.Message message)

会话消息 stomp和mqtt客户端均能够收到消息: stomp端需要订阅,格式如：/topic/thread.123456 , 注意添加前缀 '/topic/' stomp服务器发送消息： String stompDestination = "/topic/"+ messageSessionType + "." + tid; mqtt端需要订阅，格式如：thread/123456, 注意无前缀 '/topic/' ，同时 '.' 需要替换为 '/' mqtt服务器发送消息： String mqttDestination = "/topic/" + messageSessionType + "/" + tid; 其中chat为: 工作组会话消息、同事消息、群组消息 thread/contact/group thread.tid contact.tid group.tid TODO: 收到消息之后优先转发消息，通过另外的Service服务监听MQ消息写库？

参数:

principal - principal

tid - tid

message - msg

message

@MessageMapping(value="/protobuf.{sessionType}.{tid}")
public void message(Principal principal,
                                                                           @DestinationVariable(value="sessionType")
                                                                           String sessionType,
                                                                           @DestinationVariable(value="tid")
                                                                           String tid)

protobuf 消息体:

参数:

principal - principal

sessionType - sessionType

tid - tid

另请参阅:

subscribeThread

@SubscribeMapping(value="/thread.{threadId}")
public List<io.xiaper.jpa.model.User> subscribeThread(Principal principal,
                                                                                                    @DestinationVariable(value="threadId")
                                                                                                    String threadId)

订阅会话id，返回会话中的用户 注意: 不能监听订阅 /topic/ https://docs.spring.io/spring/docs/current/spring-framework-reference/web.html#websocket-stomp-subscribe-mapping

参数:

principal - principal

threadId - tid

返回:

list

speak

@MessageMapping(value="/speak")
 @SendToUser(value="/personal")
public String speak(@Payload
                                                                                    String text,
                                                                                    @Header(value="simpSessionId")
                                                                                    String sessionId)
                                                                             throws Exception

点对点推送

参数:

text - text

sessionId - sessionId

返回:

string

抛出:

Exception

handleException

@MessageExceptionHandler
 @SendToUser(destinations="/queue/errors",
            broadcast=false)
public String handleException(Throwable exception)

异常信息推送 broadcast=false 说明： If the user has more than one session, by default all of the sessions subscribed to the given destination are targeted. However sometimes, it may be necessary to target only the session that sent the message being handled. This can be done by setting the broadcast

参数:

exception -

返回: