Spring MVC - Accessing pre-existing request attributes using @RequestAttribute

[Last Updated: Dec 7, 2017]

Starting from Spring 4.3, a new annotation @RequestAttribute was introduced. This annotation can be used to bind a request attribute to a handler method parameter.

Spring retrieves the named attribute's value from ServletRequest#getAttribute(String name) to populated the parameter annotated with @RequestAttribute.

Rather than using HttpServletRequest object directly, using this annotation can benefit auto type conversion and optional/required check. This annotation has an element 'required' which is true by default. That means if the attribute value is not present in the request, an exception will be thrown. If we set it to false then we can avoid the exception but the value received can be null.

Difference between @RequestParam and @RequestAttribute

@RequestParam is used to bind parameter values from 'query string' e.g. in, myParam=3 can populate @RequestParam parameter. On the other hand, @RequestAttribute is to access objects which have been populated on the server-side but during the same HTTP request, for example they can be populated in an interceptor or a filter. The difference is same as of the difference between ServletRequest#getParameter(name) and ServletRequest#getAttribute(name)


Following example shows, how to use @RequestAttribute to access visitor counter value, which has been populated as request attribute from an HandlerInterceptor method.

The interceptor

public class MyCounterInterceptor extends HandlerInterceptorAdapter {
  private AtomicInteger counter = new AtomicInteger(0);

  public boolean preHandle (HttpServletRequest request,
                            HttpServletResponse response,
                            Object handler) throws Exception {

      request.setAttribute("visitorCounter", counter.incrementAndGet());
      return true;

The controller

public class ExampleController {

  public String handle (@RequestAttribute("visitorCounter") Integer counter) {
      return String.format("Visitor number: %d", counter);

JavaConfig class

public class AppConfig extends WebMvcConfigurerAdapter {

  public void addInterceptors (InterceptorRegistry registry) {
      registry.addInterceptor(new MyCounterInterceptor());

Run embedded tomcat

mvn tomcat7:run-war


Refreshing the page multiple times, will increase the counter value.

Example Project

Dependencies and Technologies Used:

  • spring-webmvc 4.3.5.RELEASE: Spring Web MVC.
  • javax.servlet-api 3.0.1 Java Servlet API
  • JDK 1.8
  • Maven 3.3.9

Spring Mvc Request Attribute Example Select All Download
  • request-attribute-example
    • src
      • main
        • java
          • com
            • logicbig
              • example

    See Also