@Target(value=METHOD) @Retention(value=RUNTIME) @Documented public @interface SubscribeMapping
This is a method-level annotation that can be combined with a type-level
@MessageMapping
.
Supports the same method arguments as @MessageMapping
; however,
subscription messages typically do not have a body.
The return value also follows the same rules as for @MessageMapping
,
except if the method is not annotated with
SendTo
or
SendToUser
, the message is sent directly back to the connected
user and does not pass through the message broker. This is useful for
implementing a request-reply pattern.
NOTE: When using controller interfaces (e.g. for AOP proxying),
make sure to consistently put all your mapping annotations - such as
@MessageMapping
and @SubscribeMapping
- on
the controller interface rather than on the implementation class.
MessageMapping
,
SendTo
,
SendToUser
public abstract String[] value
This is the destination of the STOMP message (e.g. "/positions"
).
Ant-style path patterns (e.g. "/price.stock.*"
) and path template
variables (e.g. "/price.stock.{ticker}"
) are also supported.