java.lang.Object
- org.springframework.messaging.handler.invocation.AbstractMethodMessageHandler<SimpMessageMappingInfo>
- - org.springframework.messaging.simp.annotation.support.SimpAnnotationMethodMessageHandler

所有已实现的接口:
Aware, InitializingBean, ApplicationContextAware, EmbeddedValueResolverAware, Lifecycle, Phased, SmartLifecycle, MessageHandler
直接已知子类:
WebSocketAnnotationMethodMessageHandler
```
public class SimpAnnotationMethodMessageHandler
extends AbstractMethodMessageHandler<SimpMessageMappingInfo>
implements EmbeddedValueResolverAware, SmartLifecycle
```
A handler for messages delegating to @MessageMapping and @SubscribeMapping annotated methods.
Supports Ant-style path patterns with template variables.
从以下版本开始:
4.0
作者:
Rossen Stoyanchev, Brian Clozel, Juergen Hoeller

字段概要
- 从类继承的字段 org.springframework.messaging.handler.invocation.AbstractMethodMessageHandler
  logger

构造器概要

构造器
构造器	说明
`SimpAnnotationMethodMessageHandler(SubscribableChannel clientInboundChannel, MessageChannel clientOutboundChannel, SimpMessageSendingOperations brokerTemplate)`	Create an instance of SimpAnnotationMethodMessageHandler with the given message channels and broker messaging template.

方法概要

所有方法实例方法具体方法
修饰符和类型	方法	说明
`protected AbstractExceptionHandlerMethodResolver`	`createExceptionHandlerMethodResolverFor(Class<?> beanType)`
`ConversionService`	`getConversionService()`	Return the configured `ConversionService`.
`protected String`	`getDestination(Message<?> message)`
`protected Set<String>`	`getDirectLookupDestinations(SimpMessageMappingInfo mapping)`	Return destinations contained in the mapping that are not patterns and are therefore suitable for direct lookups.
`MessageHeaderInitializer`	`getHeaderInitializer()`	Return the configured header initializer.
`protected String`	`getLookupDestination(String destination)`	Check whether the given destination (of an incoming message) matches to one of the configured destination prefixes and if so return the remaining portion of the destination after the matched prefix.
`protected Comparator<SimpMessageMappingInfo>`	`getMappingComparator(Message<?> message)`	Return a comparator for sorting matching mappings.
`protected SimpMessageMappingInfo`	`getMappingForMethod(Method method, Class<?> handlerType)`	Provide the mapping for a handler method.
`protected SimpMessageMappingInfo`	`getMatchingMapping(SimpMessageMappingInfo mapping, Message<?> message)`	Check if a mapping matches the current message and return a possibly new mapping with conditions relevant to the current request.
`MessageConverter`	`getMessageConverter()`	Return the configured `MessageConverter`.
`PathMatcher`	`getPathMatcher()`	Return the PathMatcher implementation to use for matching destinations.
`int`	`getPhase()`	Return the phase value of this object.
`Validator`	`getValidator()`	Return the configured Validator instance.
`protected void`	`handleMatch(SimpMessageMappingInfo mapping, HandlerMethod handlerMethod, String lookupDestination, Message<?> message)`
`protected List<HandlerMethodArgumentResolver>`	`initArgumentResolvers()`	Return the list of argument resolvers to use.
`protected List<? extends HandlerMethodReturnValueHandler>`	`initReturnValueHandlers()`	Return the list of return value handlers to use.
`boolean`	`isAutoStartup()`	Returns `true` if this `Lifecycle` component should get started automatically by the container at the time that the containing `ApplicationContext` gets refreshed.
`protected boolean`	`isHandler(Class<?> beanType)`	Whether the given bean type should be introspected for messaging handling methods.
`boolean`	`isRunning()`	Check whether this component is currently running.
`protected String[]`	`resolveEmbeddedValuesInDestinations(String[] destinations)`	Resolve placeholder values in the given array of destinations.
`void`	`setConversionService(ConversionService conversionService)`	Configure a `ConversionService` to use when resolving method arguments, for example message header values.
`void`	`setDestinationPrefixes(Collection<String> prefixes)`	When this property is configured only messages to destinations matching one of the configured prefixes are eligible for handling.
`void`	`setEmbeddedValueResolver(StringValueResolver resolver)`	Set the StringValueResolver to use for resolving embedded definition values.
`void`	`setHeaderInitializer(MessageHeaderInitializer headerInitializer)`	Configure a `MessageHeaderInitializer` to pass on to `HandlerMethodReturnValueHandler`s that send messages from controller return values.
`void`	`setMessageConverter(MessageConverter converter)`	Configure a `MessageConverter` to use to convert the payload of a message from its serialized form with a specific MIME type to an Object matching the target method parameter.
`void`	`setPathMatcher(PathMatcher pathMatcher)`	Set the PathMatcher implementation to use for matching destinations against configured destination patterns.
`void`	`setValidator(Validator validator)`	Set the Validator instance used for validating `@Payload` arguments.
`void`	`start()`	Start this component.
`void`	`stop()`	Stop this component, typically in a synchronous fashion, such that the component is fully stopped upon return of this method.
`void`	`stop(Runnable callback)`	Indicates that a Lifecycle component must stop if it is currently running.

从类继承的方法 java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

- 构造器详细资料
  - SimpAnnotationMethodMessageHandler
```
public SimpAnnotationMethodMessageHandler(SubscribableChannel clientInboundChannel,
                                          MessageChannel clientOutboundChannel,
                                          SimpMessageSendingOperations brokerTemplate)
```
    Create an instance of SimpAnnotationMethodMessageHandler with the given message channels and broker messaging template.
    参数:
    clientInboundChannel - the channel for receiving messages from clients (e.g. WebSocket clients)
    clientOutboundChannel - the channel for messages to clients (e.g. WebSocket clients)
    brokerTemplate - a messaging template to send application messages to the broker
- 方法详细资料
  - setDestinationPrefixes
```
public void setDestinationPrefixes(Collection<String> prefixes)
```
    When this property is configured only messages to destinations matching one of the configured prefixes are eligible for handling. When there is a match the prefix is removed and only the remaining part of the destination is used for method-mapping purposes.
    By default, no prefixes are configured in which case all messages are eligible for handling.
    Destination prefixes are expected to be slash-separated Strings and therefore a slash is automatically appended where missing to ensure a proper prefix-based match (i.e. matching complete segments).
    Note however that the remaining portion of a destination after the prefix may use a different separator (e.g. commonly "." in messaging) depending on the configured PathMatcher.
    覆盖:
    setDestinationPrefixes 在类中 AbstractMethodMessageHandler<SimpMessageMappingInfo>
  - setMessageConverter
```
public void setMessageConverter(MessageConverter converter)
```
    Configure a MessageConverter to use to convert the payload of a message from its serialized form with a specific MIME type to an Object matching the target method parameter. The converter is also used when sending a message to the message broker.
    另请参阅:
    CompositeMessageConverter
  - getMessageConverter
```
public MessageConverter getMessageConverter()
```
    Return the configured MessageConverter.
  - setConversionService
```
public void setConversionService(ConversionService conversionService)
```
    Configure a ConversionService to use when resolving method arguments, for example message header values.
    By default, DefaultFormattingConversionService is used.
  - getConversionService
```
public ConversionService getConversionService()
```
    Return the configured ConversionService.
  - setPathMatcher
```
public void setPathMatcher(PathMatcher pathMatcher)
```
    Set the PathMatcher implementation to use for matching destinations against configured destination patterns.
    By default, AntPathMatcher is used.
  - getPathMatcher
```
public PathMatcher getPathMatcher()
```
    Return the PathMatcher implementation to use for matching destinations.
  - getValidator
```
public Validator getValidator()
```
    Return the configured Validator instance.
  - setValidator
```
public void setValidator(Validator validator)
```
    Set the Validator instance used for validating @Payload arguments.
    另请参阅:
    Validated, PayloadArgumentResolver
  - setEmbeddedValueResolver
```
public void setEmbeddedValueResolver(StringValueResolver resolver)
```
    从接口复制的说明: EmbeddedValueResolverAware
    Set the StringValueResolver to use for resolving embedded definition values.
    指定者:
    setEmbeddedValueResolver 在接口中 EmbeddedValueResolverAware
  - setHeaderInitializer
```
public void setHeaderInitializer(MessageHeaderInitializer headerInitializer)
```
    Configure a MessageHeaderInitializer to pass on to HandlerMethodReturnValueHandlers that send messages from controller return values.
    By default, this property is not set.
  - getHeaderInitializer
```
public MessageHeaderInitializer getHeaderInitializer()
```
    Return the configured header initializer.
  - isAutoStartup
```
public boolean isAutoStartup()
```
    从接口复制的说明: SmartLifecycle
    Returns true if this Lifecycle component should get started automatically by the container at the time that the containing ApplicationContext gets refreshed.
    A value of false indicates that the component is intended to be started through an explicit Lifecycle.start() call instead, analogous to a plain Lifecycle implementation.
    指定者:
    isAutoStartup 在接口中 SmartLifecycle
    另请参阅:
    Lifecycle.start(), Phased.getPhase(), LifecycleProcessor.onRefresh(), ConfigurableApplicationContext.refresh()
  - getPhase
```
public int getPhase()
```
    从接口复制的说明: Phased
    Return the phase value of this object.
    指定者:
    getPhase 在接口中 Phased
  - start
```
public final void start()
```
    从接口复制的说明: Lifecycle
    Start this component.
    Should not throw an exception if the component is already running.
    In the case of a container, this will propagate the start signal to all components that apply.
    指定者:
    start 在接口中 Lifecycle
    另请参阅:
    SmartLifecycle.isAutoStartup()
  - stop
```
public final void stop()
```
    从接口复制的说明: Lifecycle
    Stop this component, typically in a synchronous fashion, such that the component is fully stopped upon return of this method. Consider implementing SmartLifecycle and its stop(Runnable) variant when asynchronous stop behavior is necessary.
    Note that this stop notification is not guaranteed to come before destruction: On regular shutdown, Lifecycle beans will first receive a stop notification before the general destruction callbacks are being propagated; however, on hot refresh during a context's lifetime or on aborted refresh attempts, a given bean's destroy method will be called without any consideration of stop signals upfront.
    Should not throw an exception if the component is not running (not started yet).
    In the case of a container, this will propagate the stop signal to all components that apply.
    指定者:
    stop 在接口中 Lifecycle
    另请参阅:
    SmartLifecycle.stop(Runnable), DisposableBean.destroy()
  - stop
```
public final void stop(Runnable callback)
```
    从接口复制的说明: SmartLifecycle
    Indicates that a Lifecycle component must stop if it is currently running.
    The provided callback is used by the LifecycleProcessor to support an ordered, and potentially concurrent, shutdown of all components having a common shutdown order value. The callback must be executed after the SmartLifecycle component does indeed stop.
    The LifecycleProcessor will call only this variant of the stop method; i.e. Lifecycle.stop() will not be called for SmartLifecycle implementations unless explicitly delegated to within the implementation of this method.
    指定者:
    stop 在接口中 SmartLifecycle
    另请参阅:
    Lifecycle.stop(), Phased.getPhase()
  - isRunning
```
public final boolean isRunning()
```
    从接口复制的说明: Lifecycle
    Check whether this component is currently running.
    In the case of a container, this will return true only if all components that apply are currently running.
    指定者:
    isRunning 在接口中 Lifecycle
    返回:
    whether the component is currently running
  - initArgumentResolvers
```
protected List<HandlerMethodArgumentResolver> initArgumentResolvers()
```
    从类复制的说明: AbstractMethodMessageHandler
    Return the list of argument resolvers to use. Invoked only if the resolvers have not already been set via AbstractMethodMessageHandler.setArgumentResolvers(java.util.List<org.springframework.messaging.handler.invocation.HandlerMethodArgumentResolver>).
    Subclasses should also take into account custom argument types configured via AbstractMethodMessageHandler.setCustomArgumentResolvers(java.util.List<org.springframework.messaging.handler.invocation.HandlerMethodArgumentResolver>).
    指定者:
    initArgumentResolvers 在类中 AbstractMethodMessageHandler<SimpMessageMappingInfo>
  - initReturnValueHandlers
```
protected List<? extends HandlerMethodReturnValueHandler> initReturnValueHandlers()
```
    从类复制的说明: AbstractMethodMessageHandler
    Return the list of return value handlers to use. Invoked only if the return value handlers have not already been set via AbstractMethodMessageHandler.setReturnValueHandlers(java.util.List<org.springframework.messaging.handler.invocation.HandlerMethodReturnValueHandler>).
    Subclasses should also take into account custom return value types configured via AbstractMethodMessageHandler.setCustomReturnValueHandlers(java.util.List<org.springframework.messaging.handler.invocation.HandlerMethodReturnValueHandler>).
    指定者:
    initReturnValueHandlers 在类中 AbstractMethodMessageHandler<SimpMessageMappingInfo>
  - isHandler
```
protected boolean isHandler(Class<?> beanType)
```
    从类复制的说明: AbstractMethodMessageHandler
    Whether the given bean type should be introspected for messaging handling methods.
    指定者:
    isHandler 在类中 AbstractMethodMessageHandler<SimpMessageMappingInfo>
  - getMappingForMethod
```
protected SimpMessageMappingInfo getMappingForMethod(Method method,
                                                     Class<?> handlerType)
```
    从类复制的说明: AbstractMethodMessageHandler
    Provide the mapping for a handler method.
    指定者:
    getMappingForMethod 在类中 AbstractMethodMessageHandler<SimpMessageMappingInfo>
    参数:
    method - the method to provide a mapping for
    handlerType - the handler type, possibly a sub-type of the method's declaring class
    返回:
    the mapping, or null if the method is not mapped
  - resolveEmbeddedValuesInDestinations
```
protected String[] resolveEmbeddedValuesInDestinations(String[] destinations)
```
    Resolve placeholder values in the given array of destinations.
    返回:
    a new array with updated destinations
    从以下版本开始:
    4.2
  - getDirectLookupDestinations
```
protected Set<String> getDirectLookupDestinations(SimpMessageMappingInfo mapping)
```
    从类复制的说明: AbstractMethodMessageHandler
    Return destinations contained in the mapping that are not patterns and are therefore suitable for direct lookups.
    指定者:
    getDirectLookupDestinations 在类中 AbstractMethodMessageHandler<SimpMessageMappingInfo>
  - getDestination
```
protected String getDestination(Message<?> message)
```
    指定者:
    getDestination 在类中 AbstractMethodMessageHandler<SimpMessageMappingInfo>
  - getLookupDestination
```
protected String getLookupDestination(String destination)
```
    从类复制的说明: AbstractMethodMessageHandler
    Check whether the given destination (of an incoming message) matches to one of the configured destination prefixes and if so return the remaining portion of the destination after the matched prefix.
    If there are no matching prefixes, return null.
    If there are no destination prefixes, return the destination as is.
    覆盖:
    getLookupDestination 在类中 AbstractMethodMessageHandler<SimpMessageMappingInfo>
  - getMatchingMapping
```
protected SimpMessageMappingInfo getMatchingMapping(SimpMessageMappingInfo mapping,
                                                    Message<?> message)
```
    从类复制的说明: AbstractMethodMessageHandler
    Check if a mapping matches the current message and return a possibly new mapping with conditions relevant to the current request.
    指定者:
    getMatchingMapping 在类中 AbstractMethodMessageHandler<SimpMessageMappingInfo>
    参数:
    mapping - the mapping to get a match for
    message - the message being handled
    返回:
    the match or null if there is no match
  - getMappingComparator
```
protected Comparator<SimpMessageMappingInfo> getMappingComparator(Message<?> message)
```
    从类复制的说明: AbstractMethodMessageHandler
    Return a comparator for sorting matching mappings. The returned comparator should sort 'better' matches higher.
    指定者:
    getMappingComparator 在类中 AbstractMethodMessageHandler<SimpMessageMappingInfo>
    参数:
    message - the current Message
    返回:
    the comparator, never null
  - handleMatch
```
protected void handleMatch(SimpMessageMappingInfo mapping,
                           HandlerMethod handlerMethod,
                           String lookupDestination,
                           Message<?> message)
```
    覆盖:
    handleMatch 在类中 AbstractMethodMessageHandler<SimpMessageMappingInfo>
  - createExceptionHandlerMethodResolverFor
```
protected AbstractExceptionHandlerMethodResolver createExceptionHandlerMethodResolverFor(Class<?> beanType)
```
    指定者:
    createExceptionHandlerMethodResolverFor 在类中 AbstractMethodMessageHandler<SimpMessageMappingInfo>

类 SimpAnnotationMethodMessageHandler

字段概要

从类继承的字段 org.springframework.messaging.handler.invocation.AbstractMethodMessageHandler

构造器概要

方法概要

从类继承的方法 org.springframework.messaging.handler.invocation.AbstractMethodMessageHandler

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

构造器详细资料

SimpAnnotationMethodMessageHandler

方法详细资料

setDestinationPrefixes

setMessageConverter

getMessageConverter

setConversionService

getConversionService

setPathMatcher

getPathMatcher

getValidator

setValidator

setEmbeddedValueResolver

setHeaderInitializer

getHeaderInitializer

isAutoStartup

getPhase

start

stop

stop

isRunning

initArgumentResolvers

initReturnValueHandlers

isHandler

getMappingForMethod

resolveEmbeddedValuesInDestinations

getDirectLookupDestinations

getDestination

getLookupDestination

getMatchingMapping

getMappingComparator

handleMatch

createExceptionHandlerMethodResolverFor