Package org.springframework.messaging.rsocket.annotation

Annotation Interface ConnectMapping

@Target(METHOD)
@Retention(RUNTIME)
@Documented
public @interface ConnectMapping

Annotation to map the initial ConnectionSetupPayload and subsequent metadata pushes onto a handler method.

This is a method-level annotation that can be combined with a type-level @MessageMapping for a combined route pattern. It supports the same arguments as @MessageMapping but the return value must be void. On a server, handling can be asynchronous (e.g. Mono<Void>), in which case the connection is accepted if and when the Mono<Void> completes. On the client side this method is only a callback and does not affect the establishment of the connection.

Note: an @ConnectMapping method may start requests to the remote through an RSocketRequester method argument, but it must do so independent of the handling thread (e.g. via subscribing on a different thread).

Since:

5.2

Author:

Rossen Stoyanchev

Optional Element Summary

Optional Elements

Modifier and Type	Optional Element	Description
String[]	value	Mappings expressed by this annotation to match to the route from the metadata of the initial ConnectionSetupPayload or in subsequent metadata pushes.

Element Details

value

String[] value

Mappings expressed by this annotation to match to the route from the metadata of the initial ConnectionSetupPayload or in subsequent metadata pushes.

Depending on the configured RouteMatcher, the pattern may be AntPathMatcher or PathPattern based.

By default this is an empty array in which case it matches all ConnectionSetupPayload and metadata pushes.

Default:

{}