Package org.springframework.messaging.handler

Class HandlerMethod

java.lang.Object
org.springframework.core.annotation.AnnotatedMethod
org.springframework.messaging.handler.HandlerMethod
Direct Known Subclasses:
InvocableHandlerMethod, InvocableHandlerMethod
public class HandlerMethod extends org.springframework.core.annotation.AnnotatedMethod
Encapsulates information about a handler method consisting of a method and a bean. Provides convenient access to method parameters, the method return value, method annotations, etc.

The class may be created with a bean instance or with a bean name (e.g. lazy-init bean, prototype bean). Use createWithResolvedBean() to obtain a HandlerMethod instance with a bean instance resolved through the associated BeanFactory.

Since:
4.0
Author:
Arjen Poutsma, Rossen Stoyanchev, Juergen Hoeller

  • Nested Class Summary

    Nested classes/interfaces inherited from class org.springframework.core.annotation.AnnotatedMethod

    org.springframework.core.annotation.AnnotatedMethod.AnnotatedMethodParameter

  • Field Summary

    Fields
    Modifier and Type
    Field
    Description
    static final org.apache.commons.logging.Log
    defaultLogger
    Public for wrapping with fallback logger.
    protected org.apache.commons.logging.Log
    logger
     

  • Constructor Summary

    Constructors
    Modifier
    Constructor
    Description
     
    HandlerMethod(Object bean, Method method)
    Create an instance from a bean instance and a method.
     
    HandlerMethod(Object bean, String methodName, Class<?>... parameterTypes)
    Create an instance from a bean instance, method name, and parameter types.
     
    HandlerMethod(String beanName, org.springframework.beans.factory.BeanFactory beanFactory, Method method)
    Create an instance from a bean name, a method, and a BeanFactory.
    protected
    HandlerMethod(HandlerMethod handlerMethod)
    Copy constructor for use in subclasses.

  • Method Summary

    Modifier and Type
    Method
    Description
    protected void
    assertTargetBean(Method method, Object targetBean, Object[] args)
    Assert that the target bean class is an instance of the class where the given method is declared.
    HandlerMethod
    createWithResolvedBean()
    If the provided instance contains a bean name rather than an object instance, the bean name is resolved before a HandlerMethod is created and returned.
    boolean
    equals(Object other)
     
    protected String
    formatInvokeError(String text, Object[] args)
     
    Object
    getBean()
    Return the bean for this handler method.
    Class<?>
    getBeanType()
    This method returns the type of the handler for this handler method.
    protected Class<?>
    getContainingClass()
     
    org.apache.commons.logging.Log
    getLogger()
    Return the currently configured Logger.
    HandlerMethod
    getResolvedFromHandlerMethod()
    Return the HandlerMethod from which this HandlerMethod instance was resolved via createWithResolvedBean().
    String
    getShortLogMessage()
    Return a short representation of this handler method for log message purposes.
    int
    hashCode()
     
    void
    setLogger(org.apache.commons.logging.Log logger)
    Set an alternative logger to use than the one based on the class name.

    Methods inherited from class org.springframework.core.annotation.AnnotatedMethod

    findProvidedArgument, formatArgumentError, getBridgedMethod, getMethod, getMethodAnnotation, getMethodParameters, getReturnType, getReturnValueType, hasMethodAnnotation, isVoid, toString

    Methods inherited from class java.lang.Object

    clone, finalize, getClass, notify, notifyAll, wait, wait, wait

  • Field Details

    • defaultLogger

      public static final org.apache.commons.logging.Log defaultLogger
      Public for wrapping with fallback logger.

    • logger

      protected org.apache.commons.logging.Log logger

  • Constructor Details

    • HandlerMethod

      public HandlerMethod(Object bean, Method method)
      Create an instance from a bean instance and a method.

    • HandlerMethod

      public HandlerMethod(Object bean, String methodName, Class<?>... parameterTypes) throws NoSuchMethodException
      Create an instance from a bean instance, method name, and parameter types.
      Throws:
      NoSuchMethodException - when the method cannot be found

    • HandlerMethod

      public HandlerMethod(String beanName, org.springframework.beans.factory.BeanFactory beanFactory, Method method)
      Create an instance from a bean name, a method, and a BeanFactory. The method createWithResolvedBean() may be used later to re-create the HandlerMethod with an initialized bean.

    • HandlerMethod

      protected HandlerMethod(HandlerMethod handlerMethod)
      Copy constructor for use in subclasses.

  • Method Details

    • setLogger

      public void setLogger(org.apache.commons.logging.Log logger)
      Set an alternative logger to use than the one based on the class name.
      Parameters:
      logger - the logger to use
      Since:
      5.1

    • getLogger

      public org.apache.commons.logging.Log getLogger()
      Return the currently configured Logger.
      Since:
      5.1

    • getBean

      public Object getBean()
      Return the bean for this handler method.

    • getBeanType

      public Class<?> getBeanType()
      This method returns the type of the handler for this handler method.

      Note that if the bean type is a CGLIB-generated class, the original user-defined class is returned.

    • getContainingClass

      protected Class<?> getContainingClass()
      Overrides:
      getContainingClass in class org.springframework.core.annotation.AnnotatedMethod

    • getResolvedFromHandlerMethod

      @Nullable public HandlerMethod getResolvedFromHandlerMethod()
      Return the HandlerMethod from which this HandlerMethod instance was resolved via createWithResolvedBean().
      Since:
      4.3

    • createWithResolvedBean

      public HandlerMethod createWithResolvedBean()
      If the provided instance contains a bean name rather than an object instance, the bean name is resolved before a HandlerMethod is created and returned.

    • getShortLogMessage

      public String getShortLogMessage()
      Return a short representation of this handler method for log message purposes.

    • equals

      public boolean equals(@Nullable Object other)
      Overrides:
      equals in class org.springframework.core.annotation.AnnotatedMethod

    • hashCode

      public int hashCode()
      Overrides:
      hashCode in class org.springframework.core.annotation.AnnotatedMethod

    • assertTargetBean

      protected void assertTargetBean(Method method, Object targetBean, Object[] args)
      Assert that the target bean class is an instance of the class where the given method is declared. In some cases the actual endpoint instance at request- processing time may be a JDK dynamic proxy (lazy initialization, prototype beans, and others). Endpoint classes that require proxying should prefer class-based proxy mechanisms.

    • formatInvokeError

      protected String formatInvokeError(String text, Object[] args)